source: x/installing/libva.xml@ 3240696

<?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 libva-http "http://www.freedesktop.org/software/vaapi/releases">

  <!ENTITY libva-download-http "&libva-http;/libva/libva-&libva-version;.tar.bz2">
  <!ENTITY libva-download-ftp  " ">
  <!ENTITY libva-md5sum        "ad0b55794308ec397d249a0a2a6df27a">
  <!ENTITY libva-size          "760 KB">
  <!ENTITY libva-buildsize     "17 MB">
  <!ENTITY libva-time          "0.2 SBU">

  <!ENTITY libva-intel-driver-download-http "&libva-http;/libva-intel-driver/libva-intel-driver-&libva-intel-driver-version;.tar.bz2">
  <!ENTITY libva-intel-driver-download-ftp  " ">
  <!ENTITY libva-intel-driver-md5sum        "16752f1584398265072129553b7907ce">
  <!ENTITY libva-intel-driver-size          "996 KB">
  <!ENTITY libva-intel-driver-buildsize     "27 MB">
  <!ENTITY libva-intel-driver-time          "0.2 SBU">
]>

<sect2 id="libva" xreflabel="libva-&libva-version;">

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

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

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

  <sect3 role="package">
    <title>Introduction to libva</title>

    <para> 
       The <application>libva</application> package contains a library which
       provides access to hardware accelerated video processing, using hardware
       to accelerate video processing in order to offload the central
       processing unit (CPU) to decode and encode compressed digital video.  VA
       API video decode/encode interface is platform and window system
       independent targeted at Direct Rendering Infrastructure (DRI) in the X
       Window System however it can potentially also be used with direct
       framebuffer and graphics sub-systems for video output. Accelerated
       processing includes support for video decoding, video encoding,
       subpicture blending, and rendering.
    </para>

    &lfs77_checked;

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

    <bridgehead renderas="sect4">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Intel Driver Download (HTTP): <ulink url="&libva-intel-driver-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Intel Driver Download (FTP): <ulink url="&libva-intel-driver-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Intel Driver Download MD5 sum: &libva-intel-driver-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Intel Driver Download size: &libva-intel-driver-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &libva-intel-driver-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &libva-intel-driver-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect4">libva Dependencies</bridgehead>

    <bridgehead renderas="sect5">Required</bridgehead>
    <para role="required">
      <xref linkend="mesalib"/>
    </para>

    <bridgehead renderas="sect5">Optional</bridgehead>
    <para role="optional">
      <xref linkend="doxygen"/> and
      <ulink url="http://wayland.freedesktop.org/">Wayland</ulink>
    </para>

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

  <sect3 role="installation">
    <title>Installation of libva</title>

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

<screen><userinput>mkdir -p m4              &amp;&amp;
autoreconf   -fi         &amp;&amp;
./configure $XORG_CONFIG &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>

  </sect3>

  <sect3 role="installation">
    <title>Installation of libva-intel-driver</title>

    <para>
      The <application>libva-intel-driver</application> is designed 
      specifically for video cards based on an Intel GPU.  
      Install the driver by running the following commands:
    </para>

<screen><userinput>mkdir -p m4              &amp;&amp;
autoreconf -fi           &amp;&amp;
./configure $XORG_CONFIG &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>

  </sect3>

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

    <para>
      <command>mkdir -p m4</command>: This command prevents an error
      that may occur when running autoreconf.
    </para>

    <para>
      <command>autoreconf -fi</command>: This command regenerates
      the configure script to prevent a mandatory test for 
      wayland-scanner when configuring.
    </para>

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

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Drivers</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>
          avcenc, h264encode, jpegenc, loadjpeg, mpeg2vaenc, mpeg2vldemo,
          putsurface, putsurface_wayland, and vainfo
        </seg>
        <seg>
          libva-drm.so, libva-egl.so, libva-glx.so, libva.so,
          libva-tpi.so, libva-wayland.so, and libva-x11.so
        </seg>
        <seg>
          dummy_drv_video.so and i965_drv_video.so
        </seg>
        <seg>
          $XORG_PREFIX/include/va
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="libva-lib">
        <term><filename class="libraryfile">libva.so</filename></term>
        <listitem>
          <para>
            contains API functions which provide access to hardware
            accelerated video processing.
          </para>
          <indexterm zone="libva libva-lib">
            <primary sortas="c-libva">libva.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect3>

</sect2>