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

NAME

6       enfuse - manual page for enfuse 4.2
7

SYNOPSIS

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

DESCRIPTION

12       Fuse 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; Enfuse  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   Fusion options:
66       --exposure-weight=WEIGHT
67              weight given to well-exposed pixels (0 <= WEIGHT <= 1); default:
68              1
69
70       --saturation-weight=WEIGHT
71              weight  given to highly-saturated pixels (0 <= WEIGHT <= 1); de‐
72              fault: 0.2
73
74       --contrast-weight=WEIGHT
75              weight given to pixels  in  high-contrast  neighborhoods  (0  <=
76              WEIGHT <= 1); default: 0
77
78       --entropy-weight=WEIGHT
79              weight  given  to  pixels  in  high  entropy neighborhoods (0 <=
80              WEIGHT <= 1); default: 0
81
82       --exposure-optimum=OPTIMUM
83              optimum exposure value, usually the  maximum  of  the  weighting
84              function (0 <= OPTIMUM <= 1); default: 0.5
85
86       --exposure-width=WIDTH
87              characteristic  width of the weighting function (WIDTH > 0); de‐
88              fault: 0.2
89
90       --soft-mask
91              average over all masks; this is the default
92
93       --hard-mask
94              force hard blend masks and no averaging on finest scale; this is
95              especially  useful  for focus stacks with thin and high contrast
96              features, but leads to increased noise
97
98   Expert options:
99       --save-masks[=SOFT-TEMPLATE[:HARD-TEMPLATE]]
100              save weight masks in SOFT-TEMPLATE and HARD-TEMPLATE; conversion
101              chars:  "%i":  mask  index,  "%n": mask number, "%p": full path,
102              "%d": dirname, "%b": basename, "%f": filename, "%e":  extension;
103              lowercase characters refer to input images uppercase to the out‐
104              put image default: "softmask-%n.tif":"hardmask-%n.tif"
105
106       --load-masks[=SOFT-TEMPLATE[:HARD-TEMPLATE]]
107              skip calculation of weight maps and use the ones  in  the  files
108              matching  the  templates  instead.   These can be either hard or
109              soft masks.  For template syntax  see  "--save-masks";  default:
110              "softmask-%n.tif":"hardmask-%n.tif"
111
112       --fallback-profile=PROFILE-FILE
113              use the ICC profile from PROFILE-FILE instead of sRGB
114
115       --layer-selector=ALGORITHM
116              set  the layer selector ALGORITHM; default: "all-layers"; avail‐
117              able algorithms are: "all-layers": select all layers in any  im‐
118              age;   "first-layer":   select   only   first   layer   in  each
119              (multi-)layer image; "last-layer": select  only  last  layer  in
120              each  (multi-)layer image; "largest-layer": select largest layer
121              in each (multi-)layer image; "no-layer": do not select any layer
122              from any image;
123
124       --parameter=KEY1[=VALUE1][:KEY2[=VALUE2][:...]]
125              set one or more KEY-VALUE pairs
126
127   Expert fusion options:
128       --exposure-weight-function=WEIGHT-FUNCTION
129              (1st form) select one of the built-in exposure WEIGHT-FUNCTIONs:
130              "gaussian",   "lorentzian",   "half-sine",    "full-sine",    or
131              "bi-square"; default: "gaussian"
132
133       --exposure-weight-function=SHARED-OBJECT:SYMBOL[:ARGUMENT[:...]]
134              (2nd  form)  load  user-defined  exposure weight function SYMBOL
135              from SHARED-OBJECT and optionally pass ARGUMENTs
136
137       --exposure-cutoff=LOWERCUTOFF[:UPPERCUTOFF[:LOWERPROJECTOR[:UPPERPRO‐
138       JECTOR]]]
139              LOWERCUTOFF  and  UPPERCUTOFF  are  the values below or above of
140              which pixels are weighted with zero weight in  exposure  weight‐
141              ing;   append   "%"   signs   for   relative   values;  default:
142              0%:100%:anti-value:value
143
144       --contrast-window-size=SIZE
145              set window SIZE for local-contrast analysis  (SIZE  >=  3);  de‐
146              fault: 5
147
148       --contrast-edge-scale=EDGESCALE[:LCESCALE[:LCEFACTOR]]
149              set scale on which to look for edges; positive LCESCALE switches
150              on local contrast enhancement by LCEFACTOR (EDGESCALE, LCESCALE,
151              LCEFACTOR  >=  0); append "%" to LCESCALE for values relative to
152              EDGESCALE; append "%" to LCEFACTOR for relative value;  default:
153              0:0:0
154
155       --contrast-min-curvature=CURVATURE
156              minimum  CURVATURE  for an edge to qualify; append "%" for rela‐
157              tive values; default: 0
158
159       --gray-projector=PROJECTOR
160              apply gray-scale PROJECTOR in  exposure  or  contrast  weighing,
161              where  PROJECTOR  is  one  of "anti-value", "average", "l-star",
162              "lightness",  "luminance",   "pl-star",   "value",   or   "chan‐
163              nel-mixer:RED-WEIGHT:GREEN-WEIGHT:BLUE-WEIGHT";  default: "aver‐
164              age"
165
166       --entropy-window-size=SIZE
167              set window SIZE for local entropy analysis (SIZE >= 3); default:
168              3
169
170       --entropy-cutoff=LOWERCUTOFF[:UPPERCUTOFF]
171              LOWERCUTOFF  is  the  value below of which pixels are treated as
172              black and UPPERCUTOFF is the value above  of  which  pixels  are
173              treated  as white in the entropy weighting; append "%" signs for
174              relative values; default: 0%:100%
175
176   Information options:
177       -h, --help
178              print this help message and exit
179
180       -V, --version
181              output version information and exit
182
183       --show-globbing-algorithms
184              show all globbing algorithms
185
186       --show-image-formats
187              show all recognized image formats and their filename extensions
188
189       --show-signature
190              show who compiled the binary when and on which machine
191
192       --show-software-components
193              show the software components with which Enfuse was compiled
194
195       Enfuse accepts arguments to any option in uppercase as well as in  low‐
196       ercase letters.
197

ENVIRONMENT

199       OMP_NUM_THREADS
200              The  OMP_NUM_THREADS  environment  variable  sets  the number of
201              threads to use in OpenMP parallel regions.  If unset Enfuse uses
202              as many threads as there are CPUs.
203
204       OMP_DYNAMIC
205              The OMP_DYNAMIC environment variable controls dynamic adjustment
206              of the number of threads to use in executing OpenMP parallel re‐
207              gions.
208

AUTHOR

210       Written by Andrew Mihal, Christoph Spiel and others.
211

REPORTING BUGS

213       Report bugs at <https://bugs.launchpad.net/enblend>.
214
216       Copyright © 2004-2009 Andrew Mihal.
217       Copyright © 2009-2016 Christoph Spiel.
218
219       License  GPLv2+:  GNU  GPL  version  2 or later <http://www.gnu.org/li
220       censes/gpl.html>
221       This is free software: you are free  to  change  and  redistribute  it.
222       There is NO WARRANTY, to the extent permitted by law.
223
224
225
226enfuse 4.2                         July 2022                         ENFUSE(1)
Impressum