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

FreeBSD Manual Pages

  
 
  

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

NAME
       oggTranscode - transcodes ogg files in multiple ways

SYNOPSIS
       oggTranscode [options] inputfile.ogv outputfile.ogv

DESCRIPTION
       oggTranscode can	resize an ogg file (ogg, oga or	ogv) in	multiple ways:
       It  can	change	the  video  frame  size, change	datarate for the video
       and/or audio streams contained in the ogg file and it can  also	change
       the video frame rate or audio sample rate.

       Additionally,  since  version  0.8 oggTranscode can add any ogg comment
       and png-pictures	with an	alpha channel can be rendered into  the	 video
       at any time period before and after the resizing	process.

       oggTranscode was	previously called oggResize.

OPTIONS
       -s     Sets  the	 size  of  the	video  frame.  The  size  is  given as
	      <width>x<height>.	 At default, the video frame  size  keeps  the
	      same.

	      Example: -s 320x240

       -d     Sets  the	 datarate  in  byte  per seconds for the video encoder
	      (theora).	This meant to be a upper threshold. So the file	may be
	      smaller than assumed. If not set,	the datarate of	 the  original
	      stream is	used.

	      Example: -d 1024000

       -D     Sets  the	 datarate  in  byte  per seconds for the audio encoder
	      (vorbis).	 If not	set, the datarate of the  original  stream  is
	      used.

	      Example: -D 64000

       -f     Sets  the	frame rate of the video	with numinator and demoninator
	      and is the pictures per second. If only one number is given, the
	      denominator is set to 1. If not set, the framerate of the	origi-
	      nal video	is used.

	      Example: -f 25:2

       -F     Sets the sample frequency	(sample	rate) of  the  audio  data  in
	      Hertz.  If  the sample frequency does not	match the one with the
	      original file, resamling is invoked.

	      Example: -F 32000

       -c

	      Adds comments to the video (theora) stream. Comments  are	 given
	      by  a pair of type and value in the form 'type=value'. More than
	      one comment can be concatenated with a semicolon.	It  is	recom-
	      mended  to use apostrophes as the	command	line may use the semi-
	      colon as a seperator.

	      Example: -c 'AUTHOR=yorn;DATE=03.07.09'

       -C     Adds comments to the audio (vorbis) stream. Comments  are	 given
	      by  a pair of type and value in the form 'type=value'. More than
	      one comment can be concatenated with a semicolon.	It  is	recom-
	      mended  to use apostrophes as the	command	line may use the semi-
	      colon as a seperator.

	      Example: -C 'AUTHOR=yorn;DATE=03.07.09'

       -q     Specifies	the quality for	the resizing process.  Values  can  be
	      chosen  between  1  (best	 quality,  with	 slight	bluring) and 6
	      (worst quality). The default value is 2.

	      Example: -q1

       -p     This option is meant to help creating a preview of a  film.  The
	      number given with	this option defines the	number of frames, that
	      are  omitted.  E.g.  if a	film has 24 frames per second and -p24
	      is given,	the newly created  video  shows	 the  video  24	 times
	      faster  as  only	every  24th frame is used.  This option	can be
	      combined with the	option -f to control the framerate.  With both
	      options nice video previews can be created. If -p	is  used,  the
	      audio stream is ignored.

	      Example: -p 24

       -a     Adds a picture to	the video frame	before it is resized.  The ex-
	      pression for the picture appearances:

	      <picture1.png>[,<startTime>[,<endTime>[,s]]]

	      startTime	 in  seconds - value can be a floating point.  Default
	      startTime	is 0

	      endTime in seconds - value can be	 a  floating  point.   default
	      endTime is -1, which is the end of the stream duration

	      default  s  ist  not  set.  If  s	 is set, the picture slides in
	      smoothly.

	      More than	one picture can	be included.  To concatenate  the  ex-
	      pressions	 use  the  colon.  If the appearance time overlap, the
	      pictures are placed on one another, so the last picture  is  the
	      uppest layer.

	      Example: -a etwas.png,2,7,s:etwasneues.png,5,10

       -A     Adds a picture to	the video frame	after it is resized.

	      The syntax follows the same expression as	with option -a.

EXAMPLE
       oggTranscode -s320x240 -d512000 orig.ogv	new.ogv

       Converts	 a  the	video orig.ogv to the video new.ogv with the new frame
       size 320x240. If	there was an audio stream within the orig.ogv file, it
       is copied into the new file.

       oggTranscode -D64000 -F16000 -N1	orig.ogv new.ogv

       Converts	only the audio stream of file orig.ogv to  a  sample  rate  of
       16kHz, a	datarate of 64 kBit/s and a mono channel.  The video stream is
       copied as is.

       oggTranscode  -s300x200	-D32000	 -d1024000  -A	etwas.png,2,7,s:etwas-
       neues.png,5,10 orig.ogv new.ogv

       Converts	the audio and video stream and adds the	alpha channel  picture
       etwas.png  to the video from second 2 to	second 7 with a	smooth fade in
       and fade	out.  Additionally the alpha channel picture etwasneues.png is
       placed on top of	the video frame	from second 5 to second	10 without any
       fading.

AUTHOR
       Joern Seger <yorn at gmx	dot net>

SEE ALSO
       oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggSlideshow(1),	oggTh-
       umb(1), oggSilence(1)

Linux				   JAN 2010		       OGGTRANSCODE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=oggTranscode&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help