1ENFUSE(1) User Commands ENFUSE(1)
2
6 enfuse - manual page for enfuse 4.2
7
9 enfuse [options] [--output=IMAGE] INPUT...
10
12 Fuse 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; 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 -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 Fusion options:
66 --exposure-weight=WEIGHT
67 weight given to well-exposed pixels (0 <= WEIGHT <= 1); default:
68 1
69 --saturation-weight=WEIGHT
71 weight given to highly-saturated pixels (0 <= WEIGHT <= 1); de‐
72 fault: 0.2
73 --contrast-weight=WEIGHT
75 weight given to pixels in high-contrast neighborhoods (0 <=
76 WEIGHT <= 1); default: 0
77 --entropy-weight=WEIGHT
79 weight given to pixels in high entropy neighborhoods (0 <=
80 WEIGHT <= 1); default: 0
81 --exposure-optimum=OPTIMUM
83 optimum exposure value, usually the maximum of the weighting
84 function (0 <= OPTIMUM <= 1); default: 0.5
85 --exposure-width=WIDTH
87 characteristic width of the weighting function (WIDTH > 0); de‐
88 fault: 0.2
89 --soft-mask
91 average over all masks; this is the default
92 --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 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 --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 --fallback-profile=PROFILE-FILE
113 use the ICC profile from PROFILE-FILE instead of sRGB
114 --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 --parameter=KEY1[=VALUE1][:KEY2[=VALUE2][:...]]
125 set one or more KEY-VALUE pairs
126 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 --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 --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 --contrast-window-size=SIZE
145 set window SIZE for local-contrast analysis (SIZE >= 3); de‐
146 fault: 5
147 --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 --contrast-min-curvature=CURVATURE
156 minimum CURVATURE for an edge to qualify; append "%" for rela‐
157 tive values; default: 0
158 --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 --entropy-window-size=SIZE
167 set window SIZE for local entropy analysis (SIZE >= 3); default:
168 3
169 --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 Information options:
177 -h, --help
178 print this help message and exit
179 -V, --version
181 output version information and exit
182 --show-globbing-algorithms
184 show all globbing algorithms
185 --show-image-formats
187 show all recognized image formats and their filename extensions
188 --show-signature
190 show who compiled the binary when and on which machine
191 --show-software-components
193 show the software components with which Enfuse was compiled
194 Enfuse accepts arguments to any option in uppercase as well as in low‐
196 ercase letters.
197
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 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
210 Written by Andrew Mihal, Christoph Spiel and others.
211
213 Report bugs at <https://bugs.launchpad.net/enblend>.
214
216 Copyright © 2004-2009 Andrew Mihal.
217 Copyright © 2009-2016 Christoph Spiel.
218 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.
223enfuse 4.2 January 2023 ENFUSE(1)