1OGGSLIDESHOW(1)                  User Manuals                  OGGSLIDESHOW(1)
2
3
4

NAME

6       oggSlideshow - creates slideshows from pictures
7

SYNOPSIS

9       oggSlideshow [options] picture1 [ picture2 [...] ]
10

DESCRIPTION

12       oggSlideshow  creates a theora video from a number of pictures in JPEG-
13       or PNG-format with different visual effects.
14

OPTIONS

16       -s
17
18              Sets the  size  of  the  video  frame.  The  size  is  given  as
19              <width>x<height>
20
21              Example: -s 320x240
22
23
24       -f     Sets  the frame rate of the video. This is given by the pictures
25              per second. The default frame rate is 24 pictures per second.
26
27              Example: -f 16
28
29
30       -o     Sets the output file name of the created video. The default name
31              is slideshow.ogv.
32
33              Example: -o myShow.ogv
34
35
36       -l     Sets  the  presentation time (length) of one picture. So if your
37              have 10 pictures and specify a length of 10 seconds,  then  your
38              overall video length is 1:40 (100 seconds).
39
40              Example: -l 10
41
42
43       -d     Sets  the  datarate  in  byte per seconds for the video encoder.
44              This more meant to be a upper threshold.  So  the  file  may  be
45              smaller than assumed.
46
47              Example: -d 1024000
48
49
50       -t     Sets the presentation type, as shown above. Actually types are:
51
52              kb:
53               Ken Burns effect (default)
54
55              cf:
56               Picture crossfade for changeover
57
58              p:
59               Plain picture presentation
60
61              bl:
62               Bluring at changeover
63
64              Example: -t p
65
66
67       -e     Enables  the  reframing.  In  case  a picture does not match the
68              aspect ratio of the video frame, it  can  be  "reframed",  which
69              means  black  borders  are inserted. This option is only usefull
70              with the Ken Burns effect (option -t kb). The pictures are auto‐
71              maticaly  "reframed" with the other two slideshow types to match
72              the aspect ratio.
73
74              Example: -e
75
76
77       -r     Enables the resampling to a certain value. This is  really  only
78              for  experts  and  may  not  be  available with newer version of
79              oggSlideshow.
80
81              To understand this option you need some more  internal  informa‐
82              tion: The picture is loaded by the gd lib. So the transformation
83              from png or jpeg to a plain RGBA is done here. The second reason
84              for  using  gd  is the great resizing facilities as pictures are
85              often much bigger than the video frame. OggSlideshow can  handle
86              pictures from 0.5 to 2 times of the video frame width and height
87              best, as it uses a linear pixel interpolation. With the resizing
88              feature of gd, oggSlideshow reads pictures with a size "near" to
89              the video output size and can then operate  with  that  picture.
90              This produces a very good quality output, as you can see above.
91
92              The  value  given  with this option is the factor the picture is
93              read in in respect of the video frame size. When the video frame
94              size  is 320x240 and the resample factor is 1.2 than the picture
95              that is read is resized to 384x288. Specially for the ken  burns
96              effect  this  is  important  as the sliding is done on a picture
97              bigger than the video frame size.
98

EXAMPLE

100       oggSlideshow  -l3  -tp  -d1024000  -s480x320  -o  demo-plain.ogv  <pic‐
101       ture1.jpg> <picture2.jpg> ...
102
103

AUTHOR

105       Joern Seger <yorn at gmx dot net>
106
107
108
109Linux                              JULY 2009                   OGGSLIDESHOW(1)