source: x/lib/cairo.xml@ 5ec23d4

11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5ec23d4 was 5ec23d4, checked in by Xi Ruoyao <xry111@…>, 6 months ago

cairo: remove outdated statement about epiphany

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

  • Property mode set to 100644
File size: 9.8 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.
185 </para>
186
187 <para>
188 <option>--enable-gl</option>: This switch enables
189 <application>Cairo</application>'s experimental
190 <application>OpenGL</application> surface which
191 is required for <application>Wayland</application>
192 compositor and some other packages that are not
193 part of BLFS.
194 </para>
195
196<!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
197 href="../../xincludes/gtk-doc-rebuild.xml"/>
198 NOTE: For this version, no docs are installed by default -->
199
200 <para>
201 <option>--enable-gtk-doc</option>: Use this parameter if GTK-Doc is
202 installed and you wish to create and install the documentation.
203 </para>
204
205 </sect2>
206
207 <sect2 role="content">
208 <title>Contents</title>
209
210 <segmentedlist>
211 <segtitle>Installed Programs</segtitle>
212 <segtitle>Installed Libraries</segtitle>
213 <segtitle>Installed Directories</segtitle>
214
215 <seglistitem>
216 <seg>
217 cairo-sphinx and cairo-trace
218 </seg>
219 <seg>
220 libcairo.so, libcairo-gobject.so and
221 libcairo-script-interpreter.so
222 </seg>
223 <seg>
224 /usr/{include,lib,share/gtk-doc/html}/cairo
225 </seg>
226 </seglistitem>
227 </segmentedlist>
228
229 <variablelist>
230 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
231 <?dbfo list-presentation="list"?>
232 <?dbhtml list-presentation="table"?>
233
234 <varlistentry id="cairo-sphinx">
235 <term><command>cairo-sphinx</command></term>
236 <listitem>
237 <para>
238 is an internal utility for regression analysis
239 </para>
240 <indexterm zone="cairo cairo-sphinx">
241 <primary sortas="b-cairo-sphinx">cairo-sphinx</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="cairo-trace">
247 <term><command>cairo-trace</command></term>
248 <listitem>
249 <para>
250 generates a log of all calls made by an application to
251 <application>Cairo</application>
252 </para>
253 <indexterm zone="cairo cairo-trace">
254 <primary sortas="b-cairo-trace">cairo-trace</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="libcairo">
260 <term><filename class="libraryfile">libcairo.so</filename></term>
261 <listitem>
262 <para>
263 contains the 2D graphics functions required for rendering to the
264 various output targets
265 </para>
266 <indexterm zone="cairo libcairo">
267 <primary sortas="c-libcairo">libcairo.so</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="libcairo-gobject">
273 <term><filename class="libraryfile">libcairo-gobject.so</filename></term>
274 <listitem>
275 <para>
276 contains functions that integrate
277 <application>Cairo</application> with
278 <application>Glib</application>'s GObject type system
279 </para>
280 <indexterm zone="cairo libcairo-gobject">
281 <primary sortas="c-libcairo-gobject">libcairo-gobject.so</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="libcairo-script-interpreter">
287 <term><filename class="libraryfile">libcairo-script-interpreter.so</filename></term>
288 <listitem>
289 <para>
290 contains the script interpreter functions for executing and
291 manipulating <application>Cairo</application> execution traces
292 </para>
293 <indexterm zone="cairo libcairo-script-interpreter">
294 <primary sortas="c-libcairo-script-interpreter">libcairo-script-interpreter.so</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 </variablelist>
300
301 </sect2>
302
303</sect1>
Note: See TracBrowser for help on using the repository browser.