Clarify the relationship of messages to specific layers of multi-layer images.
Document the processing order of multi-layer images.
1.1 --- a/VERSION Tue Oct 27 07:41:31 2009 +0100
1.2 +++ b/VERSION Sat Oct 31 15:17:47 2009 +0100
1.3 @@ -1,1 +1,1 @@
1.4 -4.0-8eb8bb7a385e
1.5 +4.0-dd32463fe9de
2.1 --- a/doc/enblend.info Tue Oct 27 07:41:31 2009 +0100
2.2 +++ b/doc/enblend.info Sat Oct 31 15:17:47 2009 +0100
2.3 @@ -27,7 +27,7 @@
2.4 Enblend
2.5 *******
2.6
2.7 -This manual is for Enblend (version 4.0-8eb8bb7a385e, 26 October 2009),
2.8 +This manual is for Enblend (version 4.0-dd32463fe9de, 31 October 2009),
2.9 a tool for compositing images in such a way that the seam between the
2.10 images is invisible, or at least very difficult to see.
2.11
2.12 @@ -67,8 +67,14 @@
2.13 horizontal row individually, and then running Enblend a last time to
2.14 blend all of the rows together vertically.
2.15
2.16 - Find out more about Enblend on its SourceForge web page
2.17 -(http://enblend.sourceforge.net/).
2.18 + Enblend reads all layers of multi-layer images, like, for example,
2.19 +multi-directory TIFF images(2). The input images are processed in the
2.20 +order they appear on the command line. Multi-layer images are
2.21 +processed from the first layer to the last before Enblend considers the
2.22 +next image on the command line.
2.23 +
2.24 + Find out more about Enblend on its SourceForge
2.25 +(http://sourceforge.net/) web page (http://enblend.sourceforge.net/).
2.26
2.27 ---------- Footnotes ----------
2.28
2.29 @@ -76,6 +82,9 @@
2.30 With Application to Image Mosaics", ACM Transactions on Graphics, Vol.
2.31 2, No. 4, October 1983, pages 217-236.
2.32
2.33 + (2) Use utilities like, e.g., `tiffcopy' and `tiffsplit' of LibTIFF
2.34 +to manipulate multi-directory TIFF images. *Note Helpful Programs::.
2.35 +
2.36 2 Workflow
2.37 **********
2.38
2.39 @@ -224,13 +233,31 @@
2.40 Print information on the available options and exit.
2.41
2.42 `-l LEVELS'
2.43 - Use exactly this many LEVELS for pyramid (1) blending.
2.44 + Use at most this many LEVELS for pyramid (1) blending.
2.45
2.46 - This option allows to trade off quality of results for slightly
2.47 - shorter execution time and lower memory usage. The default is to
2.48 - use as many levels as is possible given the size of the overlap
2.49 - regions. Enblend may still use a smaller number of levels if the
2.50 - geometry of the images demands.
2.51 + The number of levels used in a pyramid controls the balance between
2.52 + local and global image features (contrast, saturation, ...) in the
2.53 + blended region. Fewer levels emphasize local features and suppress
2.54 + global ones. The more levels a pyramid has, the more global
2.55 + features will be taken into account.
2.56 +
2.57 + As a guideline, remember that each new level works on a linear
2.58 + scale twice as large as the previous level. So, the zeroth layer,
2.59 + the original image, (obviously) defines the image at single-pixel
2.60 + scale, the first level works at two pixel scale, and generally, the
2.61 + n-th level contains image data at 2^n pixel scale. This is the
2.62 + reason why an image of widthxheight pixels cannot be deconstructed
2.63 + into a pyramid of more than
2.64 + floor(log_2(min(width, height)))
2.65 + levels.
2.66 +
2.67 + If too few levels are used, "halos" around regions of high local
2.68 + contrast can show up. On the other hand, if too many levels are
2.69 + used, the image might contain too much global contrast. Usually,
2.70 + the latter is not a problem, but is highly desired. This is the
2.71 + reason, why the default is to use as many levels as is possible
2.72 + given the size of the overlap regions. Enblend may still use a
2.73 + smaller number of levels if the geometry of the images demands.
2.74
2.75 The valid range of LEVELS is 1 to 29.
2.76
2.77 @@ -466,7 +493,7 @@
2.78 - to accelerate some computations.
2.79
2.80 This is an experimental feature that may not work on all systems.
2.81 - In this version of Enblend, 4.0-8eb8bb7a385e, only mask
2.82 + In this version of Enblend, 4.0-dd32463fe9de, only mask
2.83 optimization strategy 1 benefits from this option.
2.84
2.85 Note that GPU-support must have been compiled into Enblend for
2.86 @@ -691,7 +718,7 @@
2.87
2.88 The optimizer weights DISTANCE-WEIGHT and MISMATCH-WEIGHT
2.89 define how to weight these two criteria. Enblend up to
2.90 - version 3.2 used 1:1. This version of Enblend (4.0-8eb8bb7a385e)
2.91 + version 3.2 used 1:1. This version of Enblend (4.0-dd32463fe9de)
2.92 uses 8.0:1.0.
2.93
2.94 A large DISTANCE-WEIGHT pulls the optimized seam line closer to
2.95 @@ -1723,239 +1750,245 @@
2.96 Program Index
2.97 *************
2.98
2.99 -ale: See 6. (line 1072)
2.100 -align_image_stack (Hugin): See 6. (line 1079)
2.101 -cinepaint <1>: See 6. (line 1091)
2.102 -cinepaint: See 3.2. (line 457)
2.103 -convert (ImageMagick): See 6. (line 1102)
2.104 -dcraw <1>: See 6. (line 1062)
2.105 -dcraw: See 2. (line 93)
2.106 -display (ImageMagick): See 6. (line 1102)
2.107 -exiftool: See 6. (line 1130)
2.108 -exrdisplay (OpenEXR): See 6. (line 1108)
2.109 -fulla (Hugin): See 6. (line 1079)
2.110 -gimp <1>: See 6. (line 1098)
2.111 -gimp <2>: See 3.2. (line 457)
2.112 -gimp: See 2. (line 93)
2.113 -gm (GraphicsMagick): See 6. (line 1102)
2.114 -hugin <1>: See 6. (line 1076)
2.115 -hugin <2>: See 3.2. (line 448)
2.116 -hugin <3>: See 2. (line 93)
2.117 +ale: See 6. (line 1099)
2.118 +align_image_stack (Hugin): See 6. (line 1106)
2.119 +cinepaint <1>: See 6. (line 1118)
2.120 +cinepaint: See 3.2. (line 484)
2.121 +convert (ImageMagick): See 6. (line 1129)
2.122 +dcraw <1>: See 6. (line 1089)
2.123 +dcraw: See 2. (line 102)
2.124 +display (ImageMagick): See 6. (line 1129)
2.125 +exiftool: See 6. (line 1157)
2.126 +exrdisplay (OpenEXR): See 6. (line 1135)
2.127 +fulla (Hugin): See 6. (line 1106)
2.128 +gimp <1>: See 6. (line 1125)
2.129 +gimp <2>: See 3.2. (line 484)
2.130 +gimp: See 2. (line 102)
2.131 +gm (GraphicsMagick): See 6. (line 1129)
2.132 +hugin <1>: See 6. (line 1103)
2.133 +hugin <2>: See 3.2. (line 475)
2.134 +hugin <3>: See 2. (line 102)
2.135 hugin: See 1. (line 56)
2.136 -identify (ImageMagick) <1>: See 6. (line 1102)
2.137 -identify (ImageMagick): See 4.1. (line 911)
2.138 -montage (ImageMagick): See 6. (line 1102)
2.139 -nona (Hugin) <1>: See 6. (line 1079)
2.140 -nona (Hugin): See 3.2. (line 448)
2.141 -PanoTools <1>: See 2. (line 93)
2.142 +identify (ImageMagick) <1>: See 6. (line 1129)
2.143 +identify (ImageMagick): See 4.1. (line 938)
2.144 +montage (ImageMagick): See 6. (line 1129)
2.145 +nona (Hugin) <1>: See 6. (line 1106)
2.146 +nona (Hugin): See 3.2. (line 475)
2.147 +PanoTools <1>: See 2. (line 102)
2.148 PanoTools: See 1. (line 56)
2.149 -pfshdrcalibrate (PFScalibration): See 6. (line 1111)
2.150 -pfsin (PFSTools): See 6. (line 1111)
2.151 -pfsout (PFSTools): See 6. (line 1111)
2.152 -pfstmo_* (PFStmo): See 6. (line 1111)
2.153 -pfsview (PFSTools): See 6. (line 1111)
2.154 -PTmender (PanoTools): See 6. (line 1084)
2.155 -PTOptimizer (PanoTools): See 6. (line 1084)
2.156 -tifficc (LittleCMS): See 6. (line 1134)
2.157 -tiffinfo (libtiff) <1>: See 6. (line 1126)
2.158 -tiffinfo (libtiff): See 4.1. (line 911)
2.159 -ufraw <1>: See 6. (line 1065)
2.160 -ufraw: See 2. (line 93)
2.161 -ufraw-batch: See 6. (line 1065)
2.162 +pfshdrcalibrate (PFScalibration): See 6. (line 1138)
2.163 +pfsin (PFSTools): See 6. (line 1138)
2.164 +pfsout (PFSTools): See 6. (line 1138)
2.165 +pfstmo_* (PFStmo): See 6. (line 1138)
2.166 +pfsview (PFSTools): See 6. (line 1138)
2.167 +PTmender (PanoTools): See 6. (line 1111)
2.168 +PTOptimizer (PanoTools): See 6. (line 1111)
2.169 +tifficc (LittleCMS): See 6. (line 1161)
2.170 +tiffinfo (libtiff) <1>: See 6. (line 1153)
2.171 +tiffinfo (libtiff): See 4.1. (line 938)
2.172 +ufraw <1>: See 6. (line 1092)
2.173 +ufraw: See 2. (line 102)
2.174 +ufraw-batch: See 6. (line 1092)
2.175 Option Index
2.176 ************
2.177
2.178 ---anneal: See 3.3. (line 494)
2.179 ---coarse-mask: See 3.3. (line 540)
2.180 ---compression: See 3.1. (line 188)
2.181 ---depth: See 3.2. (line 368)
2.182 ---dijkstra: See 3.3. (line 580)
2.183 ---fine-mask: See 3.3. (line 593)
2.184 ---gpu: See 3.2. (line 465)
2.185 ---help: See 3.1. (line 224)
2.186 ---load-masks: See 3.3. (line 600)
2.187 ---mask-vectorize: See 3.3. (line 606)
2.188 ---no-optimize: See 3.3. (line 651)
2.189 ---optimize: See 3.3. (line 659)
2.190 ---optimizer-weights: See 3.3. (line 682)
2.191 ---output: See 3.1. (line 239)
2.192 ---save-masks: See 3.3. (line 709)
2.193 ---smooth-difference: See 3.3. (line 737)
2.194 ---verbose: See 3.1. (line 246)
2.195 ---version: See 3.1. (line 281)
2.196 ---visualize: See 3.3. (line 755)
2.197 ---wrap: See 3.1. (line 288)
2.198 --a: See 3.1. (line 180)
2.199 --b <1>: See 5. (line 985)
2.200 --b: See 3.2. (line 346)
2.201 --c: See 3.2. (line 357)
2.202 --d: See 3.2. (line 368)
2.203 --f: See 3.2. (line 445)
2.204 --g: See 3.2. (line 453)
2.205 --h: See 3.1. (line 224)
2.206 --l: See 3.1. (line 227)
2.207 --m <1>: See 5. (line 985)
2.208 --m: See 3.2. (line 477)
2.209 --o: See 3.1. (line 239)
2.210 --V: See 3.1. (line 281)
2.211 --v: See 3.1. (line 246)
2.212 --w: See 3.1. (line 288)
2.213 --x: See 3.1. (line 325)
2.214 +--anneal: See 3.3. (line 521)
2.215 +--coarse-mask: See 3.3. (line 567)
2.216 +--compression: See 3.1. (line 197)
2.217 +--depth: See 3.2. (line 395)
2.218 +--dijkstra: See 3.3. (line 607)
2.219 +--fine-mask: See 3.3. (line 620)
2.220 +--gpu: See 3.2. (line 492)
2.221 +--help: See 3.1. (line 233)
2.222 +--load-masks: See 3.3. (line 627)
2.223 +--mask-vectorize: See 3.3. (line 633)
2.224 +--no-optimize: See 3.3. (line 678)
2.225 +--optimize: See 3.3. (line 686)
2.226 +--optimizer-weights: See 3.3. (line 709)
2.227 +--output: See 3.1. (line 266)
2.228 +--save-masks: See 3.3. (line 736)
2.229 +--smooth-difference: See 3.3. (line 764)
2.230 +--verbose: See 3.1. (line 273)
2.231 +--version: See 3.1. (line 308)
2.232 +--visualize: See 3.3. (line 782)
2.233 +--wrap: See 3.1. (line 315)
2.234 +-a: See 3.1. (line 189)
2.235 +-b <1>: See 5. (line 1012)
2.236 +-b: See 3.2. (line 373)
2.237 +-c: See 3.2. (line 384)
2.238 +-d: See 3.2. (line 395)
2.239 +-f: See 3.2. (line 472)
2.240 +-g: See 3.2. (line 480)
2.241 +-h: See 3.1. (line 233)
2.242 +-l: See 3.1. (line 236)
2.243 +-m <1>: See 5. (line 1012)
2.244 +-m: See 3.2. (line 504)
2.245 +-o: See 3.1. (line 266)
2.246 +-V: See 3.1. (line 308)
2.247 +-v: See 3.1. (line 273)
2.248 +-w: See 3.1. (line 315)
2.249 +-x: See 3.1. (line 352)
2.250 General Index
2.251 *************
2.252
2.253 -360o panoramas: See 3.1. (line 288)
2.254 -a.tif: See 3.1. (line 241)
2.255 -affine transformation: See 2. (line 130)
2.256 -alpha channel <1>: See 2. (line 151)
2.257 +360o panoramas: See 3.1. (line 315)
2.258 +a.tif: See 3.1. (line 268)
2.259 +affine transformation: See 2. (line 139)
2.260 +alpha channel <1>: See 2. (line 160)
2.261 alpha channel: See 1. (line 49)
2.262 -alpha channel, associated: See 3.2. (line 453)
2.263 -anneal parameters: See 3.3. (line 494)
2.264 +alpha channel, associated: See 3.2. (line 480)
2.265 +anneal parameters: See 3.3. (line 521)
2.266 authors, list of: See Appendix B.
2.267 - (line 1289)
2.268 -binary mask: See 4. (line 895)
2.269 -bits per channel: See 3.2. (line 368)
2.270 -blur difference image: See 3.3. (line 737)
2.271 + (line 1316)
2.272 +binary mask: See 4. (line 922)
2.273 +bits per channel: See 3.2. (line 395)
2.274 +blur difference image: See 3.3. (line 764)
2.275 bug reports: See Appendix A.
2.276 - (line 1142)
2.277 + (line 1169)
2.278 Burt-Adelson multiresolution spline: See 1. (line 37)
2.279 -channel width: See 3.2. (line 368)
2.280 +channel width: See 3.2. (line 395)
2.281 channel, alpha: See 1. (line 49)
2.282 -CIECAM02: See 3.2. (line 357)
2.283 -coarse mask: See 3.3. (line 540)
2.284 -color appearance model: See 3.2. (line 357)
2.285 -color space, sRGB: See 3.2. (line 359)
2.286 -colors, visualization image: See 3.3. (line 808)
2.287 -compression: See 3.1. (line 188)
2.288 -compression, deflate: See 3.1. (line 203)
2.289 -compression, JPEG: See 3.1. (line 194)
2.290 -compression, LZW: See 3.1. (line 209)
2.291 -compression, packbits: See 3.1. (line 213)
2.292 -conversion, raw: See 2. (line 117)
2.293 -default output filename: See 3.1. (line 241)
2.294 -deflate compression: See 3.1. (line 203)
2.295 -DIJKSTRA radius: See 3.3. (line 580)
2.296 -double precision float, IEEE754: See 3.2. (line 420)
2.297 +CIECAM02: See 3.2. (line 384)
2.298 +coarse mask: See 3.3. (line 567)
2.299 +color appearance model: See 3.2. (line 384)
2.300 +color space, sRGB: See 3.2. (line 386)
2.301 +colors, visualization image: See 3.3. (line 835)
2.302 +compression: See 3.1. (line 197)
2.303 +compression, deflate: See 3.1. (line 212)
2.304 +compression, JPEG: See 3.1. (line 203)
2.305 +compression, LZW: See 3.1. (line 218)
2.306 +compression, packbits: See 3.1. (line 222)
2.307 +conversion, raw: See 2. (line 126)
2.308 +default output filename: See 3.1. (line 268)
2.309 +deflate compression: See 3.1. (line 212)
2.310 +DIJKSTRA radius: See 3.3. (line 607)
2.311 +double precision float, IEEE754: See 3.2. (line 447)
2.312 feathering, detrimental effect of: See 1. (line 56)
2.313 -fine mask: See 3.3. (line 593)
2.314 +fine mask: See 3.3. (line 620)
2.315 free documentation license (FDL): See Appendix C.
2.316 - (line 1328)
2.317 + (line 1355)
2.318 general index:
2.319 - See ``General Index''. (line 1807)
2.320 + See ``General Index''. (line 1834)
2.321 GNU free documentation license: See Appendix C.
2.322 - (line 1328)
2.323 -GPU (Graphics Processing Unit): See 3.2. (line 465)
2.324 -graphics processing unit: See 3.2. (line 465)
2.325 -half precision float, OpenEXR: See 3.2. (line 435)
2.326 -helpful programs: See 6. (line 1058)
2.327 -Hugin: See A.2. (line 1232)
2.328 -ICC profile: See 3.2. (line 359)
2.329 -IEEE754 double precision float: See 3.2. (line 420)
2.330 -IEEE754 single precision float: See 3.2. (line 411)
2.331 -image cache: See 5. (line 988)
2.332 -image cache, block size: See 3.2. (line 346)
2.333 -image cache, cache size: See 3.2. (line 477)
2.334 -image cache, location: See 5. (line 999)
2.335 -image colors, visualization: See 3.3. (line 808)
2.336 -image, visualization: See 3.3. (line 773)
2.337 + (line 1355)
2.338 +GPU (Graphics Processing Unit): See 3.2. (line 492)
2.339 +graphics processing unit: See 3.2. (line 492)
2.340 +half precision float, OpenEXR: See 3.2. (line 462)
2.341 +helpful programs: See 6. (line 1085)
2.342 +Hugin: See A.2. (line 1259)
2.343 +ICC profile: See 3.2. (line 386)
2.344 +IEEE754 double precision float: See 3.2. (line 447)
2.345 +IEEE754 single precision float: See 3.2. (line 438)
2.346 +image cache: See 5. (line 1015)
2.347 +image cache, block size: See 3.2. (line 373)
2.348 +image cache, cache size: See 3.2. (line 504)
2.349 +image cache, location: See 5. (line 1026)
2.350 +image colors, visualization: See 3.3. (line 835)
2.351 +image, multi-layer: See 1. (line 70)
2.352 +image, visualization: See 3.3. (line 800)
2.353 index, general:
2.354 - See ``General Index''. (line 1807)
2.355 + See ``General Index''. (line 1834)
2.356 index, option:
2.357 - See ``Option Index''. (line 1768)
2.358 + See ``Option Index''. (line 1795)
2.359 index, program:
2.360 - See ``Program Index''. (line 1726)
2.361 -input mask: See 4.1. (line 907)
2.362 -invocation: See 3. (line 170)
2.363 -JPEG compression: See 3.1. (line 194)
2.364 -KImageFuser: See A.2. (line 1232)
2.365 -lens distortion, correction of: See 2. (line 130)
2.366 -levels, pyramid: See 3.1. (line 227)
2.367 -LibJPEG: See 6. (line 1115)
2.368 -LibPNG: See 6. (line 1118)
2.369 -LibTiff: See 6. (line 1122)
2.370 -load mask: See 3.3. (line 600)
2.371 -loops in seam line: See 3.3. (line 636)
2.372 -LZW compression: See 3.1. (line 209)
2.373 -mask template character, %: See 3.3. (line 812)
2.374 -mask template character, B: See 3.3. (line 861)
2.375 -mask template character, b: See 3.3. (line 855)
2.376 -mask template character, D: See 3.3. (line 852)
2.377 -mask template character, d: See 3.3. (line 846)
2.378 -mask template character, E: See 3.3. (line 880)
2.379 -mask template character, e: See 3.3. (line 874)
2.380 -mask template character, F: See 3.3. (line 870)
2.381 -mask template character, f: See 3.3. (line 864)
2.382 -mask template character, i: See 3.3. (line 815)
2.383 -mask template character, n: See 3.3. (line 830)
2.384 -mask template character, P: See 3.3. (line 843)
2.385 -mask template character, p: See 3.3. (line 835)
2.386 -mask template characters, table of: See 3.3. (line 811)
2.387 -mask, binary: See 4. (line 895)
2.388 -mask, coarse: See 3.3. (line 540)
2.389 -mask, fine: See 3.3. (line 593)
2.390 -mask, generation: See 3.3. (line 575)
2.391 -mask, input files: See 4.1. (line 907)
2.392 -mask, load: See 3.3. (line 600)
2.393 -mask, optimization visualization: See 3.3. (line 755)
2.394 -mask, save: See 3.3. (line 709)
2.395 -mask, vectorization distance: See 3.3. (line 606)
2.396 -mask, weight: See 4. (line 895)
2.397 -masks, understanding: See 4. (line 895)
2.398 -memory, tuning usage of: See 5. (line 985)
2.399 -nearest-feature transform (NFT): See 3.3. (line 575)
2.400 + See ``Program Index''. (line 1753)
2.401 +input mask: See 4.1. (line 934)
2.402 +invocation: See 3. (line 179)
2.403 +JPEG compression: See 3.1. (line 203)
2.404 +KImageFuser: See A.2. (line 1259)
2.405 +lens distortion, correction of: See 2. (line 139)
2.406 +levels, pyramid: See 3.1. (line 236)
2.407 +LibJPEG: See 6. (line 1142)
2.408 +LibPNG: See 6. (line 1145)
2.409 +LibTiff: See 6. (line 1149)
2.410 +load mask: See 3.3. (line 627)
2.411 +loops in seam line: See 3.3. (line 663)
2.412 +LZW compression: See 3.1. (line 218)
2.413 +mask template character, %: See 3.3. (line 839)
2.414 +mask template character, B: See 3.3. (line 888)
2.415 +mask template character, b: See 3.3. (line 882)
2.416 +mask template character, D: See 3.3. (line 879)
2.417 +mask template character, d: See 3.3. (line 873)
2.418 +mask template character, E: See 3.3. (line 907)
2.419 +mask template character, e: See 3.3. (line 901)
2.420 +mask template character, F: See 3.3. (line 897)
2.421 +mask template character, f: See 3.3. (line 891)
2.422 +mask template character, i: See 3.3. (line 842)
2.423 +mask template character, n: See 3.3. (line 857)
2.424 +mask template character, P: See 3.3. (line 870)
2.425 +mask template character, p: See 3.3. (line 862)
2.426 +mask template characters, table of: See 3.3. (line 838)
2.427 +mask, binary: See 4. (line 922)
2.428 +mask, coarse: See 3.3. (line 567)
2.429 +mask, fine: See 3.3. (line 620)
2.430 +mask, generation: See 3.3. (line 602)
2.431 +mask, input files: See 4.1. (line 934)
2.432 +mask, load: See 3.3. (line 627)
2.433 +mask, optimization visualization: See 3.3. (line 782)
2.434 +mask, save: See 3.3. (line 736)
2.435 +mask, vectorization distance: See 3.3. (line 633)
2.436 +mask, weight: See 4. (line 922)
2.437 +masks, understanding: See 4. (line 922)
2.438 +memory, tuning usage of: See 5. (line 1012)
2.439 +multi-directory TIFF: See 1. (line 70)
2.440 +multi-layer image: See 1. (line 70)
2.441 +nearest-feature transform (NFT): See 3.3. (line 602)
2.442 Octave: See Appendix A.
2.443 - (line 1142)
2.444 -OpenEXR, data format: See 3.2. (line 431)
2.445 -OpenEXR, half precision float: See 3.2. (line 435)
2.446 -optimize seam: See 3.3. (line 651)
2.447 -optimize strategy: See 3.3. (line 664)
2.448 -optimize, anneal parameters: See 3.3. (line 494)
2.449 -optimizer weights: See 3.3. (line 682)
2.450 -optimizer, simulated annealing: See 3.3. (line 494)
2.451 + (line 1169)
2.452 +OpenEXR, data format: See 3.2. (line 458)
2.453 +OpenEXR, half precision float: See 3.2. (line 462)
2.454 +optimize seam: See 3.3. (line 678)
2.455 +optimize strategy: See 3.3. (line 691)
2.456 +optimize, anneal parameters: See 3.3. (line 521)
2.457 +optimizer weights: See 3.3. (line 709)
2.458 +optimizer, simulated annealing: See 3.3. (line 521)
2.459 option index:
2.460 - See ``Option Index''. (line 1768)
2.461 -options, common: See 3.1. (line 177)
2.462 -options, extended: See 3.2. (line 342)
2.463 -options, mask generation: See 3.3. (line 491)
2.464 -output file compression: See 3.1. (line 188)
2.465 -output filename, default: See 3.1. (line 241)
2.466 -output image, set size of: See 3.2. (line 445)
2.467 + See ``Option Index''. (line 1795)
2.468 +options, common: See 3.1. (line 186)
2.469 +options, extended: See 3.2. (line 369)
2.470 +options, mask generation: See 3.3. (line 518)
2.471 +output file compression: See 3.1. (line 197)
2.472 +output filename, default: See 3.1. (line 268)
2.473 +output image, set size of: See 3.2. (line 472)
2.474 overview: See 1. (line 37)
2.475 -packbits compression: See 3.1. (line 213)
2.476 -parallax error: See 2. (line 140)
2.477 -photometric alignment: See 2. (line 132)
2.478 +packbits compression: See 3.1. (line 222)
2.479 +parallax error: See 2. (line 149)
2.480 +photometric alignment: See 2. (line 141)
2.481 problem reports: See Appendix A.
2.482 - (line 1145)
2.483 -profile, ICC: See 3.2. (line 359)
2.484 + (line 1172)
2.485 +profile, ICC: See 3.2. (line 386)
2.486 program index:
2.487 - See ``Program Index''. (line 1726)
2.488 -programs, helpful additional: See 6. (line 1058)
2.489 -pyramid levels: See 3.1. (line 227)
2.490 -radius, DIJKSTRA: See 3.3. (line 580)
2.491 -raw conversion: See 2. (line 117)
2.492 -save mask: See 3.3. (line 709)
2.493 -seam line, loops: See 3.3. (line 636)
2.494 -seam optimization: See 3.3. (line 651)
2.495 -simulated annealing optimizer: See 3.3. (line 494)
2.496 -single precision float, IEEE754: See 3.2. (line 411)
2.497 -smooth difference image: See 3.3. (line 737)
2.498 + See ``Program Index''. (line 1753)
2.499 +programs, helpful additional: See 6. (line 1085)
2.500 +pyramid levels: See 3.1. (line 236)
2.501 +radius, DIJKSTRA: See 3.3. (line 607)
2.502 +raw conversion: See 2. (line 126)
2.503 +save mask: See 3.3. (line 736)
2.504 +seam line, loops: See 3.3. (line 663)
2.505 +seam optimization: See 3.3. (line 678)
2.506 +simulated annealing optimizer: See 3.3. (line 521)
2.507 +single precision float, IEEE754: See 3.2. (line 438)
2.508 +smooth difference image: See 3.3. (line 764)
2.509 SourceForge <1>: See Appendix A.
2.510 - (line 1148)
2.511 -SourceForge: See 1. (line 70)
2.512 + (line 1175)
2.513 +SourceForge: See 1. (line 76)
2.514 SourceForge, tracker: See Appendix A.
2.515 - (line 1148)
2.516 -sRGB color space: See 3.2. (line 359)
2.517 -TMPDIR: See 5. (line 999)
2.518 + (line 1175)
2.519 +sRGB color space: See 3.2. (line 386)
2.520 +TIFF, multi-directory: See 1. (line 70)
2.521 +tiffcopy: See 1. (line 70)
2.522 +tiffsplit: See 1. (line 70)
2.523 +TMPDIR: See 5. (line 1026)
2.524 tracker, SourceForge: See Appendix A.
2.525 - (line 1148)
2.526 -transformation, affine: See 2. (line 130)
2.527 -understanding masks: See 4. (line 895)
2.528 -visualization image: See 3.3. (line 773)
2.529 -visualization image colors: See 3.3. (line 808)
2.530 -visualization of mask optimization: See 3.3. (line 755)
2.531 -weight mask: See 4. (line 895)
2.532 -weights, optimizer: See 3.3. (line 682)
2.533 -workflow: See 2. (line 82)
2.534 -workflow with Enblend: See 2. (line 93)
2.535 -workflow with Enfuse: See 2. (line 93)
2.536 -wrap around: See 3.1. (line 288)
2.537 + (line 1175)
2.538 +transformation, affine: See 2. (line 139)
2.539 +understanding masks: See 4. (line 922)
2.540 +visualization image: See 3.3. (line 800)
2.541 +visualization image colors: See 3.3. (line 835)
2.542 +visualization of mask optimization: See 3.3. (line 782)
2.543 +weight mask: See 4. (line 922)
2.544 +weights, optimizer: See 3.3. (line 709)
2.545 +workflow: See 2. (line 91)
2.546 +workflow with Enblend: See 2. (line 102)
2.547 +workflow with Enfuse: See 2. (line 102)
2.548 +wrap around: See 3.1. (line 315)
3.1 --- a/doc/enblend.texi Tue Oct 27 07:41:31 2009 +0100
3.2 +++ b/doc/enblend.texi Sat Oct 31 15:17:47 2009 +0100
3.3 @@ -188,9 +188,24 @@
3.4 horizontal row individually, and then running Enblend a last time to
3.5 blend all of the rows together vertically.
3.6
3.7 +@cindex multi-layer image
3.8 +@cindex image, multi-layer
3.9 +@cindex multi-directory @acronym{TIFF}
3.10 +@cindex @acronym{TIFF}, multi-directory
3.11 +@cindex @command{tiffcopy}
3.12 +@cindex @command{tiffsplit}
3.13 +Enblend reads all layers of multi-layer images, like, for example,
3.14 +multi-directory @acronym{TIFF} images@footnote{Use utilities like,
3.15 +e.g., @command{tiffcopy} and @command{tiffsplit} of LibTIFF to
3.16 +manipulate multi-directory @acronym{TIFF} images. @xref{Helpful
3.17 +Programs}.}. The input images are processed in the order they appear
3.18 +on the command line. Multi-layer images are processed from the first
3.19 +layer to the last before Enblend considers the next image on the
3.20 +command line.
3.21 +
3.22 @cindex SourceForge
3.23 -Find out more about Enblend on its SourceForge
3.24 -@uref{http://@/enblend.sourceforge.net/, web page}.
3.25 +Find out more about Enblend on its @uref{http://@/sourceforge.net/,
3.26 +SourceForge} @uref{http://@/enblend.sourceforge.net/, web page}.
3.27
3.28
3.29 @node Workflow
3.30 @@ -295,18 +310,71 @@
3.31 @opindex -l
3.32 @cindex pyramid levels
3.33 @cindex levels, pyramid
3.34 -Use exactly this many @var{LEVELS} for pyramid @footnote{As
3.35 +Use at most this many @var{LEVELS} for pyramid @footnote{As
3.36 Dr.@tie{}Daniel Jackson correctly
3.37 @uref{http://stargate.wikia.com/@/wiki/@/The_@/Tomb, noted}, actually,
3.38 it is not a pyramid: ``Ziggaurat, it's a
3.39 @uref{http://en.wikipedia.org/@/wiki/@/Ziggaurat, Ziggaurat}.''}
3.40 blending.
3.41
3.42 -This option allows to trade off quality of results for slightly
3.43 -shorter execution time and lower memory usage. The default is to use
3.44 -as many levels as is possible given the size of the overlap regions.
3.45 -Enblend may still use a smaller number of levels if the geometry of
3.46 -the images demands.
3.47 +The number of levels used in a pyramid controls the balance between
3.48 +local and global image features (contrast, saturation, @dots{}) in the
3.49 +blended region. Fewer levels emphasize local features and suppress
3.50 +global ones. The more levels a pyramid has, the more global features
3.51 +will be taken into account.
3.52 +
3.53 +As a guideline, remember that each new level works on a linear scale
3.54 +twice as large as the previous level. So, the zeroth layer, the
3.55 +original image, (obviously) defines the image at single-pixel scale,
3.56 +the first level works at two pixel scale, and generally, the
3.57 +@math{n}-th level contains image data at @math{2^n} pixel scale. This
3.58 +is the reason why an image of
3.59 +@math{width}@classictimes{}@math{height}@tie{}pixels cannot be
3.60 +deconstructed into a pyramid of more than
3.61 +@ifinfo
3.62 +@display
3.63 +@math{floor(log_2(min(width, height)))}
3.64 +@end display
3.65 +@end ifinfo
3.66 +@html
3.67 +<math xmlns="http://www.w3.org/1998/Math/MathML">
3.68 + <mrow>
3.69 + <mo>⌊</mo>
3.70 + <mrow>
3.71 + <msub>
3.72 + <mo>log</mo>
3.73 + <mn>2</mo>
3.74 + </msub>
3.75 + <mo>⁡</mo>
3.76 + <mo>(</mo>
3.77 + <mrow>
3.78 + <mo>min</mo>
3.79 + <mo>⁡</mo>
3.80 + <mfenced>
3.81 + <mi mathvariant="italic">width</mi>
3.82 + <mi mathvariant="italic">height</mi>
3.83 + </mfenced>
3.84 + </mrow>
3.85 + <mo>)</mo>
3.86 + </mrow>
3.87 + <mo>⌋</mo>
3.88 + </mrow>
3.89 +</math>
3.90 +@end html
3.91 +@tex
3.92 +$$
3.93 + \lfloor \log_2(\min(\mathit{width}, \mathit{height})) \rfloor
3.94 +$$
3.95 +@end tex
3.96 +levels.
3.97 +
3.98 +If too few levels are used, ``halos'' around regions of high local
3.99 +contrast can show up. On the other hand, if too many levels are used,
3.100 +the image might contain too much global contrast. Usually, the latter
3.101 +is not a problem, but is highly desired. This is the reason, why the
3.102 +default is to use as many levels as is possible given the size of the
3.103 +overlap regions. Enblend may still use a smaller number of levels if
3.104 +the geometry of the images demands.
3.105
3.106 The valid range of @var{LEVELS} is @value{src::minimum-pyramid-levels}
3.107 to @value{src::maximum-pyramid-levels}.
4.1 --- a/doc/enfuse.info Tue Oct 27 07:41:31 2009 +0100
4.2 +++ b/doc/enfuse.info Sat Oct 31 15:17:47 2009 +0100
4.3 @@ -87,7 +87,7 @@
4.4 Enfuse
4.5 ******
4.6
4.7 -This manual is for Enfuse (version 4.0-8eb8bb7a385e, 26 October 2009),
4.8 +This manual is for Enfuse (version 4.0-dd32463fe9de, 31 October 2009),
4.9 a program to merge different exposures of the same scene to produce an
4.10 image that looks much like a tonemapped image.
4.11
4.12 @@ -160,8 +160,14 @@
4.13 Any alpha value other than zero is interpreted as "this pixel should
4.14 contribute to the final image".
4.15
4.16 - Find out more about Enfuse on its SourceForge web page
4.17 -(http://enblend.sourceforge.net/).
4.18 + Enfuse reads all layers of multi-layer images, like, for example,
4.19 +multi-directory TIFF images(4). The input images are processed in the
4.20 +order they appear on the command line. Multi-layer images are
4.21 +processed from the first layer to the last before Enfuse considers the
4.22 +next image on the command line.
4.23 +
4.24 + Find out more about Enfuse on its SourceForge
4.25 +(http://sourceforge.net/) web page (http://enblend.sourceforge.net/).
4.26
4.27 ---------- Footnotes ----------
4.28
4.29 @@ -177,6 +183,9 @@
4.30 not desired to judge the image quality of the original-size image.
4.31 Cropping might be an alternative, though.
4.32
4.33 + (4) Use utilities like, e.g., `tiffcopy' and `tiffsplit' of LibTIFF
4.34 +to manipulate multi-directory TIFF images. *Note Helpful Programs::.
4.35 +
4.36 2 Workflow
4.37 **********
4.38
4.39 @@ -318,13 +327,31 @@
4.40 Print information on the available options then exit.
4.41
4.42 `-l LEVELS'
4.43 - Use exactly this many LEVELS for pyramid (1) blending.
4.44 + Use at most this many LEVELS for pyramid (1) blending.
4.45
4.46 - This option allows to trade off quality of results for slightly
4.47 - shorter execution time and lower memory usage. The default is to
4.48 - use as many levels as possible given the size of the overlap
4.49 - regions. Enfuse may still use a smaller number of levels if the
4.50 - geometry of the images demands.
4.51 + The number of levels used in a pyramid controls the balance between
4.52 + local and global image features (contrast, saturation, ...) in the
4.53 + blended region. Fewer levels emphasize local features and suppress
4.54 + global ones. The more levels a pyramid has, the more global
4.55 + features will be taken into account.
4.56 +
4.57 + As a guideline, remember that each new level works on a linear
4.58 + scale twice as large as the previous level. So, the zeroth layer,
4.59 + the original image, (obviously) defines the image at single-pixel
4.60 + scale, the first level works at two pixel scale, and generally, the
4.61 + n-th level contains image data at 2^n pixel scale. This is the
4.62 + reason why an image of widthxheight pixels cannot be deconstructed
4.63 + into a pyramid of more than
4.64 + floor(log_2(min(width, height)))
4.65 + levels.
4.66 +
4.67 + If too few levels are used, "halos" around regions of high local
4.68 + contrast can show up. On the other hand, if too many levels are
4.69 + used, the image might contain too much global contrast. Usually,
4.70 + the latter is not a problem, but is highly desired. This is the
4.71 + reason, why the default is to use as many levels as is possible
4.72 + given the size of the overlap regions. Enfuse may still use a
4.73 + smaller number of levels if the geometry of the images demands.
4.74
4.75 The valid range of LEVELS is 1 to 29.
4.76
4.77 @@ -755,7 +782,7 @@
4.78 option `--GrayProjector'.)
4.79
4.80 Use gray projector PROJECTOR for conversion of RGB images to
4.81 - grayscale masks: (R, G, B) -> Y. In version 4.0-8eb8bb7a385e of
4.82 + grayscale masks: (R, G, B) -> Y. In version 4.0-dd32463fe9de of
4.83 Enfuse, the option is effective for exposure weighting and local
4.84 contrast weighting. Default: `average'.
4.85
4.86 @@ -3007,324 +3034,330 @@
4.87 Program Index
4.88 *************
4.89
4.90 -ale: See 8. (line 2336)
4.91 -align_image_stack (Hugin): See 8. (line 2343)
4.92 -cinepaint <1>: See 8. (line 2355)
4.93 -cinepaint: See 3.2. (line 547)
4.94 -convert (ImageMagick): See 8. (line 2366)
4.95 -dcraw <1>: See 8. (line 2326)
4.96 -dcraw: See 2. (line 194)
4.97 -display (ImageMagick): See 8. (line 2366)
4.98 -exiftool: See 8. (line 2394)
4.99 -exrdisplay (OpenEXR): See 8. (line 2372)
4.100 -fulla (Hugin): See 8. (line 2343)
4.101 -gimp <1>: See 8. (line 2362)
4.102 -gimp <2>: See 3.2. (line 547)
4.103 -gimp: See 2. (line 194)
4.104 -gm (GraphicsMagick): See 8. (line 2366)
4.105 -hugin <1>: See 8. (line 2340)
4.106 -hugin <2>: See 7.1. (line 1716)
4.107 -hugin <3>: See 3.2. (line 538)
4.108 -hugin: See 2. (line 194)
4.109 -identify (ImageMagick) <1>: See 8. (line 2366)
4.110 -identify (ImageMagick): See 5.1. (line 1555)
4.111 -montage (ImageMagick): See 8. (line 2366)
4.112 -nona (Hugin) <1>: See 8. (line 2343)
4.113 -nona (Hugin): See 3.2. (line 538)
4.114 -PanoTools: See 2. (line 194)
4.115 -pfshdrcalibrate (PFScalibration): See 8. (line 2375)
4.116 -pfsin (PFSTools): See 8. (line 2375)
4.117 -pfsout (PFSTools): See 8. (line 2375)
4.118 -pfstmo_* (PFStmo): See 8. (line 2375)
4.119 -pfsview (PFSTools): See 8. (line 2375)
4.120 -PTmender (PanoTools): See 8. (line 2348)
4.121 -PTOptimizer (PanoTools): See 8. (line 2348)
4.122 -tifficc (LittleCMS): See 8. (line 2398)
4.123 -tiffinfo (libtiff) <1>: See 8. (line 2390)
4.124 -tiffinfo (libtiff): See 5.1. (line 1555)
4.125 -ufraw <1>: See 8. (line 2329)
4.126 -ufraw: See 2. (line 194)
4.127 -ufraw-batch: See 8. (line 2329)
4.128 +ale: See 8. (line 2363)
4.129 +align_image_stack (Hugin): See 8. (line 2370)
4.130 +cinepaint <1>: See 8. (line 2382)
4.131 +cinepaint: See 3.2. (line 574)
4.132 +convert (ImageMagick): See 8. (line 2393)
4.133 +dcraw <1>: See 8. (line 2353)
4.134 +dcraw: See 2. (line 203)
4.135 +display (ImageMagick): See 8. (line 2393)
4.136 +exiftool: See 8. (line 2421)
4.137 +exrdisplay (OpenEXR): See 8. (line 2399)
4.138 +fulla (Hugin): See 8. (line 2370)
4.139 +gimp <1>: See 8. (line 2389)
4.140 +gimp <2>: See 3.2. (line 574)
4.141 +gimp: See 2. (line 203)
4.142 +gm (GraphicsMagick): See 8. (line 2393)
4.143 +hugin <1>: See 8. (line 2367)
4.144 +hugin <2>: See 7.1. (line 1743)
4.145 +hugin <3>: See 3.2. (line 565)
4.146 +hugin: See 2. (line 203)
4.147 +identify (ImageMagick) <1>: See 8. (line 2393)
4.148 +identify (ImageMagick): See 5.1. (line 1582)
4.149 +montage (ImageMagick): See 8. (line 2393)
4.150 +nona (Hugin) <1>: See 8. (line 2370)
4.151 +nona (Hugin): See 3.2. (line 565)
4.152 +PanoTools: See 2. (line 203)
4.153 +pfshdrcalibrate (PFScalibration): See 8. (line 2402)
4.154 +pfsin (PFSTools): See 8. (line 2402)
4.155 +pfsout (PFSTools): See 8. (line 2402)
4.156 +pfstmo_* (PFStmo): See 8. (line 2402)
4.157 +pfsview (PFSTools): See 8. (line 2402)
4.158 +PTmender (PanoTools): See 8. (line 2375)
4.159 +PTOptimizer (PanoTools): See 8. (line 2375)
4.160 +tifficc (LittleCMS): See 8. (line 2425)
4.161 +tiffinfo (libtiff) <1>: See 8. (line 2417)
4.162 +tiffinfo (libtiff): See 5.1. (line 1582)
4.163 +ufraw <1>: See 8. (line 2356)
4.164 +ufraw: See 2. (line 203)
4.165 +ufraw-batch: See 8. (line 2356)
4.166 Option Index
4.167 ************
4.168
4.169 ---compression: See 3.1. (line 281)
4.170 ---contrast-edge-scale: See 3.4. (line 652)
4.171 ---contrast-min-curvature: See 3.4. (line 825)
4.172 ---contrast-weight: See 3.3. (line 573)
4.173 ---contrast-window-size: See 3.4. (line 632)
4.174 ---ContrastWindowSize (deprecated): See 3.4. (line 632)
4.175 ---depth: See 3.2. (line 458)
4.176 ---EdgeScale (deprecated): See 3.4. (line 652)
4.177 ---entropy-cutoff: See 3.4. (line 673)
4.178 ---entropy-weight: See 3.3. (line 580)
4.179 ---entropy-window-size: See 3.4. (line 738)
4.180 ---EntropyCutoff (deprecated): See 3.4. (line 673)
4.181 ---EntropyWindowSize (deprecated): See 3.4. (line 738)
4.182 ---exposure-mu: See 3.3. (line 596)
4.183 ---exposure-sigma: See 3.3. (line 606)
4.184 ---exposure-weight: See 3.3. (line 588)
4.185 ---gray-projector: See 3.4. (line 754)
4.186 ---GrayProjector (deprecated): See 3.4. (line 754)
4.187 ---hard-mask <1>: See 7.6.6. (line 2304)
4.188 ---hard-mask <2>: See 4.1.2. (line 1052)
4.189 ---hard-mask: See 3.4. (line 811)
4.190 ---HardMask (deprecated): See 3.4. (line 811)
4.191 ---help: See 3.1. (line 318)
4.192 ---MinCurvature (deprecated): See 3.4. (line 825)
4.193 ---output: See 3.1. (line 333)
4.194 ---saturation-weight: See 3.3. (line 617)
4.195 ---save-masks: See 3.4. (line 843)
4.196 ---SaveMasks (deprecated): See 3.4. (line 843)
4.197 ---soft-mask: See 3.4. (line 871)
4.198 ---SoftMask (deprecated): See 3.4. (line 871)
4.199 ---verbose: See 3.1. (line 340)
4.200 ---version: See 3.1. (line 375)
4.201 ---wContrast (deprecated): See 3.3. (line 573)
4.202 ---wEntropy (deprecated): See 3.3. (line 580)
4.203 ---wExposureMu (deprecated): See 3.3. (line 588)
4.204 ---wExposureSigma (deprecated): See 3.3. (line 606)
4.205 ---wrap: See 3.1. (line 382)
4.206 ---wSaturation (deprecated): See 3.3. (line 617)
4.207 --b <1>: See 6. (line 1629)
4.208 --b: See 3.2. (line 436)
4.209 --c: See 3.2. (line 447)
4.210 --d: See 3.2. (line 458)
4.211 --f: See 3.2. (line 535)
4.212 --g: See 3.2. (line 543)
4.213 --h: See 3.1. (line 318)
4.214 --l: See 3.1. (line 321)
4.215 --m <1>: See 6. (line 1629)
4.216 --m: See 3.2. (line 555)
4.217 --o: See 3.1. (line 333)
4.218 --V: See 3.1. (line 375)
4.219 --v: See 3.1. (line 340)
4.220 --w: See 3.1. (line 382)
4.221 +--compression: See 3.1. (line 290)
4.222 +--contrast-edge-scale: See 3.4. (line 679)
4.223 +--contrast-min-curvature: See 3.4. (line 852)
4.224 +--contrast-weight: See 3.3. (line 600)
4.225 +--contrast-window-size: See 3.4. (line 659)
4.226 +--ContrastWindowSize (deprecated): See 3.4. (line 659)
4.227 +--depth: See 3.2. (line 485)
4.228 +--EdgeScale (deprecated): See 3.4. (line 679)
4.229 +--entropy-cutoff: See 3.4. (line 700)
4.230 +--entropy-weight: See 3.3. (line 607)
4.231 +--entropy-window-size: See 3.4. (line 765)
4.232 +--EntropyCutoff (deprecated): See 3.4. (line 700)
4.233 +--EntropyWindowSize (deprecated): See 3.4. (line 765)
4.234 +--exposure-mu: See 3.3. (line 623)
4.235 +--exposure-sigma: See 3.3. (line 633)
4.236 +--exposure-weight: See 3.3. (line 615)
4.237 +--gray-projector: See 3.4. (line 781)
4.238 +--GrayProjector (deprecated): See 3.4. (line 781)
4.239 +--hard-mask <1>: See 7.6.6. (line 2331)
4.240 +--hard-mask <2>: See 4.1.2. (line 1079)
4.241 +--hard-mask: See 3.4. (line 838)
4.242 +--HardMask (deprecated): See 3.4. (line 838)
4.243 +--help: See 3.1. (line 327)
4.244 +--MinCurvature (deprecated): See 3.4. (line 852)
4.245 +--output: See 3.1. (line 360)
4.246 +--saturation-weight: See 3.3. (line 644)
4.247 +--save-masks: See 3.4. (line 870)
4.248 +--SaveMasks (deprecated): See 3.4. (line 870)
4.249 +--soft-mask: See 3.4. (line 898)
4.250 +--SoftMask (deprecated): See 3.4. (line 898)
4.251 +--verbose: See 3.1. (line 367)
4.252 +--version: See 3.1. (line 402)
4.253 +--wContrast (deprecated): See 3.3. (line 600)
4.254 +--wEntropy (deprecated): See 3.3. (line 607)
4.255 +--wExposureMu (deprecated): See 3.3. (line 615)
4.256 +--wExposureSigma (deprecated): See 3.3. (line 633)
4.257 +--wrap: See 3.1. (line 409)
4.258 +--wSaturation (deprecated): See 3.3. (line 644)
4.259 +-b <1>: See 6. (line 1656)
4.260 +-b: See 3.2. (line 463)
4.261 +-c: See 3.2. (line 474)
4.262 +-d: See 3.2. (line 485)
4.263 +-f: See 3.2. (line 562)
4.264 +-g: See 3.2. (line 570)
4.265 +-h: See 3.1. (line 327)
4.266 +-l: See 3.1. (line 330)
4.267 +-m <1>: See 6. (line 1656)
4.268 +-m: See 3.2. (line 582)
4.269 +-o: See 3.1. (line 360)
4.270 +-V: See 3.1. (line 402)
4.271 +-v: See 3.1. (line 367)
4.272 +-w: See 3.1. (line 409)
4.273 General Index
4.274 *************
4.275
4.276 -360o panoramas: See 3.1. (line 382)
4.277 -a.tif: See 3.1. (line 335)
4.278 -advanced focus stacking: See 7.6.5. (line 2051)
4.279 +360o panoramas: See 3.1. (line 409)
4.280 +a.tif: See 3.1. (line 362)
4.281 +advanced focus stacking: See 7.6.5. (line 2078)
4.282 advanced focus stacking, recognizing faint edges:See 7.6.5.4.
4.283 - (line 2209)
4.284 -advanced focus stacking, suppressing noise: See 7.6.5.4. (line 2209)
4.285 -affine transformation: See 2. (line 231)
4.286 -alpha channel <1>: See 2. (line 252)
4.287 + (line 2236)
4.288 +advanced focus stacking, suppressing noise: See 7.6.5.4. (line 2236)
4.289 +affine transformation: See 2. (line 240)
4.290 +alpha channel <1>: See 2. (line 261)
4.291 alpha channel: See 1. (line 155)
4.292 -alpha channel, associated: See 3.2. (line 543)
4.293 -aperture, sweet spot: See 7.6.1. (line 1960)
4.294 -applications of enfuse: See 7. (line 1702)
4.295 +alpha channel, associated: See 3.2. (line 570)
4.296 +aperture, sweet spot: See 7.6.1. (line 1987)
4.297 +applications of enfuse: See 7. (line 1729)
4.298 authors, list of: See Appendix B.
4.299 - (line 2553)
4.300 -average, disabling: See 4.1.2. (line 1052)
4.301 -average, weighted: See 4.1.1. (line 1040)
4.302 -basic focus stacking: See 7.6.4. (line 2023)
4.303 -binary mask: See 5. (line 1539)
4.304 -bits per channel: See 3.2. (line 458)
4.305 -blending exposures: See 7.3.2. (line 1878)
4.306 + (line 2580)
4.307 +average, disabling: See 4.1.2. (line 1079)
4.308 +average, weighted: See 4.1.1. (line 1067)
4.309 +basic focus stacking: See 7.6.4. (line 2050)
4.310 +binary mask: See 5. (line 1566)
4.311 +bits per channel: See 3.2. (line 485)
4.312 +blending exposures: See 7.3.2. (line 1905)
4.313 bug reports: See Appendix A.
4.314 - (line 2406)
4.315 + (line 2433)
4.316 Burt-Adelson multiresolution spline: See 1. (line 112)
4.317 -channel width: See 3.2. (line 458)
4.318 +channel width: See 3.2. (line 485)
4.319 channel, alpha: See 1. (line 155)
4.320 -CIECAM02: See 3.2. (line 447)
4.321 -circle-of-confusion: See 7.6.1. (line 1948)
4.322 -color appearance model: See 3.2. (line 447)
4.323 -color space, sRGB: See 3.2. (line 449)
4.324 -compression: See 3.1. (line 281)
4.325 -compression, deflate: See 3.1. (line 296)
4.326 -compression, JPEG: See 3.1. (line 287)
4.327 -compression, LZW: See 3.1. (line 302)
4.328 -compression, packbits: See 3.1. (line 306)
4.329 -contrast enhancement, local: See 7.6.5.3. (line 2188)
4.330 -contrast weighting using a blend of methods: See 4.4.3. (line 1388)
4.331 -contrast weighting using laplacian-of-gaussian:See 4.4.2. (line 1290)
4.332 -contrast weighting using standard deviation: See 4.4.1. (line 1221)
4.333 -conversion, L*a*b*: See 3.4. (line 785)
4.334 -conversion, raw: See 2. (line 218)
4.335 -dark frame: See 7.6.6. (line 2300)
4.336 -decision tree, focus stacking: See 7.6.5.5. (line 2265)
4.337 -default output filename: See 3.1. (line 335)
4.338 -deflate compression: See 3.1. (line 296)
4.339 -delimiters, option: See 3.5. (line 952)
4.340 -depth-of-field: See 7.6.1. (line 1951)
4.341 -depth-of-focus increase: See 7.6. (line 1932)
4.342 -digital blending: See 7.3.2. (line 1878)
4.343 -disabling average: See 4.1.2. (line 1052)
4.344 -double precision float, IEEE754: See 3.2. (line 510)
4.345 -dynamic range increase <1>: See 7.4. (line 1916)
4.346 -dynamic range increase: See 7.3. (line 1813)
4.347 -edge detection, laplacian: See 7.6.5.2. (line 2168)
4.348 -entropy: See 4.5. (line 1449)
4.349 -entropy, definition: See 4.5. (line 1446)
4.350 -estimators: See 4.4.1.2. (line 1271)
4.351 -expectation value: See 4.4.1.1. (line 1255)
4.352 -expert focus stacking tips: See 7.6.6. (line 2288)
4.353 -exposure series: See 7.3. (line 1813)
4.354 -exposure series, common misconceptions: See 7.3.2. (line 1875)
4.355 -exposure series, tips for beginners: See 7.3.1. (line 1851)
4.356 -filename template: See 3.4. (line 848)
4.357 -flash exposure series: See 7.4. (line 1916)
4.358 -focus stacking decision tree: See 7.6.5.5. (line 2265)
4.359 -focus stacking, advanced: See 7.6.5. (line 2051)
4.360 -focus stacking, basic: See 7.6.4. (line 2023)
4.361 -focus stacks: See 7.6. (line 1932)
4.362 -focus stacks, fusing: See 7.6.3. (line 1985)
4.363 -focus stacks, preparation: See 7.6.2. (line 1971)
4.364 -focus stacks, why create them: See 7.6.1. (line 1942)
4.365 +CIECAM02: See 3.2. (line 474)
4.366 +circle-of-confusion: See 7.6.1. (line 1975)
4.367 +color appearance model: See 3.2. (line 474)
4.368 +color space, sRGB: See 3.2. (line 476)
4.369 +compression: See 3.1. (line 290)
4.370 +compression, deflate: See 3.1. (line 305)
4.371 +compression, JPEG: See 3.1. (line 296)
4.372 +compression, LZW: See 3.1. (line 311)
4.373 +compression, packbits: See 3.1. (line 315)
4.374 +contrast enhancement, local: See 7.6.5.3. (line 2215)
4.375 +contrast weighting using a blend of methods: See 4.4.3. (line 1415)
4.376 +contrast weighting using laplacian-of-gaussian:See 4.4.2. (line 1317)
4.377 +contrast weighting using standard deviation: See 4.4.1. (line 1248)
4.378 +conversion, L*a*b*: See 3.4. (line 812)
4.379 +conversion, raw: See 2. (line 227)
4.380 +dark frame: See 7.6.6. (line 2327)
4.381 +decision tree, focus stacking: See 7.6.5.5. (line 2292)
4.382 +default output filename: See 3.1. (line 362)
4.383 +deflate compression: See 3.1. (line 305)
4.384 +delimiters, option: See 3.5. (line 979)
4.385 +depth-of-field: See 7.6.1. (line 1978)
4.386 +depth-of-focus increase: See 7.6. (line 1959)
4.387 +digital blending: See 7.3.2. (line 1905)
4.388 +disabling average: See 4.1.2. (line 1079)
4.389 +double precision float, IEEE754: See 3.2. (line 537)
4.390 +dynamic range increase <1>: See 7.4. (line 1943)
4.391 +dynamic range increase: See 7.3. (line 1840)
4.392 +edge detection, laplacian: See 7.6.5.2. (line 2195)
4.393 +entropy: See 4.5. (line 1476)
4.394 +entropy, definition: See 4.5. (line 1473)
4.395 +estimators: See 4.4.1.2. (line 1298)
4.396 +expectation value: See 4.4.1.1. (line 1282)
4.397 +expert focus stacking tips: See 7.6.6. (line 2315)
4.398 +exposure series: See 7.3. (line 1840)
4.399 +exposure series, common misconceptions: See 7.3.2. (line 1902)
4.400 +exposure series, tips for beginners: See 7.3.1. (line 1878)
4.401 +filename template: See 3.4. (line 875)
4.402 +flash exposure series: See 7.4. (line 1943)
4.403 +focus stacking decision tree: See 7.6.5.5. (line 2292)
4.404 +focus stacking, advanced: See 7.6.5. (line 2078)
4.405 +focus stacking, basic: See 7.6.4. (line 2050)
4.406 +focus stacks: See 7.6. (line 1959)
4.407 +focus stacks, fusing: See 7.6.3. (line 2012)
4.408 +focus stacks, preparation: See 7.6.2. (line 1998)
4.409 +focus stacks, why create them: See 7.6.1. (line 1969)
4.410 free documentation license (FDL): See Appendix C.
4.411 - (line 2592)
4.412 -fusing, local-contrast-based: See 7.6.3. (line 1985)
4.413 + (line 2619)
4.414 +fusing, local-contrast-based: See 7.6.3. (line 2012)
4.415 general index:
4.416 - See ``General Index''. (line 3106)
4.417 + See ``General Index''. (line 3133)
4.418 GNU free documentation license: See Appendix C.
4.419 - (line 2592)
4.420 -gray projector: See 3.4. (line 754)
4.421 -gray projector, average: See 3.4. (line 765)
4.422 -gray projector, channel-mixer: See 3.4. (line 771)
4.423 -gray projector, l-star: See 3.4. (line 785)
4.424 -gray projector, lightness: See 3.4. (line 795)
4.425 -gray projector, luminance: See 3.4. (line 800)
4.426 -gray projector, value: See 3.4. (line 806)
4.427 -half precision float, OpenEXR: See 3.2. (line 525)
4.428 -helpful programs: See 8. (line 2322)
4.429 -hot pixels: See 7.6.6. (line 2300)
4.430 -Hugin: See A.2. (line 2496)
4.431 -ICC profile: See 3.2. (line 449)
4.432 -IEEE754 double precision float: See 3.2. (line 510)
4.433 -IEEE754 single precision float: See 3.2. (line 501)
4.434 -image cache: See 6. (line 1632)
4.435 -image cache, block size: See 3.2. (line 436)
4.436 -image cache, cache size: See 3.2. (line 555)
4.437 -image cache, location: See 6. (line 1643)
4.438 -images, fusable: See 7.1. (line 1709)
4.439 + (line 2619)
4.440 +gray projector: See 3.4. (line 781)
4.441 +gray projector, average: See 3.4. (line 792)
4.442 +gray projector, channel-mixer: See 3.4. (line 798)
4.443 +gray projector, l-star: See 3.4. (line 812)
4.444 +gray projector, lightness: See 3.4. (line 822)
4.445 +gray projector, luminance: See 3.4. (line 827)
4.446 +gray projector, value: See 3.4. (line 833)
4.447 +half precision float, OpenEXR: See 3.2. (line 552)
4.448 +helpful programs: See 8. (line 2349)
4.449 +hot pixels: See 7.6.6. (line 2327)
4.450 +Hugin: See A.2. (line 2523)
4.451 +ICC profile: See 3.2. (line 476)
4.452 +IEEE754 double precision float: See 3.2. (line 537)
4.453 +IEEE754 single precision float: See 3.2. (line 528)
4.454 +image cache: See 6. (line 1659)
4.455 +image cache, block size: See 3.2. (line 463)
4.456 +image cache, cache size: See 3.2. (line 582)
4.457 +image cache, location: See 6. (line 1670)
4.458 +image, multi-layer: See 1. (line 163)
4.459 +images, fusable: See 7.1. (line 1736)
4.460 index, general:
4.461 - See ``General Index''. (line 3106)
4.462 + See ``General Index''. (line 3133)
4.463 index, option:
4.464 - See ``Option Index''. (line 3051)
4.465 + See ``Option Index''. (line 3078)
4.466 index, program:
4.467 - See ``Program Index''. (line 3010)
4.468 -input mask: See 5.1. (line 1551)
4.469 -invocation: See 3. (line 271)
4.470 -JPEG compression: See 3.1. (line 287)
4.471 -KImageFuser: See A.2. (line 2496)
4.472 -L*a*b* conversion: See 3.4. (line 785)
4.473 -laplacian edge detection: See 7.6.5.2. (line 2168)
4.474 -Laplacian of Gaussian (LoG): See 4.4.2. (line 1290)
4.475 -lens distortion, correction of: See 2. (line 231)
4.476 -levels, pyramid: See 3.1. (line 321)
4.477 -LibJPEG: See 8. (line 2379)
4.478 -LibPNG: See 8. (line 2382)
4.479 -LibTiff: See 8. (line 2386)
4.480 -light probe: See 7.3.2. (line 1897)
4.481 -local analysis window: See 4.4.1. (line 1221)
4.482 -local contrast enhancement: See 7.6.5.3. (line 2188)
4.483 -local contrast problem: See 7.6.5.1. (line 2058)
4.484 -local-contrast-based fusing: See 7.6.3. (line 1985)
4.485 -LZW compression: See 3.1. (line 302)
4.486 -mask template character, %: See 3.4. (line 876)
4.487 -mask template character, B: See 3.4. (line 925)
4.488 -mask template character, b: See 3.4. (line 919)
4.489 -mask template character, D: See 3.4. (line 916)
4.490 -mask template character, d: See 3.4. (line 910)
4.491 -mask template character, E: See 3.4. (line 944)
4.492 -mask template character, e: See 3.4. (line 938)
4.493 -mask template character, F: See 3.4. (line 934)
4.494 -mask template character, f: See 3.4. (line 928)
4.495 -mask template character, i: See 3.4. (line 879)
4.496 -mask template character, n: See 3.4. (line 894)
4.497 -mask template character, P: See 3.4. (line 907)
4.498 -mask template character, p: See 3.4. (line 899)
4.499 -mask template characters, table of: See 3.4. (line 875)
4.500 -mask, binary: See 5. (line 1539)
4.501 -mask, filename template: See 3.4. (line 848)
4.502 -mask, input files: See 5.1. (line 1551)
4.503 -mask, saving: See 3.4. (line 845)
4.504 -mask, weight: See 5. (line 1539)
4.505 -masks, understanding: See 5. (line 1539)
4.506 -memory, tuning usage of: See 6. (line 1629)
4.507 + See ``Program Index''. (line 3037)
4.508 +input mask: See 5.1. (line 1578)
4.509 +invocation: See 3. (line 280)
4.510 +JPEG compression: See 3.1. (line 296)
4.511 +KImageFuser: See A.2. (line 2523)
4.512 +L*a*b* conversion: See 3.4. (line 812)
4.513 +laplacian edge detection: See 7.6.5.2. (line 2195)
4.514 +Laplacian of Gaussian (LoG): See 4.4.2. (line 1317)
4.515 +lens distortion, correction of: See 2. (line 240)
4.516 +levels, pyramid: See 3.1. (line 330)
4.517 +LibJPEG: See 8. (line 2406)
4.518 +LibPNG: See 8. (line 2409)
4.519 +LibTiff: See 8. (line 2413)
4.520 +light probe: See 7.3.2. (line 1924)
4.521 +local analysis window: See 4.4.1. (line 1248)
4.522 +local contrast enhancement: See 7.6.5.3. (line 2215)
4.523 +local contrast problem: See 7.6.5.1. (line 2085)
4.524 +local-contrast-based fusing: See 7.6.3. (line 2012)
4.525 +LZW compression: See 3.1. (line 311)
4.526 +mask template character, %: See 3.4. (line 903)
4.527 +mask template character, B: See 3.4. (line 952)
4.528 +mask template character, b: See 3.4. (line 946)
4.529 +mask template character, D: See 3.4. (line 943)
4.530 +mask template character, d: See 3.4. (line 937)
4.531 +mask template character, E: See 3.4. (line 971)
4.532 +mask template character, e: See 3.4. (line 965)
4.533 +mask template character, F: See 3.4. (line 961)
4.534 +mask template character, f: See 3.4. (line 955)
4.535 +mask template character, i: See 3.4. (line 906)
4.536 +mask template character, n: See 3.4. (line 921)
4.537 +mask template character, P: See 3.4. (line 934)
4.538 +mask template character, p: See 3.4. (line 926)
4.539 +mask template characters, table of: See 3.4. (line 902)
4.540 +mask, binary: See 5. (line 1566)
4.541 +mask, filename template: See 3.4. (line 875)
4.542 +mask, input files: See 5.1. (line 1578)
4.543 +mask, saving: See 3.4. (line 872)
4.544 +mask, weight: See 5. (line 1566)
4.545 +masks, understanding: See 5. (line 1566)
4.546 +memory, tuning usage of: See 6. (line 1656)
4.547 Mertens-Kautz-Van Reeth exposure fusion: See 1. (line 97)
4.548 -mode of operation (SDev, LoG, ...): See 4.4.4. (line 1430)
4.549 -natural sharp-unsharp transition: See 7.6.6. (line 2315)
4.550 -noise reduction: See 7.2. (line 1791)
4.551 +mode of operation (SDev, LoG, ...): See 4.4.4. (line 1457)
4.552 +multi-directory TIFF: See 1. (line 163)
4.553 +multi-layer image: See 1. (line 163)
4.554 +natural sharp-unsharp transition: See 7.6.6. (line 2342)
4.555 +noise reduction: See 7.2. (line 1818)
4.556 Octave: See Appendix A.
4.557 - (line 2406)
4.558 -OpenEXR, data format: See 3.2. (line 521)
4.559 -OpenEXR, half precision float: See 3.2. (line 525)
4.560 -option delimiters: See 3.5. (line 952)
4.561 + (line 2433)
4.562 +OpenEXR, data format: See 3.2. (line 548)
4.563 +OpenEXR, half precision float: See 3.2. (line 552)
4.564 +option delimiters: See 3.5. (line 979)
4.565 option index:
4.566 - See ``Option Index''. (line 3051)
4.567 -options, common: See 3.1. (line 278)
4.568 -options, expert: See 3.4. (line 628)
4.569 -options, extended: See 3.2. (line 432)
4.570 -options, fusion: See 3.3. (line 569)
4.571 -output file compression: See 3.1. (line 281)
4.572 -output filename, default: See 3.1. (line 335)
4.573 -output image, set size of: See 3.2. (line 535)
4.574 + See ``Option Index''. (line 3078)
4.575 +options, common: See 3.1. (line 287)
4.576 +options, expert: See 3.4. (line 655)
4.577 +options, extended: See 3.2. (line 459)
4.578 +options, fusion: See 3.3. (line 596)
4.579 +output file compression: See 3.1. (line 290)
4.580 +output filename, default: See 3.1. (line 362)
4.581 +output image, set size of: See 3.2. (line 562)
4.582 overview: See 1. (line 97)
4.583 -packbits compression: See 3.1. (line 306)
4.584 -parallax error: See 2. (line 241)
4.585 -photometric alignment: See 2. (line 233)
4.586 -pixels, hot: See 7.6.6. (line 2300)
4.587 -polarization series: See 7.5. (line 1923)
4.588 -probability function: See 4.4.1.1. (line 1252)
4.589 +packbits compression: See 3.1. (line 315)
4.590 +parallax error: See 2. (line 250)
4.591 +photometric alignment: See 2. (line 242)
4.592 +pixels, hot: See 7.6.6. (line 2327)
4.593 +polarization series: See 7.5. (line 1950)
4.594 +probability function: See 4.4.1.1. (line 1279)
4.595 problem reports: See Appendix A.
4.596 - (line 2409)
4.597 -problem, local contrast: See 7.6.5.1. (line 2058)
4.598 -profile, ICC: See 3.2. (line 449)
4.599 + (line 2436)
4.600 +problem, local contrast: See 7.6.5.1. (line 2085)
4.601 +profile, ICC: See 3.2. (line 476)
4.602 program index:
4.603 - See ``Program Index''. (line 3010)
4.604 -programs, helpful additional: See 8. (line 2322)
4.605 -pyramid levels: See 3.1. (line 321)
4.606 -raw conversion: See 2. (line 218)
4.607 -saturation enhancement: See 7.5. (line 1923)
4.608 -scaling of parameters: See 4.4.4. (line 1430)
4.609 -sensor, use of clean: See 7.6.6. (line 2291)
4.610 -series, exposure: See 7.3. (line 1813)
4.611 -series, flash exposure: See 7.4. (line 1916)
4.612 -series, polarization: See 7.5. (line 1923)
4.613 -series, simple: See 7.2. (line 1791)
4.614 -simple series: See 7.2. (line 1791)
4.615 -single precision float, IEEE754: See 3.2. (line 501)
4.616 + See ``Program Index''. (line 3037)
4.617 +programs, helpful additional: See 8. (line 2349)
4.618 +pyramid levels: See 3.1. (line 330)
4.619 +raw conversion: See 2. (line 227)
4.620 +saturation enhancement: See 7.5. (line 1950)
4.621 +scaling of parameters: See 4.4.4. (line 1457)
4.622 +sensor, use of clean: See 7.6.6. (line 2318)
4.623 +series, exposure: See 7.3. (line 1840)
4.624 +series, flash exposure: See 7.4. (line 1943)
4.625 +series, polarization: See 7.5. (line 1950)
4.626 +series, simple: See 7.2. (line 1818)
4.627 +simple series: See 7.2. (line 1818)
4.628 +single precision float, IEEE754: See 3.2. (line 528)
4.629 SourceForge <1>: See Appendix A.
4.630 - (line 2412)
4.631 -SourceForge: See 1. (line 163)
4.632 + (line 2439)
4.633 +SourceForge: See 1. (line 169)
4.634 SourceForge, tracker: See Appendix A.
4.635 - (line 2412)
4.636 -sRGB color space: See 3.2. (line 449)
4.637 -standard deviation: See 4.4.1.1. (line 1261)
4.638 -statistical moments: See 4.4.1.1. (line 1252)
4.639 -subtraction of dark frame: See 7.6.6. (line 2300)
4.640 -sweet spot aperture: See 7.6.1. (line 1960)
4.641 -tips, focus stacking experts: See 7.6.6. (line 2288)
4.642 -TMPDIR: See 6. (line 1643)
4.643 + (line 2439)
4.644 +sRGB color space: See 3.2. (line 476)
4.645 +standard deviation: See 4.4.1.1. (line 1288)
4.646 +statistical moments: See 4.4.1.1. (line 1279)
4.647 +subtraction of dark frame: See 7.6.6. (line 2327)
4.648 +sweet spot aperture: See 7.6.1. (line 1987)
4.649 +TIFF, multi-directory: See 1. (line 163)
4.650 +tiffcopy: See 1. (line 163)
4.651 +tiffsplit: See 1. (line 163)
4.652 +tips, focus stacking experts: See 7.6.6. (line 2315)
4.653 +TMPDIR: See 6. (line 1670)
4.654 tracker, SourceForge: See Appendix A.
4.655 - (line 2412)
4.656 -transformation, affine: See 2. (line 231)
4.657 -transition, natural sharp-unsharp: See 7.6.6. (line 2315)
4.658 -understanding masks: See 5. (line 1539)
4.659 -variance: See 4.4.1.1. (line 1258)
4.660 -weight mask: See 5. (line 1539)
4.661 -weight, entropy: See 3.3. (line 580)
4.662 -weight, exposure: See 3.3. (line 588)
4.663 -weight, local contrast: See 3.3. (line 573)
4.664 -weighted average: See 4.1.1. (line 1040)
4.665 -weighting functions: See 4. (line 999)
4.666 -weighting, contrast using a blend of methods: See 4.4.3. (line 1388)
4.667 -weighting, contrast using laplacian-of-gaussian:See 4.4.2. (line 1290)
4.668 -weighting, contrast using standard deviation: See 4.4.1. (line 1221)
4.669 -weighting, exposure <1>: See 4.2. (line 1072)
4.670 + (line 2439)
4.671 +transformation, affine: See 2. (line 240)
4.672 +transition, natural sharp-unsharp: See 7.6.6. (line 2342)
4.673 +understanding masks: See 5. (line 1566)
4.674 +variance: See 4.4.1.1. (line 1285)
4.675 +weight mask: See 5. (line 1566)
4.676 +weight, entropy: See 3.3. (line 607)
4.677 +weight, exposure: See 3.3. (line 615)
4.678 +weight, local contrast: See 3.3. (line 600)
4.679 +weighted average: See 4.1.1. (line 1067)
4.680 +weighting functions: See 4. (line 1026)
4.681 +weighting, contrast using a blend of methods: See 4.4.3. (line 1415)
4.682 +weighting, contrast using laplacian-of-gaussian:See 4.4.2. (line 1317)
4.683 +weighting, contrast using standard deviation: See 4.4.1. (line 1248)
4.684 +weighting, exposure <1>: See 4.2. (line 1099)
4.685 weighting, exposure: See 1. (line 121)
4.686 -weighting, general concept of: See 4.1. (line 1006)
4.687 -weighting, local contrast <1>: See 4.4. (line 1197)
4.688 +weighting, general concept of: See 4.1. (line 1033)
4.689 +weighting, local contrast <1>: See 4.4. (line 1224)
4.690 weighting, local contrast: See 1. (line 130)
4.691 -weighting, local entropy <1>: See 4.5. (line 1444)
4.692 +weighting, local entropy <1>: See 4.5. (line 1471)
4.693 weighting, local entropy: See 1. (line 135)
4.694 -weighting, saturation <1>: See 4.3. (line 1162)
4.695 +weighting, saturation <1>: See 4.3. (line 1189)
4.696 weighting, saturation: See 1. (line 126)
4.697 -window, local-analysis: See 4.4.1. (line 1221)
4.698 -workflow: See 2. (line 183)
4.699 -workflow with Enblend: See 2. (line 194)
4.700 -workflow with Enfuse: See 2. (line 194)
4.701 -wrap around: See 3.1. (line 382)
4.702 +window, local-analysis: See 4.4.1. (line 1248)
4.703 +workflow: See 2. (line 192)
4.704 +workflow with Enblend: See 2. (line 203)
4.705 +workflow with Enfuse: See 2. (line 203)
4.706 +wrap around: See 3.1. (line 409)
5.1 --- a/doc/enfuse.texi Tue Oct 27 07:41:31 2009 +0100
5.2 +++ b/doc/enfuse.texi Sat Oct 31 15:17:47 2009 +0100
5.3 @@ -318,9 +318,24 @@
5.4 Any alpha value other than zero is interpreted as ``this pixel should
5.5 contribute to the final image''.
5.6
5.7 +@cindex multi-layer image
5.8 +@cindex image, multi-layer
5.9 +@cindex multi-directory @acronym{TIFF}
5.10 +@cindex @acronym{TIFF}, multi-directory
5.11 +@cindex @command{tiffcopy}
5.12 +@cindex @command{tiffsplit}
5.13 +Enfuse reads all layers of multi-layer images, like, for example,
5.14 +multi-directory @acronym{TIFF} images@footnote{Use utilities like,
5.15 +e.g., @command{tiffcopy} and @command{tiffsplit} of LibTIFF to
5.16 +manipulate multi-directory @acronym{TIFF} images. @xref{Helpful
5.17 +Programs}.}. The input images are processed in the order they appear
5.18 +on the command line. Multi-layer images are processed from the first
5.19 +layer to the last before Enfuse considers the next image on the
5.20 +command line.
5.21 +
5.22 @cindex SourceForge
5.23 -Find out more about Enfuse on its SourceForge
5.24 -@uref{http://@/enblend.sourceforge.net/, web page}.
5.25 +Find out more about Enfuse on its @uref{http://@/sourceforge.net/,
5.26 +SourceForge} @uref{http://@/enblend.sourceforge.net/, web page}.
5.27
5.28
5.29 @node Workflow
5.30 @@ -419,18 +434,71 @@
5.31 @opindex -l
5.32 @cindex pyramid levels
5.33 @cindex levels, pyramid
5.34 -Use exactly this many @var{LEVELS} for pyramid @footnote{As
5.35 +Use at most this many @var{LEVELS} for pyramid @footnote{As
5.36 Dr.@tie{}Daniel Jackson correctly
5.37 @uref{http://stargate.wikia.com/@/wiki/@/The_@/Tomb, noted}, actually,
5.38 it is not a pyramid: ``Ziggaurat, it's a
5.39 @uref{http://en.wikipedia.org/@/wiki/@/Ziggaurat, Ziggaurat}.}
5.40 blending.
5.41
5.42 -This option allows to trade off quality of results for slightly
5.43 -shorter execution time and lower memory usage. The default is to use
5.44 -as many levels as possible given the size of the overlap regions.
5.45 -Enfuse may still use a smaller number of levels if the geometry of the
5.46 -images demands.
5.47 +The number of levels used in a pyramid controls the balance between
5.48 +local and global image features (contrast, saturation, @dots{}) in the
5.49 +blended region. Fewer levels emphasize local features and suppress
5.50 +global ones. The more levels a pyramid has, the more global features
5.51 +will be taken into account.
5.52 +
5.53 +As a guideline, remember that each new level works on a linear scale
5.54 +twice as large as the previous level. So, the zeroth layer, the
5.55 +original image, (obviously) defines the image at single-pixel scale,
5.56 +the first level works at two pixel scale, and generally, the
5.57 +@math{n}-th level contains image data at @math{2^n} pixel scale. This
5.58 +is the reason why an image of
5.59 +@math{width}@classictimes{}@math{height}@tie{}pixels cannot be
5.60 +deconstructed into a pyramid of more than
5.61 +@ifinfo
5.62 +@display
5.63 +@math{floor(log_2(min(width, height)))}
5.64 +@end display
5.65 +@end ifinfo
5.66 +@html
5.67 +<math xmlns="http://www.w3.org/1998/Math/MathML">
5.68 + <mrow>
5.69 + <mo>⌊</mo>
5.70 + <mrow>
5.71 + <msub>
5.72 + <mo>log</mo>
5.73 + <mn>2</mo>
5.74 + </msub>
5.75 + <mo>⁡</mo>
5.76 + <mo>(</mo>
5.77 + <mrow>
5.78 + <mo>min</mo>
5.79 + <mo>⁡</mo>
5.80 + <mfenced>
5.81 + <mi mathvariant="italic">width</mi>
5.82 + <mi mathvariant="italic">height</mi>
5.83 + </mfenced>
5.84 + </mrow>
5.85 + <mo>)</mo>
5.86 + </mrow>
5.87 + <mo>⌋</mo>
5.88 + </mrow>
5.89 +</math>
5.90 +@end html
5.91 +@tex
5.92 +$$
5.93 + \lfloor \log_2(\min(\mathit{width}, \mathit{height})) \rfloor
5.94 +$$
5.95 +@end tex
5.96 +levels.
5.97 +
5.98 +If too few levels are used, ``halos'' around regions of high local
5.99 +contrast can show up. On the other hand, if too many levels are used,
5.100 +the image might contain too much global contrast. Usually, the latter
5.101 +is not a problem, but is highly desired. This is the reason, why the
5.102 +default is to use as many levels as is possible given the size of the
5.103 +overlap regions. Enfuse may still use a smaller number of levels if
5.104 +the geometry of the images demands.
5.105
5.106 The valid range of @var{LEVELS} is @value{src::minimum-pyramid-levels}
5.107 to @value{src::maximum-pyramid-levels}.
6.1 --- a/doc/versenblend.texi Tue Oct 27 07:41:31 2009 +0100
6.2 +++ b/doc/versenblend.texi Sat Oct 31 15:17:47 2009 +0100
6.3 @@ -1,4 +1,4 @@
6.4 -@set UPDATED 26 October 2009
6.5 +@set UPDATED 31 October 2009
6.6 @set UPDATED-MONTH October 2009
6.7 -@set EDITION 4.0-8eb8bb7a385e
6.8 -@set VERSION 4.0-8eb8bb7a385e
6.9 +@set EDITION 4.0-dd32463fe9de
6.10 +@set VERSION 4.0-dd32463fe9de
7.1 --- a/doc/versenfuse.texi Tue Oct 27 07:41:31 2009 +0100
7.2 +++ b/doc/versenfuse.texi Sat Oct 31 15:17:47 2009 +0100
7.3 @@ -1,4 +1,4 @@
7.4 -@set UPDATED 26 October 2009
7.5 +@set UPDATED 31 October 2009
7.6 @set UPDATED-MONTH October 2009
7.7 -@set EDITION 4.0-8eb8bb7a385e
7.8 -@set VERSION 4.0-8eb8bb7a385e
7.9 +@set EDITION 4.0-dd32463fe9de
7.10 +@set VERSION 4.0-dd32463fe9de
8.1 --- a/src/common.h Tue Oct 27 07:41:31 2009 +0100
8.2 +++ b/src/common.h Sat Oct 31 15:17:47 2009 +0100
8.3 @@ -784,6 +784,25 @@
8.4 }
8.5
8.6
8.7 +/** Answer a phrase that describes a layer in an image consisting of
8.8 + * multiple layers. If the image has got only one layer, we avoid to
8.9 + * confuse the user and answer an empty string. */
8.10 +inline std::string
8.11 +optional_layer_name(unsigned layer_number, unsigned layer_total)
8.12 +{
8.13 + if (layer_total <= 1U)
8.14 + {
8.15 + return std::string();
8.16 + }
8.17 + else
8.18 + {
8.19 + std::ostringstream oss;
8.20 + oss << ", layer " << layer_number << "/" << layer_total;
8.21 + return oss.str();
8.22 + }
8.23 +}
8.24 +
8.25 +
8.26 } // namespace enblend
8.27
8.28 #endif /* __COMMON_H__ */
9.1 --- a/src/enblend.cc Tue Oct 27 07:41:31 2009 +0100
9.2 +++ b/src/enblend.cc Sat Oct 31 15:17:47 2009 +0100
9.3 @@ -1413,9 +1413,9 @@
9.4 if (inputInfo->numExtraBands() < 1) {
9.5 // Complain about lack of alpha channel.
9.6 cerr << command
9.7 - << ": input image \""
9.8 - << *inputFileNameIterator
9.9 - << "\" does not have an alpha channel"
9.10 + << ": input image \"" << *inputFileNameIterator << "\""
9.11 + << enblend::optional_layer_name(layer, layers)
9.12 + << " does not have an alpha channel"
9.13 << endl;
9.14 exit(1);
9.15 }
9.16 @@ -1439,7 +1439,7 @@
9.17 cerr << endl
9.18 << command << ": error parsing ICC profile data from file \""
9.19 << *inputFileNameIterator
9.20 - << "\"" << endl;
9.21 + << "\"" << enblend::optional_layer_name(layer, layers) << endl;
9.22 exit(1);
9.23 }
9.24 }
9.25 @@ -1449,7 +1449,8 @@
9.26
9.27 if (isColor != inputInfo->isColor()) {
9.28 cerr << command << ": input image \""
9.29 - << *inputFileNameIterator << "\" is "
9.30 + << *inputFileNameIterator << "\""
9.31 + << enblend::optional_layer_name(layer, layers) << " is "
9.32 << (inputInfo->isColor() ? "color" : "grayscale") << "\n"
9.33 << command << ": but previous images are "
9.34 << (isColor ? "color" : "grayscale")
9.35 @@ -1458,7 +1459,8 @@
9.36 }
9.37 if (pixelType != inputInfo->getPixelType()) {
9.38 cerr << command << ": input image \""
9.39 - << *inputFileNameIterator << "\" has pixel type "
9.40 + << *inputFileNameIterator << "\""
9.41 + << enblend::optional_layer_name(layer, layers) << " has pixel type "
9.42 << inputInfo->getPixelType() << ",\n"
9.43 << command << ": but previous images have pixel type "
9.44 << pixelType
9.45 @@ -1468,7 +1470,8 @@
9.46 if (resolution !=
9.47 TiffResolution(inputInfo->getXResolution(), inputInfo->getYResolution())) {
9.48 cerr << command << ": info: input image \""
9.49 - << *inputFileNameIterator << "\" has resolution "
9.50 + << *inputFileNameIterator << "\""
9.51 + << enblend::optional_layer_name(layer, layers) << " has resolution "
9.52 << inputInfo->getXResolution() << " dpi x "
9.53 << inputInfo->getYResolution() << " dpi,\n"
9.54 << command << ": info: but first image has resolution "
9.55 @@ -1487,14 +1490,14 @@
9.56 cerr << endl
9.57 << command << ": error parsing ICC profile data from file \""
9.58 << *inputFileNameIterator
9.59 - << "\"" << endl;
9.60 + << "\"" << enblend::optional_layer_name(layer, layers) << endl;
9.61 exit(1);
9.62 }
9.63 }
9.64
9.65 cerr << endl << command << ": input image \""
9.66 << *inputFileNameIterator
9.67 - << "\" has ";
9.68 + << "\"" << enblend::optional_layer_name(layer, layers) << " has ";
9.69 if (newProfile) {
9.70 cerr << " ICC profile \""
9.71 << cmsTakeProductName(newProfile)
10.1 --- a/src/enfuse.cc Tue Oct 27 07:41:31 2009 +0100
10.2 +++ b/src/enfuse.cc Sat Oct 31 15:17:47 2009 +0100
10.3 @@ -1477,12 +1477,11 @@
10.4 if (inputInfo->numExtraBands() < 1) {
10.5 // Complain about lack of alpha channel.
10.6 cerr << command
10.7 - << ": warning: input image \""
10.8 - << *inputFileNameIterator
10.9 - << "\" does not have an alpha channel;\n"
10.10 + << ": info: input image \"" << *inputFileNameIterator << "\""
10.11 + << enblend::optional_layer_name(layer, layers)
10.12 + << " does not have an alpha channel;\n"
10.13 << command
10.14 - << ": warning: assuming all pixels should "
10.15 - << "contribute to the final image"
10.16 + << ": info: assuming all pixels should contribute to the final image"
10.17 << endl;
10.18 }
10.19
10.20 @@ -1504,7 +1503,7 @@
10.21 cerr << endl
10.22 << command << ": error parsing ICC profile data from file \""
10.23 << *inputFileNameIterator
10.24 - << "\"" << endl;
10.25 + << "\"" << enblend::optional_layer_name(layer, layers) << endl;
10.26 exit(1);
10.27 }
10.28 }
10.29 @@ -1514,7 +1513,8 @@
10.30
10.31 if (isColor != inputInfo->isColor()) {
10.32 cerr << command << ": input image \""
10.33 - << *inputFileNameIterator << "\" is "
10.34 + << *inputFileNameIterator << "\""
10.35 + << enblend::optional_layer_name(layer, layers) << " is "
10.36 << (inputInfo->isColor() ? "color" : "grayscale") << "\n"
10.37 << command << ": but previous images are "
10.38 << (isColor ? "color" : "grayscale")
10.39 @@ -1523,7 +1523,8 @@
10.40 }
10.41 if (pixelType != inputInfo->getPixelType()) {
10.42 cerr << command << ": input image \""
10.43 - << *inputFileNameIterator << "\" has pixel type "
10.44 + << *inputFileNameIterator << "\""
10.45 + << enblend::optional_layer_name(layer, layers) << " has pixel type "
10.46 << inputInfo->getPixelType() << ",\n"
10.47 << command << ": but previous images have pixel type "
10.48 << pixelType
10.49 @@ -1533,7 +1534,8 @@
10.50 if (resolution !=
10.51 TiffResolution(inputInfo->getXResolution(), inputInfo->getYResolution())) {
10.52 cerr << command << ": info: input image \""
10.53 - << *inputFileNameIterator << "\" has resolution "
10.54 + << *inputFileNameIterator << "\""
10.55 + << enblend::optional_layer_name(layer, layers) << " has resolution "
10.56 << inputInfo->getXResolution() << " dpi x "
10.57 << inputInfo->getYResolution() << " dpi,\n"
10.58 << command << ": info: but first image has resolution "
10.59 @@ -1552,14 +1554,14 @@
10.60 cerr << endl
10.61 << command << ": error parsing ICC profile data from file \""
10.62 << *inputFileNameIterator
10.63 - << "\"" << endl;
10.64 + << "\"" << enblend::optional_layer_name(layer, layers) << endl;
10.65 exit(1);
10.66 }
10.67 }
10.68
10.69 cerr << endl << command << ": input image \""
10.70 << *inputFileNameIterator
10.71 - << "\" has ";
10.72 + << "\"" << enblend::optional_layer_name(layer, layers) << " has ";
10.73 if (newProfile) {
10.74 cerr << " ICC profile \""
10.75 << cmsTakeProductName(newProfile)