OGGSLIDESHOW(1) User Manuals OGGSLIDESHOW(1)NAME
oggSlideshow - creates slideshows from pictures
SYNOPSIS
oggSlideshow [options] picture1 [ picture2 [...] ]
DESCRIPTION
oggSlideshow creates a theora video from a number of pictures in JPEG- or PNG-format with different visual effects.
OPTIONS -s Sets the size of the video frame. The size is given as <width>x<height> The default size is set to 480x320.
Example: -s 320x240
-f Sets the frame rate of the video. This is given by the pictures per second. The default frame rate is 24 pictures per second.
Example: -f 16
-o Sets the output file name of the created video. The default name is slideshow.ogv.
Example: -o myShow.ogv
-l Sets the presentation time (length) of one picture. So if your have 10 pictures and specify a length of 10 seconds, then your over-
all video length is 1:40 (100 seconds).
Example: -l 10
-d Sets the datarate in byte per seconds for the video encoder. This more meant to be a upper threshold. So the file may be smaller
than assumed.
Example: -d 1024000
-t Sets the presentation type, as shown above. Actually types are:
kb:
Ken Burns effect (default)
cf:
Picture crossfade for changeover
p:
Plain picture presentation
bl:
Bluring at changeover
Example: -t p
-e Enables the reframing. In case a picture does not match the aspect ratio of the video frame, it can be "reframed", which means black
borders are inserted. This option is only usefull with the Ken Burns effect (option -t kb). The pictures are automaticaly "reframed"
with the other two slideshow types to match the aspect ratio.
Example: -e
-x Overwrite an existing output file without warning.
-r Enables the resampling to a certain value. This is really only for experts and may not be available with newer version of
oggSlideshow.
To understand this option you need some more internal information: The picture is loaded by the gd lib. So the transformation from
png or jpeg to a plain RGBA is done here. The second reason for using gd is the great resizing facilities as pictures are often much
bigger than the video frame. OggSlideshow can handle pictures from 0.5 to 2 times of the video frame width and height best, as it
uses a linear pixel interpolation. With the resizing feature of gd, oggSlideshow reads pictures with a size "near" to the video out-
put size and can then operate with that picture. This produces a very good quality output, as you can see above.
The value given with this option is the factor the picture is read in in respect of the video frame size. When the video frame size
is 320x240 and the resample factor is 1.2 than the picture that is read is resized to 384x288. Specially for the ken burns effect
this is important as the sliding is done on a picture bigger than the video frame size.
EXAMPLE
oggSlideshow -l3 -tp -d1024000 -s480x320 -o demo-plain.ogv <picture1.jpg> <picture2.jpg> ...
AUTHOR
Joern Seger <yorn at gmx dot net>
SEE ALSO oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggThumb(1), oggSilence(1)Linux JAN 2010 OGGSLIDESHOW(1)
Check Out this Related Man Page
OGGTRANSCODE(1) User Manuals OGGTRANSCODE(1)NAME
oggTranscode - transcodes ogg files in multiple ways
SYNOPSIS
oggTranscode [options] inputfile.ogv outputfile.ogv
DESCRIPTION
oggTranscode 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.
Additionally, since version 0.8 oggTranscode 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.
oggTranscode was previously called oggResize.
OPTIONS -s Sets the size of the video frame. The size is given as <width>x<height>. At default, the video frame size keeps the same.
Example: -s 320x240
-d 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.
Example: -d 1024000
-D Sets the datarate in byte per seconds for the audio encoder (vorbis). If not set, the datarate of the original stream is used.
Example: -D 64000
-f 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.
Example: -f 25:2
-F 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.
Example: -F 32000
-c
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.
Example: -c 'AUTHOR=yorn;DATE=03.07.09'
-C 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.
Example: -C 'AUTHOR=yorn;DATE=03.07.09'
-q 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.
Example: -q1
-p 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.
Example: -p 24
-a Adds a picture to the video frame before it is resized. The expression for the picture appearances:
<picture1.png>[,<startTime>[,<endTime>[,s]]]
default startTime is 0
default endTime is -1, which is the end of the stream duration
default s ist not set. If s is set, the picture slides in smoothly.
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.
Example: -a etwas.png,2,7,s:etwasneues.png,5,10
-A Adds a picture to the video frame after it is resized.
The syntax follows the same expression as with option -a.
EXAMPLE
oggTranscode -s320x240 -d512000 orig.ogv new.ogv
Converts a the video orig.ogv to the video new.ogv with the new frame size 320x240. If there was an audio stream within the orig.ogv file,
it is copied into the new file.
oggTranscode -D64000 -F16000 -N1 orig.ogv new.ogv
Converts only the audio stream of file orig.ogv to a sample rate of 16kHz, a datarate of 64 kBit/s and a mono channel. The video stream is
copied as is.
oggTranscode -s300x200 -D32000 -d1024000 -A etwas.png,2,7,s:etwasneues.png,5,10 orig.ogv new.ogv
Converts the audio and video stream and adds the alpha channel picture etwas.png to the video from second 2 to second 7 with a smooth fade
in and fade out. Additionally the alpha channel picture etwasneues.png is placed on top of the video frame from second 5 to second 10
without any fading.
AUTHOR
Joern Seger <yorn at gmx dot net>
SEE ALSO oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggSlideshow(1), oggThumb(1), oggSilence(1)Linux JAN 2010 OGGTRANSCODE(1)