1ENBLEND(1) User Commands ENBLEND(1)
2
6 enblend - manual page for enblend 4.2
7
9 enblend [options] [--output=IMAGE] INPUT...
10
12 Blend INPUT images into a single IMAGE.
13 INPUT... are image filenames or response filenames. Response filenames
15 start with an "@" character.
16
18 Common options:
19 -l, --levels=LEVELS
20 limit number of blending LEVELS to use (1 to 29); negative num‐
21 ber of LEVELS decreases maximum; "auto" restores the default au‐
22 tomatic maximization
23 -o, --output=FILE
25 write output to FILE; default: "a.tif"
26 -v, --verbose[=LEVEL]
28 verbosely report progress; repeat to increase verbosity or di‐
29 rectly set to LEVEL
30 --compression=COMPRESSION
32 set compression of output image to COMPRESSION, where COMPRES‐
33 SION is: "deflate", "jpeg", "lzw", "none", "packbits", for TIFF
34 files and 0 to 100, or "jpeg", "jpeg-arith" for JPEG files,
35 where "jpeg" and "jpeg-arith" accept a compression level
36 Advanced options:
38 --blend-colorspace=COLORSPACE
39 force COLORSPACE for blending operations; Enblend uses "CIELUV"
40 for images with ICC-profile and "IDENTITY" for those without and
41 also for all floating-point images; other available blend color
42 spaces are "CIELAB" and "CIECAM"
43 -c, --ciecam
45 use CIECAM02 to blend colors; disable with "--no-ciecam"; note
46 that this option will be withdrawn in favor of "--blend-col‐
47 orspace"
48 -d, --depth=DEPTH
50 set the number of bits per channel of the output image, where
51 DEPTH is "8", "16", "32", "r32", or "r64"
52 -f WIDTHxHEIGHT[+xXOFFSET+yYOFFSET]
54 manually set the size and position of the output image; useful
55 for cropped and shifted input TIFF images, such as those pro‐
56 duced by Nona
57 -g associated-alpha hack for Gimp (before version 2) and Cinepaint
59 -w, --wrap[=MODE]
61 wrap around image boundary, where MODE is "none", "horizontal",
62 "vertical", or "both"; default: none; without argument the op‐
63 tion selects horizontal wrapping
64 Mask generation options:
66 --coarse-mask[=FACTOR] shrink overlap regions by FACTOR to speedup mask
67 generation; this is the default; if omitted FACTOR defaults to 8
68 --fine-mask
70 generate mask at full image resolution; use e.g. if overlap re‐
71 gions are very narrow
72 --optimize
74 turn on mask optimization; this is the default; disable with
75 "--no-optimize"
76 --save-masks[=TEMPLATE]
78 save generated masks in TEMPLATE; default: "mask-%n.tif"; con‐
79 version chars: "%i": mask index, "%n": mask number, "%p": full
80 path, "%d": dirname, "%b": basename, "%f": filename, "%e": ex‐
81 tension; lowercase characters refer to input images uppercase to
82 the output image
83 --load-masks[=TEMPLATE]
85 use existing masks in TEMPLATE instead of generating them; same
86 template characters as "--save-masks"; default: "mask-%n.tif"
87 --visualize[=TEMPLATE] save results of optimizer in TEMPLATE; same tem‐
89 plate
90 characters as "--save-masks"; default: "vis-%n.tif"
91 Expert options:
93 -a, --pre-assemble
94 pre-assemble non-overlapping images; negate with "--no-pre-as‐
95 semble"
96 -x checkpoint partial results
98 --fallback-profile=PROFILE-FILE
100 use the ICC profile from PROFILE-FILE instead of sRGB
101 --layer-selector=ALGORITHM
103 set the layer selector ALGORITHM; default: "all-layers"; avail‐
104 able algorithms are: "all-layers": select all layers in any im‐
105 age; "first-layer": select only first layer in each
106 (multi-)layer image; "last-layer": select only last layer in
107 each (multi-)layer image; "largest-layer": select largest layer
108 in each (multi-)layer image; "no-layer": do not select any layer
109 from any image;
110 --parameter=KEY1[=VALUE1][:KEY2[=VALUE2][:...]]
112 set one or more KEY-VALUE pairs
113 Expert mask generation options:
115 --primary-seam-generator=ALGORITHM
116 use main seam finder ALGORITHM, where ALGORITHM is "nearest-fea‐
117 ture-transform" or "graph-cut"; default: "graph-cut"
118 --image-difference=ALGORITHM[:LUMINANCE-WEIGHT[:CHROMINANCE-WEIGHT]]
120 use ALGORITHM for calculation of the difference image, where AL‐
121 GORITHM is "max-hue-luminance" or "delta-e"; LUMINANCE-WEIGHT
122 and CHROMINANCE-WEIGHT define the weights of lightness and
123 color; default: delta-e:1:1
124 --optimizer-weights=DISTANCE-WEIGHT[:MISMATCH-WEIGHT]
126 set the optimizer's weigths for distance and mismatch; default:
127 8:1
128 --mask-vectorize=LENGTH
130 set LENGTH of single seam segment; append "%" for relative
131 value; defaults: 4 for coarse masks and 20 for fine masks
132 --anneal=TAU[:DELTAE-MAX[:DELTAE-MIN[:K-MAX]]]
134 set annealing parameters of optimizer strategy 1; defaults:
135 0.75:7000:5:32
136 --dijkstra=RADIUS
138 set search RADIUS of optimizer strategy 2; default: 25 pixels
139 Information options:
141 -h, --help
142 print this help message and exit
143 -V, --version
145 output version information and exit
146 --show-globbing-algorithms
148 show all globbing algorithms
149 --show-image-formats
151 show all recognized image formats and their filename extensions
152 --show-signature
154 show who compiled the binary when and on which machine
155 --show-software-components
157 show the software components with which Enblend was compiled
158 Enblend accepts arguments to any option in uppercase as well as in low‐
160 ercase letters.
161
163 OMP_NUM_THREADS
164 The OMP_NUM_THREADS environment variable sets the number of
165 threads to use in OpenMP parallel regions. If unset Enblend
166 uses as many threads as there are CPUs.
167 OMP_DYNAMIC
169 The OMP_DYNAMIC environment variable controls dynamic adjustment
170 of the number of threads to use in executing OpenMP parallel re‐
171 gions.
172
174 Written by Andrew Mihal, Christoph Spiel and others.
175
177 Report bugs at <https://bugs.launchpad.net/enblend>.
178
180 Copyright © 2004-2009 Andrew Mihal.
181 Copyright © 2009-2016 Christoph Spiel.
182 License GPLv2+: GNU GPL version 2 or later <http://www.gnu.org/li‐
184 censes/gpl.html>
185 This is free software: you are free to change and redistribute it.
186 There is NO WARRANTY, to the extent permitted by law.
187enblend 4.2 January 2023 ENBLEND(1)