mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-26 08:42:12 +08:00
5ec23d4a10
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24387 af4574ff-66df-0310-9fd7-8a98e5e911e0
304 lines
9.8 KiB
XML
304 lines
9.8 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!--
|
|
<!ENTITY cairo-download-http "https://www.cairographics.org/releases/cairo-&cairo-version;.tar.xz">
|
|
-->
|
|
<!ENTITY cairo-download-http "&sources-anduin-http;/cairo/cairo-&cairo-version;.tar.xz">
|
|
<!ENTITY cairo-download-ftp " ">
|
|
<!ENTITY cairo-md5sum "23a9420780f74ad0ca1e9885e53ee022">
|
|
<!ENTITY cairo-size "40 MB">
|
|
<!ENTITY cairo-buildsize "148 MB">
|
|
<!ENTITY cairo-time "0.9 SBU">
|
|
]>
|
|
|
|
<sect1 id="cairo" xreflabel="Cairo-&cairo-version;">
|
|
<?dbhtml filename="cairo.html"?>
|
|
|
|
<sect1info>
|
|
<othername>$LastChangedBy$</othername>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
|
|
<title>Cairo-&cairo-version;</title>
|
|
|
|
<indexterm zone="cairo">
|
|
<primary sortas="a-Cairo">Cairo</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to Cairo</title>
|
|
|
|
<para>
|
|
<application>Cairo</application> is a 2D graphics library with support for
|
|
multiple output devices. Currently supported output targets include the
|
|
<application>X</application> Window System, win32, image buffers,
|
|
PostScript, PDF and SVG. Experimental backends include OpenGL, Quartz and
|
|
XCB file output. <application>Cairo</application> is designed to produce
|
|
consistent output on all output media while taking advantage of display
|
|
hardware acceleration when available (e.g., through the X Render
|
|
Extension). The <application>Cairo</application> API provides operations
|
|
similar to the drawing operators of PostScript and PDF. Operations in
|
|
<application>Cairo</application> include stroking and filling cubic
|
|
Bézier splines, transforming and compositing translucent images,
|
|
and antialiased text rendering. All drawing operations can be transformed
|
|
by any
|
|
<ulink url="http://en.wikipedia.org/wiki/Affine_transformation">affine
|
|
transformation</ulink> (scale, rotation, shear, etc.).
|
|
</para>
|
|
|
|
&lfs101_checked;
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&cairo-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&cairo-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &cairo-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &cairo-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &cairo-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &cairo-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect3">Cairo Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Required</bridgehead>
|
|
<para role="required">
|
|
<xref linkend="libpng"/> and
|
|
<xref linkend="pixman"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<para role="recommended">
|
|
<xref linkend="fontconfig"/>,
|
|
<xref linkend="glib2"/> (required for most GUIs), and
|
|
<xref linkend="xorg7-lib"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="cogl"/>,
|
|
<xref linkend="gs"/>,
|
|
<xref linkend="gtk3"/> and <xref linkend="gtk2"/>,
|
|
<xref linkend="gtk-doc"/>,
|
|
<xref linkend="libdrm"/>,
|
|
<xref linkend="librsvg"/>,
|
|
<xref linkend="libxml2"/>,
|
|
<xref linkend="lzo"/>,
|
|
<xref linkend="mesa"/>,
|
|
<xref linkend="poppler"/>,
|
|
<xref linkend="qt5"/>,
|
|
<xref linkend="valgrind"/>,
|
|
<ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
|
|
<ulink url="https://github.com/rillian/jbig2dec/">jbig2dec</ulink>,
|
|
<ulink url="https://www.freedesktop.org/wiki/Software/libspectre/">libspectre</ulink>,
|
|
<ulink url="https://skia.org/">Skia</ulink>, and
|
|
<ulink url="http://download.qt.io/archive/qt/4.8/">Qt4</ulink>.
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
There is a circular dependency between cairo and harfbuzz.
|
|
If cairo is built before harfbuzz, it is necessary to rebuild cairo
|
|
after harfbuzz in order to build pango.
|
|
</para>
|
|
</note>
|
|
|
|
<para condition="html" role="usernotes">
|
|
User Notes: <ulink url="&blfs-wiki;/cairo"/>
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Cairo</title>
|
|
|
|
<para>
|
|
Install <application>Cairo</application> by running the following
|
|
commands:
|
|
</para>
|
|
|
|
<screen><userinput>autoreconf -fv &&
|
|
./configure --prefix=/usr \
|
|
--disable-static \
|
|
--enable-tee &&
|
|
make</userinput></screen>
|
|
|
|
<para>
|
|
This package does not have a working testsuite.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make install</userinput></screen>
|
|
</sect2>
|
|
|
|
<sect2 role="commands">
|
|
<title>Command Explanations</title>
|
|
|
|
<para>
|
|
<parameter>autoreconf -fv</parameter>: This prevents
|
|
<command>configure</command> ending in error with the current version
|
|
of <application>automake</application> because the AM_INIT_AUTOMAKE
|
|
definitions came from a previous version.
|
|
</para>
|
|
|
|
<para>
|
|
<parameter>--enable-tee</parameter>: This switch enables the
|
|
experimental tee surface backend which is required if using
|
|
system-installed <application>Cairo</application> with Mozilla applications.
|
|
</para>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/static-libraries.xml"/>
|
|
|
|
<para>
|
|
<option>--enable-xlib-xcb</option>: This switch enables several
|
|
experimental Xlib/XCB functions used by some window managers.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-gl</option>: This switch enables
|
|
<application>Cairo</application>'s experimental
|
|
<application>OpenGL</application> surface which
|
|
is required for <application>Wayland</application>
|
|
compositor and some other packages that are not
|
|
part of BLFS.
|
|
</para>
|
|
|
|
<!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/gtk-doc-rebuild.xml"/>
|
|
NOTE: For this version, no docs are installed by default -->
|
|
|
|
<para>
|
|
<option>--enable-gtk-doc</option>: Use this parameter if GTK-Doc is
|
|
installed and you wish to create and install the documentation.
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Libraries</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
cairo-sphinx and cairo-trace
|
|
</seg>
|
|
<seg>
|
|
libcairo.so, libcairo-gobject.so and
|
|
libcairo-script-interpreter.so
|
|
</seg>
|
|
<seg>
|
|
/usr/{include,lib,share/gtk-doc/html}/cairo
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="cairo-sphinx">
|
|
<term><command>cairo-sphinx</command></term>
|
|
<listitem>
|
|
<para>
|
|
is an internal utility for regression analysis
|
|
</para>
|
|
<indexterm zone="cairo cairo-sphinx">
|
|
<primary sortas="b-cairo-sphinx">cairo-sphinx</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="cairo-trace">
|
|
<term><command>cairo-trace</command></term>
|
|
<listitem>
|
|
<para>
|
|
generates a log of all calls made by an application to
|
|
<application>Cairo</application>
|
|
</para>
|
|
<indexterm zone="cairo cairo-trace">
|
|
<primary sortas="b-cairo-trace">cairo-trace</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libcairo">
|
|
<term><filename class="libraryfile">libcairo.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains the 2D graphics functions required for rendering to the
|
|
various output targets
|
|
</para>
|
|
<indexterm zone="cairo libcairo">
|
|
<primary sortas="c-libcairo">libcairo.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libcairo-gobject">
|
|
<term><filename class="libraryfile">libcairo-gobject.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains functions that integrate
|
|
<application>Cairo</application> with
|
|
<application>Glib</application>'s GObject type system
|
|
</para>
|
|
<indexterm zone="cairo libcairo-gobject">
|
|
<primary sortas="c-libcairo-gobject">libcairo-gobject.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libcairo-script-interpreter">
|
|
<term><filename class="libraryfile">libcairo-script-interpreter.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains the script interpreter functions for executing and
|
|
manipulating <application>Cairo</application> execution traces
|
|
</para>
|
|
<indexterm zone="cairo libcairo-script-interpreter">
|
|
<primary sortas="c-libcairo-script-interpreter">libcairo-script-interpreter.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|