source: x/lib/cogl.xml@ 716a45f

10.0 10.1 11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 716a45f was 716a45f, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Update to cogl-1.22.6.
Update to clutter-1.26.4.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22830 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 "7bcc01edb5462d4d08d01bf893feddb0">
13 <!ENTITY cogl-size "1.7 MB">
14 <!ENTITY cogl-buildsize "61 MB (add 2 MB for tests)">
15 <!ENTITY cogl-time "0.3 SBU (Using parallelism=4; add 0.6 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 \
137 --enable-gles1 \
138 --enable-gles2 \
139 --enable-{kms,wayland,xlib}-egl-platform \
140 --enable-wayland-egl-server &amp;&amp;
141make</userinput></screen>
142
143 <para>
144 To test the results, issue: <command>make check</command>. The
145 tests should be run from an X terminal on the hardware accelerated
146 Xorg Server. A few tests will use all CPUs in parallel, regardless of
147 parallellism settings.
148 </para>
149
150 <para>
151 Now, as the <systemitem class="username">root</systemitem> user:
152 </para>
153
154<screen role="root"><userinput>make install</userinput></screen>
155
156 </sect2>
157
158 <sect2 role="commands">
159 <title>Command Explanations</title>
160
161 <para>
162 <parameter>--enable-gles1</parameter>: This switch enables support
163 for OpenGL ES 1.1.
164 </para>
165
166 <para>
167 <parameter>--enable-gles2</parameter>: This switch enables support
168 for OpenGL ES 2.0.
169 </para>
170
171 <para>
172 <parameter>--enable-{kms,wayland,xlib}-egl-platform</parameter>:
173 These switches enable support for KMS, Wayland and Xlib EGL platforms.
174 They are required for <application>GNOME</application> Wayland support.
175 </para>
176
177 <para>
178 <parameter>--enable-wayland-egl-server</parameter>: This switch
179 enables <application>Cogl</application>'s Wayland Server API which is
180 required for <application>GNOME</application> Wayland support.
181 </para>
182
183 <para>
184 <option>--enable-cogl-gst</option>: This switch enables gstreamer support.
185 </para>
186
187 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
188 href="../../xincludes/gtk-doc-rebuild.xml"/>
189
190 </sect2>
191
192 <sect2 role="content">
193 <title>Contents</title>
194
195 <segmentedlist>
196 <segtitle>Installed Programs</segtitle>
197 <segtitle>Installed Libraries</segtitle>
198 <segtitle>Installed Directories</segtitle>
199
200 <seglistitem>
201 <seg>
202 None
203 </seg>
204 <seg>
205 libcogl-gles2.so,
206 libcogl-pango.so,
207 libcogl-path.so, and
208 libcogl.so, and optional libraries
209 libcogl-gst.so and /usr/lib/gstreamer-1.0/libgstcogl.so
210 </seg>
211 <seg>
212 /usr/include/cogl and
213 /usr/share/cogl
214 </seg>
215 </seglistitem>
216 </segmentedlist>
217
218 <variablelist>
219 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
220 <?dbfo list-presentation="list"?>
221 <?dbhtml list-presentation="table"?>
222
223 <varlistentry id="libcogl-gles2">
224 <term><filename class="libraryfile">libcogl-gles2.so</filename></term>
225 <listitem>
226 <para>
227 is the OpenGL ES 2.0 integration library for
228 <application>Cogl</application>.
229 </para>
230 <indexterm zone="cogl libcogl-gles2">
231 <primary sortas="c-libcogl-gles2">libcogl-gles2.so</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="libcogl-pango">
237 <term><filename class="libraryfile">libcogl-pango.so</filename></term>
238 <listitem>
239 <para>
240 is the <application>Pango</application> integration library
241 for <application>Cogl</application>.
242 </para>
243 <indexterm zone="cogl libcogl-pango">
244 <primary sortas="c-libcogl-pango">libcogl-pango.so</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libcogl">
250 <term><filename class="libraryfile">libcogl.so</filename></term>
251 <listitem>
252 <para>
253 is an object oriented GL/GLES Abstraction/Utility Layer library.
254 </para>
255 <indexterm zone="cogl libcogl">
256 <primary sortas="c-libcogl">libcogl.so</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 </variablelist>
262
263 </sect2>
264
265</sect1>
Note: See TracBrowser for help on using the repository browser.