Give response files their own section in the manual.
Explain syntactic comments in response files.
1.1 --- a/VERSION Sat Nov 07 10:02:29 2009 +0100
1.2 +++ b/VERSION Sat Nov 07 10:07:16 2009 +0100
1.3 @@ -1,1 +1,1 @@
1.4 -4.0-af0a40a346e7
1.5 +4.0-882223824422
2.1 --- a/doc/enblend.info Sat Nov 07 10:02:29 2009 +0100
2.2 +++ b/doc/enblend.info Sat Nov 07 10:07:16 2009 +0100
2.3 @@ -5,9 +5,12 @@
2.4 1 Overview
2.5 2 Workflow
2.6 3 Invocation
2.7 - 3.1 Common Options
2.8 - 3.2 Extended Options
2.9 - 3.3 Mask Generation Options
2.10 + 3.1 Response Files
2.11 + 3.1.1 Response File Format
2.12 + 3.1.2 Syntactic Comments
2.13 + 3.2 Common Options
2.14 + 3.3 Extended Options
2.15 + 3.4 Mask Generation Options
2.16 4 Understanding Masks
2.17 4.1 Masks in Input Files
2.18 4.2 Weight Mask Files
2.19 @@ -99,7 +102,7 @@
2.20 *note Figure:photographic-workflow:: shows where Enblend and Enfuse sit
2.21 in this tool chain.
2.22
2.23 -Figure 2.1: Photographic workflow with Enblend and Enfuse.
2.24 + Figure 2.1: Photographic workflow with Enblend and Enfuse.
2.25
2.26 Take Images
2.27 Take _multiple_ images to form a panorama, an exposure series, a
2.28 @@ -181,12 +184,18 @@
2.29 Assemble the sequence of images INPUT... into a single IMAGE.
2.30
2.31 Input images are either specified literally or via so-called response
2.32 -files. A response file contains filenames of images or other response
2.33 -filenames. Introduce response file names with an at-character (`@').
2.34 +files (see below). The latter are an alternative to specifying image
2.35 +filenames on the command line.
2.36
2.37 - Enblend and Enfuse process the list INPUT... from left to right,
2.38 -expanding response files depth-first. The following examples only show
2.39 -Enblend, but Enfuse works exactly the same.
2.40 +3.1 Response Files
2.41 +==================
2.42 +
2.43 +A response file contains names of images or other response filenames.
2.44 +Introduce response file names with an at-character (`@').
2.45 +
2.46 + Enblend and Enfuse process the list INPUT strictly from left to
2.47 +right, expanding response files in depth-first order. The following
2.48 +examples only show Enblend, but Enfuse works exactly the same.
2.49
2.50 Solely literal filenames.
2.51 Example:
2.52 @@ -227,12 +236,14 @@
2.53 `image-04.png', `image-05.png', `image-06.png', `image-07.png',
2.54 `image-08.png', `image-09.png', `image-10.png',
2.55
2.56 +3.1.1 Response File Format
2.57 +--------------------------
2.58
2.59 -*Response File Format* Response files contain one filename per line.
2.60 -Blank lines or lines beginning with a sharp sign (`#') are ignored.
2.61 -Filenames that begin with an at-character (`@') denote other response
2.62 -files. *note Table:response-file-format:: states a formal grammar of
2.63 -response files in EBNF (http://en.wikipedia.org/wiki/Ebnf).
2.64 +Response files contain one filename per line. Blank lines or lines
2.65 +beginning with a sharp sign (`#') are ignored; the latter can serve as
2.66 +comments. Filenames that begin with an at-character (`@') denote other
2.67 +response files. *note Table:response-file-format:: states a formal
2.68 +grammar of response files in EBNF (http://en.wikipedia.org/wiki/Ebnf).
2.69
2.70 RESPONSE-FILE ::= LINE*
2.71 LINE ::= (COMMENT | FILE-SPEC) [`\r'] `\n'
2.72 @@ -244,20 +255,21 @@
2.73
2.74 Table 3.1: EBNF definition of the grammar of response files.
2.75
2.76 - In a response file all relative filenames are used relative the the
2.77 -response file itself, not relative to the current-working directory of
2.78 -the application.
2.79 + In a response file relative filenames are used relative the response
2.80 +file itself, not relative to the current-working directory of the
2.81 +application.
2.82
2.83 The above grammar might unpleasantly surprise the user in the some ways:
2.84
2.85 Literal filenames
2.86 Inside a response file all filenames are treated as literals. No
2.87 - filename globing or expansion is performed. This is, the line
2.88 + filename globbing or filename expansion is performed. This is, for
2.89 + example, the line
2.90 img_*.tif
2.91 - stands for exactly one file called `img_*.tif'.
2.92 + stands for exactly one file, called `img_*.tif'.
2.93
2.94 Whitespace trimmed at both line ends
2.95 - For convenience whitespace at the beginning and at the end of each
2.96 + For convenience, whitespace at the beginning and at the end of each
2.97 line is ignored. However, this implies that response files cannot
2.98 represent filenames that start or end with whitespace, as there is
2.99 no quoting syntax. Filenames with embedded whitespace cause no
2.100 @@ -265,29 +277,29 @@
2.101
2.102 Only whole-line comments
2.103 Comments in response files always occupy a complete line. There
2.104 - are no line-ending comments. Thus in
2.105 + are no "line-ending comments". Thus, in
2.106 # exposure series
2.107 img-0.33ev.tif # "middle" EV
2.108 img-1.33ev.tif
2.109 img+0.67ev.tif
2.110 only the first line contains a comment, whereas the second lines
2.111 - includes none. Rather it refers to
2.112 - file `img-0.33ev.tif # "middle" EV'.
2.113 + includes none. Rather, it refers to a file called
2.114 + `img-0.33ev.tif # "middle" EV'.
2.115
2.116 Image filenames cannot start with `@'
2.117 - An at-sign always introduces a response file, even if the extension
2.118 - would hint towards an image.
2.119 + An at-sign always introduces a response file, even if the
2.120 + filename's extension hints towards an image.
2.121
2.122 - If Enblend or Enfuse do not recognize a response file, they will
2.123 -issue a warning. To force a file being recognized as a response file
2.124 -add one of the following syntactic comments to the _first_ line of the
2.125 -file.
2.126 + If Enblend or Enfuse do not recognize a response file, they will skip
2.127 +the file and issue a warning. To force a file being recognized as a
2.128 +response file add one of the following syntactic comments (see below)
2.129 +to the _first_ line of the file.
2.130
2.131 # response-file: true
2.132 # enblend-response-file: true
2.133 # enfuse-response-file: true
2.134
2.135 -Here is an example of a valid response file.
2.136 +Finally, here is an example of a valid response file.
2.137 # 4\pi panorama!
2.138
2.139 # These pictures were taken with the panorama head.
2.140 @@ -301,7 +313,25 @@
2.141 nadir-5.tif
2.142 nadir.tif
2.143
2.144 -3.1 Common Options
2.145 +3.1.2 Syntactic Comments
2.146 +------------------------
2.147 +
2.148 +Comments that follow the format described in *note
2.149 +Table:response-file-syntactic-comment:: are treated as instructions how
2.150 +to interpret the rest of the response file.
2.151 +
2.152 +SYNTACTIC-COMMENT ::= SPACE* `#' SPACE* KEY SPACE* `:' SPACE*
2.153 + VALUE
2.154 +KEY ::= (`A' .. `Z' | `a' .. `z' | `-')+
2.155 +
2.156 +where VALUE is an arbitrary string.
2.157 +
2.158 +Table 3.2: EBNF definition of the grammar of syntactic comments in
2.159 +response files.
2.160 +
2.161 + Unknown syntactic comments are silently ignored.
2.162 +
2.163 +3.2 Common Options
2.164 ==================
2.165
2.166 Common options control some overall features of Enblend.
2.167 @@ -484,7 +514,7 @@
2.168 `http://en.wikipedia.org/wiki/Born-von_Karman_boundary_condition',
2.169 BORN-VON KA'RMA'N boundary condition.
2.170
2.171 -3.2 Extended Options
2.172 +3.3 Extended Options
2.173 ====================
2.174
2.175 Extended options control the image cache, the color model, and the
2.176 @@ -633,7 +663,7 @@
2.177 feature for this option to be effective. Find out about extra
2.178 features with `enblend --version --verbose'.
2.179
2.180 -3.3 Mask Generation Options
2.181 +3.4 Mask Generation Options
2.182 ===========================
2.183
2.184 These options control the generation and the usage of masks.
2.185 @@ -720,7 +750,7 @@
2.186 algorithm, fill vector
2.187 contours.
2.188
2.189 - Table 3.2: Various options that control the generation of masks.
2.190 + Table 3.3: Various options that control the generation of masks.
2.191 All mask computations are based on the Nearest-Feature
2.192 Transformation (NFT) of the overlap region.
2.193
2.194 @@ -742,7 +772,7 @@
2.195 seam line, which can be slow. Use this option, for example, if
2.196 you have very narrow overlap regions.
2.197
2.198 - Also see *note Table 3.2: Table:mask-generation.
2.199 + Also see *note Table 3.3: Table:mask-generation.
2.200
2.201 `--load-masks[=IMAGE-TEMPLATE]'
2.202 Instead of generating masks, use those in IMAGE-TEMPLATE. The
2.203 @@ -757,7 +787,7 @@
2.204
2.205 If Enblend uses a coarse mask (`--coarse-mask') or Enblend
2.206 optimizes (`--optimize') a mask it vectorizes the initial seam
2.207 - line before performing further operations. See *note Table 3.2:
2.208 + line before performing further operations. See *note Table 3.3:
2.209 Table:mask-generation. for the precise conditions. DISTANCE tells
2.210 Enblend how long to make each of the line segments called vectors
2.211 here.
2.212 @@ -801,13 +831,13 @@
2.213 Enblend version 2.5, namely the result of a Nearest-Feature
2.214 Transform (NFT).(1)
2.215
2.216 - Also see *note Table 3.2: Table:mask-generation.
2.217 + Also see *note Table 3.3: Table:mask-generation.
2.218
2.219 `--optimize'
2.220 Use a two-strategy approach to route the seam line around
2.221 mismatches in the overlap region. This is the default. *note
2.222 Table:optimizer-strategies:: explains these strategies; also see
2.223 - *note Table 3.2: Table:mask-generation.
2.224 + *note Table 3.3: Table:mask-generation.
2.225
2.226 Stragegy 1: Simulated Annealing
2.227 Tune with option `--anneal' = TAU : DELTA-E-MAX : DELTA-E-MIN
2.228 @@ -823,7 +853,7 @@
2.229 (http://en.wikipedia.org/wiki/Dijkstra_algorithm)
2.230
2.231
2.232 - Table 3.3: Enblend's two strategies to optimize the seam lines
2.233 + Table 3.4: Enblend's two strategies to optimize the seam lines
2.234 between images.
2.235
2.236 `--optimizer-weights=DISTANCE-WEIGHT[:MISMATCH-WEIGHT]'
2.237 @@ -953,7 +983,7 @@
2.238 bright yellow
2.239 Final seam line
2.240
2.241 - Table 3.4: Colors used in seam-line visualization images.
2.242 + Table 3.5: Colors used in seam-line visualization images.
2.243
2.244
2.245 `%%'
2.246 @@ -1027,7 +1057,7 @@
2.247 `%E'
2.248 Is replaced with the extension of the output file.
2.249
2.250 -Table 3.5: Special characters to control the generation of mask
2.251 +Table 3.6: Special characters to control the generation of mask
2.252 filenames.
2.253
2.254 ---------- Footnotes ----------
2.255 @@ -1871,253 +1901,258 @@
2.256 Program Index
2.257 *************
2.258
2.259 -ale: See 6. (line 1220)
2.260 -align_image_stack (Hugin): See 6. (line 1227)
2.261 -cinepaint <1>: See 6. (line 1239)
2.262 -cinepaint: See 3.2. (line 605)
2.263 -convert (ImageMagick): See 6. (line 1250)
2.264 -dcraw <1>: See 6. (line 1210)
2.265 -dcraw: See 2. (line 102)
2.266 -display (ImageMagick): See 6. (line 1250)
2.267 -exiftool: See 6. (line 1278)
2.268 -exrdisplay (OpenEXR): See 6. (line 1256)
2.269 -fulla (Hugin): See 6. (line 1227)
2.270 -gimp <1>: See 6. (line 1246)
2.271 -gimp <2>: See 3.2. (line 605)
2.272 -gimp: See 2. (line 102)
2.273 -gm (GraphicsMagick): See 6. (line 1250)
2.274 -hugin <1>: See 6. (line 1224)
2.275 -hugin <2>: See 3.2. (line 596)
2.276 -hugin <3>: See 2. (line 102)
2.277 -hugin: See 1. (line 56)
2.278 -identify (ImageMagick) <1>: See 6. (line 1250)
2.279 -identify (ImageMagick): See 4.1. (line 1059)
2.280 -montage (ImageMagick): See 6. (line 1250)
2.281 -nona (Hugin) <1>: See 6. (line 1227)
2.282 -nona (Hugin): See 3.2. (line 596)
2.283 -PanoTools <1>: See 2. (line 102)
2.284 -PanoTools: See 1. (line 56)
2.285 -pfshdrcalibrate (PFScalibration): See 6. (line 1259)
2.286 -pfsin (PFSTools): See 6. (line 1259)
2.287 -pfsout (PFSTools): See 6. (line 1259)
2.288 -pfstmo_* (PFStmo): See 6. (line 1259)
2.289 -pfsview (PFSTools): See 6. (line 1259)
2.290 -PTmender (PanoTools): See 6. (line 1232)
2.291 -PTOptimizer (PanoTools): See 6. (line 1232)
2.292 -tifficc (LittleCMS): See 6. (line 1282)
2.293 -tiffinfo (libtiff) <1>: See 6. (line 1274)
2.294 -tiffinfo (libtiff): See 4.1. (line 1059)
2.295 -ufraw <1>: See 6. (line 1213)
2.296 -ufraw: See 2. (line 102)
2.297 -ufraw-batch: See 6. (line 1213)
2.298 +ale: See 6. (line 1250)
2.299 +align_image_stack (Hugin): See 6. (line 1257)
2.300 +cinepaint <1>: See 6. (line 1269)
2.301 +cinepaint: See 3.3. (line 635)
2.302 +convert (ImageMagick): See 6. (line 1280)
2.303 +dcraw <1>: See 6. (line 1240)
2.304 +dcraw: See 2. (line 105)
2.305 +display (ImageMagick): See 6. (line 1280)
2.306 +exiftool: See 6. (line 1308)
2.307 +exrdisplay (OpenEXR): See 6. (line 1286)
2.308 +fulla (Hugin): See 6. (line 1257)
2.309 +gimp <1>: See 6. (line 1276)
2.310 +gimp <2>: See 3.3. (line 635)
2.311 +gimp: See 2. (line 105)
2.312 +gm (GraphicsMagick): See 6. (line 1280)
2.313 +hugin <1>: See 6. (line 1254)
2.314 +hugin <2>: See 3.3. (line 626)
2.315 +hugin <3>: See 2. (line 105)
2.316 +hugin: See 1. (line 59)
2.317 +identify (ImageMagick) <1>: See 6. (line 1280)
2.318 +identify (ImageMagick): See 4.1. (line 1089)
2.319 +montage (ImageMagick): See 6. (line 1280)
2.320 +nona (Hugin) <1>: See 6. (line 1257)
2.321 +nona (Hugin): See 3.3. (line 626)
2.322 +PanoTools <1>: See 2. (line 105)
2.323 +PanoTools: See 1. (line 59)
2.324 +pfshdrcalibrate (PFScalibration): See 6. (line 1289)
2.325 +pfsin (PFSTools): See 6. (line 1289)
2.326 +pfsout (PFSTools): See 6. (line 1289)
2.327 +pfstmo_* (PFStmo): See 6. (line 1289)
2.328 +pfsview (PFSTools): See 6. (line 1289)
2.329 +PTmender (PanoTools): See 6. (line 1262)
2.330 +PTOptimizer (PanoTools): See 6. (line 1262)
2.331 +tifficc (LittleCMS): See 6. (line 1312)
2.332 +tiffinfo (libtiff) <1>: See 6. (line 1304)
2.333 +tiffinfo (libtiff): See 4.1. (line 1089)
2.334 +ufraw <1>: See 6. (line 1243)
2.335 +ufraw: See 2. (line 105)
2.336 +ufraw-batch: See 6. (line 1243)
2.337 Option Index
2.338 ************
2.339
2.340 ---anneal: See 3.3. (line 642)
2.341 ---coarse-mask: See 3.3. (line 688)
2.342 ---compression: See 3.1. (line 318)
2.343 ---depth: See 3.2. (line 516)
2.344 ---dijkstra: See 3.3. (line 728)
2.345 ---fine-mask: See 3.3. (line 741)
2.346 ---gpu: See 3.2. (line 613)
2.347 ---help: See 3.1. (line 354)
2.348 ---load-masks: See 3.3. (line 748)
2.349 ---mask-vectorize: See 3.3. (line 754)
2.350 ---no-optimize: See 3.3. (line 799)
2.351 ---optimize: See 3.3. (line 807)
2.352 ---optimizer-weights: See 3.3. (line 830)
2.353 ---output: See 3.1. (line 387)
2.354 ---save-masks: See 3.3. (line 857)
2.355 ---smooth-difference: See 3.3. (line 885)
2.356 ---verbose: See 3.1. (line 394)
2.357 ---version: See 3.1. (line 429)
2.358 ---visualize: See 3.3. (line 903)
2.359 ---wrap: See 3.1. (line 436)
2.360 --a: See 3.1. (line 310)
2.361 --b <1>: See 5. (line 1133)
2.362 --b: See 3.2. (line 494)
2.363 --c: See 3.2. (line 505)
2.364 --d: See 3.2. (line 516)
2.365 --f: See 3.2. (line 593)
2.366 --g: See 3.2. (line 601)
2.367 --h: See 3.1. (line 354)
2.368 --l: See 3.1. (line 357)
2.369 --m <1>: See 5. (line 1133)
2.370 --m: See 3.2. (line 625)
2.371 --o: See 3.1. (line 387)
2.372 --V: See 3.1. (line 429)
2.373 --v: See 3.1. (line 394)
2.374 --w: See 3.1. (line 436)
2.375 --x: See 3.1. (line 473)
2.376 +--anneal: See 3.4. (line 672)
2.377 +--coarse-mask: See 3.4. (line 718)
2.378 +--compression: See 3.2. (line 348)
2.379 +--depth: See 3.3. (line 546)
2.380 +--dijkstra: See 3.4. (line 758)
2.381 +--fine-mask: See 3.4. (line 771)
2.382 +--gpu: See 3.3. (line 643)
2.383 +--help: See 3.2. (line 384)
2.384 +--load-masks: See 3.4. (line 778)
2.385 +--mask-vectorize: See 3.4. (line 784)
2.386 +--no-optimize: See 3.4. (line 829)
2.387 +--optimize: See 3.4. (line 837)
2.388 +--optimizer-weights: See 3.4. (line 860)
2.389 +--output: See 3.2. (line 417)
2.390 +--save-masks: See 3.4. (line 887)
2.391 +--smooth-difference: See 3.4. (line 915)
2.392 +--verbose: See 3.2. (line 424)
2.393 +--version: See 3.2. (line 459)
2.394 +--visualize: See 3.4. (line 933)
2.395 +--wrap: See 3.2. (line 466)
2.396 +-a: See 3.2. (line 340)
2.397 +-b <1>: See 5. (line 1163)
2.398 +-b: See 3.3. (line 524)
2.399 +-c: See 3.3. (line 535)
2.400 +-d: See 3.3. (line 546)
2.401 +-f: See 3.3. (line 623)
2.402 +-g: See 3.3. (line 631)
2.403 +-h: See 3.2. (line 384)
2.404 +-l: See 3.2. (line 387)
2.405 +-m <1>: See 5. (line 1163)
2.406 +-m: See 3.3. (line 655)
2.407 +-o: See 3.2. (line 417)
2.408 +-V: See 3.2. (line 459)
2.409 +-v: See 3.2. (line 424)
2.410 +-w: See 3.2. (line 466)
2.411 +-x: See 3.2. (line 503)
2.412 General Index
2.413 *************
2.414
2.415 -360o panoramas: See 3.1. (line 436)
2.416 -a.tif: See 3.1. (line 389)
2.417 -affine transformation: See 2. (line 139)
2.418 -alpha channel <1>: See 2. (line 160)
2.419 -alpha channel: See 1. (line 49)
2.420 -alpha channel, associated: See 3.2. (line 601)
2.421 -anneal parameters: See 3.3. (line 642)
2.422 +360o panoramas: See 3.2. (line 466)
2.423 +a.tif: See 3.2. (line 419)
2.424 +affine transformation: See 2. (line 142)
2.425 +alpha channel <1>: See 2. (line 163)
2.426 +alpha channel: See 1. (line 52)
2.427 +alpha channel, associated: See 3.3. (line 631)
2.428 +anneal parameters: See 3.4. (line 672)
2.429 authors, list of: See Appendix B.
2.430 - (line 1437)
2.431 -binary mask: See 4. (line 1043)
2.432 -bits per channel: See 3.2. (line 516)
2.433 -blur difference image: See 3.3. (line 885)
2.434 + (line 1467)
2.435 +binary mask: See 4. (line 1073)
2.436 +bits per channel: See 3.3. (line 546)
2.437 +blur difference image: See 3.4. (line 915)
2.438 bug reports: See Appendix A.
2.439 - (line 1290)
2.440 -Burt-Adelson multiresolution spline: See 1. (line 37)
2.441 -channel width: See 3.2. (line 516)
2.442 -channel, alpha: See 1. (line 49)
2.443 -CIECAM02: See 3.2. (line 505)
2.444 -coarse mask: See 3.3. (line 688)
2.445 -color appearance model: See 3.2. (line 505)
2.446 -color space, sRGB: See 3.2. (line 507)
2.447 -colors, visualization image: See 3.3. (line 956)
2.448 -compression: See 3.1. (line 318)
2.449 -compression, deflate: See 3.1. (line 333)
2.450 -compression, JPEG: See 3.1. (line 324)
2.451 -compression, LZW: See 3.1. (line 339)
2.452 -compression, packbits: See 3.1. (line 343)
2.453 -conversion, raw: See 2. (line 126)
2.454 -default output filename: See 3.1. (line 389)
2.455 -deflate compression: See 3.1. (line 333)
2.456 -DIJKSTRA radius: See 3.3. (line 728)
2.457 -double precision float, IEEE754: See 3.2. (line 568)
2.458 -feathering, detrimental effect of: See 1. (line 56)
2.459 -filenames, literal: See 3. (line 183)
2.460 -fine mask: See 3.3. (line 741)
2.461 -format of response files: See 3. (line 231)
2.462 + (line 1320)
2.463 +Burt-Adelson multiresolution spline: See 1. (line 40)
2.464 +channel width: See 3.3. (line 546)
2.465 +channel, alpha: See 1. (line 52)
2.466 +CIECAM02: See 3.3. (line 535)
2.467 +coarse mask: See 3.4. (line 718)
2.468 +color appearance model: See 3.3. (line 535)
2.469 +color space, sRGB: See 3.3. (line 537)
2.470 +colors, visualization image: See 3.4. (line 986)
2.471 +compression: See 3.2. (line 348)
2.472 +compression, deflate: See 3.2. (line 363)
2.473 +compression, JPEG: See 3.2. (line 354)
2.474 +compression, LZW: See 3.2. (line 369)
2.475 +compression, packbits: See 3.2. (line 373)
2.476 +conversion, raw: See 2. (line 129)
2.477 +default output filename: See 3.2. (line 419)
2.478 +deflate compression: See 3.2. (line 363)
2.479 +DIJKSTRA radius: See 3.4. (line 758)
2.480 +double precision float, IEEE754: See 3.3. (line 598)
2.481 +feathering, detrimental effect of: See 1. (line 59)
2.482 +filename, literal: See 3. (line 186)
2.483 +fine mask: See 3.4. (line 771)
2.484 +format of response file: See 3.1.1. (line 242)
2.485 free documentation license (FDL): See Appendix C.
2.486 - (line 1476)
2.487 + (line 1506)
2.488 general index:
2.489 - See ``General Index''. (line 1955)
2.490 + See ``General Index''. (line 1985)
2.491 GNU free documentation license: See Appendix C.
2.492 - (line 1476)
2.493 -GPU (Graphics Processing Unit): See 3.2. (line 613)
2.494 -grammar, response file: See 3. (line 245)
2.495 -graphics processing unit: See 3.2. (line 613)
2.496 -half precision float, OpenEXR: See 3.2. (line 583)
2.497 -helpful programs: See 6. (line 1206)
2.498 -Hugin: See A.2. (line 1380)
2.499 -ICC profile: See 3.2. (line 507)
2.500 -IEEE754 double precision float: See 3.2. (line 568)
2.501 -IEEE754 single precision float: See 3.2. (line 559)
2.502 -image cache: See 5. (line 1136)
2.503 -image cache, block size: See 3.2. (line 494)
2.504 -image cache, cache size: See 3.2. (line 625)
2.505 -image cache, location: See 5. (line 1147)
2.506 -image colors, visualization: See 3.3. (line 956)
2.507 -image, multi-layer: See 1. (line 70)
2.508 -image, visualization: See 3.3. (line 921)
2.509 + (line 1506)
2.510 +GPU (Graphics Processing Unit): See 3.3. (line 643)
2.511 +grammar, response file: See 3.1.1. (line 256)
2.512 +grammar, syntactic comment: See 3.1.2. (line 329)
2.513 +graphics processing unit: See 3.3. (line 643)
2.514 +half precision float, OpenEXR: See 3.3. (line 613)
2.515 +helpful programs: See 6. (line 1236)
2.516 +Hugin: See A.2. (line 1410)
2.517 +ICC profile: See 3.3. (line 537)
2.518 +IEEE754 double precision float: See 3.3. (line 598)
2.519 +IEEE754 single precision float: See 3.3. (line 589)
2.520 +image cache: See 5. (line 1166)
2.521 +image cache, block size: See 3.3. (line 524)
2.522 +image cache, cache size: See 3.3. (line 655)
2.523 +image cache, location: See 5. (line 1177)
2.524 +image colors, visualization: See 3.4. (line 986)
2.525 +image, multi-layer: See 1. (line 73)
2.526 +image, visualization: See 3.4. (line 951)
2.527 index, general:
2.528 - See ``General Index''. (line 1955)
2.529 + See ``General Index''. (line 1985)
2.530 index, option:
2.531 - See ``Option Index''. (line 1916)
2.532 + See ``Option Index''. (line 1946)
2.533 index, program:
2.534 - See ``Program Index''. (line 1874)
2.535 -input mask: See 4.1. (line 1055)
2.536 -invocation: See 3. (line 179)
2.537 -JPEG compression: See 3.1. (line 324)
2.538 -KImageFuser: See A.2. (line 1380)
2.539 -lens distortion, correction of: See 2. (line 139)
2.540 -levels, pyramid: See 3.1. (line 357)
2.541 -LibJPEG: See 6. (line 1263)
2.542 -LibPNG: See 6. (line 1266)
2.543 -LibTiff: See 6. (line 1270)
2.544 -literal filenames: See 3. (line 183)
2.545 -load mask: See 3.3. (line 748)
2.546 -loops in seam line: See 3.3. (line 784)
2.547 -LZW compression: See 3.1. (line 339)
2.548 -mask template character, %: See 3.3. (line 960)
2.549 -mask template character, B: See 3.3. (line 1009)
2.550 -mask template character, b: See 3.3. (line 1003)
2.551 -mask template character, D: See 3.3. (line 1000)
2.552 -mask template character, d: See 3.3. (line 994)
2.553 -mask template character, E: See 3.3. (line 1028)
2.554 -mask template character, e: See 3.3. (line 1022)
2.555 -mask template character, F: See 3.3. (line 1018)
2.556 -mask template character, f: See 3.3. (line 1012)
2.557 -mask template character, i: See 3.3. (line 963)
2.558 -mask template character, n: See 3.3. (line 978)
2.559 -mask template character, P: See 3.3. (line 991)
2.560 -mask template character, p: See 3.3. (line 983)
2.561 -mask template characters, table of: See 3.3. (line 959)
2.562 -mask, binary: See 4. (line 1043)
2.563 -mask, coarse: See 3.3. (line 688)
2.564 -mask, fine: See 3.3. (line 741)
2.565 -mask, generation: See 3.3. (line 723)
2.566 -mask, input files: See 4.1. (line 1055)
2.567 -mask, load: See 3.3. (line 748)
2.568 -mask, optimization visualization: See 3.3. (line 903)
2.569 -mask, save: See 3.3. (line 857)
2.570 -mask, vectorization distance: See 3.3. (line 754)
2.571 -mask, weight: See 4. (line 1043)
2.572 -masks, understanding: See 4. (line 1043)
2.573 -memory, tuning usage of: See 5. (line 1133)
2.574 -multi-directory TIFF: See 1. (line 70)
2.575 -multi-layer image: See 1. (line 70)
2.576 -nearest-feature transform (NFT): See 3.3. (line 723)
2.577 + See ``Program Index''. (line 1904)
2.578 +input mask: See 4.1. (line 1085)
2.579 +invocation: See 3. (line 182)
2.580 +JPEG compression: See 3.2. (line 354)
2.581 +KImageFuser: See A.2. (line 1410)
2.582 +lens distortion, correction of: See 2. (line 142)
2.583 +levels, pyramid: See 3.2. (line 387)
2.584 +LibJPEG: See 6. (line 1293)
2.585 +LibPNG: See 6. (line 1296)
2.586 +LibTiff: See 6. (line 1300)
2.587 +literal filename: See 3. (line 186)
2.588 +load mask: See 3.4. (line 778)
2.589 +loops in seam line: See 3.4. (line 814)
2.590 +LZW compression: See 3.2. (line 369)
2.591 +mask template character, %: See 3.4. (line 990)
2.592 +mask template character, B: See 3.4. (line 1039)
2.593 +mask template character, b: See 3.4. (line 1033)
2.594 +mask template character, D: See 3.4. (line 1030)
2.595 +mask template character, d: See 3.4. (line 1024)
2.596 +mask template character, E: See 3.4. (line 1058)
2.597 +mask template character, e: See 3.4. (line 1052)
2.598 +mask template character, F: See 3.4. (line 1048)
2.599 +mask template character, f: See 3.4. (line 1042)
2.600 +mask template character, i: See 3.4. (line 993)
2.601 +mask template character, n: See 3.4. (line 1008)
2.602 +mask template character, P: See 3.4. (line 1021)
2.603 +mask template character, p: See 3.4. (line 1013)
2.604 +mask template characters, table of: See 3.4. (line 989)
2.605 +mask, binary: See 4. (line 1073)
2.606 +mask, coarse: See 3.4. (line 718)
2.607 +mask, fine: See 3.4. (line 771)
2.608 +mask, generation: See 3.4. (line 753)
2.609 +mask, input files: See 4.1. (line 1085)
2.610 +mask, load: See 3.4. (line 778)
2.611 +mask, optimization visualization: See 3.4. (line 933)
2.612 +mask, save: See 3.4. (line 887)
2.613 +mask, vectorization distance: See 3.4. (line 784)
2.614 +mask, weight: See 4. (line 1073)
2.615 +masks, understanding: See 4. (line 1073)
2.616 +memory, tuning usage of: See 5. (line 1163)
2.617 +multi-directory TIFF: See 1. (line 73)
2.618 +multi-layer image: See 1. (line 73)
2.619 +nearest-feature transform (NFT): See 3.4. (line 753)
2.620 Octave: See Appendix A.
2.621 - (line 1290)
2.622 -OpenEXR, data format: See 3.2. (line 579)
2.623 -OpenEXR, half precision float: See 3.2. (line 583)
2.624 -optimize seam: See 3.3. (line 799)
2.625 -optimize strategy: See 3.3. (line 812)
2.626 -optimize, anneal parameters: See 3.3. (line 642)
2.627 -optimizer weights: See 3.3. (line 830)
2.628 -optimizer, simulated annealing: See 3.3. (line 642)
2.629 + (line 1320)
2.630 +OpenEXR, data format: See 3.3. (line 609)
2.631 +OpenEXR, half precision float: See 3.3. (line 613)
2.632 +optimize seam: See 3.4. (line 829)
2.633 +optimize strategy: See 3.4. (line 842)
2.634 +optimize, anneal parameters: See 3.4. (line 672)
2.635 +optimizer weights: See 3.4. (line 860)
2.636 +optimizer, simulated annealing: See 3.4. (line 672)
2.637 option index:
2.638 - See ``Option Index''. (line 1916)
2.639 -options, common: See 3.1. (line 307)
2.640 -options, extended: See 3.2. (line 490)
2.641 -options, mask generation: See 3.3. (line 639)
2.642 -output file compression: See 3.1. (line 318)
2.643 -output filename, default: See 3.1. (line 389)
2.644 -output image, set size of: See 3.2. (line 593)
2.645 -overview: See 1. (line 37)
2.646 -packbits compression: See 3.1. (line 343)
2.647 -parallax error: See 2. (line 149)
2.648 -photometric alignment: See 2. (line 141)
2.649 + See ``Option Index''. (line 1946)
2.650 +options, common: See 3.2. (line 337)
2.651 +options, extended: See 3.3. (line 520)
2.652 +options, mask generation: See 3.4. (line 669)
2.653 +output file compression: See 3.2. (line 348)
2.654 +output filename, default: See 3.2. (line 419)
2.655 +output image, set size of: See 3.3. (line 623)
2.656 +overview: See 1. (line 40)
2.657 +packbits compression: See 3.2. (line 373)
2.658 +parallax error: See 2. (line 152)
2.659 +photometric alignment: See 2. (line 144)
2.660 problem reports: See Appendix A.
2.661 - (line 1293)
2.662 -profile, ICC: See 3.2. (line 507)
2.663 + (line 1323)
2.664 +profile, ICC: See 3.3. (line 537)
2.665 program index:
2.666 - See ``Program Index''. (line 1874)
2.667 -programs, helpful additional: See 6. (line 1206)
2.668 -pyramid levels: See 3.1. (line 357)
2.669 -radius, DIJKSTRA: See 3.3. (line 728)
2.670 -raw conversion: See 2. (line 126)
2.671 -response file, force recognition: See 3. (line 281)
2.672 -response file, format: See 3. (line 231)
2.673 -response file, grammar: See 3. (line 245)
2.674 -response files: See 3. (line 183)
2.675 -save mask: See 3.3. (line 857)
2.676 -seam line, loops: See 3.3. (line 784)
2.677 -seam optimization: See 3.3. (line 799)
2.678 -simulated annealing optimizer: See 3.3. (line 642)
2.679 -single precision float, IEEE754: See 3.2. (line 559)
2.680 -smooth difference image: See 3.3. (line 885)
2.681 + See ``Program Index''. (line 1904)
2.682 +programs, helpful additional: See 6. (line 1236)
2.683 +pyramid levels: See 3.2. (line 387)
2.684 +radius, DIJKSTRA: See 3.4. (line 758)
2.685 +raw conversion: See 2. (line 129)
2.686 +response file <1>: See 3.1. (line 193)
2.687 +response file: See 3. (line 186)
2.688 +response file, force recognition of: See 3.1.1. (line 293)
2.689 +response file, format: See 3.1.1. (line 242)
2.690 +response file, grammar: See 3.1.1. (line 256)
2.691 +response file, syntactic comment: See 3.1.2. (line 319)
2.692 +save mask: See 3.4. (line 887)
2.693 +seam line, loops: See 3.4. (line 814)
2.694 +seam optimization: See 3.4. (line 829)
2.695 +simulated annealing optimizer: See 3.4. (line 672)
2.696 +single precision float, IEEE754: See 3.3. (line 589)
2.697 +smooth difference image: See 3.4. (line 915)
2.698 SourceForge <1>: See Appendix A.
2.699 - (line 1296)
2.700 -SourceForge: See 1. (line 76)
2.701 + (line 1326)
2.702 +SourceForge: See 1. (line 79)
2.703 SourceForge, tracker: See Appendix A.
2.704 - (line 1296)
2.705 -sRGB color space: See 3.2. (line 507)
2.706 -TIFF, multi-directory: See 1. (line 70)
2.707 -tiffcopy: See 1. (line 70)
2.708 -tiffsplit: See 1. (line 70)
2.709 -TMPDIR: See 5. (line 1147)
2.710 + (line 1326)
2.711 +sRGB color space: See 3.3. (line 537)
2.712 +syntactic comment, grammar: See 3.1.2. (line 329)
2.713 +syntactic comment, response file: See 3.1.2. (line 319)
2.714 +TIFF, multi-directory: See 1. (line 73)
2.715 +tiffcopy: See 1. (line 73)
2.716 +tiffsplit: See 1. (line 73)
2.717 +TMPDIR: See 5. (line 1177)
2.718 tracker, SourceForge: See Appendix A.
2.719 - (line 1296)
2.720 -transformation, affine: See 2. (line 139)
2.721 -understanding masks: See 4. (line 1043)
2.722 -visualization image: See 3.3. (line 921)
2.723 -visualization image colors: See 3.3. (line 956)
2.724 -visualization of mask optimization: See 3.3. (line 903)
2.725 -weight mask: See 4. (line 1043)
2.726 -weights, optimizer: See 3.3. (line 830)
2.727 -workflow: See 2. (line 91)
2.728 -workflow with Enblend: See 2. (line 102)
2.729 -workflow with Enfuse: See 2. (line 102)
2.730 -wrap around: See 3.1. (line 436)
2.731 + (line 1326)
2.732 +transformation, affine: See 2. (line 142)
2.733 +understanding masks: See 4. (line 1073)
2.734 +visualization image: See 3.4. (line 951)
2.735 +visualization image colors: See 3.4. (line 986)
2.736 +visualization of mask optimization: See 3.4. (line 933)
2.737 +weight mask: See 4. (line 1073)
2.738 +weights, optimizer: See 3.4. (line 860)
2.739 +workflow: See 2. (line 94)
2.740 +workflow with Enblend: See 2. (line 105)
2.741 +workflow with Enfuse: See 2. (line 105)
2.742 +wrap around: See 3.2. (line 466)
3.1 --- a/doc/enblend.texi Sat Nov 07 10:02:29 2009 +0100
3.2 +++ b/doc/enblend.texi Sat Nov 07 10:07:16 2009 +0100
3.3 @@ -226,15 +226,29 @@
3.4 Assemble the sequence of images @var{INPUT}@dots{} into a single
3.5 @var{IMAGE}.
3.6
3.7 -@include filespec.texi
3.8 +@cindex literal filename
3.9 +@cindex filename, literal
3.10 +@cindex response file
3.11 +Input images are either specified literally or via so-called response
3.12 +files (see below). The latter are an alternative to specifying image
3.13 +filenames on the command line.
3.14 +
3.15
3.16 @menu
3.17 +* Response Files:: Files listing the images' names
3.18 * Common Options:: General options
3.19 * Extended Options:: Memory and @acronym{GPU} control
3.20 * Mask Generation Options:: Mask generation control
3.21 @end menu
3.22
3.23
3.24 +@node Response Files
3.25 +@section Response Files
3.26 +@cindex response file
3.27 +
3.28 +@include filespec.texi
3.29 +
3.30 +
3.31 @node Common Options
3.32 @section Common Options
3.33 @cindex options, common
4.1 --- a/doc/enfuse.info Sat Nov 07 10:02:29 2009 +0100
4.2 +++ b/doc/enfuse.info Sat Nov 07 10:07:16 2009 +0100
4.3 @@ -27,11 +27,14 @@
4.4 1 Overview
4.5 2 Workflow
4.6 3 Invocation
4.7 - 3.1 Common Options
4.8 - 3.2 Extended Options
4.9 - 3.3 Fusion Options
4.10 - 3.4 Expert Options
4.11 - 3.5 Option Delimiters
4.12 + 3.1 Response Files
4.13 + 3.1.1 Response File Format
4.14 + 3.1.2 Syntactic Comments
4.15 + 3.2 Common Options
4.16 + 3.3 Extended Options
4.17 + 3.4 Fusion Options
4.18 + 3.5 Expert Options
4.19 + 3.6 Option Delimiters
4.20 4 Weighting Functions
4.21 4.1 Weighting Pixels
4.22 4.1.1 Weighted Average
4.23 @@ -87,7 +90,7 @@
4.24 Enfuse
4.25 ******
4.26
4.27 -This manual is for Enfuse (version 4.0-dd32463fe9de, 5 November 2009),
4.28 +This manual is for Enfuse (version 4.0-dd32463fe9de, 7 November 2009),
4.29 a program to merge different exposures of the same scene to produce an
4.30 image that looks much like a tonemapped image.
4.31
4.32 @@ -282,12 +285,18 @@
4.33 Fuse the sequence of images INPUT... into a single IMAGE.
4.34
4.35 Input images are either specified literally or via so-called response
4.36 -files. A response file contains filenames of images or other response
4.37 -filenames. Introduce response file names with an at-character (`@').
4.38 -
4.39 - Enblend and Enfuse process the list INPUT... from left to right,
4.40 -expanding response files depth-first. The following examples only show
4.41 -Enblend, but Enfuse works exactly the same.
4.42 +files (see below). The latter are an alternative to specifying image
4.43 +filenames on the command line.
4.44 +
4.45 +3.1 Response Files
4.46 +==================
4.47 +
4.48 +A response file contains names of images or other response filenames.
4.49 +Introduce response file names with an at-character (`@').
4.50 +
4.51 + Enblend and Enfuse process the list INPUT strictly from left to
4.52 +right, expanding response files in depth-first order. The following
4.53 +examples only show Enblend, but Enfuse works exactly the same.
4.54
4.55 Solely literal filenames.
4.56 Example:
4.57 @@ -328,12 +337,14 @@
4.58 `image-04.png', `image-05.png', `image-06.png', `image-07.png',
4.59 `image-08.png', `image-09.png', `image-10.png',
4.60
4.61 -
4.62 -*Response File Format* Response files contain one filename per line.
4.63 -Blank lines or lines beginning with a sharp sign (`#') are ignored.
4.64 -Filenames that begin with an at-character (`@') denote other response
4.65 -files. *note Table:response-file-format:: states a formal grammar of
4.66 -response files in EBNF (http://en.wikipedia.org/wiki/Ebnf).
4.67 +3.1.1 Response File Format
4.68 +--------------------------
4.69 +
4.70 +Response files contain one filename per line. Blank lines or lines
4.71 +beginning with a sharp sign (`#') are ignored; the latter can serve as
4.72 +comments. Filenames that begin with an at-character (`@') denote other
4.73 +response files. *note Table:response-file-format:: states a formal
4.74 +grammar of response files in EBNF (http://en.wikipedia.org/wiki/Ebnf).
4.75
4.76 RESPONSE-FILE ::= LINE*
4.77 LINE ::= (COMMENT | FILE-SPEC) [`\r'] `\n'
4.78 @@ -345,20 +356,21 @@
4.79
4.80 Table 3.1: EBNF definition of the grammar of response files.
4.81
4.82 - In a response file all relative filenames are used relative the the
4.83 -response file itself, not relative to the current-working directory of
4.84 -the application.
4.85 + In a response file relative filenames are used relative the response
4.86 +file itself, not relative to the current-working directory of the
4.87 +application.
4.88
4.89 The above grammar might unpleasantly surprise the user in the some ways:
4.90
4.91 Literal filenames
4.92 Inside a response file all filenames are treated as literals. No
4.93 - filename globing or expansion is performed. This is, the line
4.94 + filename globbing or filename expansion is performed. This is, for
4.95 + example, the line
4.96 img_*.tif
4.97 - stands for exactly one file called `img_*.tif'.
4.98 + stands for exactly one file, called `img_*.tif'.
4.99
4.100 Whitespace trimmed at both line ends
4.101 - For convenience whitespace at the beginning and at the end of each
4.102 + For convenience, whitespace at the beginning and at the end of each
4.103 line is ignored. However, this implies that response files cannot
4.104 represent filenames that start or end with whitespace, as there is
4.105 no quoting syntax. Filenames with embedded whitespace cause no
4.106 @@ -366,29 +378,29 @@
4.107
4.108 Only whole-line comments
4.109 Comments in response files always occupy a complete line. There
4.110 - are no line-ending comments. Thus in
4.111 + are no "line-ending comments". Thus, in
4.112 # exposure series
4.113 img-0.33ev.tif # "middle" EV
4.114 img-1.33ev.tif
4.115 img+0.67ev.tif
4.116 only the first line contains a comment, whereas the second lines
4.117 - includes none. Rather it refers to
4.118 - file `img-0.33ev.tif # "middle" EV'.
4.119 + includes none. Rather, it refers to a file called
4.120 + `img-0.33ev.tif # "middle" EV'.
4.121
4.122 Image filenames cannot start with `@'
4.123 - An at-sign always introduces a response file, even if the extension
4.124 - would hint towards an image.
4.125 -
4.126 - If Enblend or Enfuse do not recognize a response file, they will
4.127 -issue a warning. To force a file being recognized as a response file
4.128 -add one of the following syntactic comments to the _first_ line of the
4.129 -file.
4.130 + An at-sign always introduces a response file, even if the
4.131 + filename's extension hints towards an image.
4.132 +
4.133 + If Enblend or Enfuse do not recognize a response file, they will skip
4.134 +the file and issue a warning. To force a file being recognized as a
4.135 +response file add one of the following syntactic comments (see below)
4.136 +to the _first_ line of the file.
4.137
4.138 # response-file: true
4.139 # enblend-response-file: true
4.140 # enfuse-response-file: true
4.141
4.142 -Here is an example of a valid response file.
4.143 +Finally, here is an example of a valid response file.
4.144 # 4\pi panorama!
4.145
4.146 # These pictures were taken with the panorama head.
4.147 @@ -402,7 +414,25 @@
4.148 nadir-5.tif
4.149 nadir.tif
4.150
4.151 -3.1 Common Options
4.152 +3.1.2 Syntactic Comments
4.153 +------------------------
4.154 +
4.155 +Comments that follow the format described in *note
4.156 +Table:response-file-syntactic-comment:: are treated as instructions how
4.157 +to interpret the rest of the response file.
4.158 +
4.159 +SYNTACTIC-COMMENT ::= SPACE* `#' SPACE* KEY SPACE* `:' SPACE*
4.160 + VALUE
4.161 +KEY ::= (`A' .. `Z' | `a' .. `z' | `-')+
4.162 +
4.163 +where VALUE is an arbitrary string.
4.164 +
4.165 +Table 3.2: EBNF definition of the grammar of syntactic comments in
4.166 +response files.
4.167 +
4.168 + Unknown syntactic comments are silently ignored.
4.169 +
4.170 +3.2 Common Options
4.171 ==================
4.172
4.173 Common options control some overall features of Enfuse.
4.174 @@ -574,7 +604,7 @@
4.175 `http://en.wikipedia.org/wiki/Born-von_Karman_boundary_condition',
4.176 BORN-VON KA'RMA'N boundary condition.
4.177
4.178 -3.2 Extended Options
4.179 +3.3 Extended Options
4.180 ====================
4.181
4.182 Extended options control the image cache, the color model, and the
4.183 @@ -711,7 +741,7 @@
4.184 feature for this option to be effective. Find out about extra
4.185 features with `enfuse --version --verbose'.
4.186
4.187 -3.3 Fusion Options
4.188 +3.4 Fusion Options
4.189 ==================
4.190
4.191 Fusion options define the proportion to which each input image's pixel
4.192 @@ -770,7 +800,7 @@
4.193 0 <= WEIGHT <= 1. Saturation weighting is only defined for color
4.194 images. *Note Saturation Weighting::.
4.195
4.196 -3.4 Expert Options
4.197 +3.5 Expert Options
4.198 ==================
4.199
4.200 Expert options influence the workings of Enfuse that require the user
4.201 @@ -1091,10 +1121,10 @@
4.202 `%E'
4.203 Is replaced with the extension of the output file.
4.204
4.205 -Table 3.2: Special characters to control the generation of mask
4.206 +Table 3.3: Special characters to control the generation of mask
4.207 filenames.
4.208
4.209 -3.5 Option Delimiters
4.210 +3.6 Option Delimiters
4.211 =====================
4.212
4.213 Enfuse allows the arguments supplied to the program's options to be
4.214 @@ -3136,15 +3166,16 @@
4.215 **************
4.216
4.217 Table 1.1: Weighting criteria See 1.
4.218 -Table 3.1: Response-file grammar See 3.
4.219 -Table 3.2: Mask template characters See 3.4.
4.220 +Table 3.1: Grammar of response files See 3.1.1.
4.221 +Table 3.2: Grammar of syntactic comments See 3.1.2.
4.222 +Table 3.3: Mask template characters See 3.5.
4.223 Table 6.1: Suggested cache-size settings See 6.
4.224
4.225 List of Figures
4.226 ***************
4.227
4.228 Figure 2.1: Photographic workflow with ... See 2.
4.229 -Figure 3.1: Entropy cutoff function See 3.4.
4.230 +Figure 3.1: Entropy cutoff function See 3.5.
4.231 Figure 4.1: Gaussian function See 4.2.
4.232 Figure 4.2: Local analysis window See 4.4.1.
4.233 Figure 4.3: Laplacian-of-Gaussian See 4.4.2.
4.234 @@ -3156,338 +3187,343 @@
4.235 Program Index
4.236 *************
4.237
4.238 -ale: See 8. (line 2484)
4.239 -align_image_stack (Hugin): See 8. (line 2491)
4.240 -cinepaint <1>: See 8. (line 2503)
4.241 -cinepaint: See 3.2. (line 695)
4.242 -convert (ImageMagick): See 8. (line 2514)
4.243 -dcraw <1>: See 8. (line 2474)
4.244 -dcraw: See 2. (line 203)
4.245 -display (ImageMagick): See 8. (line 2514)
4.246 -exiftool: See 8. (line 2542)
4.247 -exrdisplay (OpenEXR): See 8. (line 2520)
4.248 -fulla (Hugin): See 8. (line 2491)
4.249 -gimp <1>: See 8. (line 2510)
4.250 -gimp <2>: See 3.2. (line 695)
4.251 -gimp: See 2. (line 203)
4.252 -gm (GraphicsMagick): See 8. (line 2514)
4.253 -hugin <1>: See 8. (line 2488)
4.254 -hugin <2>: See 7.1. (line 1864)
4.255 -hugin <3>: See 3.2. (line 686)
4.256 -hugin: See 2. (line 203)
4.257 -identify (ImageMagick) <1>: See 8. (line 2514)
4.258 -identify (ImageMagick): See 5.1. (line 1703)
4.259 -montage (ImageMagick): See 8. (line 2514)
4.260 -nona (Hugin) <1>: See 8. (line 2491)
4.261 -nona (Hugin): See 3.2. (line 686)
4.262 -PanoTools: See 2. (line 203)
4.263 -pfshdrcalibrate (PFScalibration): See 8. (line 2523)
4.264 -pfsin (PFSTools): See 8. (line 2523)
4.265 -pfsout (PFSTools): See 8. (line 2523)
4.266 -pfstmo_* (PFStmo): See 8. (line 2523)
4.267 -pfsview (PFSTools): See 8. (line 2523)
4.268 -PTmender (PanoTools): See 8. (line 2496)
4.269 -PTOptimizer (PanoTools): See 8. (line 2496)
4.270 -tifficc (LittleCMS): See 8. (line 2546)
4.271 -tiffinfo (libtiff) <1>: See 8. (line 2538)
4.272 -tiffinfo (libtiff): See 5.1. (line 1703)
4.273 -ufraw <1>: See 8. (line 2477)
4.274 -ufraw: See 2. (line 203)
4.275 -ufraw-batch: See 8. (line 2477)
4.276 +ale: See 8. (line 2514)
4.277 +align_image_stack (Hugin): See 8. (line 2521)
4.278 +cinepaint <1>: See 8. (line 2533)
4.279 +cinepaint: See 3.3. (line 725)
4.280 +convert (ImageMagick): See 8. (line 2544)
4.281 +dcraw <1>: See 8. (line 2504)
4.282 +dcraw: See 2. (line 206)
4.283 +display (ImageMagick): See 8. (line 2544)
4.284 +exiftool: See 8. (line 2572)
4.285 +exrdisplay (OpenEXR): See 8. (line 2550)
4.286 +fulla (Hugin): See 8. (line 2521)
4.287 +gimp <1>: See 8. (line 2540)
4.288 +gimp <2>: See 3.3. (line 725)
4.289 +gimp: See 2. (line 206)
4.290 +gm (GraphicsMagick): See 8. (line 2544)
4.291 +hugin <1>: See 8. (line 2518)
4.292 +hugin <2>: See 7.1. (line 1894)
4.293 +hugin <3>: See 3.3. (line 716)
4.294 +hugin: See 2. (line 206)
4.295 +identify (ImageMagick) <1>: See 8. (line 2544)
4.296 +identify (ImageMagick): See 5.1. (line 1733)
4.297 +montage (ImageMagick): See 8. (line 2544)
4.298 +nona (Hugin) <1>: See 8. (line 2521)
4.299 +nona (Hugin): See 3.3. (line 716)
4.300 +PanoTools: See 2. (line 206)
4.301 +pfshdrcalibrate (PFScalibration): See 8. (line 2553)
4.302 +pfsin (PFSTools): See 8. (line 2553)
4.303 +pfsout (PFSTools): See 8. (line 2553)
4.304 +pfstmo_* (PFStmo): See 8. (line 2553)
4.305 +pfsview (PFSTools): See 8. (line 2553)
4.306 +PTmender (PanoTools): See 8. (line 2526)
4.307 +PTOptimizer (PanoTools): See 8. (line 2526)
4.308 +tifficc (LittleCMS): See 8. (line 2576)
4.309 +tiffinfo (libtiff) <1>: See 8. (line 2568)
4.310 +tiffinfo (libtiff): See 5.1. (line 1733)
4.311 +ufraw <1>: See 8. (line 2507)
4.312 +ufraw: See 2. (line 206)
4.313 +ufraw-batch: See 8. (line 2507)
4.314 Option Index
4.315 ************
4.316
4.317 ---compression: See 3.1. (line 411)
4.318 ---contrast-edge-scale: See 3.4. (line 800)
4.319 ---contrast-min-curvature: See 3.4. (line 973)
4.320 ---contrast-weight: See 3.3. (line 721)
4.321 ---contrast-window-size: See 3.4. (line 780)
4.322 ---ContrastWindowSize (deprecated): See 3.4. (line 780)
4.323 ---depth: See 3.2. (line 606)
4.324 ---EdgeScale (deprecated): See 3.4. (line 800)
4.325 ---entropy-cutoff: See 3.4. (line 821)
4.326 ---entropy-weight: See 3.3. (line 728)
4.327 ---entropy-window-size: See 3.4. (line 886)
4.328 ---EntropyCutoff (deprecated): See 3.4. (line 821)
4.329 ---EntropyWindowSize (deprecated): See 3.4. (line 886)
4.330 ---exposure-mu: See 3.3. (line 744)
4.331 ---exposure-sigma: See 3.3. (line 754)
4.332 ---exposure-weight: See 3.3. (line 736)
4.333 ---gray-projector: See 3.4. (line 902)
4.334 ---GrayProjector (deprecated): See 3.4. (line 902)
4.335 ---hard-mask <1>: See 7.6.6. (line 2452)
4.336 ---hard-mask <2>: See 4.1.2. (line 1200)
4.337 ---hard-mask: See 3.4. (line 959)
4.338 ---HardMask (deprecated): See 3.4. (line 959)
4.339 ---help: See 3.1. (line 448)
4.340 ---MinCurvature (deprecated): See 3.4. (line 973)
4.341 ---output: See 3.1. (line 481)
4.342 ---saturation-weight: See 3.3. (line 765)
4.343 ---save-masks: See 3.4. (line 991)
4.344 ---SaveMasks (deprecated): See 3.4. (line 991)
4.345 ---soft-mask: See 3.4. (line 1019)
4.346 ---SoftMask (deprecated): See 3.4. (line 1019)
4.347 ---verbose: See 3.1. (line 488)
4.348 ---version: See 3.1. (line 523)
4.349 ---wContrast (deprecated): See 3.3. (line 721)
4.350 ---wEntropy (deprecated): See 3.3. (line 728)
4.351 ---wExposureMu (deprecated): See 3.3. (line 736)
4.352 ---wExposureSigma (deprecated): See 3.3. (line 754)
4.353 ---wrap: See 3.1. (line 530)
4.354 ---wSaturation (deprecated): See 3.3. (line 765)
4.355 --b <1>: See 6. (line 1777)
4.356 --b: See 3.2. (line 584)
4.357 --c: See 3.2. (line 595)
4.358 --d: See 3.2. (line 606)
4.359 --f: See 3.2. (line 683)
4.360 --g: See 3.2. (line 691)
4.361 --h: See 3.1. (line 448)
4.362 --l: See 3.1. (line 451)
4.363 --m <1>: See 6. (line 1777)
4.364 --m: See 3.2. (line 703)
4.365 --o: See 3.1. (line 481)
4.366 --V: See 3.1. (line 523)
4.367 --v: See 3.1. (line 488)
4.368 --w: See 3.1. (line 530)
4.369 +--compression: See 3.2. (line 441)
4.370 +--contrast-edge-scale: See 3.5. (line 830)
4.371 +--contrast-min-curvature: See 3.5. (line 1003)
4.372 +--contrast-weight: See 3.4. (line 751)
4.373 +--contrast-window-size: See 3.5. (line 810)
4.374 +--ContrastWindowSize (deprecated): See 3.5. (line 810)
4.375 +--depth: See 3.3. (line 636)
4.376 +--EdgeScale (deprecated): See 3.5. (line 830)
4.377 +--entropy-cutoff: See 3.5. (line 851)
4.378 +--entropy-weight: See 3.4. (line 758)
4.379 +--entropy-window-size: See 3.5. (line 916)
4.380 +--EntropyCutoff (deprecated): See 3.5. (line 851)
4.381 +--EntropyWindowSize (deprecated): See 3.5. (line 916)
4.382 +--exposure-mu: See 3.4. (line 774)
4.383 +--exposure-sigma: See 3.4. (line 784)
4.384 +--exposure-weight: See 3.4. (line 766)
4.385 +--gray-projector: See 3.5. (line 932)
4.386 +--GrayProjector (deprecated): See 3.5. (line 932)
4.387 +--hard-mask <1>: See 7.6.6. (line 2482)
4.388 +--hard-mask <2>: See 4.1.2. (line 1230)
4.389 +--hard-mask: See 3.5. (line 989)
4.390 +--HardMask (deprecated): See 3.5. (line 989)
4.391 +--help: See 3.2. (line 478)
4.392 +--MinCurvature (deprecated): See 3.5. (line 1003)
4.393 +--output: See 3.2. (line 511)
4.394 +--saturation-weight: See 3.4. (line 795)
4.395 +--save-masks: See 3.5. (line 1021)
4.396 +--SaveMasks (deprecated): See 3.5. (line 1021)
4.397 +--soft-mask: See 3.5. (line 1049)
4.398 +--SoftMask (deprecated): See 3.5. (line 1049)
4.399 +--verbose: See 3.2. (line 518)
4.400 +--version: See 3.2. (line 553)
4.401 +--wContrast (deprecated): See 3.4. (line 751)
4.402 +--wEntropy (deprecated): See 3.4. (line 758)
4.403 +--wExposureMu (deprecated): See 3.4. (line 766)
4.404 +--wExposureSigma (deprecated): See 3.4. (line 784)
4.405 +--wrap: See 3.2. (line 560)
4.406 +--wSaturation (deprecated): See 3.4. (line 795)
4.407 +-b <1>: See 6. (line 1807)
4.408 +-b: See 3.3. (line 614)
4.409 +-c: See 3.3. (line 625)
4.410 +-d: See 3.3. (line 636)
4.411 +-f: See 3.3. (line 713)
4.412 +-g: See 3.3. (line 721)
4.413 +-h: See 3.2. (line 478)
4.414 +-l: See 3.2. (line 481)
4.415 +-m <1>: See 6. (line 1807)
4.416 +-m: See 3.3. (line 733)
4.417 +-o: See 3.2. (line 511)
4.418 +-V: See 3.2. (line 553)
4.419 +-v: See 3.2. (line 518)
4.420 +-w: See 3.2. (line 560)
4.421 General Index
4.422 *************
4.423
4.424 -360o panoramas: See 3.1. (line 530)
4.425 -a.tif: See 3.1. (line 483)
4.426 -advanced focus stacking: See 7.6.5. (line 2199)
4.427 +360o panoramas: See 3.2. (line 560)
4.428 +a.tif: See 3.2. (line 513)
4.429 +advanced focus stacking: See 7.6.5. (line 2229)
4.430 advanced focus stacking, recognizing faint edges:See 7.6.5.4.
4.431 - (line 2357)
4.432 -advanced focus stacking, suppressing noise: See 7.6.5.4. (line 2357)
4.433 -affine transformation: See 2. (line 240)
4.434 -alpha channel <1>: See 2. (line 261)
4.435 -alpha channel: See 1. (line 155)
4.436 -alpha channel, associated: See 3.2. (line 691)
4.437 -aperture, sweet spot: See 7.6.1. (line 2108)
4.438 -applications of enfuse: See 7. (line 1850)
4.439 + (line 2387)
4.440 +advanced focus stacking, suppressing noise: See 7.6.5.4. (line 2387)
4.441 +affine transformation: See 2. (line 243)
4.442 +alpha channel <1>: See 2. (line 264)
4.443 +alpha channel: See 1. (line 158)
4.444 +alpha channel, associated: See 3.3. (line 721)
4.445 +aperture, sweet spot: See 7.6.1. (line 2138)
4.446 +applications of enfuse: See 7. (line 1880)
4.447 authors, list of: See Appendix B.
4.448 - (line 2701)
4.449 -average, disabling: See 4.1.2. (line 1200)
4.450 -average, weighted: See 4.1.1. (line 1188)
4.451 -basic focus stacking: See 7.6.4. (line 2171)
4.452 -binary mask: See 5. (line 1687)
4.453 -bits per channel: See 3.2. (line 606)
4.454 -blending exposures: See 7.3.2. (line 2026)
4.455 + (line 2731)
4.456 +average, disabling: See 4.1.2. (line 1230)
4.457 +average, weighted: See 4.1.1. (line 1218)
4.458 +basic focus stacking: See 7.6.4. (line 2201)
4.459 +binary mask: See 5. (line 1717)
4.460 +bits per channel: See 3.3. (line 636)
4.461 +blending exposures: See 7.3.2. (line 2056)
4.462 bug reports: See Appendix A.
4.463 - (line 2554)
4.464 -Burt-Adelson multiresolution spline: See 1. (line 112)
4.465 -channel width: See 3.2. (line 606)
4.466 -channel, alpha: See 1. (line 155)
4.467 -CIECAM02: See 3.2. (line 595)
4.468 -circle-of-confusion: See 7.6.1. (line 2096)
4.469 -color appearance model: See 3.2. (line 595)
4.470 -color space, sRGB: See 3.2. (line 597)
4.471 -compression: See 3.1. (line 411)
4.472 -compression, deflate: See 3.1. (line 426)
4.473 -compression, JPEG: See 3.1. (line 417)
4.474 -compression, LZW: See 3.1. (line 432)
4.475 -compression, packbits: See 3.1. (line 436)
4.476 -contrast enhancement, local: See 7.6.5.3. (line 2336)
4.477 -contrast weighting using a blend of methods: See 4.4.3. (line 1536)
4.478 -contrast weighting using laplacian-of-gaussian:See 4.4.2. (line 1438)
4.479 -contrast weighting using standard deviation: See 4.4.1. (line 1369)
4.480 -conversion, L*a*b*: See 3.4. (line 933)
4.481 -conversion, raw: See 2. (line 227)
4.482 -dark frame: See 7.6.6. (line 2448)
4.483 -decision tree, focus stacking: See 7.6.5.5. (line 2413)
4.484 -default output filename: See 3.1. (line 483)
4.485 -deflate compression: See 3.1. (line 426)
4.486 -delimiters, option: See 3.5. (line 1100)
4.487 -depth-of-field: See 7.6.1. (line 2099)
4.488 -depth-of-focus increase: See 7.6. (line 2080)
4.489 -digital blending: See 7.3.2. (line 2026)
4.490 -disabling average: See 4.1.2. (line 1200)
4.491 -double precision float, IEEE754: See 3.2. (line 658)
4.492 -dynamic range increase <1>: See 7.4. (line 2064)
4.493 -dynamic range increase: See 7.3. (line 1961)
4.494 -edge detection, laplacian: See 7.6.5.2. (line 2316)
4.495 -entropy: See 4.5. (line 1597)
4.496 -entropy, definition: See 4.5. (line 1594)
4.497 -estimators: See 4.4.1.2. (line 1419)
4.498 -expectation value: See 4.4.1.1. (line 1403)
4.499 -expert focus stacking tips: See 7.6.6. (line 2436)
4.500 -exposure series: See 7.3. (line 1961)
4.501 -exposure series, common misconceptions: See 7.3.2. (line 2023)
4.502 -exposure series, tips for beginners: See 7.3.1. (line 1999)
4.503 -filename template: See 3.4. (line 996)
4.504 -filenames, literal: See 3. (line 284)
4.505 -flash exposure series: See 7.4. (line 2064)
4.506 -focus stacking decision tree: See 7.6.5.5. (line 2413)
4.507 -focus stacking, advanced: See 7.6.5. (line 2199)
4.508 -focus stacking, basic: See 7.6.4. (line 2171)
4.509 -focus stacks: See 7.6. (line 2080)
4.510 -focus stacks, fusing: See 7.6.3. (line 2133)
4.511 -focus stacks, preparation: See 7.6.2. (line 2119)
4.512 -focus stacks, why create them: See 7.6.1. (line 2090)
4.513 -format of response files: See 3. (line 332)
4.514 + (line 2584)
4.515 +Burt-Adelson multiresolution spline: See 1. (line 115)
4.516 +channel width: See 3.3. (line 636)
4.517 +channel, alpha: See 1. (line 158)
4.518 +CIECAM02: See 3.3. (line 625)
4.519 +circle-of-confusion: See 7.6.1. (line 2126)
4.520 +color appearance model: See 3.3. (line 625)
4.521 +color space, sRGB: See 3.3. (line 627)
4.522 +compression: See 3.2. (line 441)
4.523 +compression, deflate: See 3.2. (line 456)
4.524 +compression, JPEG: See 3.2. (line 447)
4.525 +compression, LZW: See 3.2. (line 462)
4.526 +compression, packbits: See 3.2. (line 466)
4.527 +contrast enhancement, local: See 7.6.5.3. (line 2366)
4.528 +contrast weighting using a blend of methods: See 4.4.3. (line 1566)
4.529 +contrast weighting using laplacian-of-gaussian:See 4.4.2. (line 1468)
4.530 +contrast weighting using standard deviation: See 4.4.1. (line 1399)
4.531 +conversion, L*a*b*: See 3.5. (line 963)
4.532 +conversion, raw: See 2. (line 230)
4.533 +dark frame: See 7.6.6. (line 2478)
4.534 +decision tree, focus stacking: See 7.6.5.5. (line 2443)
4.535 +default output filename: See 3.2. (line 513)
4.536 +deflate compression: See 3.2. (line 456)
4.537 +delimiters, option: See 3.6. (line 1130)
4.538 +depth-of-field: See 7.6.1. (line 2129)
4.539 +depth-of-focus increase: See 7.6. (line 2110)
4.540 +digital blending: See 7.3.2. (line 2056)
4.541 +disabling average: See 4.1.2. (line 1230)
4.542 +double precision float, IEEE754: See 3.3. (line 688)
4.543 +dynamic range increase <1>: See 7.4. (line 2094)
4.544 +dynamic range increase: See 7.3. (line 1991)
4.545 +edge detection, laplacian: See 7.6.5.2. (line 2346)
4.546 +entropy: See 4.5. (line 1627)
4.547 +entropy, definition: See 4.5. (line 1624)
4.548 +estimators: See 4.4.1.2. (line 1449)
4.549 +expectation value: See 4.4.1.1. (line 1433)
4.550 +expert focus stacking tips: See 7.6.6. (line 2466)
4.551 +exposure series: See 7.3. (line 1991)
4.552 +exposure series, common misconceptions: See 7.3.2. (line 2053)
4.553 +exposure series, tips for beginners: See 7.3.1. (line 2029)
4.554 +filename template: See 3.5. (line 1026)
4.555 +filename, literal: See 3. (line 287)
4.556 +flash exposure series: See 7.4. (line 2094)
4.557 +focus stacking decision tree: See 7.6.5.5. (line 2443)
4.558 +focus stacking, advanced: See 7.6.5. (line 2229)
4.559 +focus stacking, basic: See 7.6.4. (line 2201)
4.560 +focus stacks: See 7.6. (line 2110)
4.561 +focus stacks, fusing: See 7.6.3. (line 2163)
4.562 +focus stacks, preparation: See 7.6.2. (line 2149)
4.563 +focus stacks, why create them: See 7.6.1. (line 2120)
4.564 +format of response file: See 3.1.1. (line 343)
4.565 free documentation license (FDL): See Appendix C.
4.566 - (line 2740)
4.567 -fusing, local-contrast-based: See 7.6.3. (line 2133)
4.568 + (line 2770)
4.569 +fusing, local-contrast-based: See 7.6.3. (line 2163)
4.570 general index:
4.571 - See ``General Index''. (line 3255)
4.572 + See ``General Index''. (line 3286)
4.573 GNU free documentation license: See Appendix C.
4.574 - (line 2740)
4.575 -grammar, response file: See 3. (line 346)
4.576 -gray projector: See 3.4. (line 902)
4.577 -gray projector, average: See 3.4. (line 913)
4.578 -gray projector, channel-mixer: See 3.4. (line 919)
4.579 -gray projector, l-star: See 3.4. (line 933)
4.580 -gray projector, lightness: See 3.4. (line 943)
4.581 -gray projector, luminance: See 3.4. (line 948)
4.582 -gray projector, value: See 3.4. (line 954)
4.583 -half precision float, OpenEXR: See 3.2. (line 673)
4.584 -helpful programs: See 8. (line 2470)
4.585 -hot pixels: See 7.6.6. (line 2448)
4.586 -Hugin: See A.2. (line 2644)
4.587 -ICC profile: See 3.2. (line 597)
4.588 -IEEE754 double precision float: See 3.2. (line 658)
4.589 -IEEE754 single precision float: See 3.2. (line 649)
4.590 -image cache: See 6. (line 1780)
4.591 -image cache, block size: See 3.2. (line 584)
4.592 -image cache, cache size: See 3.2. (line 703)
4.593 -image cache, location: See 6. (line 1791)
4.594 -image, multi-layer: See 1. (line 163)
4.595 -images, fusable: See 7.1. (line 1857)
4.596 + (line 2770)
4.597 +grammar, response file: See 3.1.1. (line 357)
4.598 +grammar, syntactic comment: See 3.1.2. (line 430)
4.599 +gray projector: See 3.5. (line 932)
4.600 +gray projector, average: See 3.5. (line 943)
4.601 +gray projector, channel-mixer: See 3.5. (line 949)
4.602 +gray projector, l-star: See 3.5. (line 963)
4.603 +gray projector, lightness: See 3.5. (line 973)
4.604 +gray projector, luminance: See 3.5. (line 978)
4.605 +gray projector, value: See 3.5. (line 984)
4.606 +half precision float, OpenEXR: See 3.3. (line 703)
4.607 +helpful programs: See 8. (line 2500)
4.608 +hot pixels: See 7.6.6. (line 2478)
4.609 +Hugin: See A.2. (line 2674)
4.610 +ICC profile: See 3.3. (line 627)
4.611 +IEEE754 double precision float: See 3.3. (line 688)
4.612 +IEEE754 single precision float: See 3.3. (line 679)
4.613 +image cache: See 6. (line 1810)
4.614 +image cache, block size: See 3.3. (line 614)
4.615 +image cache, cache size: See 3.3. (line 733)
4.616 +image cache, location: See 6. (line 1821)
4.617 +image, multi-layer: See 1. (line 166)
4.618 +images, fusable: See 7.1. (line 1887)
4.619 index, general:
4.620 - See ``General Index''. (line 3255)
4.621 + See ``General Index''. (line 3286)
4.622 index, option:
4.623 - See ``Option Index''. (line 3200)
4.624 + See ``Option Index''. (line 3231)
4.625 index, program:
4.626 - See ``Program Index''. (line 3159)
4.627 -input mask: See 5.1. (line 1699)
4.628 -invocation: See 3. (line 280)
4.629 -JPEG compression: See 3.1. (line 417)
4.630 -KImageFuser: See A.2. (line 2644)
4.631 -L*a*b* conversion: See 3.4. (line 933)
4.632 -laplacian edge detection: See 7.6.5.2. (line 2316)
4.633 -Laplacian of Gaussian (LoG): See 4.4.2. (line 1438)
4.634 -lens distortion, correction of: See 2. (line 240)
4.635 -levels, pyramid: See 3.1. (line 451)
4.636 -LibJPEG: See 8. (line 2527)
4.637 -LibPNG: See 8. (line 2530)
4.638 -LibTiff: See 8. (line 2534)
4.639 -light probe: See 7.3.2. (line 2045)
4.640 -literal filenames: See 3. (line 284)
4.641 -local analysis window: See 4.4.1. (line 1369)
4.642 -local contrast enhancement: See 7.6.5.3. (line 2336)
4.643 -local contrast problem: See 7.6.5.1. (line 2206)
4.644 -local-contrast-based fusing: See 7.6.3. (line 2133)
4.645 -LZW compression: See 3.1. (line 432)
4.646 -mask template character, %: See 3.4. (line 1024)
4.647 -mask template character, B: See 3.4. (line 1073)
4.648 -mask template character, b: See 3.4. (line 1067)
4.649 -mask template character, D: See 3.4. (line 1064)
4.650 -mask template character, d: See 3.4. (line 1058)
4.651 -mask template character, E: See 3.4. (line 1092)
4.652 -mask template character, e: See 3.4. (line 1086)
4.653 -mask template character, F: See 3.4. (line 1082)
4.654 -mask template character, f: See 3.4. (line 1076)
4.655 -mask template character, i: See 3.4. (line 1027)
4.656 -mask template character, n: See 3.4. (line 1042)
4.657 -mask template character, P: See 3.4. (line 1055)
4.658 -mask template character, p: See 3.4. (line 1047)
4.659 -mask template characters, table of: See 3.4. (line 1023)
4.660 -mask, binary: See 5. (line 1687)
4.661 -mask, filename template: See 3.4. (line 996)
4.662 -mask, input files: See 5.1. (line 1699)
4.663 -mask, saving: See 3.4. (line 993)
4.664 -mask, weight: See 5. (line 1687)
4.665 -masks, understanding: See 5. (line 1687)
4.666 -memory, tuning usage of: See 6. (line 1777)
4.667 -Mertens-Kautz-Van Reeth exposure fusion: See 1. (line 97)
4.668 -mode of operation (SDev, LoG, ...): See 4.4.4. (line 1578)
4.669 -multi-directory TIFF: See 1. (line 163)
4.670 -multi-layer image: See 1. (line 163)
4.671 -natural sharp-unsharp transition: See 7.6.6. (line 2463)
4.672 -noise reduction: See 7.2. (line 1939)
4.673 + See ``Program Index''. (line 3190)
4.674 +input mask: See 5.1. (line 1729)
4.675 +invocation: See 3. (line 283)
4.676 +JPEG compression: See 3.2. (line 447)
4.677 +KImageFuser: See A.2. (line 2674)
4.678 +L*a*b* conversion: See 3.5. (line 963)
4.679 +laplacian edge detection: See 7.6.5.2. (line 2346)
4.680 +Laplacian of Gaussian (LoG): See 4.4.2. (line 1468)
4.681 +lens distortion, correction of: See 2. (line 243)
4.682 +levels, pyramid: See 3.2. (line 481)
4.683 +LibJPEG: See 8. (line 2557)
4.684 +LibPNG: See 8. (line 2560)
4.685 +LibTiff: See 8. (line 2564)
4.686 +light probe: See 7.3.2. (line 2075)
4.687 +literal filename: See 3. (line 287)
4.688 +local analysis window: See 4.4.1. (line 1399)
4.689 +local contrast enhancement: See 7.6.5.3. (line 2366)
4.690 +local contrast problem: See 7.6.5.1. (line 2236)
4.691 +local-contrast-based fusing: See 7.6.3. (line 2163)
4.692 +LZW compression: See 3.2. (line 462)
4.693 +mask template character, %: See 3.5. (line 1054)
4.694 +mask template character, B: See 3.5. (line 1103)
4.695 +mask template character, b: See 3.5. (line 1097)
4.696 +mask template character, D: See 3.5. (line 1094)
4.697 +mask template character, d: See 3.5. (line 1088)
4.698 +mask template character, E: See 3.5. (line 1122)
4.699 +mask template character, e: See 3.5. (line 1116)
4.700 +mask template character, F: See 3.5. (line 1112)
4.701 +mask template character, f: See 3.5. (line 1106)
4.702 +mask template character, i: See 3.5. (line 1057)
4.703 +mask template character, n: See 3.5. (line 1072)
4.704 +mask template character, P: See 3.5. (line 1085)
4.705 +mask template character, p: See 3.5. (line 1077)
4.706 +mask template characters, table of: See 3.5. (line 1053)
4.707 +mask, binary: See 5. (line 1717)
4.708 +mask, filename template: See 3.5. (line 1026)
4.709 +mask, input files: See 5.1. (line 1729)
4.710 +mask, saving: See 3.5. (line 1023)
4.711 +mask, weight: See 5. (line 1717)
4.712 +masks, understanding: See 5. (line 1717)
4.713 +memory, tuning usage of: See 6. (line 1807)
4.714 +Mertens-Kautz-Van Reeth exposure fusion: See 1. (line 100)
4.715 +mode of operation (SDev, LoG, ...): See 4.4.4. (line 1608)
4.716 +multi-directory TIFF: See 1. (line 166)
4.717 +multi-layer image: See 1. (line 166)
4.718 +natural sharp-unsharp transition: See 7.6.6. (line 2493)
4.719 +noise reduction: See 7.2. (line 1969)
4.720 Octave: See Appendix A.
4.721 - (line 2554)
4.722 -OpenEXR, data format: See 3.2. (line 669)
4.723 -OpenEXR, half precision float: See 3.2. (line 673)
4.724 -option delimiters: See 3.5. (line 1100)
4.725 + (line 2584)
4.726 +OpenEXR, data format: See 3.3. (line 699)
4.727 +OpenEXR, half precision float: See 3.3. (line 703)
4.728 +option delimiters: See 3.6. (line 1130)
4.729 option index:
4.730 - See ``Option Index''. (line 3200)
4.731 -options, common: See 3.1. (line 408)
4.732 -options, expert: See 3.4. (line 776)
4.733 -options, extended: See 3.2. (line 580)
4.734 -options, fusion: See 3.3. (line 717)
4.735 -output file compression: See 3.1. (line 411)
4.736 -output filename, default: See 3.1. (line 483)
4.737 -output image, set size of: See 3.2. (line 683)
4.738 -overview: See 1. (line 97)
4.739 -packbits compression: See 3.1. (line 436)
4.740 -parallax error: See 2. (line 250)
4.741 -photometric alignment: See 2. (line 242)
4.742 -pixels, hot: See 7.6.6. (line 2448)
4.743 -polarization series: See 7.5. (line 2071)
4.744 -probability function: See 4.4.1.1. (line 1400)
4.745 + See ``Option Index''. (line 3231)
4.746 +options, common: See 3.2. (line 438)
4.747 +options, expert: See 3.5. (line 806)
4.748 +options, extended: See 3.3. (line 610)
4.749 +options, fusion: See 3.4. (line 747)
4.750 +output file compression: See 3.2. (line 441)
4.751 +output filename, default: See 3.2. (line 513)
4.752 +output image, set size of: See 3.3. (line 713)
4.753 +overview: See 1. (line 100)
4.754 +packbits compression: See 3.2. (line 466)
4.755 +parallax error: See 2. (line 253)
4.756 +photometric alignment: See 2. (line 245)
4.757 +pixels, hot: See 7.6.6. (line 2478)
4.758 +polarization series: See 7.5. (line 2101)
4.759 +probability function: See 4.4.1.1. (line 1430)
4.760 problem reports: See Appendix A.
4.761 - (line 2557)
4.762 -problem, local contrast: See 7.6.5.1. (line 2206)
4.763 -profile, ICC: See 3.2. (line 597)
4.764 + (line 2587)
4.765 +problem, local contrast: See 7.6.5.1. (line 2236)
4.766 +profile, ICC: See 3.3. (line 627)
4.767 program index:
4.768 - See ``Program Index''. (line 3159)
4.769 -programs, helpful additional: See 8. (line 2470)
4.770 -pyramid levels: See 3.1. (line 451)
4.771 -raw conversion: See 2. (line 227)
4.772 -response file, force recognition: See 3. (line 382)
4.773 -response file, format: See 3. (line 332)
4.774 -response file, grammar: See 3. (line 346)
4.775 -response files: See 3. (line 284)
4.776 -saturation enhancement: See 7.5. (line 2071)
4.777 -scaling of parameters: See 4.4.4. (line 1578)
4.778 -sensor, use of clean: See 7.6.6. (line 2439)
4.779 -series, exposure: See 7.3. (line 1961)
4.780 -series, flash exposure: See 7.4. (line 2064)
4.781 -series, polarization: See 7.5. (line 2071)
4.782 -series, simple: See 7.2. (line 1939)
4.783 -simple series: See 7.2. (line 1939)
4.784 -single precision float, IEEE754: See 3.2. (line 649)
4.785 + See ``Program Index''. (line 3190)
4.786 +programs, helpful additional: See 8. (line 2500)
4.787 +pyramid levels: See 3.2. (line 481)
4.788 +raw conversion: See 2. (line 230)
4.789 +response file <1>: See 3.1. (line 294)
4.790 +response file: See 3. (line 287)
4.791 +response file, force recognition of: See 3.1.1. (line 394)
4.792 +response file, format: See 3.1.1. (line 343)
4.793 +response file, grammar: See 3.1.1. (line 357)
4.794 +response file, syntactic comment: See 3.1.2. (line 420)
4.795 +saturation enhancement: See 7.5. (line 2101)
4.796 +scaling of parameters: See 4.4.4. (line 1608)
4.797 +sensor, use of clean: See 7.6.6. (line 2469)
4.798 +series, exposure: See 7.3. (line 1991)
4.799 +series, flash exposure: See 7.4. (line 2094)
4.800 +series, polarization: See 7.5. (line 2101)
4.801 +series, simple: See 7.2. (line 1969)
4.802 +simple series: See 7.2. (line 1969)
4.803 +single precision float, IEEE754: See 3.3. (line 679)
4.804 SourceForge <1>: See Appendix A.
4.805 - (line 2560)
4.806 -SourceForge: See 1. (line 169)
4.807 + (line 2590)
4.808 +SourceForge: See 1. (line 172)
4.809 SourceForge, tracker: See Appendix A.
4.810 - (line 2560)
4.811 -sRGB color space: See 3.2. (line 597)
4.812 -standard deviation: See 4.4.1.1. (line 1409)
4.813 -statistical moments: See 4.4.1.1. (line 1400)
4.814 -subtraction of dark frame: See 7.6.6. (line 2448)
4.815 -sweet spot aperture: See 7.6.1. (line 2108)
4.816 -TIFF, multi-directory: See 1. (line 163)
4.817 -tiffcopy: See 1. (line 163)
4.818 -tiffsplit: See 1. (line 163)
4.819 -tips, focus stacking experts: See 7.6.6. (line 2436)
4.820 -TMPDIR: See 6. (line 1791)
4.821 + (line 2590)
4.822 +sRGB color space: See 3.3. (line 627)
4.823 +standard deviation: See 4.4.1.1. (line 1439)
4.824 +statistical moments: See 4.4.1.1. (line 1430)
4.825 +subtraction of dark frame: See 7.6.6. (line 2478)
4.826 +sweet spot aperture: See 7.6.1. (line 2138)
4.827 +syntactic comment, grammar: See 3.1.2. (line 430)
4.828 +syntactic comment, response file: See 3.1.2. (line 420)
4.829 +TIFF, multi-directory: See 1. (line 166)
4.830 +tiffcopy: See 1. (line 166)
4.831 +tiffsplit: See 1. (line 166)
4.832 +tips, focus stacking experts: See 7.6.6. (line 2466)
4.833 +TMPDIR: See 6. (line 1821)
4.834 tracker, SourceForge: See Appendix A.
4.835 - (line 2560)
4.836 -transformation, affine: See 2. (line 240)
4.837 -transition, natural sharp-unsharp: See 7.6.6. (line 2463)
4.838 -understanding masks: See 5. (line 1687)
4.839 -variance: See 4.4.1.1. (line 1406)
4.840 -weight mask: See 5. (line 1687)
4.841 -weight, entropy: See 3.3. (line 728)
4.842 -weight, exposure: See 3.3. (line 736)
4.843 -weight, local contrast: See 3.3. (line 721)
4.844 -weighted average: See 4.1.1. (line 1188)
4.845 -weighting functions: See 4. (line 1147)
4.846 -weighting, contrast using a blend of methods: See 4.4.3. (line 1536)
4.847 -weighting, contrast using laplacian-of-gaussian:See 4.4.2. (line 1438)
4.848 -weighting, contrast using standard deviation: See 4.4.1. (line 1369)
4.849 -weighting, exposure <1>: See 4.2. (line 1220)
4.850 -weighting, exposure: See 1. (line 121)
4.851 -weighting, general concept of: See 4.1. (line 1154)
4.852 -weighting, local contrast <1>: See 4.4. (line 1345)
4.853 -weighting, local contrast: See 1. (line 130)
4.854 -weighting, local entropy <1>: See 4.5. (line 1592)
4.855 -weighting, local entropy: See 1. (line 135)
4.856 -weighting, saturation <1>: See 4.3. (line 1310)
4.857 -weighting, saturation: See 1. (line 126)
4.858 -window, local-analysis: See 4.4.1. (line 1369)
4.859 -workflow: See 2. (line 192)
4.860 -workflow with Enblend: See 2. (line 203)
4.861 -workflow with Enfuse: See 2. (line 203)
4.862 -wrap around: See 3.1. (line 530)
4.863 + (line 2590)
4.864 +transformation, affine: See 2. (line 243)
4.865 +transition, natural sharp-unsharp: See 7.6.6. (line 2493)
4.866 +understanding masks: See 5. (line 1717)
4.867 +variance: See 4.4.1.1. (line 1436)
4.868 +weight mask: See 5. (line 1717)
4.869 +weight, entropy: See 3.4. (line 758)
4.870 +weight, exposure: See 3.4. (line 766)
4.871 +weight, local contrast: See 3.4. (line 751)
4.872 +weighted average: See 4.1.1. (line 1218)
4.873 +weighting functions: See 4. (line 1177)
4.874 +weighting, contrast using a blend of methods: See 4.4.3. (line 1566)
4.875 +weighting, contrast using laplacian-of-gaussian:See 4.4.2. (line 1468)
4.876 +weighting, contrast using standard deviation: See 4.4.1. (line 1399)
4.877 +weighting, exposure <1>: See 4.2. (line 1250)
4.878 +weighting, exposure: See 1. (line 124)
4.879 +weighting, general concept of: See 4.1. (line 1184)
4.880 +weighting, local contrast <1>: See 4.4. (line 1375)
4.881 +weighting, local contrast: See 1. (line 133)
4.882 +weighting, local entropy <1>: See 4.5. (line 1622)
4.883 +weighting, local entropy: See 1. (line 138)
4.884 +weighting, saturation <1>: See 4.3. (line 1340)
4.885 +weighting, saturation: See 1. (line 129)
4.886 +window, local-analysis: See 4.4.1. (line 1399)
4.887 +workflow: See 2. (line 195)
4.888 +workflow with Enblend: See 2. (line 206)
4.889 +workflow with Enfuse: See 2. (line 206)
4.890 +wrap around: See 3.2. (line 560)
5.1 --- a/doc/enfuse.texi Sat Nov 07 10:02:29 2009 +0100
5.2 +++ b/doc/enfuse.texi Sat Nov 07 10:07:16 2009 +0100
5.3 @@ -356,9 +356,16 @@
5.4 Fuse the sequence of images @var{INPUT}@dots{} into a single
5.5 @var{IMAGE}.
5.6
5.7 -@include filespec.texi
5.8 +@cindex literal filename
5.9 +@cindex filename, literal
5.10 +@cindex response file
5.11 +Input images are either specified literally or via so-called response
5.12 +files (see below). The latter are an alternative to specifying image
5.13 +filenames on the command line.
5.14 +
5.15
5.16 @menu
5.17 +* Response Files:: Files listing the images' names
5.18 * Common Options:: General options
5.19 * Extended Options:: Memory control and others
5.20 * Fusion Options:: Image fusion control
5.21 @@ -367,6 +374,13 @@
5.22 @end menu
5.23
5.24
5.25 +@node Response Files
5.26 +@section Response Files
5.27 +@cindex response file
5.28 +
5.29 +@include filespec.texi
5.30 +
5.31 +
5.32 @node Common Options
5.33 @section Common Options
5.34 @cindex options, common
6.1 --- a/doc/filespec.texi Sat Nov 07 10:02:29 2009 +0100
6.2 +++ b/doc/filespec.texi Sat Nov 07 10:07:16 2009 +0100
6.3 @@ -1,14 +1,9 @@
6.4 -@cindex literal filenames
6.5 -@cindex filenames, literal
6.6 -@cindex response files
6.7 -Input images are either specified literally or via so-called response
6.8 -files. A response file contains filenames of images or other response
6.9 -filenames. Introduce response file names with an at-character
6.10 -(@samp{@@}).
6.11 +A response file contains names of images or other response filenames.
6.12 +Introduce response file names with an at-character (@samp{@@}).
6.13
6.14 -Enblend and Enfuse process the list @var{INPUT}... from left to right,
6.15 -expanding response files depth-first. The following examples only show
6.16 -Enblend, but Enfuse works exactly the same.
6.17 +Enblend and Enfuse process the list @var{INPUT} strictly from left to
6.18 +right, expanding response files in depth-first order. The following
6.19 +examples only show Enblend, but Enfuse works exactly the same.
6.20
6.21 @table @asis
6.22 @item Solely literal filenames.
6.23 @@ -18,7 +13,7 @@
6.24 @end example
6.25
6.26 The ultimate order in which the images are processed is:
6.27 -@file{image-1.tif}, @file{image-2.tif}, @file{image-3.tif}.
6.28 +@file{image-@/1.tif}, @file{image-@/2.tif}, @file{image-@/3.tif}.
6.29
6.30 @item Single response file.
6.31 Example:
6.32 @@ -61,21 +56,27 @@
6.33 image-07.png
6.34 @end example
6.35
6.36 -Ultimate order: @file{image-01.png}, @file{image-02.png},
6.37 -@file{image-03.png}, @file{image-04.png}, @file{image-05.png},
6.38 -@file{image-06.png}, @file{image-07.png}, @file{image-08.png},
6.39 -@file{image-09.png}, @file{image-10.png},
6.40 +Ultimate order: @file{image-@/01.png}, @file{image-@/02.png},
6.41 +@file{image-@/03.png}, @file{image-@/04.png}, @file{image-@/05.png},
6.42 +@file{image-@/06.png}, @file{image-@/07.png}, @file{image-@/08.png},
6.43 +@file{image-@/09.png}, @file{image-@/10.png},
6.44 @end table
6.45
6.46 -@sp 1
6.47 -@noindent
6.48 -@strong{Response File Format}
6.49 +
6.50 +@c @menu
6.51 +@c * Response File Format:: Definition of the files' format
6.52 +@c * Syntactic Comments:: Control interpretation of response files
6.53 +@c @end menu
6.54 +
6.55 +@c @node Response File Format
6.56 +@subsection Response File Format
6.57 @cindex response file, format
6.58 -@cindex format of response files
6.59 -@need 150
6.60 +@cindex format of response file
6.61 +
6.62 Response files contain one filename per line. Blank lines or lines
6.63 -beginning with a sharp sign (@samp{#}) are ignored. Filenames that
6.64 -begin with an at-character (@samp{@@}) denote other response files.
6.65 +beginning with a sharp sign (@samp{#}) are ignored; the latter can
6.66 +serve as comments. Filenames that begin with an at-character
6.67 +(@samp{@@}) denote other response files.
6.68 @ref{Table:response-file-format} states a formal grammar of response
6.69 files in @uref{http://@/en.wikipedia.org/@/wiki/@/Ebnf,
6.70 @acronym{EBNF}}.
6.71 @@ -104,15 +105,15 @@
6.72 filename.
6.73
6.74 @caption{@acronym{EBNF} definition of the grammar of response files.}
6.75 -@shortcaption{Response-file grammar}
6.76 +@shortcaption{Grammar of response files}
6.77
6.78 @cindex response file, grammar
6.79 @cindex grammar, response file
6.80 @end float
6.81
6.82 -In a response file all relative filenames are used relative the the
6.83 -response file itself, not relative to the current-working directory of
6.84 -the application.
6.85 +In a response file relative filenames are used relative the response
6.86 +file itself, not relative to the current-working directory of the
6.87 +application.
6.88
6.89 @noindent
6.90 The above grammar might unpleasantly surprise the user in the
6.91 @@ -121,15 +122,15 @@
6.92 @table @asis
6.93 @item Literal filenames
6.94 Inside a response file all filenames are treated as literals. No
6.95 -filename globing or expansion is performed. This is, the
6.96 -line
6.97 +filename globbing or filename expansion is performed. This is, for
6.98 +example, the line
6.99 @example
6.100 img_*.tif
6.101 @end example
6.102 -stands for exactly one file called @samp{img_*.tif}.
6.103 +stands for exactly one file, called @samp{img_*.tif}.
6.104
6.105 @item Whitespace trimmed at both line ends
6.106 -For convenience whitespace at the beginning and at the end of each
6.107 +For convenience, whitespace at the beginning and at the end of each
6.108 line is ignored. However, this implies that response files cannot
6.109 represent filenames that start or end with whitespace, as there is no
6.110 quoting syntax. Filenames with embedded whitespace cause no problems,
6.111 @@ -137,7 +138,7 @@
6.112
6.113 @item Only whole-line comments
6.114 Comments in response files always occupy a complete line. There are
6.115 -no line-ending comments. Thus in
6.116 +no ``line-ending comments''. Thus, in
6.117 @example
6.118 # exposure series
6.119 img-0.33ev.tif # "middle" EV
6.120 @@ -145,19 +146,19 @@
6.121 img+0.67ev.tif
6.122 @end example
6.123 only the first line contains a comment, whereas the second lines
6.124 -includes none. Rather it refers to file@tie{}@w{@samp{img-0.33ev.tif
6.125 -# "middle" EV}}.
6.126 +includes none. Rather, it refers to a file called
6.127 +@w{@samp{img-@/0.33ev.tif # "middle" EV}}.
6.128
6.129 @item Image filenames cannot start with @samp{@@}
6.130 -An at-sign always introduces a response file, even if the extension
6.131 -would hint towards an image.
6.132 +An at-sign always introduces a response file, even if the filename's
6.133 +extension hints towards an image.
6.134 @end table
6.135
6.136 -@cindex response file, force recognition
6.137 -If Enblend or Enfuse do not recognize a response file, they will issue
6.138 -a warning. To force a file being recognized as a response file add
6.139 -one of the following syntactic comments to the @emph{first} line of
6.140 -the file.
6.141 +@cindex response file, force recognition of
6.142 +If Enblend or Enfuse do not recognize a response file, they will skip
6.143 +the file and issue a warning. To force a file being recognized as a
6.144 +response file add one of the following syntactic comments (see below)
6.145 +to the @emph{first} line of the file.
6.146
6.147 @example
6.148 @group
6.149 @@ -168,7 +169,7 @@
6.150 @end example
6.151
6.152 @noindent
6.153 -Here is an example of a valid response file.
6.154 +Finally, here is an example of a valid response file.
6.155 @example
6.156 @group
6.157 # 4\pi panorama!
6.158 @@ -185,3 +186,36 @@
6.159 nadir.tif
6.160 @end group
6.161 @end example
6.162 +
6.163 +
6.164 +@c @node Syntactic Comments
6.165 +@subsection Syntactic Comments
6.166 +@cindex response file, syntactic comment
6.167 +@cindex syntactic comment, response file
6.168 +
6.169 +Comments that follow the format described in
6.170 +@ref{Table:response-file-syntactic-comment} are treated as
6.171 +instructions how to interpret the rest of the response file.
6.172 +
6.173 +@float Table,Table:response-file-syntactic-comment
6.174 +@multitable {@var{syntactic-comment}} {::=} {abcdefghijklmnopqrstuvwxyzabcdefghijklm}
6.175 +@item @var{syntactic-comment}
6.176 +@tab ::=
6.177 +@tab @var{space}* @samp{#} @var{space}* @var{key} @var{space}* @samp{:} @var{space}* @var{value}
6.178 +@item @var{key}
6.179 +@tab ::=
6.180 +@tab (@samp{A} .. @samp{Z} | @samp{a} .. @samp{z} | @samp{-})+
6.181 +@end multitable
6.182 +
6.183 +@noindent
6.184 +where @var{value} is an arbitrary string.
6.185 +
6.186 +@caption{@acronym{EBNF} definition of the grammar of syntactic
6.187 +comments in response files.}
6.188 +@shortcaption{Grammar of syntactic comments}
6.189 +
6.190 +@cindex syntactic comment, grammar
6.191 +@cindex grammar, syntactic comment
6.192 +@end float
6.193 +
6.194 +Unknown syntactic comments are silently ignored.
7.1 --- a/doc/versenfuse.texi Sat Nov 07 10:02:29 2009 +0100
7.2 +++ b/doc/versenfuse.texi Sat Nov 07 10:07:16 2009 +0100
7.3 @@ -1,4 +1,4 @@
7.4 -@set UPDATED 5 November 2009
7.5 +@set UPDATED 7 November 2009
7.6 @set UPDATED-MONTH November 2009
7.7 @set EDITION 4.0-dd32463fe9de
7.8 @set VERSION 4.0-dd32463fe9de