<?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 openquicktime-download-http "&sourceforge-repo;/openquicktime/openquicktime-&openquicktime-version;-src.tgz">
  <!ENTITY openquicktime-download-ftp  " ">
  <!ENTITY openquicktime-md5sum        "f90bc78b8632c6c254cddf70b4726644">
  <!ENTITY openquicktime-size          "313 KB">
  <!ENTITY openquicktime-buildsize     "8.6 MB">
  <!ENTITY openquicktime-time          "0.11 SBU">
]>

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

  <sect1info>
    <othername>$LastChangedBy: bdubbs $</othername>
    <date>$Date: 2012-05-12 19:05:19 -0400 (Sat, 12 May 2012) $</date>
  </sect1info>

  <title>OpenQuicktime-&openquicktime-version;</title>

  <indexterm zone="openquicktime">
    <primary sortas="a-OpenQuicktime">OpenQuicktime</primary>
  </indexterm>

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

    <para><application>OpenQuicktime</application> is a small library that handles
    the Quicktime file format on most varieties of Unix. Audio and video decoding
    and encoding is provided using a plug-in mechanism.</para>

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

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Required patch: <ulink
        url="&patch-root;/openquicktime-&openquicktime-version;-gcc34-1.patch"></ulink></para>
      </listitem>
      <listitem>
        <para>Optional CODEC: <ulink
        url="http://www.openquicktime.org/codecs.php"/></para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="GLib"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="libjpeg"/></para>

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

  </sect2>

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

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

<screen><userinput>patch -Np1 -i ../openquicktime-&openquicktime-version;-gcc34-1.patch &amp;&amp;
./configure --prefix=/usr &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</userinput></screen>

  </sect2>

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

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

      <seglistitem>
        <seg>dechunk, make_streamable, qtdump, qtinfo, and recover</seg>
        <seg>libopenquicktime.so, quicktime_codec_ms.so,
        quicktime_codec_jpeg.so and quicktime_codec_.mp3.so </seg>
        <seg>/usr/include/openquicktime</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="dechunk">
        <term><command>dechunk</command></term>
        <listitem>
          <para>extracts RGB frames from a movie and writes them as
          PPM images.</para>
          <indexterm zone="openquicktime dechunk">
            <primary sortas="b-dechunk">dechunk</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="make_streamable">
        <term><command>make_streamable</command></term>
        <listitem>
          <para>this program makes the Quicktime file streamable.</para>
          <indexterm zone="openquicktime make_streamable">
            <primary sortas="b-make_streamable">make_streamable</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtdump">
        <term><command>qtdump</command></term>
        <listitem>
          <para>dumps all tables in a movie.</para>
          <indexterm zone="openquicktime qtdump">
            <primary sortas="b-qtdump">qtdump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtinfo">
        <term><command>qtinfo</command></term>
        <listitem>
          <para>reads all the information about the file.</para>
          <indexterm zone="openquicktime qtinfo">
            <primary sortas="b-qtinfo">qtinfo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="recover">
        <term><command>recover</command></term>
        <listitem>
          <para>this program recovers JPEG and PCM audio from a
          corrupted movie.</para>
          <indexterm zone="openquicktime recover">
            <primary sortas="b-recover">recover</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libopenquicktime">
        <term><filename class='libraryfile'>libopenquicktime.{so,a}</filename></term>
        <listitem>
          <para>this is the core library.</para>
          <indexterm zone="openquicktime libopenquicktime">
            <primary sortas="c-libopenquicktime">libopenquicktime.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>
