NAME¶

enblend - combine images using a multiresolution spline

SYNOPSIS¶

enblend [ options] [--output=IMAGE] INPUT...

DESCRIPTION¶

Blend INPUT images into a single IMAGE. INPUT... are image filenames or response filenames. Response filenames start with an "@" character.

Common options:¶

-V, --version

output version information and exit

-a

pre-assemble non-overlapping images

-h, --help

print this help message and exit

-l, --levels=LEVELS

limit number of blending LEVELS to use (1 to 29); negative number of LEVELS decreases maximum; "auto" restores the default automatic maximization

-o, --output=FILE

write output to FILE; default: "a.tif"

-v, --verbose[=LEVEL]

verbosely report progress; repeat to increase verbosity or directly set to LEVEL

-w, --wrap[=MODE]

wrap around image boundary, where MODE is "none", "horizontal", "vertical", or "both"; default: none; without argument the option selects horizontal wrapping

-x

checkpoint partial results

--compression=COMPRESSION

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

--layer-selector=ALGORITHM

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;

--parameter=KEY1[=VALUE1][:KEY2[=VALUE2][:...]]

set one or more KEY-VALUE pairs

Extended options:¶

-b BLOCKSIZE

image cache BLOCKSIZE in kilobytes; default: 2048KB

-c, --ciecam

use CIECAM02 to blend colors; disable with "--no-ciecam"

--fallback-profile=PROFILE-FILE

use the ICC profile from PROFILE-FILE instead of sRGB

-d, --depth=DEPTH

set the number of bits per channel of the output image, where DEPTH is "8", "16", "32", "r32", or "r64"

-g

associated-alpha hack for Gimp (before version 2) and Cinepaint

--gpu

use graphics card to accelerate seam-line optimization

-f 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

-m CACHESIZE

set image CACHESIZE in megabytes; default: 1024MB

Mask generation options:¶

--primary-seam-generator=ALGORITHM

use main seam finder ALGORITHM, where ALGORITHM is "nearest-feature-transform" or "graph-cut"; default: "nearest-feature-transform"

--image-difference=ALGORITHM[: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

--coarse-mask[=FACTOR] shrink overlap regions by FACTOR to speedup mask

generation; this is the default; if omitted FACTOR defaults to 8

--fine-mask

generate mask at full image resolution; use e.g. if overlap regions are very narrow

--smooth-difference=RADIUS

(deprecated) smooth the difference image prior to seam-line optimization with a Gaussian blur of RADIUS; default: 0 pixels

--optimize

turn on mask optimization; this is the default

--no-optimize

turn off mask optimization

--optimizer-weights=DISTANCE-WEIGHT[:MISMATCH-WEIGHT]

set the optimizer's weigths for distance and mismatch; default: 8:1

--mask-vectorize=LENGTH

set LENGTH of single seam segment; append "%" for relative value; defaults: 4 for coarse masks and 20 for fine masks

--anneal=TAU[:DELTAE-MAX[:DELTAE-MIN[:K-MAX]]]

set annealing parameters of optimizer strategy 1; defaults: 0.75:7000:5:32

--dijkstra=RADIUS

set search RADIUS of optimizer strategy 2; default: 25 pixels

--save-masks[=TEMPLATE]

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

--load-masks[=TEMPLATE]

use existing masks in TEMPLATE instead of generating them; same template characters as "--save-masks"; default: "mask-%n.tif"

--visualize[=TEMPLATE] save results of optimizer in TEMPLATE; same template

characters as "--save-masks"; default: "vis-%n.tif"

Enblend accepts arguments to any option in uppercase as well as in lowercase letters.

AUTHOR¶

Written by Andrew Mihal and others.

REPORTING BUGS¶

Report bugs at <https://bugs.launchpad.net/enblend>.

COPYRIGHT¶

Copyright © 2004-2014 Andrew Mihal. License GPLv2+: GNU GPL version 2 or later <http://www.gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO¶

The full documentation for enblend is maintained as a Texinfo manual. If the info and enblend programs are properly installed at your site, the command

info enblend

should give you access to the complete manual.