oggslideshow(1) [debian man page]
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
OGGCAT(1) User Manuals OGGCAT(1) NAME
oggCat - concatenates two ogg video files (.ogv, .ogg or oga) SYNOPSIS
oggCat [options] outfile.ogv file1.ogv file2.ogv [ file3.ogv [...] ] DESCRIPTION
oggCat concatenates two or more ogg files. The parameters of the resulting ogg file is defined by the first file in the concatenation list. The parameters could be changed by some options, explained below. All subsequent files that does not match these video file parameters are automatically transcoded. A concatenation will fail in case that there are not enought streams available. This could happen e.g. if the first file consists of one audio and one video stream and the second file only carries a video stream. If there is more than one video or audio stream within the file, the first stream is used. OPTIONS
-s Sets the size of the video frame. The size is given as <width>x<height>. At default, the video frame size is the size of the first video stream. 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 first file 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 first file 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 first file 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 video quality for the newly created stream. Valid values can be chosen between 0 and 63 (best). Example: -q 63 -rv Force to reencode the video stream. This is sometimes neccessary, if the video stream match in video parameters, but not in the the- ora version. In that case, reencoding the video stream helps creating good results. -x Force to overwrite the output file, even if it exists. This is mainly helpful if the oggCat is server controlled. EXAMPLES
oggCat concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv or oggCat -o concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv This command creates a cancatenated file concatFile.ogv that consists of the three files myfile1.ogv myfile2.ogv myfile3.ogv oggCat -s320x240 -q63 concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv This command connects the three files myfile[1-3].ogv to file concatFile.ogv with the size of 320x240 and best quality. AUTHOR
Joern Seger <yorn at gmx dot net> SEE ALSO
oggCut(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggSlideshow(1), oggThumb(1), oggSilence(1) Linux JAN 2010 OGGCAT(1)