Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
OGGSLIDESHOW(1)			 User Manuals		       OGGSLIDESHOW(1)

       oggSlideshow - creates slideshows from pictures

       oggSlideshow [options] picture1 [ picture2 [...]	]

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

       -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:

	       Ken Burns effect	(default)

	       Picture crossfade for changeover

	       Plain picture presentation

	       Bluring at changeover

	      Example: -t p

       -e     Enables  the reframing. In case a	picture	does not match the as-
	      pect 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 as-
	      pect 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 og-

	      To understand this option	you need some more  internal  informa-
	      tion: 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.

       oggSlideshow  -l3  -tp  -d1024000  -s480x320  -o	 demo-plain.ogv	 _pic-
       ture1.jpg_ _picture2.jpg_ ...

       Joern Seger <yorn at gmx	dot net>

       oggCut(1),  oggCat(1), oggJoin(1), oggSplit(1), oggTranscode(1),	oggTh-
       umb(1), oggSilence(1)

Linux				   JAN 2010		       OGGSLIDESHOW(1)


Want to link to this manual page? Use this URL:

home | help