source: x/lib/cairo.xml@ ba3b0498

11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/soup3 xry111/xf86-video-removal
Last change on this file since ba3b0498 was ba3b0498, checked in by Xi Ruoyao <xry111@…>, 21 months ago

cairo: adapt for glibc-2.36
  • Property mode set to 100644
File size: 10.3 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 <!ENTITY cairo-download-http "&gnome-download-http;/cairo/&cairo-minor;/cairo-&cairo-version;.tar.xz">
8 <!--<!ENTITY cairo-download-http "https://www.cairographics.org/snapshots/cairo-&cairo-version;.tar.xz">
9 <!ENTITY cairo-download-http "&sources-anduin-http;/cairo/cairo-&cairo-version;.tar.xz">-->
10 <!ENTITY cairo-download-ftp " ">
11 <!ENTITY cairo-md5sum "c5a6f255af72a2e5faa8e6a53dd882e2">
12 <!ENTITY cairo-size "33 MB">
13 <!ENTITY cairo-buildsize "137 MB">
14 <!ENTITY cairo-time "0.4 SBU (Using parallelism=4)">
15]>
16
17<sect1 id="cairo" xreflabel="Cairo-&cairo-version;">
18 <?dbhtml filename="cairo.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Cairo-&cairo-version;</title>
25
26 <indexterm zone="cairo">
27 <primary sortas="a-Cairo">Cairo</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Cairo</title>
32
33 <para>
34 <application>Cairo</application> is a 2D graphics library with support for
35 multiple output devices. Currently supported output targets include the
36 <application>X</application> Window System, win32, image buffers,
37 PostScript, PDF and SVG. Experimental backends include OpenGL, Quartz and
38 XCB file output. <application>Cairo</application> is designed to produce
39 consistent output on all output media while taking advantage of display
40 hardware acceleration when available (e.g., through the X Render
41 Extension). The <application>Cairo</application> API provides operations
42 similar to the drawing operators of PostScript and PDF. Operations in
43 <application>Cairo</application> include stroking and filling cubic
44 B&eacute;zier splines, transforming and compositing translucent images,
45 and antialiased text rendering. All drawing operations can be transformed
46 by any
47 <ulink url="http://en.wikipedia.org/wiki/Affine_transformation">affine
48 transformation</ulink> (scale, rotation, shear, etc.).
49 </para>
50
51 &lfs111_checked;
52
53 <bridgehead renderas="sect3">Package Information</bridgehead>
54 <itemizedlist spacing="compact">
55 <listitem>
56 <para>
57 Download (HTTP): <ulink url="&cairo-download-http;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download (FTP): <ulink url="&cairo-download-ftp;"/>
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download MD5 sum: &cairo-md5sum;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Download size: &cairo-size;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated disk space required: &cairo-buildsize;
78 </para>
79 </listitem>
80 <listitem>
81 <para>
82 Estimated build time: &cairo-time;
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">Cairo Dependencies</bridgehead>
88
89 <bridgehead renderas="sect4">Required</bridgehead>
90 <para role="required">
91 <xref linkend="libpng"/> and
92 <xref linkend="pixman"/>
93 </para>
94
95 <bridgehead renderas="sect4">Recommended</bridgehead>
96 <para role="recommended">
97 <xref linkend="fontconfig"/>,
98 <xref linkend="glib2"/> (required for most GUIs), and
99 <xref linkend="xorg7-lib"/>
100 </para>
101
102 <bridgehead renderas="sect4">Optional</bridgehead>
103 <para role="optional">
104 <xref linkend="cogl"/>,
105 <xref linkend="gs"/>,
106 <xref linkend="gtk3"/> and <xref linkend="gtk2"/>,
107 <xref linkend="gtk-doc"/>,
108 <xref linkend="libdrm"/>,
109 <xref linkend="librsvg"/>,
110 <xref linkend="libxml2"/>,
111 <xref linkend="lzo"/>,
112 <xref linkend="mesa"/>,
113 <xref linkend="poppler"/>,
114 <xref linkend="qt5"/>,
115 <xref linkend="valgrind"/>,
116 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
117 <ulink url="https://github.com/rillian/jbig2dec/">jbig2dec</ulink>,
118 <ulink url="https://www.freedesktop.org/wiki/Software/libspectre/">libspectre</ulink>,
119 <ulink url="https://skia.org/">Skia</ulink>, and
120 <ulink url="http://download.qt.io/archive/qt/4.8/">Qt4</ulink>.
121 </para>
122
123 <note>
124 <para>
125 There is a circular dependency between cairo and harfbuzz.
126 If cairo is built before harfbuzz, it is necessary to rebuild cairo
127 after harfbuzz in order to build pango.
128 </para>
129 </note>
130
131 <para condition="html" role="usernotes">
132 User Notes: <ulink url="&blfs-wiki;/cairo"/>
133 </para>
134 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of Cairo</title>
138
139 <para>
140 Adapt this package for glibc-2.36:
141 </para>
142
143<screen><userinput>sed 's/PTR/void */' -i util/cairo-trace/lookup-symbol.c</userinput></screen>
144
145 <para>
146 Install <application>Cairo</application> by running the following
147 commands:
148 </para>
149
150<screen><userinput>./configure --prefix=/usr \
151 --disable-static \
152 --enable-tee &amp;&amp;
153make</userinput></screen>
154
155 <para>
156 This package does not have a working testsuite.
157 <!-- The test suite can be run with 'make check', but 488 tests fail and
158 59 tests pass. This seems to be due to minute changes in the expected
159 output, similar to librsvg's tests. Since it's a huge chunk of the tests,
160 let's keep it as "broken" for now.-->
161 </para>
162
163 <para>
164 Now, as the <systemitem class="username">root</systemitem> user:
165 </para>
166
167<screen role="root"><userinput>make install</userinput></screen>
168 </sect2>
169
170 <sect2 role="commands">
171 <title>Command Explanations</title>
172
173<!-- Not needed with 1.17.4
174 <para>
175 <parameter>autoreconf -fv</parameter>: This prevents
176 <command>configure</command> ending in error with the current version
177 of <application>automake</application> because the AM_INIT_AUTOMAKE
178 definitions came from a previous version.
179 </para>
180-->
181
182 <para>
183 <parameter>--enable-tee</parameter>: This switch enables the
184 experimental tee surface backend which is required if using
185 system-installed <application>Cairo</application> with Mozilla applications.
186 </para>
187
188 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
189 href="../../xincludes/static-libraries.xml"/>
190
191 <para>
192 <option>--enable-xlib-xcb</option>: This switch enables several
193 experimental Xlib/XCB functions used by some window managers.
194 </para>
195
196 <para>
197 <option>--enable-gl</option>: This switch enables
198 <application>Cairo</application>'s experimental
199 <application>OpenGL</application> surface which
200 is required for <application>Wayland</application>
201 compositor and some other packages that are not
202 part of BLFS.
203 </para>
204
205<!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
206 href="../../xincludes/gtk-doc-rebuild.xml"/>
207 NOTE: For this version, no docs are installed by default -->
208
209 <para>
210 <option>--enable-gtk-doc</option>: Use this parameter if GTK-Doc is
211 installed and you wish to create and install the documentation.
212 </para>
213
214 </sect2>
215
216 <sect2 role="content">
217 <title>Contents</title>
218
219 <segmentedlist>
220 <segtitle>Installed Programs</segtitle>
221 <segtitle>Installed Libraries</segtitle>
222 <segtitle>Installed Directories</segtitle>
223
224 <seglistitem>
225 <seg>
226 cairo-trace
227 </seg>
228 <seg>
229 libcairo.so, libcairo-gobject.so and
230 libcairo-script-interpreter.so
231 </seg>
232 <seg>
233 /usr/{include,lib,share/gtk-doc/html}/cairo
234 </seg>
235 </seglistitem>
236 </segmentedlist>
237
238 <variablelist>
239 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
240 <?dbfo list-presentation="list"?>
241 <?dbhtml list-presentation="table"?>
242
243<!--
244 <varlistentry id="cairo-sphinx">
245 <term><command>cairo-sphinx</command></term>
246 <listitem>
247 <para>
248 is an internal utility for regression analysis
249 </para>
250 <indexterm zone="cairo cairo-sphinx">
251 <primary sortas="b-cairo-sphinx">cairo-sphinx</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255-->
256
257 <varlistentry id="cairo-trace">
258 <term><command>cairo-trace</command></term>
259 <listitem>
260 <para>
261 generates a log of all calls made by an application to
262 <application>Cairo</application>
263 </para>
264 <indexterm zone="cairo cairo-trace">
265 <primary sortas="b-cairo-trace">cairo-trace</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="libcairo">
271 <term><filename class="libraryfile">libcairo.so</filename></term>
272 <listitem>
273 <para>
274 contains the 2D graphics functions required for rendering to the
275 various output targets
276 </para>
277 <indexterm zone="cairo libcairo">
278 <primary sortas="c-libcairo">libcairo.so</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="libcairo-gobject">
284 <term><filename class="libraryfile">libcairo-gobject.so</filename></term>
285 <listitem>
286 <para>
287 contains functions that integrate
288 <application>Cairo</application> with
289 <application>Glib</application>'s GObject type system
290 </para>
291 <indexterm zone="cairo libcairo-gobject">
292 <primary sortas="c-libcairo-gobject">libcairo-gobject.so</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="libcairo-script-interpreter">
298 <term><filename class="libraryfile">libcairo-script-interpreter.so</filename></term>
299 <listitem>
300 <para>
301 contains the script interpreter functions for executing and
302 manipulating <application>Cairo</application> execution traces
303 </para>
304 <indexterm zone="cairo libcairo-script-interpreter">
305 <primary sortas="c-libcairo-script-interpreter">libcairo-script-interpreter.so</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 </variablelist>
311
312 </sect2>
313
314</sect1>
Note: See TracBrowser for help on using the repository browser.