source: x/lib/cairo.xml@ 08f422e

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 08f422e was 08f422e, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Archive qt4.
Make referenced to Qt4 in highlight and cairo external.

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

  • Property mode set to 100644
File size: 8.6 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 "http://cairographics.org/releases/cairo-&cairo-version;.tar.xz">
8 <!ENTITY cairo-download-ftp " ">
9 <!ENTITY cairo-md5sum "23a0b2f0235431d35238df1d3a517fdb">
10 <!ENTITY cairo-size "35 MB">
11 <!ENTITY cairo-buildsize "144 MB">
12 <!ENTITY cairo-time "0.8 SBU">
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 &lfs79_checked;&gcc6_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="gtk-doc"/>,
105 <xref linkend="libdrm"/>,
106 <xref linkend="lzo"/>,
107 <xref linkend="mesa"/>,
108 <xref linkend="valgrind"/>,
109 <ulink url="http://download.qt.io/official_releases/qt/4.8/">Qt4</ulink>,
110 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
111 <ulink url="https://github.com/rillian/jbig2dec/">jbig2dec</ulink>, and
112 <ulink url="http://code.google.com/p/skia/">Skia</ulink>
113 </para>
114
115 <para condition="html" role="usernotes">
116 User Notes: <ulink url="&blfs-wiki;/cairo"/>
117 </para>
118 </sect2>
119
120 <sect2 role="installation">
121 <title>Installation of Cairo</title>
122
123 <para>
124 Install <application>Cairo</application> by running the following
125 commands:
126 </para>
127
128<screen><userinput>./configure --prefix=/usr \
129 --disable-static \
130 --enable-tee &amp;&amp;
131make</userinput></screen>
132
133 <para>
134 This package does not have a working testsuite.
135 </para>
136
137 <para>
138 Now, as the <systemitem class="username">root</systemitem> user:
139 </para>
140
141<screen role="root"><userinput>make install</userinput></screen>
142 </sect2>
143
144 <sect2 role="commands">
145 <title>Command Explanations</title>
146
147 <para>
148 <parameter>--enable-tee</parameter>: This switch enables experimental tee
149 surface backend which is required if using system-installed
150 <application>Cairo</application> with Mozilla applications.
151 </para>
152
153 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
154 href="../../xincludes/static-libraries.xml"/>
155
156 <para>
157 <option>--enable-xlib-xcb</option>: This switch enables experimental
158 Xlib/XCB functions used by some window managers.
159 </para>
160
161 <para>
162 <option>--enable-gl</option>: This switch enables
163 <application>Cairo</application>'s experimental
164 <application>OpenGL</application> surface which
165 is required for <application>Wayland</application>
166 compositor and some other packages that are not
167 part of BLFS.
168 </para>
169
170 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
171 href="../../xincludes/gtk-doc-rebuild.xml"/>
172
173 </sect2>
174
175 <sect2 role="content">
176 <title>Contents</title>
177
178 <segmentedlist>
179 <segtitle>Installed Programs</segtitle>
180 <segtitle>Installed Libraries</segtitle>
181 <segtitle>Installed Directories</segtitle>
182
183 <seglistitem>
184 <seg>
185 cairo-sphinx and cairo-trace
186 </seg>
187 <seg>
188 libcairo.so, libcairo-gobject.so and
189 libcairo-script-interpreter.so
190 </seg>
191 <seg>
192 /usr/{include,lib,share/gtk-doc/html}/cairo
193 </seg>
194 </seglistitem>
195 </segmentedlist>
196
197 <variablelist>
198 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
199 <?dbfo list-presentation="list"?>
200 <?dbhtml list-presentation="table"?>
201
202 <varlistentry id="cairo-sphinx">
203 <term><command>cairo-sphinx</command></term>
204 <listitem>
205 <para>
206 is an internal utility for regression analysis.
207 </para>
208 <indexterm zone="cairo cairo-sphinx">
209 <primary sortas="b-cairo-sphinx">cairo-sphinx</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="cairo-trace">
215 <term><command>cairo-trace</command></term>
216 <listitem>
217 <para>
218 generates a log of all calls made by an application to
219 <application>Cairo</application>.
220 </para>
221 <indexterm zone="cairo cairo-trace">
222 <primary sortas="b-cairo-trace">cairo-trace</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 <varlistentry id="libcairo">
228 <term><filename class="libraryfile">libcairo.so</filename></term>
229 <listitem>
230 <para>
231 contains the 2D graphics functions required for rendering to the
232 various output targets.
233 </para>
234 <indexterm zone="cairo libcairo">
235 <primary sortas="c-libcairo">libcairo.so</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239
240 <varlistentry id="libcairo-gobject">
241 <term><filename class="libraryfile">libcairo-gobject.so</filename></term>
242 <listitem>
243 <para>
244 contains functions that integrate
245 <application>Cairo</application> with <xref linkend="glib2"/>'s
246 GObject type system.
247 </para>
248 <indexterm zone="cairo libcairo-gobject">
249 <primary sortas="c-libcairo-gobject">libcairo-gobject.so</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="libcairo-script-interpreter">
255 <term><filename class="libraryfile">libcairo-script-interpreter.so</filename></term>
256 <listitem>
257 <para>
258 contains the script interpreter functions for executing and
259 manipulating <application>Cairo</application> execution traces.
260 </para>
261 <indexterm zone="cairo libcairo-script-interpreter">
262 <primary sortas="c-libcairo-script-interpreter">libcairo-script-interpreter.so</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 </variablelist>
268
269 </sect2>
270
271</sect1>
Note: See TracBrowser for help on using the repository browser.