enblend(1)

enblend1

Manual page for enblend 4.2.1-0bcfaaf743e7

Usage

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

Overview

Blend INPUT images into a single IMAGE.

INPUT... are image filenames or response filenames. Response filenames start with an "@" character.

Options

Common options:

-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

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

Advanced options:

--blend-colorspace=COLORSPACE

force COLORSPACE for blending operations; Enblend uses "CIELUV" for images with ICC-profile and "IDENTITY" for those without and also for all floating-point images; other available blend color spaces are "CIELAB" and "CIECAM"

-c, --ciecam

use CIECAM02 to blend colors; disable with "--no-ciecam"; note that this option will be withdrawn in favor of "--blend-colorspace"

-d, --depth=DEPTH

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

-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

-g

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

-w, --wrap[=MODE]

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

Mask generation options:

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

--optimize

turn on mask optimization; this is the default; disable with "--no-optimize"

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

Expert options:

-a, --pre-assemble

pre-assemble non-overlapping images; negate with "--no-pre-assemble"

-x

checkpoint partial results

--fallback-profile=PROFILE-FILE

use the ICC profile from PROFILE-FILE instead of sRGB

--layer-selector=ALGORITHM

set the layer selector ALGORITHM; default: "all-layers"; available algorithms are: "all-layers": select all layers in any image; "first-layer": select only first layer in each (multi-)layer image; "last-layer": select only last 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

Expert mask generation options:

--primary-seam-generator=ALGORITHM

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

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

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

Information options:

-h, --help

print this help message and exit

-V, --version

output version information and exit

--show-globbing-algorithms

show all globbing algorithms

--show-image-formats

show all recognized image formats and their filename extensions

--show-signature

show who compiled the binary when and on which machine

--show-software-components

show the software components with which Enblend was compiled

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

Environment

OMP_NUM_THREADS

The OMP_NUM_THREADS environment variable sets the number of threads to use in OpenMP parallel regions. If unset Enblend uses as many threads as there are CPUs.

OMP_DYNAMIC

The OMP_DYNAMIC environment variable controls dynamic adjustment of the number of threads to use in executing OpenMP parallel regions.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 9 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8
  5. 9
  6. 10
  7. 11
  8. 12
  9. 13
  10. Arch

--anneal since Debian 6.0 (Squeeze); --blend-colorspace since Debian 9 (Stretch); --ciecam since Debian 8 (Jessie); --compression since Debian 6.0 (Squeeze); --depth since Debian 6.0 (Squeeze); --dijkstra since Debian 6.0 (Squeeze); --fallback-profile since Debian 8 (Jessie); --help since Debian 6.0 (Squeeze); --image-difference since Debian 8 (Jessie); --layer-selector since Debian 8 (Jessie); --levels since Debian 6.0 (Squeeze); --load-masks since Debian 6.0 (Squeeze); --mask-vectorize since Debian 6.0 (Squeeze); --optimizer-weights since Debian 6.0 (Squeeze); --output since Debian 6.0 (Squeeze); --parameter since Debian 8 (Jessie); --pre-assemble since Debian 9 (Stretch); --primary-seam-generator since Debian 8 (Jessie); --save-masks since Debian 6.0 (Squeeze); --show-globbing-algorithms since Debian 9 (Stretch); --show-image-formats since Debian 9 (Stretch); --show-signature since Debian 9 (Stretch); --show-software-components since Debian 9 (Stretch); --verbose since Debian 6.0 (Squeeze); --version since Debian 6.0 (Squeeze); --wrap since Debian 6.0 (Squeeze); -V since Debian 6.0 (Squeeze); -d since Debian 6.0 (Squeeze).

--coarse-mask until Debian 5.0 (Lenny); --gpu until Debian 8 (Jessie); --load-mask until Debian 5.0 (Lenny); --no-optimize until Debian 8 (Jessie); --save-mask until Debian 5.0 (Lenny); --smooth-difference until Debian 8 (Jessie); --visualize until Debian 5.0 (Lenny); -b until Debian 8 (Jessie); -m until Debian 8 (Jessie); -z until Debian 5.0 (Lenny).

Author

Written by Andrew Mihal, Christoph Spiel and others.

Reporting bugs

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

From enblend-enfuse 4.2.r1546+hb66125418f7d-5 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.