source: x/lib/cairo.xml@ 3df8ea47

10.1 11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 3df8ea47 was 3df8ea47, checked in by Bruce Dubbs <bdubbs@…>, 7 months ago

Tags for libraries

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

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