oggSlideshow - creates slideshows from pictures
oggSlideshow [options] picture1 [ picture2 [...] ]
oggSlideshow creates a theora video from a number of pictures in
JPEG‐ or PNG‐format with different visual effects.
oggSlideshow -l3 -tp -d1024000 -s480x320 -o demo-plain.ogv
<picture1.jpg> <picture2.jpg> ...
Joern Seger <yorn at gmx dot net>
oggCut(1), oggCat(1), oggJoin(1), oggSplit(1),
oggTranscode(1), oggThumb(1), oggSilence(1)
- 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
- 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
- Sets the output file name of the created video. The default name is
Example: -o myShow.ogv
- Sets the presentation time (length) of one picture. So if your have 10
pictures and specify a length of 10 seconds, then your overall video
length is 1:40 (100 seconds).
Example: -l 10
- 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
- Sets the presentation type, as shown above. Actually types are:
Ken Burns effect (default)
Picture crossfade for changeover
Plain picture presentation
Bluring at changeover
Example: -t p
- 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.
- Overwrite an existing output file without warning.
- 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 output 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
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.