1MATCH-N-SHIFT(1)      User Contributed Perl Documentation     MATCH-N-SHIFT(1)
2
3
4

NAME

6       match-n-shift - generate a Hugin .pto project from a list of photos
7

SYNOPSIS

9       match-n-shift [options] --output project.pto image1 image2 [...]
10
11        Options:
12         -o | --output name    Filename of created panorama project
13         -i | --input name     Filename of CSV file specifying input images (optional, see below)
14         -f | --projection     Panotools style input projection number. Use
15                                 0 for rectilinear (default), 2 for circular fisheye and
16                                 3 for full-frame fisheye images.  Note, this has to be
17                                 specified for fisheye lenses as this can't be determined
18                                 from EXIF metadata
19         -v | --fov            Horizontal field of view in degrees, this value is
20                                 only used if FoV can't be determined from EXIF
21                                 metadata, defaults to 50
22         -k | --selection      Crop selection boundary, eg -459,2459,-57,2861
23         -l | --linkstacks     Hard link positions of stacked photos.
24         -a | --align          Generate control points (default no).
25         -h | --help           Outputs help documentation.
26
27        Deprecated options (have no effect when using cpfind):
28         -s | --size number    Downsize images until width and height is
29                                 smaller than number, default 1600
30         -p | --points number  Number of generated control points between,
31                                 each pair, default: 25
32         -n | --noransac       No ransac detection, useful for fisheye images
33         -r | --refine         Refine the found control points using the
34                                 original images, delete unrefinable.
35

DESCRIPTION

37       match-n-shift takes a list of image files and creates a hugin
38       compatible project file (optionally containing control points linking
39       the images together, though there are better ways of doing this).
40
41       As much information as possible is extracted from photo EXIF data.  So
42       photo orientation, exposure, angle of view and white balance will all
43       be initialised if possible.
44
45       An optional input file can be chosen with the --input option, this can
46       be a simple list of photo filenames, or full paths, one per line:
47
48         DSC_0001.JPG
49         DSC_0002.JPG
50         DSC_0003.JPG
51         DSC_0004.JPG
52
53       ..or a CSV file specifying "filename, yaw, pitch, roll" (in degrees):
54
55         DSC_0001.JPG,0,20,90
56         DSC_0002.JPG,90,-20,90
57         DSC_0003.JPG,180,20,90
58         DSC_0004.JPG,-180,-20,90
59
60       ..or optionally specify XYZ translation parameters as well:
61
62         DSC_0001.JPG, 0, 20, 0, 0.5, 0.0, 1.0
63         DSC_0002.JPG, 0, 20, 0, 1.4, 0.0, 1.0
64         DSC_0003.JPG, 0, 20, 0, 2.3, 0.0, 1.0
65         DSC_0004.JPG, 0, 20, 0, 3.2, 0.0, 1.0
66
67       If the roll field is ommitted then it will be set to zero or any value
68       obtainable from EXIF data, similarly if the pitch field is ommitted
69       then pitch will be set to zero.  So this should also work:
70
71         DSC_0001.JPG,0
72         DSC_0002.JPG,90
73         DSC_0003.JPG,180
74         DSC_0004.JPG,-180
75

LICENSE

77       This program is free software; you can redistribute it and/or modify it
78       under the terms of the GNU General Public License as published by the
79       Free Software Foundation; either version 2 of the License, or (at your
80       option) any later version.
81

SEE ALSO

83       <http://hugin.sourceforge.net/>
84

AUTHOR

86       Bruno Postle - February 2008.
87
88
89
90perl v5.38.0                      2023-07-21                  MATCH-N-SHIFT(1)