- Timestamp:
- 11/23/2011 11:25:44 PM (12 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- d453af5
- Parents:
- 447b0bc
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
x/lib/cairo.xml
r447b0bc r827336dc 7 7 <!ENTITY cairo-download-http "http://cairographics.org/releases/cairo-&cairo-version;.tar.gz"> 8 8 <!ENTITY cairo-download-ftp "&gentoo-ftp-repo;/cairo-&cairo-version;.tar.gz"> 9 <!ENTITY cairo-md5sum " b60a82f405f9400bbfdcf850b1728d25">10 <!ENTITY cairo-size " 7.1MB">11 <!ENTITY cairo-buildsize " 40 MB (up to an additional 270MB to run the test suite)">12 <!ENTITY cairo-time "0. 4 SBU (up to an additional 2.9SBU to run the test suite)">9 <!ENTITY cairo-md5sum "f101a9e88b783337b20b2e26dfd26d5f"> 10 <!ENTITY cairo-size "22.5 MB"> 11 <!ENTITY cairo-buildsize "145 MB (up to an additional 454 MB to run the test suite)"> 12 <!ENTITY cairo-time "0.7 SBU (up to an additional 10 SBU to run the test suite)"> 13 13 ]> 14 14 … … 30 30 <title>Introduction to cairo</title> 31 31 32 <para><application> cairo</application> is a 2D graphics library with32 <para><application>Cairo</application> is a 2D graphics library with 33 33 support for multiple output devices. Currently supported output targets 34 34 include the <application>X</application> Window System, win32, image 35 35 buffers, PostScript, PDF and SVG. Experimental backends include OpenGL 36 (through glitz), Quartz and XCB file output. cairo is designed to produce37 consistent output on all output media while taking advantage of display38 hardware acceleration when available (e.g., through the X Render39 Extension). The <application>cairo</application> API provides operations40 similar to thedrawing operators of PostScript and PDF. Operations in41 <application> cairo</application> include stroking and filling cubic42 B ézier splines, transforming and compositing translucent images, and36 Quartz and XCB file output. cairo is designed to produce consistent output 37 on all output media while taking advantage of display hardware acceleration 38 when available (e.g., through the X Render Extension). The 39 <application>Cairo</application> API provides operations similar to the 40 drawing operators of PostScript and PDF. Operations in 41 <application>Cairo</application> include stroking and filling cubic 42 Bézier splines, transforming and compositing translucent images, and 43 43 antialiased text rendering. All drawing operations can be transformed by 44 any affine transformation (scale, rotation, shear, etc.).</para> 45 46 &lfs65_checked; 44 any <ulink url="http://en.wikipedia.org/wiki/Affine_transformation">affine 45 transformation</ulink> (scale, rotation, shear, etc.).</para> 46 47 &lfs70_checked; 47 48 48 49 <bridgehead renderas="sect3">Package Information</bridgehead> … … 71 72 72 73 <bridgehead renderas="sect4">Required</bridgehead> 73 <para role="required"><xref linkend="libpng"/>, 74 <xref linkend="pixman"/>, and 75 <xref linkend="fontconfig"/></para> 76 <!-- and <xref linkend="pkgconfig"/></para> --> 74 <para role="required"><xref linkend="pkgconfig"/>, <xref linkend="libpng"/>, 75 <xref linkend="pixman"/>, and <xref linkend="fontconfig"/></para> 77 76 78 77 <bridgehead renderas="sect4">Recommended</bridgehead> 79 <para role="recommended"><xref linkend="x-window-system"/></para> 78 <para role="recommended"><xref linkend="x-window-system"/> (gtk requires 79 cairo to be built after libX11 is installed)</para> 80 80 81 81 <bridgehead renderas="sect4">Optional</bridgehead> 82 <para role="optional"><ulink 83 url="http://www.freedesktop.org/Software/glitz">glitz</ulink>, 82 <para role="optional"><xref linkend="gtk-doc"/>, 84 83 <ulink url="http://www.directfb.org/">DirectFB</ulink>, 85 <xref linkend="gtk-doc"/>, 86 <xref linkend="xcb-util"/>, 87 <ulink url="http://libspectre.freedesktop.org">libspectre</ulink>, and 84 <ulink url="http://code.google.com/p/skia/">Skia</ulink> and 88 85 <ulink url="http://www.valgrind.org">Valgrind</ulink></para> 89 86 90 87 <bridgehead renderas="sect4">Optional (to provide extended test suite 91 88 coverage)</bridgehead> 92 <para role="optional"><xref linkend="gtk2"/> (for testing the PDF backend), 93 <xref linkend="poppler"/> (for testing the PDF backend), and 94 <xref linkend="librsvg"/> (for testing the SVG backend) 95 <!-- [ comment this pending clarification - not presently required] , and 96 <ulink url="http://ltp.sourceforge.net/">LTP</ulink>--></para> 89 <para role="optional"><xref linkend="gs"/> (to test the postscript 90 backend), <xref linkend="gtk2"/> (for testing the PDF backend), 91 <xref linkend="poppler"/> (for testing the PDF backend), 92 <ulink url="http://libspectre.freedesktop.org">libspectre</ulink> (to test 93 the PDF backend) and <xref linkend="librsvg"/> (for testing the SVG 94 backend)</para> 97 95 98 96 <para>Note that the GTK, Poppler and librsvg packages are circular in that 99 using them for test suite coverage requires installing cairo first, 100 then installing the desired package(s), then installing cairo again.</para> 97 using them for test suite coverage requires installing cairo first, then 98 installing the desired package(s), then installing cairo again. As the test 99 suite seems to be somewhat broken it doesn't seem worth the effort.</para> 101 100 102 101 <para condition="html" role="usernotes">User Notes: … … 108 107 <title>Installation of cairo</title> 109 108 110 <para>Install <application> cairo</application> by running the following109 <para>Install <application>Cairo</application> by running the following 111 110 commands:</para> 112 111 113 <screen><userinput>./configure --prefix=/usr &&112 <screen><userinput>./configure --prefix=/usr --enable-tee --enable-gl && 114 113 make</userinput></screen> 115 114 116 <!-- Tested with Poppler 0.10.7, librsvg 2.26.0, libspectre 0.2.2, 117 GTK+ 2.26.5, and GPL Ghostscript 8.64. 118 29 of 205 tests failed --> 119 120 <para>To test the results, issue: <command>make check</command>. Note that 121 as many as 29 of the tests are known to fail for unknown reasons. 122 If you do not have a <command>gs</command> binary in your path, many 123 <!-- used to be (87 of $total), needs to be updated by someone who can 124 get them to run through without hanging --> 125 of the 205 tests will fail. Also, to enhance test 126 coverage, the tests should be run with an available X Window screen (e.g. 127 from a local xterm or equivalent window).</para> 128 129 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 115 <para>To test the results, issue: <command>make -k check</command>.</para> 116 117 <para>Note that the tests take a long time to run and many of them fail for 118 unknown reasons.</para> 119 120 <para>Now, as the <systemitem class="username">root</systemitem> 121 user:</para> 130 122 131 123 <screen role="root"><userinput>make install</userinput></screen> … … 139 131 href="../../xincludes/gtk-doc-rebuild.xml"/> 140 132 141 <para><option>--enable-xcb=yes</option>: Enable the xcb back end. 142 </para> 143 144 <para><option>--disable-static</option>: Prevent static libraries 145 being built and installed.</para> 133 <para><option>--enable-tee</option>: This is used by 134 <application>Firefox</application>. If you don't enable the Cairo's tee 135 surface back end you won't be able to build 136 <application>Firefox</application> with 137 <option>--enable-system-cairo</option>.</para> 138 139 <para><option>--enable-gl</option>: Enable the 140 <application>Cairo</application> OpenGL back end. Remove this option if 141 you've not installed <xref linkend="mesalib"/>.</para> 142 143 <para><option>--enable-xcb</option>: Enable 144 <application>Cairo</application>'s <xref linkend="libxcb"/> back end.</para> 145 146 <para><option>--disable-static</option>: Prevent static libraries being 147 built and installed.</para> 148 149 <para><option>--enable-vg</option>: Enable the 150 <application>Cairo</application> 151 <ulink url="http://en.wikipedia.org/wiki/OpenVG">OpenVG</ulink> back 152 end (requires <xref linkend="mesalib"/> installed, configured with 153 --enable-gallium-egl and --enable-openvg).</para> 146 154 147 155 </sect2> … … 156 164 157 165 <seglistitem> 158 <seg>None</seg> 159 <seg>libcairo.{so,a}</seg> 160 <seg>/usr/include/cairo and /usr/share/gtk-doc/html/cairo</seg> 166 <seg>cairo-trace</seg> 167 <seg>libcairo.{so,a}, libcairo-gobject.{so,a} and 168 libcairo-script-interpreter.{so,a}</seg> 169 <seg>/usr/include/cairo, usr/lib/cairo and 170 /usr/share/gtk-doc/html/cairo</seg> 161 171 </seglistitem> 162 172 </segmentedlist> … … 167 177 <?dbhtml list-presentation="table"?> 168 178 179 <varlistentry id="cairo-trace"> 180 <term><command>cairo-trace</command></term> 181 <listitem> 182 <para>generates a log of all calls made by an application to 183 <application>Cairo</application>.</para> 184 <indexterm zone="cairo cairo-trace"> 185 <primary sortas="b-cairo-trace">cairo-trace</primary> 186 </indexterm> 187 </listitem> 188 </varlistentry> 189 169 190 <varlistentry id="libcairo"> 170 191 <term><filename class='libraryfile'>libcairo.{so,a}</filename></term> … … 178 199 </varlistentry> 179 200 201 <varlistentry id="libcairo-gobject"> 202 <term><filename class='libraryfile'>libcairo-gobject.{so,a}</filename></term> 203 <listitem> 204 <para>contains functions that integrate 205 <application>Cairo</application> with <xref linkend="glib2"/>'s 206 GObject type system.</para> 207 <indexterm zone="cairo libcairo-gobject"> 208 <primary sortas="c-libcairo-gobject">libcairo-gobject.{so,a}</primary> 209 </indexterm> 210 </listitem> 211 </varlistentry> 212 213 <varlistentry id="libcairo-script-interpreter"> 214 <term><filename class='libraryfile'>libcairo-script-interpreter.{so,a}</filename></term> 215 <listitem> 216 <para>contains the script interpreter functions for executing and 217 manipulating <application>Cairo</application> execution traces.</para> 218 <indexterm zone="cairo libcairo-script-interpreter"> 219 <primary sortas="c-libcairo-script-interpreter">libcairo-script-interpreter.{so,a}</primary> 220 </indexterm> 221 </listitem> 222 </varlistentry> 223 180 224 </variablelist> 181 225
Note:
See TracChangeset
for help on using the changeset viewer.