NAME
ptosort - sort pto files with variable criteria
SYNOPSIS
ptosort [options] infile.pto outfile.pto
Options:
-p | --point order Provide a sorting order for control points
-i | --image order Provide a sorting order for images
-c | --clean yes/no Switch removal of duplicate control points
on/off, default is on
-h | --help Show the full manpage
DESCRIPTION
ptosort takes a pto file as input, sorts it and writes a sorted pto file as output. By default images are sorted according to their filename and control points are sorted by left image number, right image number and y pixel coordinate.
The --point and --image command line options can be used to modify the sorting order. The order string should consist of a list letters separated by commas identifying the values to be taken for the comparison, e.g. for images y means yaw or r means roll. By default sorting for yaw (y), pitch (p), roll (r) and exposure (Eev) is fuzzy, i.e. values within an interval of 10 degress for yaw are considered to be the same. This is especially useful when sorting multirow panoramas. Appending a colon to the sort parameter forces strict sorting without fuzziness, while appending a tilde and a numerical value can be used to specify the fuzziness in terms of intervall width.
EXAMPLES
- ptosort --image n --point n,N,y in.pto out.pto
-
Sort the images by filename and the control points by left image number, right image number and y pixel coordinate. This is identical to the default behaviour without options.
- ptosort --image y in.pto out.pto
-
Sort images by yaw and control points using the default.
- ptosort --image y,p,Eev in.pto out.pto
-
Sort images in a multiraw panorama by position and exposure value.
- ptosort --image Eev:,y~5.5,p in.pto out.pto
-
Sort strict without fuzziness by exposure value, with a fuzziness interval of 5.5 degree by yaw and by pitch.
LICENSE
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
AUTHOR
Felix Hagemann, July 2008