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         -j | --jobs numb      Use that many jobs parallel if possible
14         -o | --output name    Output .pto project name, defaults to 'morphed.pto'
15         -p | --polynomial num Uses a polynomial best fit, num is 'order' of polynomial
16                                   and must be 1, 2, 3, 4 or 5
17

DESCRIPTION

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

LICENSE

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

SEE ALSO

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

AUTHOR

65       Bruno Postle - April 2012.
66
67
68
69perl v5.38.0                      2023-07-21                       PTOMORPH(1)
Impressum