Diff of /java/help/mpremap [000000] .. [65b66c]  Maximize  Restore

Switch to unified view

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