Add Glamor.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11102 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Krejzi 2013-03-16 20:17:21 +00:00
parent f14424398a
commit bb9728099f

View File

@ -4,6 +4,18 @@
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY radeon-wiki "http://wiki.x.org/wiki/RadeonFeature">
<!ENTITY radeon-marketing-names "&radeon-wiki;#Decoder_ring_for_engineering_vs_marketing_names">
<!ENTITY glamor-egl-version "0.5.0">
<!ENTITY glamor-egl-download-http "&sources-anduin-other-http;/glamor-egl-&glamor-egl-version;.tar.xz">
<!ENTITY glamor-egl-download-ftp "&sources-anduin-other;/glamor-egl-&glamor-egl-version;.tar.xz">
<!ENTITY glamor-egl-md5sum "8b8c3ca4d502313df8e62c01c000e10d">
<!ENTITY glamor-egl-size "100 KB">
<!ENTITY glamor-egl-buildsize "13 MB">
<!ENTITY glamor-egl-time "0.1 SBU">
<!ENTITY xorg-evdev-driver-version "2.7.3">
<!ENTITY xorg-evdev-driver-download-http "&xorg-download-http;/driver/xf86-input-evdev-&xorg-evdev-driver-version;.tar.bz2">
@ -193,6 +205,19 @@
</para>
</note>
<sect3 id="xorg-modules">
<title>Xorg Modules</title>
<itemizedlist spacing="compact">
<listitem>
<para>
<xref linkend="glamor-egl"/>
</para>
</listitem>
</itemizedlist>
</sect3>
<sect3 id="xorg-input-drivers">
<title>Xorg Input Drivers</title>
@ -296,6 +321,168 @@
</sect2>
<!-- Begin Glamor EGL -->
<sect2 id="glamor-egl" xreflabel="Glamor EGL-&glamor-egl-version;">
<title>Glamor EGL-&glamor-egl-version;</title>
<indexterm zone="glamor-egl">
<primary sortas="a-glamor-egl">glamor-egl</primary>
</indexterm>
<sect3 role="package">
<title>Introduction to Glamor EGL</title>
<para>
The <application>Glamor EGL</application> package contains a
GL-based rendering acceleration library for X server.
</para>
&lfs72_checked;
<bridgehead renderas="sect4">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&glamor-egl-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&glamor-egl-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &glamor-egl-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &glamor-egl-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &glamor-egl-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &glamor-egl-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect4">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Required patch:
<ulink url="&patch-root;/glamor-egl-&glamor-egl-version;-fixes-1.patch"/>
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect4">Glamor EGL Dependencies</bridgehead>
<bridgehead renderas="sect5">Required</bridgehead>
<para role="required">
<xref linkend="xorg-server"/>
</para>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/glamor-egl"/>
</para>
</sect3>
<sect3 role="installation">
<title>Installation of Glamor EGL</title>
<para>
Install <application>Glamor EGL</application> by running the following
commands:
</para>
<screen><userinput>patch -Np1 -i ../glamor-egl-&glamor-egl-version;-fixes-1.patch &amp;&amp;
autoreconf -fi &amp;&amp;
./configure $XORG_CONFIG --enable-glx-tls &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>
<title>Command Explanations</title>
<para>
<parameter>--enable-glx-tls</parameter>: This switch enables
TLS support in GLX.
</para>
</sect3>
<sect3 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Xorg Module</segtitle>
<seglistitem>
<seg>
libglamor.so
</seg>
<seg>
libglamoregl.so
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect4">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libglamoregl">
<term><filename class="libraryfile">libglamoregl.so</filename></term>
<listitem>
<para>
contains functions to create and initialize OpenGL/EGL context.
</para>
<indexterm zone="glamor-egl libglamoregl">
<primary sortas="c-libglamoregl">libglamoregl.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libglamor">
<term><filename class="libraryfile">libglamor.so</filename></term>
<listitem>
<para>
contains the <application>Glamor</application> rendering functions.
</para>
<indexterm zone="glamor-egl libglamor">
<primary sortas="c-libglamor">libglamor.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- End Glamor EGL -->
<!-- Begin Xorg Evdev Driver -->
<sect2 id="xorg-evdev-driver" xreflabel="Xorg Evdev Driver-&xorg-evdev-driver-version;">
@ -945,7 +1132,7 @@ make</userinput></screen>
<para>
The <application>Xorg ATI Driver</application> package contains the X.Org
Video Driver for ATI Radeon video cards including all chipsets ranging
from R100 to R700 including newer Radeon HD ones.
from R100 to R900 and the newer RAxx chipsets.
</para>
&lfs72_checked;
@ -953,7 +1140,7 @@ make</userinput></screen>
<note>
<para>
For Direct Rendering to work with newer Radeon Cards (r300 and later chipsets),
you will need to enable building of r300 and r600 Gallium drivers in
you will need to enable building of r300, r600 and radeonsi Gallium drivers in
<xref linkend="mesalib"/> instructions. Also, some cards will require Firmware
to be available when kernel driver is loaded. Firmware can be obtained from
<ulink url="http://git.kernel.org/?p=linux/kernel/git/dwmw2/linux-firmware.git">
@ -999,12 +1186,7 @@ make</userinput></screen>
<bridgehead renderas="sect5">Required</bridgehead>
<para role="required">
<xref linkend="xorg-server"/>
</para>
<bridgehead renderas="sect5">Optional</bridgehead>
<para role="optional">
<ulink url="http://www.freedesktop.org/wiki/Software/Glamor">Glamor</ulink>
<xref linkend="glamor-egl"/>
</para>
<para condition="html" role="usernotes">
@ -1039,7 +1221,7 @@ make</userinput></screen>
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
<screen><userinput>./configure $XORG_CONFIG --enable-glamor &amp;&amp;
make</userinput></screen>
<para>
@ -1053,6 +1235,54 @@ make</userinput></screen>
<screen role="root"><userinput>make install</userinput></screen>
</sect3>
<sect3>
<title>Command Explanations</title>
<para>
<parameter>--enable-glamor</parameter>: This switch enables
new GL-based acceleration.
</para>
</sect3>
<sect3>
<title>Glamor Acceleration</title>
<para>
Glamor is an acceleration library which uses cards' 3D capabilities
to accelerate 2D rendering. Glamor acceleration is required for
Radeon "South Islands" GPUs which use "radeonsi" Gallium3D driver
from <xref linkend="mesalib"/>. To see which cards fall under
"South Islands" category, read the
<ulink url="&radeon-marketing-names;">
Decoder ring for engineering vs marketing names</ulink>. Please note
that Glamor acceleration can be used with other chips as well, but
it has not been tested recently.
</para>
<para>
Glamor acceleration is not enabled by default. You have to use a
<filename>xorg.conf</filename> file to enable it. To enable
Glamor, create the following
<filename>/etc/X11/xorg.conf</filename> as the
<systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>cat &gt;&gt; /etc/X11/xorg.conf &lt;&lt; "EOF"
<literal>Section "Module"
Load "dri2"
Load "glamoregl"
EndSection
Section "Device"
Identifier "radeon"
Driver "radeon"
Option "AccelMethod" "glamor"
EndSection</literal>
EOF</userinput></screen>
</sect3>
<sect3 role="content">
<title>Contents</title>
@ -1258,7 +1488,7 @@ make</userinput></screen>
<para>
The <application>Xorg Intel Driver</application> package contains the X.Org
Video Driver for Intel integrated video cards including 8xx, 9xx, Gxx, Qxx
and HD graphics processors.
and HD graphics processors (SandyBridge, IvyBridge and Haswell).
</para>
&lfs72_checked;