


transcode(export)       3th February 2008       transcode(export)


NAME
       transcode - export modules collection

SYNOPSIS
       transcode -y module[,module[,module]] [other options]

COPYRIGHT
       transcode  is  Copyright  (C)  2001-2003 by Thomas Oestreich, 2003-2004
       Tilmann Bitterberg, 2004-2009 Transcode Team

ENCODER PARAMETERS STRING
       Module-dependent parameters can be  passed  to  encoder  using  the  -F
       transcode(1) option:

           transcode -F codec_string

       Those  parameters tune the general behaviour of the export module. More
       specific settings can fine-tune the export settings. Those settings are
       passed  to  export modules through module options or through the module
       configuration file; both configuration file and options can be  present
       at  same  time:  in  that case, the options overrides the configuration
       file. Passing option strings to export modules is  done  like  to  pass
       options to filter modules: The syntax is:

           transcode -y vmod=options,amod=options

       see transcode_filter(1) for full reference and examples.

       The  -F  parameter has different meanings for different export modules,
       as documented on section below.


ENCODER MODULES PARAMETERS
       ffmpeg:
                The codec String for the codec you  want  to  encode.  Example
              values  are  -F  mpeg4  or -F mpeg1video or -F huffyuv. To get a
              list of valid codecs, use -F list


       im:      The name of the image format you want to export. Example  val-
              ues are '-F jpg' (default) or '-F png' or -F 'gif'. With -F jpg,
              -w gives quality in percent. With -F png, the first digit of  -w
              gives  compression level, the second one gives quality, so -w 95
              selects best compression level (9) and 5 means PNG adaptive fil-
              tering.


       jpg:      The quality of the JPEG encode in percent. Example values are
              '-F 75' (default) or '-F 100'


       mov:     Syntax: -F "<vcodec>,<acodec>[,<parameters>]"
                  <vcodec> = Videocodec to encode with. Default: "mjpa"
                  <acodec> = Audiocodec to encode with. Default: "ima4"



1                            modules                            1





transcode(export)       3th February 2008       transcode(export)


                  <parameters> = A comma seperated list of parameters
                                 to be passed to the codec.

              Note: You can use "list" instead of a video/audiocodec or param-
              eter to get a list of supported options.


       mpeg:    Syntax: -F "<base-profile>[,<resizer-mode>[,user-profile]]"
                  <base-profile> can be one of
                    '1' = MPEG 1 (default)
                    'b' = big MPEG 1 (experimental)
                    'v' = VCD
                    's' = SVCD
                    '2' = MPEG2
                    'd' = DVD compliant
                  <resizer-mode> can be one of
                     0 = disable resizer (default)
                     1 = 352x288
                     2 = 480x480
                     3 = 480x576
                     4 = 352x240
                  <user-profile>  is  a  filename of the profile file. You can
              either specify the absolute path to the file or if you transcode
              will look for it in the directory where you started transcode.


       mpeg2enc:
                Syntax: -F "<base-profile>[,<options_string>]"
                  <base-profile> can be one of
                    '0' = Generic MPEG1 (default)
                    '1' = Standard VCD
                    '2' = User VCD
                    '3' = Generic MPEG2
                    '4' = Standard SVCD
                    '5' = User SVCD
                    '6' = Manual parameter mode
                    '8' = DVD
                  <options_string>  will  be passed down to mpeg2enc untouched
              by transcode. Have a look at the manpage for mpeg2enc.


       raw:     The name of the image format to use  for  uncompressed  video.
              Examples  are I420 (YUV 4:2:0 planar), YV12 (the same thing with
              U and V reversed), or UYVY (YUV 4:2:2 packed). Use "-F help"  to
              get a list of formats.


EXPORT MODULES
       If no module is specified through the -y option, transcode will use the
       null module for both audio and video export. If a multiplex  module  is
       given,  by  giving  three  export  module  names instead the usual two,
       transcode will use the new-style encode/multiplex modules (still  under
       development, see the encode and multiplex directories); if no multiplex
       module is given, the traditional export modules will be used.



1                            modules                            2





transcode(export)       3th February 2008       transcode(export)


       To see what export modules are avalaible for your  transcode  installa-
       tion, do a

           ls -1 $( tcmodinfo -p )/export*.so

       A complete transcode installation has the following export modules:

              ac3 - (video) null | (audio) ac3
                  This  module  has no compile-time dependencies.  At run-time
                  ffmpeg must be present.  Support for this module is good.
                      Encodes audio (raw PCM) to AC3 via the ffmpeg binary.
                      Supported processing formats: audio - PCM, video - none

              af6 - (video) Win32 dll | (audio) MPEG/AC3/PCM
                  At compile-time libavifile must be available.   At  run-time
                  libavifile  and  win32codecs  must  be present.  Support for
                  this module is good.
                      Interface to the avifile library which allows the use of
                      win32codec on the linux-x86 platform.
                      Supported processing formats: audio - RAW (pass-through)
                      PCM AC3, video - RGB YUV

              divx5 - (video) DivX 5.xx | (audio) MPEG/AC3/PCM
                  At compile-time libmp3lame (only for MPEG audio  layer  III)
                  must  be available.  At run-time divx4linux (new) and libdi-
                  vxencore.so must be present.  Support  for  this  module  is
                  good.
                      Encodes  MPEG4  video  using  the closed-source binaries
                      from divx.com to an AVI container.
                      Supported processing formats: audio - RAW (pass-through)
                      PCM AC3, video - RGB YUV

              dv - (video) Digital Video | (audio) MPEG/AC3/PCM
                  At  compile-time  libdv  and libmp3lame (only for MPEG audio
                  layer III) must be available.  At  run-time  libdv  must  be
                  present.  Support for this module is good.
                      Encodes  DV  into an AVI container. DV is a codec devel-
                      oped by Sony and is often used in digital camcorders.
                      Supported processing formats: audio - PCM AC3,  video  -
                      RGB YUV

              dvraw - (video) Digital Video | (audio) PCM
                  At  compile-time libdv must be available.  At run-time libdv
                  must be present.  Support for this module is good.
                      Encodes DV into a DV file. DV is a  codec  developed  by
                      Sony  and  is often used in digital camcorders. A raw DV
                      file can be played back into the camcorder.
                      Supported processing formats: audio - PCM, video  -  RAW
                      (pass-through) RGB YUV YUV422

              ffmpeg - (video) * | (audio) MPEG/AC3/PCM
                  At  compile-time  libmp3lame (only for MPEG audio layer III)
                  must be available.  This module has  no  run-time  dependen-
                  cies.  Support for this module is good.



1                            modules                            3





transcode(export)       3th February 2008       transcode(export)


                      Encodes many different formats to both AVI and raw. Sup-
                      ported are mpeg1video, mpeg2video, mpeg4,  mjpeg,  h263,
                      h263p, wmv1, wmv2, rv10, msmpeg4, msmpeg4v2, huffyuv and
                      dvvideo.
                      Supported processing formats: audio  RAW  (pass-through)
                      PCM AC3, video - RGB YUV YUV422

              im - (video) * | (audio) MPEG/AC3/PCM
                  At compile-time libImageMagick must be available.  This mod-
                  ule has no run-time dependencies.  Support for  this  module
                  is good.
                      Encodes   image   sequences  by  using  the  ImageMagick
                      library. ImageMagick is able to handle a lot of  differ-
                      ent image formats such as png, jpg, miff, tiff, etc. Use
                      -F to select the desired format.
                      Supported processing formats: audio - RAW (pass-through)
                      PCM, video - RGB YUV

              jpg - (video) * | (audio) MPEG/AC3/PCM
                  At  compile-time libjpeg must be available.  This module has
                  no run-time dependencies.  Support for this module is  good.
                      Encodes  jpg  image sequences using libjpeg. Faster than
                      ImageMagick. Use -F to select the compression quality.
                      Supported processing formats: audio - RAW (pass-through)
                      PCM, video - RGB YUV

              lame - (audio) MPEG 1/2
                  At  compile-time  libmp3lame (only for MPEG audio layer III)
                  must be available.  At run-time lame and sox  must  be  pre-
                  sent.  Support for this module is good.
                      An  audio-only encoder which drives the lame binary. The
                      tool sox is used to do resampling if  required.  Encodes
                      to a MP3 file.
                      Supported processing formats: audio - PCM, video - none

              lzo - (video) LZO real-time compression | (audio) MPEG/AC3/PCM
                  At  compile-time  liblzo and libmp3lame (only for MPEG audio
                  layer III) must be available.  This module has  no  run-time
                  dependencies.  Support for this module is good.
                      Encodes  video  using  a  loss-less real-time LZO codec.
                      This codec is a homegrown invention of transcode and  is
                      intended  as an intermediate storage format. MPlayer can
                      playback LZO-based AVI files as well.
                      Supported processing formats: audio - RAW (pass-through)
                      PCM AC3, video - RAW (pass-through) RGB YUV DV

              mov - (video) * | (audio) *
                  At compile-time libquicktime must be available.  At run-time
                  libquicktime must be present.  Support for  this  module  is
                  fair.
                      Interface to the quicktime library.
                      Supported  processing  formats: audio - PCM, video - RAW
                      (pass-through) RGB YUV YUV422 YUY2




1                            modules                            4





transcode(export)       3th February 2008       transcode(export)


              mp2 - (video) null | (audio) MPEG 1/2
                  This module has no compile-time dependencies.   At  run-time
                  ffmpeg  and sox must be present.  Support for this module is
                  good.
                      Encodes audio (raw PCM) to MPEG 1 Layer 2 audio aka mp2.
                      Additionaly  it can change the speed of the audio stream
                      by a factor you can specify. See docs/export_mp2.txt.
                      Supported processing formats: audio - PCM, video - none

              mp2enc - (audio) MPEG 1/2
                  At compile-time mjpegtools must be available.   At  run-time
                  mp2enc must be present.  Support for this module is good.
                      Drives   the   mp2enc   binary   and   writes   an   MP2
                      (MPEG1-Layer2) file. Useful for when encoding to SVCD to
                      be multiplexed with mplex after encoding.
                      Supported processing formats: audio - PCM, video - none

              mpeg2enc - (video) MPEG 1/2
                  At  compile-time  mjpegtools must be available.  At run-time
                  mpeg2enc must be present.  Support for this module is  good.
                      Drives  the  mpeg2enc binary. mpeg2enc is a very feature
                      rich MPEG encoder, have a look at its  manpage.  Encodes
                      generic mpeg1, VCD, SVCD, MPEG2 and DVD type video.
                      Supported  processing formats: audio - none, video - RGB
                      YUV

              null - (video) null | (audio) null
                  This module has no compile-time dependencies.   This  module
                  has  no  run-time  dependencies.  Support for this module is
                  good.
                      Data sink. Does nothing else than discarding data.
                      Supported processing formats: audio - none, video - none

              ogg - (video) null | (audio) ogg
                  This  module  has no compile-time dependencies.  At run-time
                  oggenc must be present.  Support for this module is good.
                      Drives the oggenc binary. Encodes  an  Ogg/Vorbis  file.
                      Resamples.
                      Supported processing formats: audio - PCM, video - none

              ppm - (video) PPM/PGM | (audio) MPEG/AC3/PCM
                  This  module  has no compile-time dependencies.  This module
                  has no run-time dependencies.  Support for  this  module  is
                  good.
                      Writes  an image sequence of PGM or PPM files. PPM is an
                      old format and there are several tools around to manipu-
                      late such files.
                      Supported processing formats: audio - RAW (pass-through)
                      PCM AC3, video - RGB YUV

              pvm - (video) * | (audio) *
                  At compile-time libpvm3 must be available.  At run-time  pvm
                  must be present.  Support for this module is good.
                      Meta  module.  It  allows  transcode to be used in a PVM



1                            modules                            5





transcode(export)       3th February 2008       transcode(export)


                      cluster. See docs/export_pvm.txt
                      Supported processing formats: audio - RAW (pass-through)
                      PCM  AC3,  video  - RAW (pass-through) RGB YUV DV YUV422
                      YUY2

              raw - (video) * | (audio) MPEG/AC3/PCM
                  This module has no compile-time dependencies.   This  module
                  has  no  run-time  dependencies.  Support for this module is
                  good.
                      Can write uncompressed streams to an AVI file as well as
                      raw  mpeg2  files in pass-through mode. The image format
                      for uncompressed streams can be selected with -F (use -F
                      help to see available formats).
                      Supported processing formats: audio - RAW (pass-through)
                      PCM AC3, video - RAW (pass-through) RGB YUV DV YUV422

              toolame - (audio) MPEG 1/2
                  This module has no compile-time dependencies.   At  run-time
                  toolame and sox must be present.  Support for this module is
                  good.
                      Drives the toolame binary to create  MP2  audio  tracks.
                      Sox is used for resampling if requested.
                      Supported processing formats: audio - PCM, video - none

              wav - (audio) WAVE PCM
                  This  module  has no compile-time dependencies.  This module
                  has no run-time dependencies.  Support for  this  module  is
                  good.
                      Creates  WAVE  PCM  files  with  interleaved  audio  for
                      stereo.
                      Supported processing formats: audio - PCM, video  -  RAW
                      (pass-through) RGB YUV

              xvid4 - (video) XviD 1.0.x series (aka API 4.0) | (audio)
              MPEG/AC3/PCM
                  At compile-time libmp3lame (only for MPEG audio  layer  III)
                  must  be  available.   At  run-time libxvidcore.so.4 must be
                  present.  Support for this module is good.
                      Encodes MPEG4 video using  the  library  available  from
                      xvid.org.  Check  out the library from xvidcvs using cvs
                      -d :pserver:anonymous@cvs.xvid.org:/xvid co  -rdev-api-4
                      xvidcore.  There is also a tool available to create con-
                      figuration   files   for   this    xvid    version    at
                      http://zebra.fh-weingarten.de/transcode/xvid4conf.   The
                      output can either be an AVI file or a  MPEG4  elementary
                      stream (with -F raw).
                      Supported processing formats: audio - RAW (pass-through)
                      PCM AC3, video - RGB YUV YUV422

              yuv4mpeg - (video) YUV4MPEG2 | (audio) MPEG/AC3/PCM
                  At compile-time mjpegtools must be available.   This  module
                  has  no  run-time  dependencies.  Support for this module is
                  good.
                      Writes the uncompressed  raw  YUV  data  in  a  YUV4MPEG



1                            modules                            6





transcode(export)       3th February 2008       transcode(export)


                      format as used by the lav* and mjpeg* tools.
                      Supported processing formats: audio - RAW (pass-through)
                      PCM AC3, video - RGB YUV




AUTHORS
       transcode was written by Thomas Oestreich
       <ostreich@theorie.physik.uni-goettingen.de>  with  contributions   from
       many others.  See AUTHORS for details.


SEE ALSO
       transcode(1), tcmodinfo(1), transcode_import(1), transcode_filter(1),










































1                            modules                            7


