[ab4fdfc] | 1 | <?xml version="1.0" encoding="UTF-8"?>
|
---|
[07584d8] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[58c3bfd] | 7 | <!ENTITY libvdpau-version "1.5">
|
---|
| 8 |
|
---|
[e1a98063] | 9 | <!ENTITY libvdpau-download-http "https://gitlab.freedesktop.org/vdpau/libvdpau/-/archive/&libvdpau-version;/libvdpau-&libvdpau-version;.tar.bz2">
|
---|
[07584d8] | 10 | <!ENTITY libvdpau-download-ftp " ">
|
---|
[384f06b] | 11 | <!ENTITY libvdpau-md5sum "148a192110e7a49d62c0bf9ef916c099">
|
---|
[4e3bb60] | 12 | <!ENTITY libvdpau-size "140 KB">
|
---|
[384f06b] | 13 | <!ENTITY libvdpau-buildsize "4.6 MB (with tests)">
|
---|
[e5e7a1d] | 14 | <!ENTITY libvdpau-time "less than 0.1 SBU (with tests)">
|
---|
[07584d8] | 15 | ]>
|
---|
| 16 |
|
---|
[9a612888] | 17 | <sect1 id="libvdpau" xreflabel="libvdpau-&libvdpau-version;">
|
---|
| 18 | <?dbhtml filename="libvdpau.html"?>
|
---|
[4c24eb0a] | 19 |
|
---|
[9a612888] | 20 | <sect1info>
|
---|
[4c24eb0a] | 21 | <date>$Date$</date>
|
---|
[9a612888] | 22 | </sect1info>
|
---|
[4c24eb0a] | 23 |
|
---|
| 24 | <title>libvdpau-&libvdpau-version;</title>
|
---|
| 25 |
|
---|
| 26 | <indexterm zone="libvdpau">
|
---|
| 27 | <primary sortas="a-libvdpau">libvdpau</primary>
|
---|
| 28 | </indexterm>
|
---|
| 29 |
|
---|
[9a612888] | 30 | <sect2 role="package">
|
---|
[4c24eb0a] | 31 | <title>Introduction to libvdpau</title>
|
---|
| 32 |
|
---|
| 33 | <para>
|
---|
| 34 | The <application>libvdpau</application> package contains a library which
|
---|
| 35 | implements the VDPAU library.
|
---|
| 36 | </para>
|
---|
| 37 |
|
---|
| 38 | <para>
|
---|
| 39 | VDPAU (Video Decode and Presentation API for Unix) is an open source
|
---|
| 40 | library (libvdpau) and API originally designed by Nvidia for its GeForce
|
---|
[f9a4671] | 41 | 8 series and later GPU hardware targeted at the X Window System.
|
---|
[4c24eb0a] | 42 | This VDPAU API allows video programs to offload portions of the video
|
---|
| 43 | decoding process and video post-processing to the GPU video-hardware.
|
---|
| 44 | </para>
|
---|
| 45 |
|
---|
| 46 | <para>
|
---|
| 47 | Currently, the portions capable of being offloaded by VDPAU onto the GPU
|
---|
| 48 | are motion compensation (mo comp), inverse discrete cosine transform
|
---|
| 49 | (iDCT), VLD (variable-length decoding) and deblocking for MPEG-1, MPEG-2,
|
---|
| 50 | MPEG-4 ASP (MPEG-4 Part 2), H.264/MPEG-4 AVC and VC-1, WMV3/WMV9 encoded
|
---|
| 51 | videos. Which specific codecs of these that can be offloaded to the
|
---|
| 52 | GPU depends on the version of the GPU hardware; specifically,
|
---|
| 53 | to also decode MPEG-4 ASP (MPEG-4 Part 2), Xvid/OpenDivX (DivX 4), and
|
---|
| 54 | DivX 5 formats, a GeForce 200M (2xxM) Series (the eleventh generation of
|
---|
| 55 | Nvidia's GeForce graphics processing units) or newer GPU hardware is
|
---|
| 56 | required.
|
---|
| 57 | </para>
|
---|
| 58 |
|
---|
[d4dc5bae] | 59 | &lfs122_checked;
|
---|
[4c24eb0a] | 60 |
|
---|
[9a612888] | 61 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
[4c24eb0a] | 62 | <itemizedlist spacing="compact">
|
---|
| 63 | <listitem>
|
---|
| 64 | <para>
|
---|
| 65 | Download (HTTP): <ulink url="&libvdpau-download-http;"/>
|
---|
| 66 | </para>
|
---|
| 67 | </listitem>
|
---|
| 68 | <listitem>
|
---|
| 69 | <para>
|
---|
| 70 | Download (FTP): <ulink url="&libvdpau-download-ftp;"/>
|
---|
| 71 | </para>
|
---|
| 72 | </listitem>
|
---|
| 73 | <listitem>
|
---|
| 74 | <para>
|
---|
| 75 | Download MD5 sum: &libvdpau-md5sum;
|
---|
| 76 | </para>
|
---|
| 77 | </listitem>
|
---|
| 78 | <listitem>
|
---|
| 79 | <para>
|
---|
| 80 | Download size: &libvdpau-size;
|
---|
| 81 | </para>
|
---|
| 82 | </listitem>
|
---|
| 83 | <listitem>
|
---|
| 84 | <para>
|
---|
| 85 | Estimated disk space required: &libvdpau-buildsize;
|
---|
| 86 | </para>
|
---|
| 87 | </listitem>
|
---|
| 88 | <listitem>
|
---|
| 89 | <para>
|
---|
| 90 | Estimated build time: &libvdpau-time;
|
---|
| 91 | </para>
|
---|
| 92 | </listitem>
|
---|
| 93 | </itemizedlist>
|
---|
| 94 |
|
---|
[9a612888] | 95 | <bridgehead renderas="sect3">libvdpau Dependencies</bridgehead>
|
---|
[4c24eb0a] | 96 |
|
---|
[9a612888] | 97 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
[4c24eb0a] | 98 | <para role="required">
|
---|
| 99 | <xref linkend="xorg7-lib"/>
|
---|
| 100 | </para>
|
---|
| 101 |
|
---|
[e26871f] | 102 | <bridgehead renderas="sect4">Recommended (Runtime)</bridgehead>
|
---|
| 103 | <!-- "nodep" to prevent BLFS tool from blindly installing all the
|
---|
| 104 | drivers -->
|
---|
| 105 | <para role='nodep'>
|
---|
| 106 | The VDPAU driver suitable for the hardware in your system:
|
---|
| 107 | <xref linkend='libvdpau-va-gl'/> (for Intel GPUs) and
|
---|
| 108 | <xref linkend='mesa'/> (providing the <literal>r600</literal>,
|
---|
[a39688a] | 109 | <literal>radeonsi</literal>, and <literal>nouveau</literal> VDPAU
|
---|
| 110 | drivers, for the ATI/AMD Radeon HD 2xxx GPUs and later, and
|
---|
[e26871f] | 111 | <ulink url='https://nouveau.freedesktop.org/VideoAcceleration.html'>
|
---|
| 112 | supported
|
---|
| 113 | NVIDIA GPUs</ulink>; Mesa must be built after this package for these
|
---|
| 114 | drivers)
|
---|
| 115 | </para>
|
---|
| 116 |
|
---|
[9a612888] | 117 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
[4c24eb0a] | 118 | <para role="optional">
|
---|
| 119 | <xref linkend="doxygen"/>,
|
---|
| 120 | <xref linkend="graphviz"/>, and
|
---|
| 121 | <xref linkend="texlive"/> or <xref linkend="tl-installer"/>
|
---|
| 122 | </para>
|
---|
| 123 |
|
---|
[9a612888] | 124 | </sect2>
|
---|
[4c24eb0a] | 125 |
|
---|
[9a612888] | 126 | <sect2 role="installation">
|
---|
[4c24eb0a] | 127 | <title>Installation of libvdpau</title>
|
---|
| 128 |
|
---|
| 129 | <para>
|
---|
| 130 | Install <application>libvdpau</application> by running the following
|
---|
| 131 | commands:
|
---|
| 132 | </para>
|
---|
[07584d8] | 133 |
|
---|
[e1a98063] | 134 | <screen><userinput>mkdir build &&
|
---|
| 135 | cd build &&
|
---|
| 136 |
|
---|
[91318eb] | 137 | meson setup --prefix=$XORG_PREFIX .. &&
|
---|
[e1a98063] | 138 | ninja</userinput></screen>
|
---|
[07584d8] | 139 |
|
---|
[4c24eb0a] | 140 | <para>
|
---|
| 141 | To test the results, issue: <command>ninja test</command>.
|
---|
[8558044] | 142 | There is only one test for this package, dlclose, and it is known to
|
---|
[6469488] | 143 | fail on some systems.
|
---|
[4c24eb0a] | 144 | </para>
|
---|
[07584d8] | 145 |
|
---|
[4c24eb0a] | 146 | <para>
|
---|
| 147 | Now, as the <systemitem class="username">root</systemitem> user:
|
---|
| 148 | </para>
|
---|
[07584d8] | 149 |
|
---|
[73b4a90] | 150 | <screen role="root"><userinput>ninja install</userinput></screen>
|
---|
| 151 |
|
---|
| 152 | <para>
|
---|
| 153 | If <application>doxygen</application> is present at build time
|
---|
[7a9a7b26] | 154 | place the documentation in a versioned directory as the
|
---|
[73b4a90] | 155 | <systemitem class="username">root</systemitem> user:
|
---|
| 156 | </para>
|
---|
| 157 |
|
---|
| 158 | <screen role="root"><userinput>[ -e $XORG_PREFIX/share/doc/libvdpau ] && mv -v $XORG_PREFIX/share/doc/libvdpau{,&libvdpau-version;}</userinput></screen>
|
---|
[07584d8] | 159 |
|
---|
[9a612888] | 160 | </sect2>
|
---|
[4c24eb0a] | 161 |
|
---|
[9a612888] | 162 | <sect2 role="content">
|
---|
[4c24eb0a] | 163 | <title>Contents</title>
|
---|
| 164 |
|
---|
| 165 | <segmentedlist>
|
---|
| 166 | <segtitle>Installed Programs</segtitle>
|
---|
| 167 | <segtitle>Installed Library</segtitle>
|
---|
| 168 | <segtitle>Installed Directories</segtitle>
|
---|
| 169 |
|
---|
| 170 | <seglistitem>
|
---|
| 171 | <seg>
|
---|
| 172 | None
|
---|
| 173 | </seg>
|
---|
| 174 | <seg>
|
---|
| 175 | libvdpau.so
|
---|
| 176 | </seg>
|
---|
| 177 | <seg>
|
---|
[8558044] | 178 | $XORG_PREFIX/{include,lib}/vdpau
|
---|
[4c24eb0a] | 179 | </seg>
|
---|
| 180 | </seglistitem>
|
---|
| 181 | </segmentedlist>
|
---|
| 182 |
|
---|
| 183 | <variablelist>
|
---|
[9a612888] | 184 | <bridgehead renderas="sect2">Short Descriptions</bridgehead>
|
---|
[4c24eb0a] | 185 | <?dbfo list-presentation="list"?>
|
---|
| 186 | <?dbhtml list-presentation="table"?>
|
---|
| 187 |
|
---|
| 188 | <varlistentry id="libvdpau-lib">
|
---|
| 189 | <term><filename class="libraryfile">libvdpau.so</filename></term>
|
---|
| 190 | <listitem>
|
---|
| 191 | <para>
|
---|
| 192 | contains functions to offload portions of the video decoding
|
---|
| 193 | process and video post-processing to the GPU video-hardware
|
---|
| 194 | </para>
|
---|
| 195 | <indexterm zone="libvdpau libvdpau-lib">
|
---|
| 196 | <primary sortas="c-libvdpau">libvdpau.so</primary>
|
---|
| 197 | </indexterm>
|
---|
| 198 | </listitem>
|
---|
| 199 | </varlistentry>
|
---|
| 200 |
|
---|
| 201 | </variablelist>
|
---|
| 202 |
|
---|
[9a612888] | 203 | </sect2>
|
---|
[4c24eb0a] | 204 |
|
---|
[9a612888] | 205 | </sect1>
|
---|