← Back to branch summary

~ubuntu-branches/ubuntu/trusty/enblend-enfuse/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/enfuse.texi

  • Committer: Package Import Robot
  • Author(s): Dmitrijs Ledkovs
  • Date: 2013-08-21 20:52:52 UTC
  • mfrom: (5.1.5 sid)
  • Revision ID: package-import@ubuntu.com-20130821205252-n4p1m7q3or02ge3w
Tags: 4.0+dfsg-6ubuntu1
* Merge from Debian, remaining changes:
  - Build-depend on libtiff-dev rather than libtiff4-dev.
  - Build-depend on libglew-dev rather than libglew1.5-dev | libglew1.4-dev
    | libglew-dev.
  - Use default inlining parameters for the build.
  - Build using -O1 on armel.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/enfuse.texi
8
8
 
9
9
@c %**start of header
10
10
@setfilename enfuse.info
 
11
@include versenfuse.texi
11
12
@settitle Fusing Multiple Images with Enfuse @value{VERSION}
12
13
@include auxmac.texi
13
 
@include versenfuse.texi
14
14
@include varsenfuse.texi
15
15
@include config-h.texi
16
16
 
475
475
first level works at two-pixel scale, and generally, the @math{n}-th
476
476
level contains image data at @math{2^n}-pixel scale.  This is the
477
477
reason why an image of
478
 
@math{width}@classictimes{}@math{height}@tie{}pixels cannot be
 
478
@math{width}@c
 
479
@classictimes{}@c
 
480
@math{height}@tie{}pixels cannot be
479
481
deconstructed into a pyramid of more than
480
482
@ifinfo
481
483
@display
531
533
pyramids.
532
534
 
533
535
The valid range of the absolute value of @var{LEVELS} is
534
 
@value{src::minimum-pyramid-levels} to
535
 
@value{src::maximum-pyramid-levels}.
 
536
@value{srcCOLONCOLONminimumDASHpyramidDASHlevels} to
 
537
@value{srcCOLONCOLONmaximumDASHpyramidDASHlevels}.
536
538
 
537
539
@item -o
538
540
@itemx --output=@var{FILE}
540
542
@opindex --output
541
543
Place output in @var{FILE}.
542
544
 
543
 
@cindex @file{@value{src::default-output-filename}}
 
545
@cindex @file{@value{srcCOLONCOLONdefaultDASHoutputDASHfilename}}
544
546
@cindex default output filename
545
547
@cindex output filename, default
546
548
If @option{--output} is not specified, the default is to put the
547
 
resulting image in @file{@value{src::default-output-filename}}.
 
549
resulting image in @file{@value{srcCOLONCOLONdefaultDASHoutputDASHfilename}}.
548
550
 
549
551
@item -v
550
552
@itemx --verbose[=@var{LEVEL}]
584
586
@end table
585
587
 
586
588
The default verbosity level of Enfuse is
587
 
@value{src::default-verbosity-level}.
 
589
@value{srcCOLONCOLONdefaultDASHverbosityDASHlevel}.
588
590
 
589
591
@item -V
590
592
@itemx --version
905
907
 
906
908
@itemize
907
909
@item
908
 
Minimal normalized value: @semilog{1.2, -38}
909
 
@item
910
 
Epsilon: @semilog{1.2, -7}
911
 
@item
912
 
Maximal finite value: @semilog{3.4, 38}
 
910
Minimal normalized value: 
 
911
@semilog{1.2, -38}
 
912
@item
 
913
Epsilon: 
 
914
@semilog{1.2, -7}
 
915
@item
 
916
Maximal finite value: 
 
917
@semilog{3.4, 38}
913
918
@end itemize
914
919
 
915
920
@c IEEE double: 64 bits, n = 53, k = 64 - n - 1 = 10
921
926
 
922
927
@itemize
923
928
@item
924
 
Minimal normalized value: @semilog{2.2, -308}
925
 
@item
926
 
Epsilon: @semilog{2.2, -16}
927
 
@item
928
 
Maximal finite value: @semilog{1.8, 308}
 
929
Minimal normalized value: 
 
930
@semilog{2.2, -308}
 
931
@item
 
932
Epsilon: 
 
933
@semilog{2.2, -16}
 
934
@item
 
935
Maximal finite value: 
 
936
@semilog{1.8, 308}
929
937
@end itemize
930
938
@end table
931
939
 
947
955
 
948
956
@itemize
949
957
@item
950
 
Minimum normalized value: @semilog{9.3, -10}
951
 
@item
952
 
Epsilon: @semilog{2.0, -3}
953
 
@item
954
 
Maximum finite value: @semilog{4.3, 9}
 
958
Minimum normalized value: 
 
959
@semilog{9.3, -10}
 
960
@item
 
961
Epsilon: 
 
962
@semilog{2.0, -3}
 
963
@item
 
964
Maximum finite value: 
 
965
@semilog{4.3, 9}
955
966
@end itemize
956
967
 
957
968
@item -f @var{WIDTH}x@var{HEIGHT}
959
970
@opindex -f
960
971
@cindex output image, set size of
961
972
Set the size of the output image manually to
962
 
@var{WIDTH}@classictimes{}@var{HEIGHT}.  Optionally specify the
 
973
@var{WIDTH}@c
 
974
@classictimes{}@c
 
975
@var{HEIGHT}.  Optionally specify the
963
976
@var{X-OFFSET} and @var{Y-OFFSET}, too.
964
977
 
965
978
@pindex nona @r{(Hugin)}
1018
1031
option@tie{}@option{--wContrast}.)
1019
1032
 
1020
1033
Sets the relative @var{WEIGHT} of high local-contrast pixels.
1021
 
Default: @value{src::default-weight-contrast}.  Valid range:
 
1034
Default: @value{srcCOLONCOLONdefaultDASHweightDASHcontrast}.  Valid range:
1022
1035
@ifinfo
1023
 
@value{src::minimum-weight-contrast} @leq{} @var{WEIGHT} @leq{}
1024
 
@value{src::maximum-weight-contrast}.
 
1036
@value{srcCOLONCOLONminimumDASHweightDASHcontrast} @leq{} @var{WEIGHT} @leq{}
 
1037
@value{srcCOLONCOLONmaximumDASHweightDASHcontrast}.
1025
1038
@end ifinfo
1026
1039
@html
1027
1040
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1028
1041
    <mrow>
1029
 
        <mn>@value{src::minimum-weight-contrast}</mn>
 
1042
        <mn>@value{srcCOLONCOLONminimumDASHweightDASHcontrast}</mn>
1030
1043
        <mo>&le;</mo>
1031
1044
        <mi mathvariant="italic">WEIGHT</mi>
1032
1045
        <mo>&le;</mo>
1033
 
        <mn>@value{src::maximum-weight-contrast}</mn>
 
1046
        <mn>@value{srcCOLONCOLONmaximumDASHweightDASHcontrast}</mn>
1034
1047
        <mtext>.</mtext>
1035
1048
    </mrow>
1036
1049
</math>
1037
1050
@end html
1038
1051
@tex
1039
 
$@value{src::minimum-weight-contrast} \le \mathit{WEIGHT} \le
1040
 
@value{src::maximum-weight-contrast}$.
 
1052
$@value{srcCOLONCOLONminimumDASHweightDASHcontrast} \le \mathit{WEIGHT} \le
 
1053
@value{srcCOLONCOLONmaximumDASHweightDASHcontrast}$.
1041
1054
@end tex
1042
1055
 
1043
1056
See @ref{Local Contrast Weighting} and @ref{Expert Options, Option
1051
1064
option@tie{}@option{--wEntropy}.)
1052
1065
 
1053
1066
Sets the relative @var{WEIGHT} of high local entropy pixels.  Default:
1054
 
@value{src::default-weight-entropy}.  Valid range:
 
1067
@value{srcCOLONCOLONdefaultDASHweightDASHentropy}.  Valid range:
1055
1068
@ifinfo
1056
 
@value{src::minimum-weight-entropy} @leq{} @var{WEIGHT} @leq{}
1057
 
@value{src::maximum-weight-entropy}.
 
1069
@value{srcCOLONCOLONminimumDASHweightDASHentropy} @leq{} @var{WEIGHT} @leq{}
 
1070
@value{srcCOLONCOLONmaximumDASHweightDASHentropy}.
1058
1071
@end ifinfo
1059
1072
@html
1060
1073
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1061
1074
    <mrow>
1062
 
        <mn>@value{src::minimum-weight-entropy}</mn>
 
1075
        <mn>@value{srcCOLONCOLONminimumDASHweightDASHentropy}</mn>
1063
1076
        <mo>&le;</mo>
1064
1077
        <mi mathvariant="italic">WEIGHT</mi>
1065
1078
        <mo>&le;</mo>
1066
 
        <mn>@value{src::maximum-weight-entropy}</mn>
 
1079
        <mn>@value{srcCOLONCOLONmaximumDASHweightDASHentropy}</mn>
1067
1080
        <mtext>.</mtext>
1068
1081
    </mrow>
1069
1082
</math>
1070
1083
@end html
1071
1084
@tex
1072
 
$@value{src::minimum-weight-entropy} \le \mathit{WEIGHT} \le
1073
 
@value{src::maximum-weight-entropy}$.
 
1085
$@value{srcCOLONCOLONminimumDASHweightDASHentropy} \le \mathit{WEIGHT} \le
 
1086
@value{srcCOLONCOLONmaximumDASHweightDASHentropy}$.
1074
1087
@end tex
1075
1088
 
1076
1089
See @ref{Local Entropy Weighting} and @ref{Expert Options, Options
1086
1099
Sets the relative @var{WEIGHT} of the well-exposedness criterion.
1087
1100
Increasing this weight relative to the others will make well-exposed
1088
1101
pixels contribute more to the final output.  Default:
1089
 
@value{src::default-weight-exposure}.  Valid range:
 
1102
@value{srcCOLONCOLONdefaultDASHweightDASHexposure}.  Valid range:
1090
1103
@ifinfo
1091
 
@value{src::minimum-weight-exposure} @leq{} @var{WEIGHT} @leq{}
1092
 
@value{src::maximum-weight-exposure}.
 
1104
@value{srcCOLONCOLONminimumDASHweightDASHexposure} @leq{} @var{WEIGHT} @leq{}
 
1105
@value{srcCOLONCOLONmaximumDASHweightDASHexposure}.
1093
1106
@end ifinfo
1094
1107
@html
1095
1108
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1096
1109
    <mrow>
1097
 
        <mn>@value{src::minimum-weight-exposure}</mn>
 
1110
        <mn>@value{srcCOLONCOLONminimumDASHweightDASHexposure}</mn>
1098
1111
        <mo>&le;</mo>
1099
1112
        <mi mathvariant="italic">WEIGHT</mi>
1100
1113
        <mo>&le;</mo>
1101
 
        <mn>@value{src::maximum-weight-exposure}</mn>
 
1114
        <mn>@value{srcCOLONCOLONmaximumDASHweightDASHexposure}</mn>
1102
1115
        <mtext>.</mtext>
1103
1116
    </mrow>
1104
1117
</math>
1105
1118
@end html
1106
1119
@tex
1107
 
$@value{src::minimum-weight-exposure} \le \mathit{WEIGHT} \le
1108
 
@value{src::maximum-weight-exposure}$.
 
1120
$@value{srcCOLONCOLONminimumDASHweightDASHexposure} \le \mathit{WEIGHT} \le
 
1121
@value{srcCOLONCOLONmaximumDASHweightDASHexposure}$.
1109
1122
@end tex
1110
1123
 
1111
1124
@xref{Exposure Weighting}.
1117
1130
option@tie{}@option{--wExposureMu}.)
1118
1131
 
1119
1132
Set the @var{MEAN} (this is, the center) of the Gaussian exposure
1120
 
weight curve.  Default: @value{src::default-exposure-mu}.  Valid
 
1133
weight curve.  Default: @value{srcCOLONCOLONdefaultDASHexposureDASHmu}.  Valid
1121
1134
range:
1122
1135
@ifinfo
1123
 
@value{src::minimum-exposure-mu} @leq{} @var{MEAN} @leq{}
1124
 
@value{src::maximum-exposure-mu}.
 
1136
@value{srcCOLONCOLONminimumDASHexposureDASHmu} @leq{} @var{MEAN} @leq{}
 
1137
@value{srcCOLONCOLONmaximumDASHexposureDASHmu}.
1125
1138
@end ifinfo
1126
1139
@html
1127
1140
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1128
1141
    <mrow>
1129
 
        <mn>@value{src::minimum-exposure-mu}</mn>
 
1142
        <mn>@value{srcCOLONCOLONminimumDASHexposureDASHmu}</mn>
1130
1143
        <mo>&le;</mo>
1131
1144
        <mi mathvariant="italic">MEAN</mi>
1132
1145
        <mo>&le;</mo>
1133
 
        <mn>@value{src::maximum-exposure-mu}</mn>
 
1146
        <mn>@value{srcCOLONCOLONmaximumDASHexposureDASHmu}</mn>
1134
1147
        <mtext>.</mtext>
1135
1148
    </mrow>
1136
1149
</math>
1137
1150
@end html
1138
1151
@tex
1139
 
$@value{src::minimum-exposure-mu} \le \mathit{MEAN} \le
1140
 
@value{src::maximum-exposure-mu}$.
 
1152
$@value{srcCOLONCOLONminimumDASHexposureDASHmu} \le \mathit{MEAN} \le
 
1153
@value{srcCOLONCOLONmaximumDASHexposureDASHmu}$.
1141
1154
@end tex
1142
1155
 
1143
1156
Use this option to fine-tune exposure weighting (@pxref{Exposure
1150
1163
option@tie{}@option{--wExposureSigma}.)
1151
1164
 
1152
1165
Standard deviation @var{STD-DEV} of the Gaussian exposure weight
1153
 
curve.  Default: @value{src::default-exposure-sigma}.  Low numbers
 
1166
curve.  Default: @value{srcCOLONCOLONdefaultDASHexposureDASHsigma}.  Low numbers
1154
1167
give less weight to pixels that are far from @option{--wMu} and vice
1155
1168
versa.  Valid range:
1156
1169
@ifinfo
1157
 
@value{src::minimum-exposure-sigma} @leq{} @var{STD-DEV}.
 
1170
@value{srcCOLONCOLONminimumDASHexposureDASHsigma} @leq{} @var{STD-DEV}.
1158
1171
@end ifinfo
1159
1172
@html
1160
1173
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1161
1174
    <mrow>
1162
 
        <mn>@value{src::minimum-exposure-sigma}</mn>
 
1175
        <mn>@value{srcCOLONCOLONminimumDASHexposureDASHsigma}</mn>
1163
1176
        <mo>&le;</mo>
1164
1177
        <mi mathvariant="italic">STD-DEV</mi>
1165
1178
        <mtext>.</mtext>
1167
1180
</math>
1168
1181
@end html
1169
1182
@tex
1170
 
$@value{src::minimum-exposure-sigma} \le \mathit{STD-DEV}$.
 
1183
$@value{srcCOLONCOLONminimumDASHexposureDASHsigma} \le \mathit{STD-DEV}$.
1171
1184
@end tex
1172
1185
 
1173
1186
Use this option to fine-tune exposure weighting (@pxref{Exposure
1181
1194
 
1182
1195
Sets the relative @var{WEIGHT} of high-saturation pixels.  Increasing
1183
1196
this weight makes pixels with high saturation contribute more to the
1184
 
final output.  Default: @value{src::default-weight-saturation}.  Valid
 
1197
final output.  Default: @value{srcCOLONCOLONdefaultDASHweightDASHsaturation}.  Valid
1185
1198
range:
1186
1199
@ifinfo
1187
 
@value{src::minimum-weight-saturation} @leq{} @var{WEIGHT} @leq{}
1188
 
@value{src::maximum-weight-saturation}.
 
1200
@value{srcCOLONCOLONminimumDASHweightDASHsaturation} @leq{} @var{WEIGHT} @leq{}
 
1201
@value{srcCOLONCOLONmaximumDASHweightDASHsaturation}.
1189
1202
@end ifinfo
1190
1203
@html
1191
1204
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1192
1205
    <mrow>
1193
 
        <mn>@value{src::minimum-weight-saturation}</mn>
 
1206
        <mn>@value{srcCOLONCOLONminimumDASHweightDASHsaturation}</mn>
1194
1207
        <mo>&le;</mo>
1195
1208
        <mi mathvariant="italic">WEIGHT</mi>
1196
1209
        <mo>&le;</mo>
1197
 
        <mn>@value{src::maximum-weight-saturation}</mn>
 
1210
        <mn>@value{srcCOLONCOLONmaximumDASHweightDASHsaturation}</mn>
1198
1211
        <mtext>.</mtext>
1199
1212
    </mrow>
1200
1213
</math>
1201
1214
@end html
1202
1215
@tex
1203
 
$@value{src::minimum-weight-saturation} \le \mathit{WEIGHT} \le
1204
 
@value{src::maximum-weight-saturation}$.
 
1216
$@value{srcCOLONCOLONminimumDASHweightDASHsaturation} \le \mathit{WEIGHT} \le
 
1217
@value{srcCOLONCOLONmaximumDASHweightDASHsaturation}$.
1205
1218
@end tex
1206
1219
 
1207
1220
Saturation weighting is only defined for color images.
1224
1237
option@tie{}@option{--ContrastWindowSize}.)
1225
1238
 
1226
1239
Set the window @var{SIZE} for local contrast analysis.  The window
1227
 
will be a square of @var{SIZE}@classictimes{}@var{SIZE} pixels.
 
1240
will be a square of @var{SIZE}@c
 
1241
@classictimes{}@c
 
1242
@var{SIZE} pixels.
1228
1243
 
1229
1244
For contrast analysis @var{SIZE} values larger than 5 might result in
1230
1245
a blurry composite image.  Values of 3 and 5 have given good results
1232
1247
 
1233
1248
Valid range:
1234
1249
@ifinfo
1235
 
@var{SIZE} @geq{} @value{src::minimum-contrast-window-size}.
 
1250
@var{SIZE} @geq{} @value{srcCOLONCOLONminimumDASHcontrastDASHwindowDASHsize}.
1236
1251
@end ifinfo
1237
1252
@html
1238
1253
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1239
1254
    <mrow>
1240
1255
        <mi mathvariant="italic">SIZE</mi>
1241
1256
        <mo>&ge;</mo>
1242
 
        <mn>@value{src::minimum-contrast-window-size}</mn>
 
1257
        <mn>@value{srcCOLONCOLONminimumDASHcontrastDASHwindowDASHsize}</mn>
1243
1258
        <mtext>.</mtext>
1244
1259
    </mrow>
1245
1260
</math>
1246
1261
@end html
1247
1262
@tex
1248
 
$\mathit{SIZE} \ge @value{src::minimum-contrast-window-size}$.
 
1263
$\mathit{SIZE} \ge @value{srcCOLONCOLONminimumDASHcontrastDASHwindowDASHsize}$.
1249
1264
@end tex
1250
1265
 
1251
1266
If given an even @var{SIZE}, Enfuse will automatically use the next
1264
1279
A non-zero value for @var{EDGE-SCALE} switches on the
1265
1280
Laplacian-of-Gaussian (@acronym{LoG}) edge detection algorithm.
1266
1281
@var{EDGE-SCALE} is the radius of the Gaussian used in the search for
1267
 
edges.  Default: @value{src::default-edge-scale}@dmn{pixels}.
 
1282
edges.  Default: @value{srcCOLONCOLONdefaultDASHedgeDASHscale}@dmn{pixels}.
1268
1283
 
1269
1284
A positive @var{LCE-SCALE} turns on local contrast enhancement
1270
1285
(@acronym{LCE}) before the @acronym{LoG} edge detection.
1329
1344
$$
1330
1345
@end tex
1331
1346
 
1332
 
@var{LCE-SCALE} defaults to @value{src::default-lce-scale} pixels and
1333
 
@var{LCE-FACTOR} defaults to @value{src::default-lce-factor}.  Append
 
1347
@var{LCE-SCALE} defaults to @value{srcCOLONCOLONdefaultDASHlceDASHscale} pixels and
 
1348
@var{LCE-FACTOR} defaults to @value{srcCOLONCOLONdefaultDASHlceDASHfactor}.  Append
1334
1349
@samp{%} to @var{LCE-SCALE} to specify the radius as a percentage of
1335
1350
@var{EDGE-SCALE}.  Append @samp{%} to @var{LCE-FACTOR} to specify the
1336
1351
weight as a percentage.
1350
1365
For color images @var{LOWER-CUTOFF} and @var{UPPER-CUTOFF} are applied
1351
1366
separately and independently to each channel.
1352
1367
 
1353
 
Defaults: @value{src::default-entropy-lower-cutoff} for
1354
 
@var{LOWER-CUTOFF} and @value{src::default-entropy-upper-cutoff} for
 
1368
Defaults: @value{srcCOLONCOLONdefaultDASHentropyDASHlowerDASHcutoff} for
 
1369
@var{LOWER-CUTOFF} and @value{srcCOLONCOLONdefaultDASHentropyDASHupperDASHcutoff} for
1355
1370
@var{UPPER-CUTOFF}, that is, all pixels' values are taken into
1356
1371
account.  Append a @samp{%} to specify the cutoff relative to maximum
1357
1372
pixel value in the source image (for example 255 or 65535).
1382
1397
option@tie{}@option{--EntropyWindowSize}.)
1383
1398
 
1384
1399
Window @var{SIZE} for local entropy analysis.  The window will be a
1385
 
square of @var{SIZE}@classictimes{}@var{SIZE} pixels.
 
1400
square of @var{SIZE}@c
 
1401
@classictimes{}@c
 
1402
@var{SIZE} pixels.
1386
1403
 
1387
1404
In the entropy calculation @var{SIZE} values of 3 to 7 yield an
1388
1405
acceptable compromise of the locality of the information and the
1390
1407
 
1391
1408
Valid range:
1392
1409
@ifinfo
1393
 
@var{SIZE} @geq{} @value{src::minimum-entropy-window-size}.
 
1410
@var{SIZE} @geq{} @value{srcCOLONCOLONminimumDASHentropyDASHwindowDASHsize}.
1394
1411
@end ifinfo
1395
1412
@html
1396
1413
<math xmlns="http://www.w3.org/1998/Math/MathML" display="inline">
1397
1414
    <mrow>
1398
1415
        <mi mathvariant="italic">SIZE</mi>
1399
1416
        <mo>&ge;</mo>
1400
 
        <mn>@value{src::minimum-entropy-window-size}</mn>
 
1417
        <mn>@value{srcCOLONCOLONminimumDASHentropyDASHwindowDASHsize}</mn>
1401
1418
        <mtext>.</mtext>
1402
1419
    </mrow>
1403
1420
</math>
1404
1421
@end html
1405
1422
@tex
1406
 
$\mathit{SIZE} \ge @value{src::minimum-entropy-window-size}$.
 
1423
$\mathit{SIZE} \ge @value{srcCOLONCOLONminimumDASHentropyDASHwindowDASHsize}$.
1407
1424
@end tex
1408
1425
 
1409
1426
If given an even @var{SIZE} Enfuse will automatically use the next odd
1693
1710
option@tie{}@option{--MinCurvature}.)
1694
1711
 
1695
1712
Define the minimum @var{CURVATURE} for the @acronym{LoG} edge
1696
 
detection.  Default: @value{src::default-minimum-curvature}.  Append a
 
1713
detection.  Default: @value{srcCOLONCOLONdefaultDASHminimumDASHcurvature}.  Append a
1697
1714
@samp{%} to specify the minimum curvature relative to maximum pixel
1698
1715
value in the source image (for example 255 or 65535).
1699
1716
 
1717
1734
@cindex mask, saving
1718
1735
First form: Save all soft weight masks in files.  If
1719
1736
option@tie{}@option{--hard-mask} is effective also save the hard masks.
1720
 
The defaults are @file{@value{src::default-soft-mask-template}} and
1721
 
@file{@value{src::default-hard-mask-template}}.
 
1737
The defaults are @file{@value{srcCOLONCOLONdefaultDASHsoftDASHmaskDASHtemplate}} and
 
1738
@file{@value{srcCOLONCOLONdefaultDASHhardDASHmaskDASHtemplate}}.
1722
1739
@cindex filename template
1723
1740
@cindex mask, filename template
1724
1741
In the second form, @var{SOFT-MASK-TEMPLATE} defines the names of the
2382
2399
@noindent
2383
2400
whose center@tie{}@math{Mu} and width@tie{}@math{Sigma} are controlled
2384
2401
by the command line options@tie{}@option{--exposure-mu} and @option{--exposure-sigma}
2385
 
respectively.  @math{Mu} defaults to @value{src::default-exposure-mu}
2386
 
and @math{Sigma} defaults to @value{src::default-exposure-sigma}.
 
2402
respectively.  @math{Mu} defaults to @value{srcCOLONCOLONdefaultDASHexposureDASHmu}
 
2403
and @math{Sigma} defaults to @value{srcCOLONCOLONdefaultDASHexposureDASHsigma}.
2387
2404
@ref{Figure:gaussian} shows a Gaussian.
2388
2405
 
2389
2406
@float Figure,Figure:gaussian
2606
2623
 
2607
2624
@noindent
2608
2625
It associates a probability@tie{}@math{p} with each of the @math{n}
2609
 
different possible outcomes@tie{}@inlineomega{} of the random
 
2626
different possible outcomes@tie{}@c
 
2627
@inlineomega{}
 
2628
of the random
2610
2629
variable@tie{}@math{X}.
2611
2630
@cindex expectation value
2612
2631
Based on @math{w}, we define the @dfn{expectation value} or ``First
2952
2971
@end tex
2953
2972
 
2954
2973
@noindent
2955
 
The parameter@tie{}@inlinesigma{}, the argument of
 
2974
The parameter@tie{}@c
 
2975
@inlinesigma{}
 
2976
, the argument of
2956
2977
option@tie{}@option{--contrast-edge-scale}, is the length scale on which edges
2957
2978
are detected by @math{g(x, y)}.  We apply the Laplacian operator in
2958
2979
Cartesian coordinates
3073
3094
$$
3074
3095
@end tex
3075
3096
 
3076
 
where we have used the dimensionless distance@tie{}@inlinexi{} from
 
3097
where we have used the dimensionless distance@tie{}@c
 
3098
@inlinexi{}
 
3099
from
3077
3100
the origin
3078
3101
@ifinfo
3079
3102
@display
3160
3183
@float Figure,Figure:laplacian-of-gaussian
3161
3184
@image{laplacian-of-gaussian}
3162
3185
 
3163
 
@caption{Laplacian-of-Gaussian function for @inlinesigma{} = 0.5.}
 
3186
@caption{Laplacian-of-Gaussian function for 
 
3187
@inlinesigma{}
 
3188
= 0.5.}
3164
3189
 
3165
3190
@shortcaption{Laplacian-of-Gaussian}
3166
3191
@end float
3178
3203
argument@tie{}@var{CURVATURE} to suppress all edges with a curvature
3179
3204
below @minus{}@var{CURVATURE} (which is a positive value).  Check the
3180
3205
effects with the mask files and particularly the hard-mask files
3181
 
(@file{@value{src::default-hard-mask-template}}) if using
 
3206
(@file{@value{srcCOLONCOLONdefaultDASHhardDASHmaskDASHtemplate}}) if using
3182
3207
option@tie{}@option{--hard-mask}.
3183
3208
 
3184
3209
To indicate the @var{CURVATURE} in relative terms, which is
3260
3285
@var{CURVATURE} nor the mode of operation (@acronym{SDev}-only,
3261
3286
@acronym{LoG}-only, or a blend of both) scales to different image
3262
3287
sizes.  In practice, this means that if you start with a set of
3263
 
reduced size images, say 2808@classictimes{}1872 pixels, carefully
 
3288
reduced size images, say 2808@c
 
3289
@classictimes{}@c
 
3290
1872 pixels, carefully
3264
3291
optimize @var{EDGESCALE}, @var{CURVATURE} and so on, and find
3265
3292
@acronym{LoG}-only the best mode, and then switch to the original
3266
 
resolution of 5616@classictimes{}3744 pixels, multiplying (or
 
3293
resolution of 5616@c
 
3294
@classictimes{}@c
 
3295
3744 pixels, multiplying (or
3267
3296
dividing) the parameters by four and sticking to @acronym{LoG}-only
3268
3297
might @emph{not} result in the best fused image.  For best quality,
3269
3298
perform the parameter optimization and the search for the most
3561
3590
Images should align well to be suitable for fusion.  However, there is
3562
3591
no hard mathematical rule what ``well'' means.  The alignment
3563
3592
requirements for 16@dmn{MPixel} images to yield a sharp
3564
 
4"@classictimes{}6" print at 300@dmn{dpi} (``dpi'' means dots per
 
3593
4"@c
 
3594
@classictimes{}@c
 
3595
6" print at 300@dmn{dpi} (``dpi'' means dots per
3565
3596
inch) or even for web presentation are relatively low, whereas the
3566
 
alignment of 8@dmn{MPixel} images for a 12"@classictimes{}18" print
 
3597
alignment of 8@dmn{MPixel} images for a 12"@c
 
3598
@classictimes{}@c
 
3599
18" print
3567
3600
ought to be tight.
3568
3601
 
3569
3602
@pindex hugin
3679
3712
prominent method in this class is dark-frame subtraction.
3680
3713
 
3681
3714
The defaults set
3682
 
@samp{--exposure-weight=@value{src::default-weight-exposure}} and
3683
 
@samp{--saturation-weight=@value{src::default-weight-saturation}}.
 
3715
@samp{--exposure-weight=@value{srcCOLONCOLONdefaultDASHweightDASHexposure}} and
 
3716
@samp{--saturation-weight=@value{srcCOLONCOLONdefaultDASHweightDASHsaturation}}.
3684
3717
Eliminating the saturation component with @samp{--saturation-weight=0.0} can
3685
3718
be worth an extra run.
3686
3719
 
3700
3733
manual of your model for details.
3701
3734
 
3702
3735
Enfuse's defaults,
3703
 
@samp{--exposure-weight=@value{src::default-weight-exposure}} and
3704
 
@samp{--saturation-weight=@value{src::default-weight-saturation}} are well
 
3736
@samp{--exposure-weight=@value{srcCOLONCOLONdefaultDASHweightDASHexposure}} and
 
3737
@samp{--saturation-weight=@value{srcCOLONCOLONdefaultDASHweightDASHsaturation}} are well
3705
3738
suited for fusion of @emph{color} images.  Remember that saturation
3706
3739
weighting only works for @acronym{RGB} data.
3707
3740
Option@tie{}@option{--saturation-weight} helps to control burnt-out
3940
3973
@table @option
3941
3974
@item --exposure-weight=0
3942
3975
Switch @strong{off} exposure based pixel selection.  The default
3943
 
weight is @value{src::default-weight-exposure}.
 
3976
weight is @value{srcCOLONCOLONdefaultDASHweightDASHexposure}.
3944
3977
 
3945
3978
@item --saturation-weight=0
3946
3979
Switch @strong{off} saturation based pixel selection.  The default
3947
 
weight is @value{src::default-weight-saturation}.
 
3980
weight is @value{srcCOLONCOLONdefaultDASHweightDASHsaturation}.
3948
3981
 
3949
3982
@item --contrast-weight=1
3950
3983
Switch @strong{on} pixel selection based on local contrast.
4026
4059
 
4027
4060
Let us use an example to illustrate the problem of relating the
4028
4061
sharpness with the local contrast variations.  Say we use a
4029
 
5@classictimes{}5 contrast window.  Moreover, let @code{sharp_edge}
 
4062
5@c
 
4063
@classictimes{}@c
 
4064
5 contrast window.  Moreover, let @code{sharp_edge}
4030
4065
and @code{smooth_edge} be two specific configurations:
4031
4066
 
4032
4067
@example
4106
4141
find the best value for @var{SCALE} though, usually some
4107
4142
experimentation will be necessary.  Use @option{--save-masks} to get
4108
4143
all soft-mask (default:
4109
 
@file{@value{src::default-soft-mask-template}}) and hard-mask files
4110
 
(default: @file{@value{src::default-hard-mask-template}}).  Check how
 
4144
@file{@value{srcCOLONCOLONdefaultDASHsoftDASHmaskDASHtemplate}}) and hard-mask files
 
4145
(default: @file{@value{srcCOLONCOLONdefaultDASHhardDASHmaskDASHtemplate}}).  Check how
4111
4146
different scales affect the artifacts.  Also @pxref{Understanding
4112
4147
Masks}.
4113
4148
 
4205
4240
Apply the default grayscale projector: @code{average} and throw away
4206
4241
all edges with a curvature of less than 0.5% and replace the
4207
4242
@acronym{LoG} data between 0% and 0.5% with @acronym{SDev} data.  Use
4208
 
a window of 7@classictimes{}7@dmn{pixel} window to compute the
 
4243
a window of 7@c
 
4244
@classictimes{}@c
 
4245
7@dmn{pixel} window to compute the
4209
4246
@acronym{SDev}.
4210
4247
@end table
4211
4248