.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.45.1. .TH ENBLEND "1" "July 2014" "enblend 4.1.3" "User Commands" .SH NAME enblend \- combine images using a multiresolution spline .SH SYNOPSIS .B enblend [\fI\,options\/\fR] [\fI\,--output=IMAGE\/\fR] \fI\,INPUT\/\fR... .SH DESCRIPTION Blend INPUT images into a single IMAGE. .PP INPUT... are image filenames or response filenames. Response filenames start with an "@" character. .SS "Common options:" .TP \fB\-V\fR, \fB\-\-version\fR output version information and exit .TP \fB\-a\fR pre\-assemble non\-overlapping images .TP \fB\-h\fR, \fB\-\-help\fR print this help message and exit .TP \fB\-l\fR, \fB\-\-levels\fR=\fI\,LEVELS\/\fR limit number of blending LEVELS to use (1 to 29); negative number of LEVELS decreases maximum; "auto" restores the default automatic maximization .TP \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR write output to FILE; default: "a.tif" .TP \fB\-v\fR, \fB\-\-verbose\fR[=\fI\,LEVEL\/\fR] verbosely report progress; repeat to increase verbosity or directly set to LEVEL .TP \fB\-w\fR, \fB\-\-wrap\fR[=\fI\,MODE\/\fR] wrap around image boundary, where MODE is "none", "horizontal", "vertical", or "both"; default: none; without argument the option selects horizontal wrapping .TP \fB\-x\fR checkpoint partial results .TP \fB\-\-compression\fR=\fI\,COMPRESSION\/\fR set compression of output image to COMPRESSION, where COMPRESSION is: "deflate", "jpeg", "lzw", "none", "packbits", for TIFF files and 0 to 100, or "jpeg", "jpeg\-arith" for JPEG files, where "jpeg" and "jpeg\-arith" accept a compression level .TP \fB\-\-layer\-selector\fR=\fI\,ALGORITHM\/\fR set the layer selector ALGORITHM; default: "all\-layers"; available algorithms are: "all\-layers": select all layers in all images; "first\-layer": select only first layer in each multi\-layer image; "largest\-layer": select largest layer in each multi\-layer image; "no\-layer": do not select any layer from any image; .TP \fB\-\-parameter\fR=\fI\,KEY1[=VALUE1][\/\fR:KEY2[=VALUE2][:...]] set one or more KEY\-VALUE pairs .SS "Extended options:" .TP \fB\-b\fR BLOCKSIZE image cache BLOCKSIZE in kilobytes; default: 2048KB .TP \fB\-c\fR, \fB\-\-ciecam\fR use CIECAM02 to blend colors; disable with "\-\-no\-ciecam" .TP \fB\-\-fallback\-profile\fR=\fI\,PROFILE\-FILE\/\fR use the ICC profile from PROFILE\-FILE instead of sRGB .TP \fB\-d\fR, \fB\-\-depth\fR=\fI\,DEPTH\/\fR set the number of bits per channel of the output image, where DEPTH is "8", "16", "32", "r32", or "r64" .TP \fB\-g\fR associated\-alpha hack for Gimp (before version 2) and Cinepaint .TP \fB\-\-gpu\fR use graphics card to accelerate seam\-line optimization .TP \fB\-f\fR WIDTHxHEIGHT[+xXOFFSET+yYOFFSET] manually set the size and position of the output image; useful for cropped and shifted input TIFF images, such as those produced by Nona .TP \fB\-m\fR CACHESIZE set image CACHESIZE in megabytes; default: 1024MB .SS "Mask generation options:" .TP \fB\-\-primary\-seam\-generator\fR=\fI\,ALGORITHM\/\fR use main seam finder ALGORITHM, where ALGORITHM is "nearest\-feature\-transform" or "graph\-cut"; default: "nearest\-feature\-transform" .TP \fB\-\-image\-difference\fR=\fI\,ALGORITHM[\/\fR:LUMINANCE\-WEIGHT[:CHROMINANCE\-WEIGHT]] use ALGORITHM for calculation of the difference image, where ALGORITHM is "max\-hue\-luminance" or "delta\-e"; LUMINANCE\-WEIGHT and CHROMINANCE\-WEIGHT define the weights of lightness and color; default: delta\-e:1: 1 .TP \fB\-\-coarse\-mask\fR[=\fI\,FACTOR\/\fR] shrink overlap regions by FACTOR to speedup mask generation; this is the default; if omitted FACTOR defaults to 8 .TP \fB\-\-fine\-mask\fR generate mask at full image resolution; use e.g. if overlap regions are very narrow .TP \fB\-\-smooth\-difference\fR=\fI\,RADIUS\/\fR (deprecated) smooth the difference image prior to seam\-line optimization with a Gaussian blur of RADIUS; default: 0 pixels .TP \fB\-\-optimize\fR turn on mask optimization; this is the default .TP \fB\-\-no\-optimize\fR turn off mask optimization .TP \fB\-\-optimizer\-weights\fR=\fI\,DISTANCE\-WEIGHT[\/\fR:MISMATCH\-WEIGHT] set the optimizer's weigths for distance and mismatch; default: 8:1 .TP \fB\-\-mask\-vectorize\fR=\fI\,LENGTH\/\fR set LENGTH of single seam segment; append "%" for relative value; defaults: 4 for coarse masks and 20 for fine masks .TP \fB\-\-anneal\fR=\fI\,TAU[\/\fR:DELTAE\-MAX[:DELTAE\-MIN[:K\-MAX]]] set annealing parameters of optimizer strategy 1; defaults: 0.75:7000:5:32 .TP \fB\-\-dijkstra\fR=\fI\,RADIUS\/\fR set search RADIUS of optimizer strategy 2; default: 25 pixels .TP \fB\-\-save\-masks\fR[=\fI\,TEMPLATE\/\fR] save generated masks in TEMPLATE; default: "mask\-%n.tif"; conversion chars: "%i": mask index, "%n": mask number, "%p": full path, "%d": dirname, "%b": basename, "%f": filename, "%e": extension; lowercase characters refer to input images uppercase to the output image .TP \fB\-\-load\-masks\fR[=\fI\,TEMPLATE\/\fR] use existing masks in TEMPLATE instead of generating them; same template characters as "\-\-save\-masks"; default: "mask\-%n.tif" .TP \fB\-\-visualize\fR[=\fI\,TEMPLATE\/\fR] save results of optimizer in TEMPLATE; same template characters as "\-\-save\-masks"; default: "vis\-%n.tif" .PP Enblend accepts arguments to any option in uppercase as well as in lowercase letters. .SH AUTHOR Written by Andrew Mihal and others. .SH "REPORTING BUGS" Report bugs at . .SH COPYRIGHT Copyright \(co 2004\-2014 Andrew Mihal. License GPLv2+: GNU GPL version 2 or later .br This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. .SH "SEE ALSO" The full documentation for .B enblend is maintained as a Texinfo manual. If the .B info and .B enblend programs are properly installed at your site, the command .IP .B info enblend .PP should give you access to the complete manual.