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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
|
Content-type: text/html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of OGGTRANSCODE</TITLE>
</HEAD><BODY>
<H1>OGGTRANSCODE</H1>
Section: User Manuals (1)<BR>Updated: JAN 2010<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
oggTranscode - transcodes ogg files in multiple ways
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<B>oggTranscode [options] inputfile.ogv outputfile.ogv </B>
<A NAME="lbAD"> </A>
<H2>DESCRIPTION</H2>
<B>oggTranscode </B>
can resize an ogg file (ogg, oga or ogv) in multiple ways:
It can change the video frame size, change datarate for the video and/or audio streams
contained in the ogg file and it can also change the video frame rate or audio sample rate.
<P>
Additionally, since version 0.8
<B>oggTranscode </B>
can add any ogg comment and png-pictures with an alpha channel can be rendered into the
video at any time period before and after the resizing process.
<P>
<B>oggTranscode</B>
was previously called
<B>oggResize.</B>
<P>
<A NAME="lbAE"> </A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT>-s<DD>
Sets the size of the video frame. The size is given as
<B><width>x<height>.</B>
At default, the video frame size keeps the same.
<P>
<I>Example: -s 320x240</I>
<P>
<DT>-d<DD>
Sets the datarate in byte per seconds for the video encoder (theora). This meant
to be a upper threshold. So the file may be smaller than assumed. If not set,
the datarate of the original stream is used.
<P>
<I>Example: -d 1024000</I>
<P>
<DT>-D<DD>
Sets the datarate in byte per seconds for the audio encoder (vorbis).
If not set, the datarate of the original stream is used.
<P>
<I>Example: -D 64000</I>
<P>
<DT>-f<DD>
Sets the frame rate of the video with numinator and demoninator and is the
pictures per second. If only one number is given, the denominator is set to
1. If not set, the framerate of the original video is used.
<P>
<I>Example: -f 25:2</I>
<P>
<DT>-F<DD>
Sets the sample frequency (sample rate) of the audio data in Hertz. If the
sample frequency does not match the one with the original file, resamling is invoked.
<P>
<I>Example: -F 32000</I>
<P>
<DT>-c<DD>
<P>
Adds comments to the video (theora) stream. Comments are given by a pair
of type and value in the form 'type=value'. More than one comment can be
concatenated with a semicolon. It is recommended to use apostrophes
as the command line may use the semicolon as a seperator.
<P>
<I>Example: -c 'AUTHOR=yorn;DATE=03.07.09'</I>
<P>
<DT>-C<DD>
Adds comments to the audio (vorbis) stream. Comments are given by a pair
of type and value in the form 'type=value'. More than one comment can be
concatenated with a semicolon. It is recommended to use apostrophes
as the command line may use the semicolon as a seperator.
<P>
<I>Example: -C 'AUTHOR=yorn;DATE=03.07.09'</I>
<P>
<DT>-q<DD>
Specifies the quality for the resizing process. Values can be chosen between 1 (best
quality, with slight bluring) and 6 (worst quality). The default value is 2.
<P>
<I>Example: -q1</I>
<P>
<DT>-p<DD>
This option is meant to help creating a preview of a film. The number
given with this option defines the number of frames, that are omitted. E.g.
if a film has 24 frames per second and -p24 is given, the newly created
video shows the video 24 times faster as only every 24th frame is used.
This option can be combined with the option -f to control the framerate.
With both options nice video previews can be created. If -p is used, the
audio stream is ignored.
<P>
<I>Example: -p 24</I>
<P>
<DT>-a<DD>
Adds a picture to the video frame before it is resized.
The expression for the picture appearances:
<P>
<B><picture1.png>[,<startTime>[,<endTime>[,s]]]</B>
<P>
default
<B>startTime </B>
is 0
<P>
default
<B>endTime</B>
is -1, which is the end of the stream duration
<P>
default
<B>s </B>
ist not set. If
<B>s </B>
is set, the picture slides in smoothly.
<P>
More than one picture can be included.
To concatenate the expressions use the colon.
If the appearance time overlap, the pictures are placed on one another,
so the last picture is the uppest layer.
<P>
<I>Example: -a etwas.png,2,7,s:etwasneues.png,5,10</I>
<P>
<DT>-A<DD>
Adds a picture to the video frame after it is resized.
<P>
The syntax follows the same expression as with option -a.
<P>
</DL>
<A NAME="lbAF"> </A>
<H2>EXAMPLE</H2>
<P>
<I>oggTranscode -s320x240 -d512000 orig.ogv new.ogv</I>
<P>
Converts a the video
<B>orig.ogv </B>
to the video
<B>new.ogv </B>
with the new frame size 320x240. If
there was an audio stream within the orig.ogv file, it is copied into the new
file.
<P>
<I>oggTranscode -D64000 -F16000 -N1 orig.ogv new.ogv</I>
<P>
Converts only the audio stream of file
<B>orig.ogv </B>
to a sample rate of 16kHz, a datarate of 64 kBit/s and a mono channel.
The video stream is copied as is.
<P>
<I>oggTranscode -s300x200 -D32000 -d1024000 -A etwas.png,2,7,s:etwasneues.png,5,10 orig.ogv new.ogv</I>
<P>
Converts the audio and video stream and adds the alpha channel picture
<B>etwas.png </B>
to the video from second 2 to second 7 with a smooth fade in and fade out.
Additionally the alpha channel picture
<B>etwasneues.png</B>
is placed on top of the video frame from second 5 to second 10 without any
fading.
<P>
<A NAME="lbAG"> </A>
<H2>AUTHOR</H2>
Joern Seger <yorn at gmx dot net>
<A NAME="lbAH"> </A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+oggCut">oggCut</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+oggCat">oggCat</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+oggJoin">oggJoin</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+oggSplit">oggSplit</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+oggSlideshow">oggSlideshow</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+oggThumb">oggThumb</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+oggSilence">oggSilence</A></B>(1)
<HR>
<A NAME="index"> </A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">EXAMPLE</A><DD>
<DT><A HREF="#lbAG">AUTHOR</A><DD>
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 09:28:30 GMT, January 10, 2010
</BODY>
</HTML>
|
