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 overall 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 useful with the Ken
              Burns  effect  (option  -t  kb).  The  pictures  are  automatically  "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 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 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)