1PTOMORPH(1)           User Contributed Perl Documentation          PTOMORPH(1)
2
3
4

NAME

6       ptomorph - Distort photos before stitching
7

SYNOPSIS

9       ptomorph [options] project.pto
10
11        Options:
12         -h | --help           Outputs help documentation
13         -o | --output name    Output .pto project name, defaults to 'morphed.pto'
14         -p | --polynomial num Uses a polynomial best fit, num is 'order' of polynomial
15                                   and must be 1, 2, 3, 4 or 5
16

DESCRIPTION

18       ptomorph looks at control points in a Hugin PTO panorama project and
19       creates a new set of photos that are distorted such that these control
20       points line up perfectly.  Distortion is a 'rubber-sheet' type morph.
21
22       A PTO project is created that references these distorted photos, this
23       project can then be stitched as normal.
24
25       Temporary distorted images are in PNG format with filenames based on
26       the prefix of the new PTO filename. i.e. this command:
27
28         ptomorph -o /path/to/morphed.pto project.pto
29
30       ..will produce the following files:
31
32         /path/to/morphed.pto
33         /path/to/morphed_0000.png
34         /path/to/morphed_0001.png
35         /path/to/morphed_0002.png
36            etc...
37
38       Control point positions are calculated using the 'pano_trafo' tool from
39       the Hugin project, the morphed photos are created with 'convert' from
40       the ImageMagick project.
41
42       By default the 'Shepards' distortion is used, if a polynomial is
43       specified then the ImageMagick 'Polynomial' distortion is used, see
44       <http://www.imagemagick.org/Usage/distorts/#polynomial> and
45       <http://www.imagemagick.org/Usage/distorts/#shepards>
46
47       Masks and cropping settings are not distorted, so projects with masks
48       that need lots of distortion may not work so well.
49
50       Note: Due to the way that the 'pano_trafo' process is spawned, it is
51       likely that this proof of concept tool doesn't currently work on
52       Windows.
53

LICENSE

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

SEE ALSO

61       <http://hugin.sourceforge.net/> <http://www.imagemagick.org/>
62

AUTHOR

64       Bruno Postle - April 2012.
65
66
67
68perl v5.28.0                      2013-05-12                       PTOMORPH(1)
Impressum