source: multimedia/libdriv/libva.xml@ 5c22cb01

<?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        "d6d34cd725a0100a5e476e711838e1b1">
  <!ENTITY libva-size          "744 KB">
  <!ENTITY libva-buildsize     "20 MB">
  <!ENTITY libva-time          "0.2 SBU">
]>

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

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

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

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

  <sect2 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>

    &lfs79_checked;

    <bridgehead renderas="sect3">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="sect3">libva Dependencies</bridgehead>

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

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="mesa"/>,
      <xref linkend="wayland"/> and
      <xref linkend="xorg7-lib"/>
    </para>

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

    <note>
      <para>
        There is a circular dependency between <xref linkend="mesa"/>
        and this package. If you need the VAAPI driver provided by
        <xref linkend="mesa"/>, build this package without EGL and
        GLX support, install <application>MesaLib</application>, then
        reinstall this package with EGL and GLX support. 
      </para>
    </note>

    <bridgehead renderas="sect4">Runtime Dependency</bridgehead>
    <para role="optional">
      At least one of <xref linkend="libva-drivers"/> or the
      driver shipped within <xref linkend="mesa"/> for the
      Radeon hardware.
    </para>

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

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

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

<screen><userinput>autoreconf -fi          &amp;&amp;
./configure --prefix=/usr --disable-static &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="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/static-libraries.xml"/>

    <para>
      <parameter>--disable-egl --disable-glx"</parameter>:
      Use these two switches in the configure command if you would 
      like to build without EGL and GLX support, e.g. to satisfy
      the circular dependency with Mesa.
    </para>

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

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</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>
          /usr/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>

  </sect2>

</sect1>