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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | AUTHOR | SEE ALSO

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

home | help