source: x/lib/cogl.xml@ 43c4beb

10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 43c4beb was 43c4beb, checked in by Ken Moffat <ken@…>, 2 years ago

Cogl: remove invocation of autoreconf for commented old patch.

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

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