1OGGRESIZE(1) User Manuals OGGRESIZE(1)
2
3
4
6 oggResize - resizes ogg files in multiple ways
7
9 oggResize [options] inputfile.ogv outputfile.ogv
10
12 oggResize can resize an ogg file (ogg, oga or ogv) in multiple ways: It
13 can change the video frame size, change datarate for the video and/or
14 audio streams contained in the ogg file and it can also change the
15 video frame rate or audio sample rate.
16
17 Additionally, since version 0.8 oggResize can add any ogg comment and
18 png-pictures with an alpha channel can be rendered into the video at
19 any time period before and after the resizing process.
20
21
23 -s
24
25 Sets the size of the video frame. The size is given as
26 <width>x<height> The default size is 480x320.
27
28 Example: -s 320x240
29
30
31 -d
32
33 Sets the datarate in byte per seconds for the video encoder
34 (theora). This meant to be a upper threshold. So the file may be
35 smaller than assumed. If not set, the datarate of the original
36 stream is used.
37
38 Example: -d 1024000
39
40
41 -D
42
43 Sets the datarate in byte per seconds for the audio encoder
44 (vorbis). If not set, the datarate of the original stream is
45 used.
46
47 Example: -D 64000
48
49
50 -f
51
52 Sets the frame rate of the video with numinator and demoninator
53 and is the pictures per second. If only one number is given, the
54 denominator is set to 1. If not set, the framerate of the origi‐
55 nal video is used.
56
57 Example: -f 25:2
58
59
60 -F
61
62 Sets the sample frequency (sample rate) of the audio data in
63 Hertz. If the sample frequency does not match the one with the
64 original file, resamling is invoked.
65
66 Example: -F 32000
67
68
69 -c
70
71 Adds comments to the video (theora) stream. Comments are given
72 by a pair of type and value in the form 'type=value'. More than
73 one comment can be concatenated with a semicolon. It is recom‐
74 mended to use apostrophes as the command line may use the semi‐
75 colon as a seperator.
76
77 Example: -c 'AUTHOR=yorn;DATE=03.07.09'
78
79
80 -C
81
82 Adds comments to the audio (vorbis) stream. Comments are given
83 by a pair of type and value in the form 'type=value'. More than
84 one comment can be concatenated with a semicolon. It is recom‐
85 mended to use apostrophes as the command line may use the semi‐
86 colon as a seperator.
87
88 Example: -C 'AUTHOR=yorn;DATE=03.07.09'
89
90
91 -q
92
93 Specifies the quality for the resizing process. Values can be
94 chosen between 1 (best quality, with slight bluring) and 6
95 (worst quality). The default value is 2.
96
97 Example: -q1
98
99
100 -p
101
102 This option is meant to help creating a preview of a film. The
103 number given with this option defines the number of frames, that
104 are omitted. E.g. if a film has 24 frames per second and -p24
105 is given, the newly created video shows the video 24 times
106 faster as only every 24th frame is used. This option can be
107 combined with the option -f to control the framerate. With both
108 options nice video previews can be created. If -p is used, the
109 audio stream is ignored.
110
111 Example: -p 24
112
113
114 -a
115
116 Adds a picture to the video frame before it is resized. The
117 expression for the picture appearances:
118
119 <picture1.png>[,<startTime>[,<endTime>[,s]]]
120
121 default startTime is 0
122
123 default endTime is -1, which is the end of the stream duration
124
125 default s ist not set. If s is set, the picture slides in
126 smoothly.
127
128 More than one picture can be included. To concatenate the
129 expressions use the colon. If the appearance time overlap, the
130 pictures are placed on one another, so the last picture is the
131 uppest layer.
132
133 Example: -a etwas.png,2,7,s:etwasneues.png,5,10
134
135
136 -A
137
138 Adds a picture to the video frame after it is resized.
139
140 The syntax follows the same expression as with option -a.
141
142
144 oggResize -s320x240 -d512000 orig.ogv new.ogv
145
146 Converts a the video orig.ogv to the video new.ogv with the new frame
147 size 320x240. If there was an audio stream within the orig.ogv file, it
148 is copied into the new file.
149
150 oggResize -D64000 -F16000 -N1 orig.ogv new.ogv
151
152 Converts only the audio stream of file orig.ogv to a sample rate of
153 16kHz, a datarate of 64 kBit/s and a mono channel. The video stream is
154 copied as is.
155
156 oggResize -s300x200 -D32000 -d1024000 -A etwas.png,2,7,s:etwas‐
157 neues.png,5,10 orig.ogv new.ogv
158
159 Converts the audio and video stream and adds the alpha channel picture
160 etwas.png to the video from second 2 to second 7 with a smooth fade in
161 and fade out. Additionally the alpha channel picture etwasneues.png is
162 placed on top of the video frame from second 5 to second 10 without any
163 fading.
164
165
167 Joern Seger <yorn at gmx dot net>
168
170 oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggSlideshow(1), oggTh‐
171 umb(1), oggSilence(1)
172
173
174
175Linux JULY 2009 OGGRESIZE(1)