source: x/lib/cogl.xml@ a676cd04

10.0 10.1 11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a676cd04 was a676cd04, checked in by Pierre Labastie <pieere@…>, 2 years ago

Add a patch to build cogl with mesa-20.x

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22796 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
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
7 <!-- Editors, update this for new releass as needed -->
8 <!ENTITY cogl-minor "1.22">
9
10 <!ENTITY cogl-download-http "&gnome-download-http;/cogl/&cogl-minor;/cogl-&cogl-version;.tar.xz">
11 <!ENTITY cogl-download-ftp "&gnome-download-ftp;/cogl/&cogl-minor;/cogl-&cogl-version;.tar.xz">
12 <!ENTITY cogl-md5sum "31755015a865c4af51ac84f6e53af8ab">
13 <!ENTITY cogl-size "1.6 MB">
14 <!ENTITY cogl-buildsize "55 MB">
15 <!ENTITY cogl-time "0.3 SBU (Using parallelism=4; add 0.5 SBU for tests)">
16]>
17
18<sect1 id="cogl" xreflabel="Cogl-&cogl-version;">
19 <?dbhtml filename="cogl.html"?>
20
21 <sect1info>
22 <othername>$LastChangedBy$</othername>
23 <date>$Date$</date>
24 </sect1info>
25
26 <title>Cogl-&cogl-version;</title>
27
28 <indexterm zone="cogl">
29 <primary sortas="a-Cogl">Cogl</primary>
30 </indexterm>
31
32 <sect2 role="package">
33 <title>Introduction to Cogl</title>
34
35 <para>
36 <application>Cogl</application> is a modern 3D graphics API with associated
37 utility APIs designed to expose the features of 3D graphics hardware using
38 a direct state access API design, as opposed to the state-machine style
39 of OpenGL.
40 </para>
41
42 &lfs91_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&cogl-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&cogl-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &cogl-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &cogl-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &cogl-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &cogl-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>
82 Required patch:
83 <ulink url="&patch-root;/cogl-&cogl-version;-mesa_20_fixes-1.patch"/>
84 </para>
85 </listitem>
86 </itemizedlist>
87
88 <bridgehead renderas="sect3">Cogl Dependencies</bridgehead>
89
90 <bridgehead renderas="sect4">Required</bridgehead>
91 <para role="required">
92 <xref linkend="cairo"/>,
93 <xref linkend="gdk-pixbuf"/>,
94 <xref linkend="glu"/>,
95 <xref linkend="mesa"/>,
96 <xref linkend="pango"/>, and
97 <xref linkend="wayland"/>
98 </para>
99
100 <bridgehead renderas="sect4">Recommended</bridgehead>
101 <para role="recommended">
102 <xref linkend="gobject-introspection"/>
103 </para>
104
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref linkend="gst10-plugins-base"/>,
108 <xref linkend="gtk-doc"/>,
109 <xref linkend="sdl"/>, and
110 <xref linkend="sdl2"/>
111 </para>
112
113 <para condition="html" role="usernotes">User Notes:
114 <ulink url="&blfs-wiki;/cogl"/>
115 </para>
116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of Cogl</title>
120
121 <para>
122 First fix an issue introduced by mesa-20.x and later:
123 </para>
124
125<screen><userinput>patch -Np1 -i ../cogl-&cogl-version;-mesa_20_fixes-1.patch</userinput></screen>
126
127 <para>
128 Install <application>Cogl</application> by running the following
129 commands:
130 </para>
131
132 &parallel_issues;
133
134<screen><userinput>autoreconf &amp;&amp;
135
136./configure --prefix=/usr --enable-gles1 --enable-gles2 \
137 --enable-{kms,wayland,xlib}-egl-platform \
138 --enable-wayland-egl-server &amp;&amp;
139make</userinput></screen>
140
141 <para>
142 To test the results, issue: <command>make check</command>. The
143 tests should be run from an X terminal on the hardware accelerated
144 Xorg Server. A few tests will use all CPUs in parallel, regardless of
145 parallellism settings.
146 </para>
147
148 <para>
149 Now, as the <systemitem class="username">root</systemitem> user:
150 </para>
151
152<screen role="root"><userinput>make install</userinput></screen>
153
154 </sect2>
155
156 <sect2 role="commands">
157 <title>Command Explanations</title>
158
159 <para>
160 <parameter>--enable-gles1</parameter>: This switch enables support
161 for OpenGL ES 1.1.
162 </para>
163
164 <para>
165 <parameter>--enable-gles2</parameter>: This switch enables support
166 for OpenGL ES 2.0.
167 </para>
168
169 <para>
170 <parameter>--enable-{kms,wayland,xlib}-egl-platform</parameter>:
171 These switches enable support for KMS, Wayland and Xlib EGL platforms.
172 They are required for <application>GNOME</application> Wayland support.
173 </para>
174
175 <para>
176 <parameter>--enable-wayland-egl-server</parameter>: This switch
177 enables <application>Cogl</application>'s Wayland Server API which is
178 required for <application>GNOME</application> Wayland support.
179 </para>
180
181 <para>
182 <option>--enable-cogl-gst</option>: This switch enables gstreamer support.
183 </para>
184
185 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
186 href="../../xincludes/gtk-doc-rebuild.xml"/>
187
188 </sect2>
189
190 <sect2 role="content">
191 <title>Contents</title>
192
193 <segmentedlist>
194 <segtitle>Installed Programs</segtitle>
195 <segtitle>Installed Libraries</segtitle>
196 <segtitle>Installed Directories</segtitle>
197
198 <seglistitem>
199 <seg>
200 None
201 </seg>
202 <seg>
203 libcogl-gles2.so,
204 libcogl-pango.so,
205 libcogl-path.so, and
206 libcogl.so, and optional libraries
207 libcogl-gst.so and /usr/lib/gstreamer-1.0/libgstcogl.so
208 </seg>
209 <seg>
210 /usr/include/cogl and
211 /usr/share/cogl
212 </seg>
213 </seglistitem>
214 </segmentedlist>
215
216 <variablelist>
217 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
218 <?dbfo list-presentation="list"?>
219 <?dbhtml list-presentation="table"?>
220
221 <varlistentry id="libcogl-gles2">
222 <term><filename class="libraryfile">libcogl-gles2.so</filename></term>
223 <listitem>
224 <para>
225 is the OpenGL ES 2.0 integration library for
226 <application>Cogl</application>.
227 </para>
228 <indexterm zone="cogl libcogl-gles2">
229 <primary sortas="c-libcogl-gles2">libcogl-gles2.so</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="libcogl-pango">
235 <term><filename class="libraryfile">libcogl-pango.so</filename></term>
236 <listitem>
237 <para>
238 is the <application>Pango</application> integration library
239 for <application>Cogl</application>.
240 </para>
241 <indexterm zone="cogl libcogl-pango">
242 <primary sortas="c-libcogl-pango">libcogl-pango.so</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="libcogl">
248 <term><filename class="libraryfile">libcogl.so</filename></term>
249 <listitem>
250 <para>
251 is an object oriented GL/GLES Abstraction/Utility Layer library.
252 </para>
253 <indexterm zone="cogl libcogl">
254 <primary sortas="c-libcogl">libcogl.so</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 </variablelist>
260
261 </sect2>
262
263</sect1>
Note: See TracBrowser for help on using the repository browser.