glfs/shareddeps/drivers/libva.xml

<?xml version="1.0" encoding="UTF-8"?>
<!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-download-http "https://github.com/intel/libva/archive/&libva-version;/libva-&libva-version;.tar.gz">
  <!ENTITY libva-download-ftp  " ">
]>

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

    <sect1info>
      <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. The 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>

      

      <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>
      </itemizedlist>

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

      <bridgehead renderas="sect4">Required</bridgehead>
      <para role="required">
        <xref linkend="xorg-env"/> and
        <xref linkend="libdrm"/>
      </para>

      <bridgehead renderas="sect4">Recommended</bridgehead>
      <para role="recommended">
	<xref linkend="mesa"/>
      </para>

      <bridgehead renderas="sect4">Recommended (Runtime)</bridgehead>
      <!-- "nodep" to prevent BLFS tool from blindly installing all the
           drivers -->
      <para role='nodep'>
        The VA API driver suitable for the hardware in your system:
        intel-vaapi-driver (for Intel GPUs provided with
        Haswell CPUs or earlier),
        intel-media (for Intel GPUs provided with
        Broadwell CPUs or later), and
	      <xref linkend="mesa"/> (providing the <literal>r600</literal>,
        <literal>radeonsi</literal>, and <literal>nouveau</literal> VA API
        drivers, for the ATI/AMD Radeon HD 2xxx GPUs and later, and
        <ulink url='https://nouveau.freedesktop.org/VideoAcceleration.html'>
supported
	NVIDIA GPUs</ulink>; there is a circular dependency, read the
	<xref linkend="mesa"/> page for information on how to break it)
      </para>

      <bridgehead renderas="sect4">Optional</bridgehead>
      <para role="optional">
	<xref linkend="wayland"/>, and
        <ulink url="https://gitlab.freedesktop.org/drm/igt-gpu-tools">intel-gpu-tools</ulink>
      </para>

    </sect2>

    <sect2 role="installation">
      <title>Installation of libva</title>
      <!-- libva*.so.2 have been around for a long time...
      <caution>
        <para>
          If you are reinstalling this package, you will need
          to remove the older versions of the libraries.  These are in the
          form of libva*.so.1 and any symbolic links pointing to them.  In
          addition, any packages that use these files need to be rebuilt.
        </para>
      </caution>
      -->
      <para>
        Install <application>libva</application> by running the following
        commands:
      </para>

<screen><userinput>cd build &amp;&amp;

meson setup --prefix=$XORG_PREFIX --buildtype=release &amp;&amp;
ninja</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>ninja install</userinput></screen>

    </sect2>

    <sect2 role="installation">
      <title>32-bit Installation of libva</title>
      
      <para>
        First clean the build directory:
      </para>

<screen><userinput>rm -rf *</userinput></screen>

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

<screen><userinput>CC="gcc -m32" CXX="g++ -m32"                 \
PKG_CONFIG_PATH=$XORG_PREFIX/lib32/pkgconfig \
meson setup --prefix=$XORG_PREFIX            \
            --libdir=$XORG_PREFIX/lib32      \
            --buildtype=release &amp;&amp;
ninja</userinput></screen>

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

<screen role="root"><userinput>DESTDIR=$PWD/DESTDIR ninja install
cp -vr DESTDIR/$XORG_PREFIX/lib32/* $XORG_PREFIX/lib32
rm -rf DESTDIR
ldconfig</userinput></screen>

    </sect2>

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

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

        <seglistitem>
          <seg>
            None
          </seg>
          <seg>
            libva-drm.so,
            libva-glx.so,
            libva.so,
            libva-wayland.so, and
            libva-x11.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>

    </sect2>

  </sect1>