debian man page for oggthumb

OGGTHUMB(1)							   User Manuals 						       OGGTHUMB(1)

NAME
       oggThumb - creates thumbnails from an ogg video file

SYNOPSIS
       oggThumb [options] file1.ogv [ file2.ogv [ file3.ogv [...] ] ]

DESCRIPTION
       oggThumb creates Thumbnails from one or more ogg video files, at a given time position or a given frame number. It is also possible to cre-
       ate a series of thumbnails at different time or frame positions. The pictures can be created in JPG or PNG format and can be resized to any
       given size.

       The default naming of each thumbnail series follows the following rule:

       <filename_without_extension>_x.<picture_extension>

       Where  x starts with 0 and is incremented with every created thumbnail. So the thumbnails are successivly numbered by the appearence order.
       This is even valid, if time positions and frame numbers are mixed.

OPTIONS
       -t     Time at which a thumbnail should be created. More than one thumbnail time can be concatenated by commas. The times  can  be  set	by
	      integer or floating point values in seconds. If the time is not exactly matching, the next frame is used. The times don't have to be
	      sorted incrementally.

	      Example: -t 12.4,14.157,13.23

       -f     Number of a frame that should be created as a thumbnail. More than one thumbnail frame can be concatenated by commas. The frame num-
	      bers must be an integers. The frame numbers don't have to be sorted incrementally.

	      Example: -f 12000,13000,11000

       -s     Picture  output  size.  The  thumbnail is created in the size given as <width>x<height>.	If you want to include the thumbnails into
	      your webpage and you need to have a fixed width but dynamic height, you can set the dynamic axis to 0. So the aspect  ratio  of  the
	      video frame is kept. This is the same for setting width or height to 0.

	      Example: -s 0x100

       -o     Output format. This can be png or jpg. The default is jpg.

	      Example: -o png

       -n     Alternative thumbnail picture name. The % can be used within the name to indicate the counter placeholder.

	      In  case of more than one video file, the counter continuous throughout the different videos, so that the pictures are not overwrit-
	      ten.

	      If the name has an extension. This extension is used to identify the output picture format.

	      Example: -n myNo_%_thumb

EXAMPLE
       oggThumb -t 10.3,22.4,31.9,43.4,59.4 -f 1200 -s 0x100 myFile.ogv

       oggThumb -f 200,400,300,100 -t 3.54 -n %_thumb.png myfile.ogv mysecondfile.ogv

AUTHOR
       Joern Seger <yorn at gmx dot net>

SEE ALSO
       oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggSlideshow(1), oggSilence(1)

Linux								     JAN 2010							       OGGTHUMB(1)