source: x/lib/cairo.xml@ f58cd213

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f58cd213 was f58cd213, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Tags for some xfce dependencies

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

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