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)