source: multimedia/videoutils/transcode.xml@ 01062dd

<!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://zebra.fh-weingarten.de/~transcode/pre/transcode-&transcode-version;.tar.bz2">
  <!ENTITY transcode-download-ftp  " ">
  <!ENTITY transcode-size          "2.8 MB">
  <!ENTITY transcode-buildsize     "88 MB">
  <!ENTITY transcode-time          "2.41 SBU">
]>

<sect1 id="transcode" xreflabel="transcode-&transcode-version;">
<?dbhtml filename="transcode.html"?>
<title>transcode-&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.</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 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><application>transcode</application> dependencies</title>
<sect4><title>Optional</title>
<para>
<xref linkend="NASM"/>,
<xref linkend="lame"/>,
X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="mplayer"/>,
<xref linkend="imagemagick"/>, 
<xref linkend="libdv"/>,
<xref linkend="libdvdread"/>
<ulink url="http://mjpeg.sourceforge.net/">mjpeg tools</ulink>,
<xref linkend="SDL"/>, 
<xref linkend="qt"/>, 
<xref linkend="avifile"/>,
<xref linkend="libfame"/>, 
<xref linkend="libmpeg3"/>,
<xref linkend="xvid"/>, 
<xref linkend="LZO"/>, 
<xref linkend="libxml2"/>,
<xref linkend="liba52"/>,
<xref linkend="ffmpeg"/>, 
<xref linkend="libmad"/>, 
<xref linkend="curl"/>,
<xref linkend="libogg"/>,
<xref linkend="libvorbis"/>,
<ulink url="http://www.theora.org/">Theora</ulink>,
<xref linkend="libjpeg"/>,
<xref linkend="GLib"/>,
<xref linkend="GTK"/>,
<xref linkend="freetype2"/>,
<xref linkend="libmpeg3"/> and
<xref linkend="openquicktime"/>
</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><parameter>--without-x</parameter>: Omit this switch if you have
an <application>X</application>
Window System installed and you want to compile X11 dependent filter
plugins.</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>