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

EXAMPLE

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

AUTHOR

107       Joern Seger <yorn at gmx dot net>
108
109

SEE ALSO

111       oggCut(1),  oggCat(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggTh‐
112       umb(1), oggSilence(1)
113
114
115
116Linux                              JAN 2010                    OGGSLIDESHOW(1)
Impressum