/
mpremap
114 lines (95 loc) · 4.61 KB
/
mpremap
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
mpremap - Remap from/to Motion Pictures
=======================================
Summary:
--------
With mpremap motion pictures can be remapped from
and to almost any geometric projection. Images made
with fisheye lenses can be 'rectified' to wide-angle
rectilinear or cylindrical formats. Arbitrary partial
views can be extracted from wide angle images. Static
panoramic images can be transformed into movies. Lens
distortion corrections and perspective changes can
be accomplished. Any transformation supported by the
underlying Panorama-Tools-library may be applied.
Transformations use either global, constant parameters,
or per-frame specifications. The latter method allows the
user to generate virtual moving camera positons (pan,
tilt, rotate and zoom) from static source material. A
few examples can be viewed at my website
http://www.fh-furtwangen.de/~dersch
Usage:
------
Invokation:
mpremap [options] [inputfile1, inputfile2,...]
input Specify inputfile names. Any number of
images in formats supported by the
Panorama Tools library pano12 can be
used. The supported file formats depend
on the computer platform; ppm is always
available and can be generated from almost
any other format using the free netpbm
utilities.
Multiple numbered images can be read using
a filename containing the percent-sign '%'.
mpremap inserts an integer number starting with
0 according to the rules of the C-function 'printf'.
Example: The input file name 'image%d.jpg' is
expanded to 'image0.jpg image1.jpg image2.jpg ...'
A continous stream of ppm-frames is read
from standard input if "-" is specified
as inputfile name.
HDR-images are supported via ppm-48bit pixels.
List of options:
-o name Specify name of outputfile (required)
Single JPEG-encoded frames are written
if this name ends with ".jpg".
All other names lead to "ppm"-encoded frames.
Consecutive numbering of frames is
achieved by embedding the sequence "%d"
somwhere in the name, which will be
replaced by the framenumber.
Using "-" as output name causes ppm-
encoded frames to be continouesly written
to standard output.
-f script Specify name of scriptfile (required except
if F-option given instead).
The scriptfile contains global or per-frame
conversion specifications. See separate
chapter for syntax.
-F command Specify conversion command (required except
if f-option given instead). Short scripts
(e.g. twoliners for static global
conversion parameters)can be given on the
commandline using this option. To avoid
shell-quoting madness, the script can be
entered as one word using "_" for whitespace
and ":" for line separator, e.g.
-F p_f2_w1000_h500_v120:o_f0_y0_p10_r0_v100
-q number Specify quality (0...100) of JPEG compressor.
(optional, default: 80). This option is only
used if output is set to JPEG-format, and
ignored in all other cases.
-e Use extract mode (default: insert mode).
In this mode scriptlines starting with
the letter 'p' specify input images,
while lines starting with 'o' specify
output. This is reversed in default mode
(insert).
-b number Apply motion blur (optional, default: 1).
This option is only used in "extract"-mode
and blurs the images during rapid panning
and zooming. This leads to more natural
appearance of virtual pans and less stutter.
Blurring is accomplished by creating
a number of images (amount specified by
the option) which interpolate the last two
positions in the virtual move. These images
are then averaged. Processing time increases
proportional to this number.
-s Stitch (optional, default: off). This option
is only used in "insert" mode. If set, the
previous frame is used as background for the
current frame. This can be used to fill
uncovered areas resulting from shift
operations.
-h Print help message.