source: multimedia/videoutils/avifile.xml@ 68ad918

<!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 avifile-download-http "http://prdownloads.sourceforge.net/avifile/avifile-0.7-&avifile-version;.tar.gz">
  <!ENTITY avifile-download-ftp  " ">
  <!ENTITY avifile-size          "2.9 MB">
  <!ENTITY avifile-buildsize     "51 MB">
  <!ENTITY avifile-time          "2.85 SBU">
  <!ENTITY codec-download        "http://prdownloads.sourceforge.net/avifile/binaries-011002.tgz">
  <!ENTITY codec-size            "4.4 MB">
  <!ENTITY codec-buildsize       "13 MB">
  <!ENTITY codec-time            "0.01 SBU">
]>

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

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

<para>The <application>Avifile</application> package contains an
<acronym>AVI</acronym> video file player, tools and support libraries. This is 
useful for viewing and editing <acronym>AVI</acronym> files.</para>

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

<sect3><title>Additional downloads</title>
<para><emphasis>CODECs</emphasis></para>
<itemizedlist spacing='compact'>
<listitem><para>Required <acronym>CODEC</acronym>s: 
<ulink url="&codec-download;"/></para></listitem>
<listitem><para>Download size: 
&codec-size;</para></listitem>
<listitem><para>Estimated Disk space required: 
&codec-buildsize;</para></listitem>
<listitem><para>Estimated build time: 
&codec-time;</para></listitem>
</itemizedlist>

<para><emphasis>Patches</emphasis></para>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch (if compiled using 
<application><acronym>GCC</acronym></application>-3.4.x): <ulink 
url="&patch-root;/avifile-&avifile-version;-gcc34-1.patch"/></para>
</listitem>
<listitem><para>Required Patch (if 
<application>FFmpeg</application> is installed): <ulink 
url="&patch-root;/avifile-&avifile-version;-gcc34_ffmpeg-1.patch"/></para>
</listitem>
<listitem><para>Required Patch: <ulink 
url="&patch-root;/avifile-&avifile-version;-freetype_fix-1.patch"/></para>
</listitem></itemizedlist>
</sect3>

<sect3><title><application>Avifile</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="qt"/> and <xref linkend="sdl"/></para>
</sect4>

<sect4><title>Optional</title>
<para><xref linkend="pkgconfig"/>, <xref linkend="libjpeg"/>, 
<xref linkend="libogg"/>, <xref linkend="liba52"/>, 
<xref linkend="ffmpeg"/>, <xref linkend="lame"/>, 
<xref linkend="libmad"/>, <xref linkend="libvorbis"/>, 
<xref linkend="xvid"/> (plugin currently broken), 
<ulink url="http://www.audiocoding.com/modules/mydownloads/">FAAD</ulink> and 
<ulink url="http://dmalloc.com/">Dmalloc</ulink></para>
</sect4>
</sect3>

</sect2>

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

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

<screen><userinput><command>patch -Np1 -i ../avifile-&avifile-version;-gcc34-1.patch &amp;&amp;
patch -Np1 -i ../avifile-&avifile-version;-gcc34_ffmpeg-1.patch &amp;&amp;
patch -Np1 -i ../avifile-&avifile-version;-freetype_fix-1.patch &amp;&amp;
install -d /usr/lib/avifile-0.7/win32 &amp;&amp;
tar xzvf ../binaries-011002.tgz -C /usr/lib/avifile-0.7 &amp;&amp;
./autogen.sh &amp;&amp;
./configure &amp;&amp;
make maintainer-clean &amp;&amp;
./autogen.sh &amp;&amp;
./configure --prefix=/usr \
    --with-win32-path=/usr/lib/avifile-0.7/win32 &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect2>

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

<para><command>./autogen.sh &amp;&amp; ./configure &amp;&amp;
make maintainer-clean &amp;&amp; ./autogen.sh</command>: The 
author of this package used the old autoconf which leads to
problems like configure not being able to detect some libraries and compilation
errors. This is fixed by rebuilding the configuration scripts.
</para>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>Avifile</application> package contains 
<command>aviplay</command>, <command>avibench</command>, 
<command>avifile-config</command>, <command>mmxnow-config</command>, 
<command>avirecompress</command>, <command>avicap</command>, 
<command>avirec</command>, <command>kv4lsetup</command>, 
<command>avicat</command>, <command>avitype</command> and 
<command>avimake</command>.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>aviplay</title>
<para><command>aviplay</command> manages the input formats, the
<acronym>CODEC</acronym>s and the output formats to display 
<acronym>AVI</acronym> video files on your screen.</para></sect3>

<sect3><title>avibench</title>
<para><command>avibench</command> performs a measurement of the 
<application><acronym>AVI</acronym> file support</application> 
library's performance for a file.</para></sect3>

<sect3><title>avifile-config</title>
<para><command>avifile-config</command> is run by 
<command>configure</command> for programs wishing to link to the  
<application>Avifile</application> library.</para></sect3>

<sect3><title>mmxnow-config</title>
<para><command>mmxnow-config</command> is run by 
<command>configure</command> for programs wishing to link to the 
mmxnow library.</para></sect3>

<sect3><title>avirecompress</title>
<para><command>avirecompress</command> is a widget that takes an input file of 
one <acronym>CODEC</acronym> type and converts it into a video file of
another <acronym>CODEC</acronym>.</para></sect3>

<sect3><title>avicap</title>
<para><command>avicap</command> is a widget that displays acquired video from a 
Video For Windows (<acronym>VFW</acronym>) compatible device, like a webcam or 
a TV-tuner.</para></sect3>

<sect3><title>avirec</title>
<para><command>avirec</command> is a command-line video recording 
tool.</para></sect3>

<sect3><title>kv4lsetup</title>
<para><command>kv4lsetup</command> is a small tool which tells 
<application>video4linux</application> about the current video 
mode.</para></sect3>

<sect3><title>avicat</title>
<para><command>avicat</command> takes a set of <acronym>AVI</acronym> files and 
combines them into a single file.</para></sect3>

<sect3><title>avitype</title>
<para><command>avitype</command> will read and display <acronym>AVI</acronym> 
file header information.</para></sect3>

<sect3><title>avimake</title>
<para><command>avimake</command> takes a set of <acronym>JPG</acronym> images 
and creates a movie.</para></sect3>

</sect2>

</sect1>