source: x/lib/cairo.xml@ a5fe42a

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 a5fe42a was a5fe42a, checked in by Pierre Labastie <pierre.labastie@…>, 2 years ago

Fix cairo download url
  • Property mode set to 100644
File size: 10.1 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 Install <application>Cairo</application> by running the following
141 commands:
142 </para>
143
144<screen><userinput>./configure --prefix=/usr \
145 --disable-static \
146 --enable-tee &amp;&amp;
147make</userinput></screen>
148
149 <para>
150 This package does not have a working testsuite.
151 <!-- The test suite can be run with 'make check', but 488 tests fail and
152 59 tests pass. This seems to be due to minute changes in the expected
153 output, similar to librsvg's tests. Since it's a huge chunk of the tests,
154 let's keep it as "broken" for now.-->
155 </para>
156
157 <para>
158 Now, as the <systemitem class="username">root</systemitem> user:
159 </para>
160
161<screen role="root"><userinput>make install</userinput></screen>
162 </sect2>
163
164 <sect2 role="commands">
165 <title>Command Explanations</title>
166
167<!-- Not needed with 1.17.4
168 <para>
169 <parameter>autoreconf -fv</parameter>: This prevents
170 <command>configure</command> ending in error with the current version
171 of <application>automake</application> because the AM_INIT_AUTOMAKE
172 definitions came from a previous version.
173 </para>
174-->
175
176 <para>
177 <parameter>--enable-tee</parameter>: This switch enables the
178 experimental tee surface backend which is required if using
179 system-installed <application>Cairo</application> with Mozilla applications.
180 </para>
181
182 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
183 href="../../xincludes/static-libraries.xml"/>
184
185 <para>
186 <option>--enable-xlib-xcb</option>: This switch enables several
187 experimental Xlib/XCB functions used by some window managers.
188 </para>
189
190 <para>
191 <option>--enable-gl</option>: This switch enables
192 <application>Cairo</application>'s experimental
193 <application>OpenGL</application> surface which
194 is required for <application>Wayland</application>
195 compositor and some other packages that are not
196 part of BLFS.
197 </para>
198
199<!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
200 href="../../xincludes/gtk-doc-rebuild.xml"/>
201 NOTE: For this version, no docs are installed by default -->
202
203 <para>
204 <option>--enable-gtk-doc</option>: Use this parameter if GTK-Doc is
205 installed and you wish to create and install the documentation.
206 </para>
207
208 </sect2>
209
210 <sect2 role="content">
211 <title>Contents</title>
212
213 <segmentedlist>
214 <segtitle>Installed Programs</segtitle>
215 <segtitle>Installed Libraries</segtitle>
216 <segtitle>Installed Directories</segtitle>
217
218 <seglistitem>
219 <seg>
220 cairo-trace
221 </seg>
222 <seg>
223 libcairo.so, libcairo-gobject.so and
224 libcairo-script-interpreter.so
225 </seg>
226 <seg>
227 /usr/{include,lib,share/gtk-doc/html}/cairo
228 </seg>
229 </seglistitem>
230 </segmentedlist>
231
232 <variablelist>
233 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
234 <?dbfo list-presentation="list"?>
235 <?dbhtml list-presentation="table"?>
236
237<!--
238 <varlistentry id="cairo-sphinx">
239 <term><command>cairo-sphinx</command></term>
240 <listitem>
241 <para>
242 is an internal utility for regression analysis
243 </para>
244 <indexterm zone="cairo cairo-sphinx">
245 <primary sortas="b-cairo-sphinx">cairo-sphinx</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249-->
250
251 <varlistentry id="cairo-trace">
252 <term><command>cairo-trace</command></term>
253 <listitem>
254 <para>
255 generates a log of all calls made by an application to
256 <application>Cairo</application>
257 </para>
258 <indexterm zone="cairo cairo-trace">
259 <primary sortas="b-cairo-trace">cairo-trace</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="libcairo">
265 <term><filename class="libraryfile">libcairo.so</filename></term>
266 <listitem>
267 <para>
268 contains the 2D graphics functions required for rendering to the
269 various output targets
270 </para>
271 <indexterm zone="cairo libcairo">
272 <primary sortas="c-libcairo">libcairo.so</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="libcairo-gobject">
278 <term><filename class="libraryfile">libcairo-gobject.so</filename></term>
279 <listitem>
280 <para>
281 contains functions that integrate
282 <application>Cairo</application> with
283 <application>Glib</application>'s GObject type system
284 </para>
285 <indexterm zone="cairo libcairo-gobject">
286 <primary sortas="c-libcairo-gobject">libcairo-gobject.so</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="libcairo-script-interpreter">
292 <term><filename class="libraryfile">libcairo-script-interpreter.so</filename></term>
293 <listitem>
294 <para>
295 contains the script interpreter functions for executing and
296 manipulating <application>Cairo</application> execution traces
297 </para>
298 <indexterm zone="cairo libcairo-script-interpreter">
299 <primary sortas="c-libcairo-script-interpreter">libcairo-script-interpreter.so</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 </variablelist>
305
306 </sect2>
307
308</sect1>
Note: See TracBrowser for help on using the repository browser.