source: x/lib/cairo.xml@ f68e46f

10.0 10.1 11.0 11.1 11.2 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since f68e46f was f68e46f, checked in by Douglas R. Reno <renodr@…>, 3 years ago

PyGTK: Adapt to Pango changes
Update to Pango-1.44.7
Update to Cairo-1.17.2+f93fc72c03e
Update to Nautilus-3.34.2

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

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