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

FreeBSD Manual Pages

  
 
  

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

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  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-
	      gSlideshow.

	      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.

EXAMPLE
       oggSlideshow  -l3  -tp  -d1024000  -s480x320  -o	 demo-plain.ogv	 <pic-
       ture1.jpg> <picture2.jpg> ...

AUTHOR
       Joern Seger <yorn at gmx	dot net>

SEE ALSO
       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:
<https://man.freebsd.org/cgi/man.cgi?query=oggSlideshow&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help