source: multimedia/libdriv/libquicktime.xml@ 52b1b8c

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY libquicktime-download-http "&sourceforge-repo;/libquicktime/libquicktime-&libquicktime-version;.tar.gz">
  <!ENTITY libquicktime-download-ftp  "&gentoo-ftp-repo;/libquicktime-&libquicktime-version;.tar.gz">
  <!ENTITY libquicktime-md5sum        "9a82a1546408605ea8337b3a7c78786e">
  <!ENTITY libquicktime-size          "1000 KB">
  <!ENTITY libquicktime-buildsize     "17 MB">
  <!ENTITY libquicktime-time          "0.7 SBU (includes building all codec modules)">
]>

<sect1 id="libquicktime" xreflabel="libquicktime-&libquicktime-version;">
  <?dbhtml filename="libquicktime.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>libquicktime-&libquicktime-version;</title>

  <indexterm zone="libquicktime">
    <primary sortas="a-libquicktime">libquicktime</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to libquicktime</title>

    <para>The <application>libquicktime</application> package contains the
    <filename class='libraryfile'>libquicktime</filename> library, various
    plugins and codecs, along with graphical and command line utilities used
    for encoding and decoding Quicktime files. This is useful for reading and
    writing files in the Quicktime format. The goal of the project is to
    enhance, while providing compatibility with, the
    <application>Quicktime 4 Linux</application> library.</para>

    &lfs70_checked;

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

    <bridgehead renderas="sect3">libquicktime Dependencies</bridgehead>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="alsa"/>,
    <xref linkend="faac"/>,
    <xref linkend="faad2"/>,
    <xref linkend="ffmpeg"/>,
    <xref linkend="gtk2"/>,
    <xref linkend="lame"/>,
    <xref linkend="libdv"/>,
    <xref linkend="libjpeg"/>,
    <xref linkend="libpng"/>,
    <xref linkend="libvorbis"/>,
    <ulink url="http://www.diracvideo.org">Schroedinger</ulink>,
    <ulink url="http://developers.videolan.org/x264.html">x264</ulink> and
    <xref linkend="x-window-system"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/libquicktime"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of libquicktime</title>

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

<screen><userinput>./configure --prefix=/usr \
            --docdir=/usr/share/doc/libquicktime-&libquicktime-version; \
            --without-doxygen &amp;&amp;
make</userinput></screen>

    <para>This package does not come with a test suite.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/libquicktime-&libquicktime-version; &amp;&amp;
install -v -m644    README doc/{*.txt,*.html,mainpage.incl} \
                    /usr/share/doc/libquicktime-&libquicktime-version;</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><parameter>--with-libdv</parameter>: Build with libdv support.
    Not enabled by default.</para>

    <para><parameter>--without-doxygen</parameter>: This is necessary if you do
    not have Doxygen, omit this if installed.</para>

    <para><parameter>--enable-gpl</parameter>: Changes the licence to GPL. This
    enables some extra plugins, such as FAAC, FAAD2, and x264.</para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>libquicktime_config, lqtplay, lqtremux, lqt_transcode,
        qt2text, qtdechunk, qtdump, qtinfo, qtrechunk, qtstreamize and
        qtyuv4toyuv</seg>
        <seg>libquicktime.so and several plugin codec libraries</seg>
        <seg>/usr/include/lqt, /usr/lib/libquicktime and
        /usr/share/doc/libquicktime-&libquicktime-version;</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="libquicktime_config">
        <term><command>libquicktime_config</command></term>
        <listitem>
          <para>is a graphical front end to examine and configure the
          available <application>libquicktime</application> audio and
          video codecs.</para>
          <indexterm zone="libquicktime libquicktime_config">
            <primary sortas="b-libquicktime_config">libquicktime_config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lqtplay">
        <term><command>lqtplay</command></term>
        <listitem>
          <para>is a simple Quicktime movie player for X11.</para>
          <indexterm zone="libquicktime lqtplay">
            <primary sortas="b-lqtplay">lqtplay</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lqt_transcode">
        <term><command>lqt_transcode</command></term>
        <listitem>
          <para>is a command-line program used to encode video and/or audio
          files from one format to another.</para>
          <indexterm zone="libquicktime lqt_transcode">
            <primary sortas="b-lqt_transcode">lqt_transcode</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtdechunk">
        <term><command>qtdechunk</command></term>
        <listitem>
          <para>can take movies containing rgb frames and write them out as
          ppm images.</para>
          <indexterm zone="libquicktime qtdechunk">
            <primary sortas="b-qtdechunk">qtdechunk</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtrechunk">
        <term><command>qtrechunk</command></term>
        <listitem>
          <para>concatenates input frames into a Quicktime movie.</para>
          <indexterm zone="libquicktime qtrechunk">
            <primary sortas="b-qtrechunk">qtrechunk</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtyuv4toyuv">
        <term><command>qtyuv4toyuv</command></term>
        <listitem>
          <para>is used to write a YUV4 encoded movie as a planar YUV 4:2:0
          file.</para>
          <indexterm zone="libquicktime qtyuv4toyuv">
            <primary sortas="b-qtyuv4toyuv">qtyuv4toyuv</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libquicktime-lib">
        <term><filename class='libraryfile'>libquicktime.so</filename></term>
        <listitem>
          <para>is a library for reading and writing Quicktime files. It
          provides convenient access to Quicktime files with a variety of
          supported codecs. The library contains new functions integrated with
          all the original Quicktime 4 Linux library functions used to encode
          and decode Quicktime files.</para>
          <indexterm zone="libquicktime libquicktime-lib">
            <primary sortas="c-libquicktime">libquicktime.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>