source: multimedia/videoutils/transcode.xml@ 0598344

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY transcode-download-http "http://www.ligo.caltech.edu/~pehrens/transcode-&transcode-version;.tar.gz">
  <!ENTITY transcode-download-ftp  "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/transcode-&transcode-version;.tar.gz">
  <!ENTITY transcode-md5sum        "9bfef83b7e0fe2c27d25d871fef75a92">
  <!ENTITY transcode-size          "2.6 MB">
  <!ENTITY transcode-buildsize     "60 MB">
  <!ENTITY transcode-time          "1.69 SBU">
]>

<sect1 id="transcode" xreflabel="Transcode-&transcode-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="transcode.html"?>
<title><application>Transcode</application>-&transcode-version;</title>

<sect2>
<title>Introduction to <application>Transcode</application></title>

<para><application>Transcode</application> is a fast, versatile and 
command-line based audio/video everything to everything 
converter. For a rundown of the features and capabilities, along with 
usage examples, visit the Transcode Wiki at 
<ulink url="http://www.transcoding.org/"/>.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&transcode-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&transcode-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &transcode-md5sum;</para></listitem>
<listitem><para>Download size: &transcode-size;</para></listitem>
<listitem><para>Estimated disk space required:
&transcode-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&transcode-time;</para></listitem></itemizedlist>
</sect3>

<!-- 
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink 
url="&patch-root;/transcode-&transcode-version;-fix_largefile_split-1.patch"/></para>
</listitem>
<listitem><para>Required Patch (if 
<application>libdv</application> is installed): <ulink 
url="&patch-root;/transcode-&transcode-version;-fix_dv-1.patch"/></para>
</listitem>
<listitem><para>Required Patch (if compiled with
<application><acronym>GCC</acronym></application>-3.4.x): <ulink 
url="&patch-root;/transcode-&transcode-version;-gcc34-1.patch"/></para>
</listitem>
</itemizedlist>
</sect3>
 -->

<sect3><title><application>Transcode</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="ffmpeg"/></para>
</sect4>

<sect4><title>Recommended</title>
<para><xref linkend="NASM"/> and <xref linkend="lame-package"/></para>
</sect4>

<sect4><title>Optional</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), 
<xref linkend="freetype2"/>, 
<xref linkend="GTK"/>, 
<xref linkend="sdl"/>, 
<xref linkend="libxml2"/>, 
<xref linkend="imagemagick"/>, 
<xref linkend="libjpeg"/> or 
<ulink url="http://sourceforge.net/projects/mjpeg">MMX Jpeg</ulink>, 
<xref linkend="libdv"/>, 
<xref linkend="libdvdread"/>, 
<xref linkend="avifile"/>, 
<xref linkend="libfame"/>, 
<xref linkend="libmpeg3"/>, 
<xref linkend="xvid"/>, 
<xref linkend="LZO"/>, 
<xref linkend="liba52"/>, 
<xref linkend="libogg"/>, 
<xref linkend="libvorbis"/>, 
<ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>, 
<ulink url="http://libquicktime.sourceforge.net/">libquicktime</ulink>, 
<ulink url="http://www.theora.org/">Theora</ulink>, 
<ulink url="http://lvempeg.sourceforge.net/">LVE</ulink>, 
<ulink url="http://www.netlib.org/pvm3/">PVM3</ulink> and 
<ulink url="http://loci.cs.utk.edu/">LoRS/IBP</ulink></para>

<para>Though <application>Transcode</application> has no compile-time 
requirement for <xref linkend="mplayer"/>'s shared post-processing library, 
<application>Transcode</application> can use it at run-time.</para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>Transcode</application></title>

<para>Install <application>Transcode</application> by running the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr --without-x &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><option>--without-x</option>: Omit this parameter if you have an 
<application>X</application> Window System installed and you want to compile 
X11 dependent filter plugins.</para>

<para><option>--enable-netstream</option>: This parameter enables network 
streaming support.</para>

<para>Building support for most of the dependency packages requires using 
options passed to the <command>configure</command> script. View the 
<filename>INSTALL</filename> file and the output from 
<command>./configure --help</command> for complete information about 
enabling dependency packages.</para>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>Transcode</application> package contains 
<command>transcode</command>,
<command>tccat</command>, 
<command>tcdecode</command>,
<command>tcdemux</command>, 
<command>tcextract</command>,
<command>tcframe</command>, 
<command>tcmodinfo</command>,
<command>tcmp3cut</command>,
<command>tcmplex</command>,
<command>tcprobe</command>,
<command>tcrequant</command>,
<command>tcscan</command>, 
<command>tcxmlcheck</command>,
<command>tcxpm2rgb</command>,
<command>avicodec</command>,
<command>avidump</command>, 
<command>avifix</command>,
<command>aviindex</command>,
<command>avimerge</command>,
<command>avisplit</command>, 
<command>avisync</command>
and input/filter/output modules.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>transcode</title>
<para><command>transcode</command> is the encoder's user interface that handles
the plugins and other programs, being the glue between the modules.
There are several well documented usage examples on both the homepage
and the documentation included in the package.</para></sect3>

<sect3><title>tccat</title>
<para><command>tccat</command> concatenates input files using the input plugins
of <application>Transcode</application>.</para></sect3>

<sect3><title>tcdecode</title>
<para><command>tcdecode</command> is used to decode input files to
raw video and <acronym>PCM</acronym> audio stream.</para></sect3>

<sect3><title>tcdemux</title>
<para><command>tcdemux</command> demultiplexes (separates) audio/video input 
that contains multiple streams, e.g., <acronym>VOB</acronym> files.</para>
</sect3>

<sect3><title>tcextract</title>
<para><command>tcextract</command> grabs single streams from a file containing 
multiple streams.</para></sect3>

<sect3><title>tcframe</title>
<para><command>tcframe</command> processes single video frames for different 
color encodings (<acronym>RGB</acronym> &gt;-&lt; <acronym>YUV</acronym> or 
similar).</para></sect3>

<sect3><title>tcmodinfo</title>
<para><command>tcmodinfo</command> loads a supplied
<application>Transcode</application> filter module and prints its
parameters.</para></sect3>

<sect3><title>tcmp3cut</title>
<para><command>tcmp3cut</command> is a tool which can cut
<acronym>MP3</acronym> streams at milliseconds positions.</para></sect3>

<sect3><title>tcprobe</title>
<para><command>tcprobe</command> prints information about the input file 
format.</para></sect3>

<sect3><title>tcrequant</title>
<para><command>tcrequant</command> is a tool which can requantize an
<acronym>MPEG</acronym>-2 elementary stream.</para></sect3> 

<sect3><title>tcscan</title>
<para><command>tcscan</command> performs several measurements on the given 
input data.</para></sect3>

<sect3><title>tcxmlcheck</title>
<para><command>tcxmlcheck</command> checks information in a
<acronym>SMIL</acronym> input file.</para></sect3>

<sect3><title>avicodec</title>
<para><command>avicodec</command> indicates or changes
<acronym>FOURCC</acronym> <acronym>CODEC</acronym> flag in an
<acronym>AVI</acronym> file.</para></sect3>

<sect3><title>avidump</title>
<para><command>avidump</command> dumps audio or video stream of a given 
<acronym>AVI</acronym> file to stdout (for <acronym>AVI</acronym>
conversion or extraction of audio streams).</para></sect3>

<sect3><title>avifix</title>
<para><command>avifix</command> fixes the header of an
<acronym>AVI</acronym> file.</para></sect3>

<sect3><title>aviindex</title>
<para><command>aviindex</command> writes a text file describing the
index of an <acronym>AVI</acronym> file.</para></sect3>

<sect3><title>avimerge</title>
<para><command>avimerge</command> merges <acronym>AVI</acronym> files of the 
same format. Do not try to merge <acronym>AVI</acronym> files of different 
formats, it will most likely result in errors (and format means same bitrates, 
too!).</para></sect3>

<sect3><title>avisplit</title>
<para><command>avisplit</command> splits <acronym>AVI</acronym> files
into multiple files.</para></sect3>

<sect3><title>avisync</title>
<para><command>avisync</command> can shift audio in
<acronym>AVI</acronym> files for better synchronizing of audio and video
data signal.</para></sect3>

<sect3><title>input/filter/output modules</title>
<para>Depending on the external libraries that are used, there are a
great number of plugins to convert audio and video input to raw format,
process raw video and audio and convert raw audio and video to other
formats to be written into a file type of choice. Read the
documentation.</para></sect3>

</sect2>

</sect1>