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
ENCODE(1) General Commands Manual ENCODE(1) NAME
encodedv - encode a series of images to a digital video stream SYNOPSIS
encodedv [ options ] video_pattern [ audio_input ] DESCRIPTION
encodedv takes a series of images in PPM/PGM/video format and optionally an audio stream and compiles them into a DV-encoded video stream. pattern specifies where the input data is located and may be either - for stdin, or a printf-style pattern taking one numeric argument that gets replaced by the current frame number. Like image%03d.ppm, which gets expanded to image000.ppm, image001.ppm, etc. --version show encodedv version number. -s, --start-frame=count start encoding at frame number count (defaults to 0). -e, --end-frame=count end encoding at frame number count (defaults to unlimited). -l, --wrong-interlace flip lines to compensate for wrong interlacing in the input data. Happened with mpeg2dec generated data. -p, --vlc-passes vlc code distribution passes (1-3) greater values = better quality but not necessarily slower encoding! This defaults for best qual- ity = 3. -v, --verbose show encoder statistics / status information -i, --input=filter-name Choose input-filter: [>ppm<, pgm, video] The ppm-filter only supports raw rgb ppm files. The pgm file format is the one generated by mpeg2dec of the livid project. ( http://linuxvideo.org ) This means: Y-data appended by U and V data which are scaled down by 2 and placed side by side. This option defaults to PPM. Some things you want to keep in mind: 1) If you want to stream video frames (using video_pattern = "-") you have to make sure that there is no trailing garbage at the end of the pictures. This is ignored by most image manipulation programs! 2) If you are one of the poor persons with a buggy PCI bus-mastering board be sure to have a backup handy if you want to use video support. Some versions of the VIA board chipsets crash your machine and even your harddisk. Since encodedv uses full resolution cap- turing it is more likely to trigger these bugs than other programs. If you have a VIA board you definitely want to upgrade to Linux 2.4.3 or higher. 3) The encoded pictures must have the correct resolution. If they don't, you may want to try ppmqscale. The used video format is chosen by picture resolution. Use 720x576 for PAL and 720x480 for NTSC. 4) If you want to speed up things a little bit and you are generating the input pictures automatically you may want to try pgm's instead of ppm's since they are encoded somewhat faster. But keep in mind, that this pgm format is only optimal for PAL since NTSC averages the U and V values somewhat differently. -a, --audio-input=filter-name Choose audio-input-filter: [>none<, wav, dsp] -o, --output=filter-name Choose output-filter: [>raw<] -q, --static-qno=table-no Static qno tables for quantisation on 2 VLC passes. For turbo (but somewhat lossy encoding) try -q [1,2] -p [2,3]. There are only two static qno tables registered right now: 1 : for sharp DV pictures 2 : for somewhat noisy satelite television signal If you want to add some more, go ahead ;-) -f, --fps=fps-number Set frames per second (default: use all frames) -d, --force-dct=dct-mode Force dct mode (88 or 248) for whole picture Help Options -?, --help Show help message. --usage Display brief usage message. SEE ALSO
playdv(1),dvconnect(1),dubdv(1),encodedv(1). AVAILABILITY
See http://libdv.sourceforge.net/ for the latest version. AUTHORS
encodedv was written by James Bowman <jamesb@excamera.com> and Peter Schlaile <udbz@rz.uni-karlsruhe.de>. This manual page is based on encodedv's help message and was written by Daniel Kobras <kobras@debian.org> for the Debian GNU/Linux system (but may be used by others). It was updated by Peter Schlaile <udbz@rz.uni-karlsruhe.de>. April 2001 ENCODE(1)