1ENBLEND(1)                       User Commands                      ENBLEND(1)
2
3
4

NAME

6       enblend - manual page for enblend 4.2
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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
24       -o, --output=FILE
25              write output to FILE; default: "a.tif"
26
27       -v, --verbose[=LEVEL]
28              verbosely report progress; repeat to increase verbosity  or  di‐
29              rectly set to LEVEL
30
31       --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
37   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
44       -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
49       -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
53       -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
58       -g     associated-alpha hack for Gimp (before version 2) and Cinepaint
59
60       -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
65   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
69       --fine-mask
70              generate mask at full image resolution; use e.g.  if overlap re‐
71              gions are very narrow
72
73       --optimize
74              turn  on  mask  optimization;  this is the default; disable with
75              "--no-optimize"
76
77       --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
84       --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
88       --visualize[=TEMPLATE] save results of optimizer in TEMPLATE; same tem‐
89       plate
90              characters as "--save-masks"; default: "vis-%n.tif"
91
92   Expert options:
93       -a, --pre-assemble
94              pre-assemble non-overlapping images; negate  with  "--no-pre-as‐
95              semble"
96
97       -x     checkpoint partial results
98
99       --fallback-profile=PROFILE-FILE
100              use the ICC profile from PROFILE-FILE instead of sRGB
101
102       --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
111       --parameter=KEY1[=VALUE1][:KEY2[=VALUE2][:...]]
112              set one or more KEY-VALUE pairs
113
114   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
119       --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
125       --optimizer-weights=DISTANCE-WEIGHT[:MISMATCH-WEIGHT]
126              set  the optimizer's weigths for distance and mismatch; default:
127              8:1
128
129       --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
133       --anneal=TAU[:DELTAE-MAX[:DELTAE-MIN[:K-MAX]]]
134              set  annealing  parameters  of  optimizer  strategy 1; defaults:
135              0.75:7000:5:32
136
137       --dijkstra=RADIUS
138              set search RADIUS of optimizer strategy 2; default: 25 pixels
139
140   Information options:
141       -h, --help
142              print this help message and exit
143
144       -V, --version
145              output version information and exit
146
147       --show-globbing-algorithms
148              show all globbing algorithms
149
150       --show-image-formats
151              show all recognized image formats and their filename extensions
152
153       --show-signature
154              show who compiled the binary when and on which machine
155
156       --show-software-components
157              show the software components with which Enblend was compiled
158
159       Enblend accepts arguments to any option in uppercase as well as in low‐
160       ercase letters.
161

ENVIRONMENT

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

AUTHOR

174       Written by Andrew Mihal, Christoph Spiel and others.
175

REPORTING BUGS

177       Report bugs at <https://bugs.launchpad.net/enblend>.
178
180       Copyright © 2004-2009 Andrew Mihal.
181       Copyright © 2009-2016 Christoph Spiel.
182
183       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.
187
188
189
190enblend 4.2                        July 2022                        ENBLEND(1)
Impressum