source: x/lib/gdk-pixbuf.xml@ a8e1b4ab

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since a8e1b4ab was a8e1b4ab, checked in by Ken Moffat <ken@…>, 15 months ago

gdk-pixbuf, pango:

Add --wrap-mode=no-fallback to prevent gi-docgen getting downloaded
if you have the (python3) deps present. Comment gtk-doc in these
packages, explain that gi-docgen is used for the documentation.

  • Property mode set to 100644
File size: 9.5 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 gdk-pixbuf-download-http
8 "&gnome-download-http;/gdk-pixbuf/2.42/gdk-pixbuf-&gdk-pixbuf-version;.tar.xz">
9 <!ENTITY gdk-pixbuf-download-ftp
10 "&gnome-download-ftp;/gdk-pixbuf/2.42/gdk-pixbuf-&gdk-pixbuf-version;.tar.xz">
11 <!ENTITY gdk-pixbuf-md5sum "7cd2fdaa3c55e2302316fe36968f7425">
12 <!ENTITY gdk-pixbuf-size "7.4 MB">
13 <!ENTITY gdk-pixbuf-buildsize "71 MB (with tests)">
14 <!ENTITY gdk-pixbuf-time "0.2 SBU (Using parallelism=4; with tests)">
15]>
16
17<sect1 id="gdk-pixbuf" xreflabel="gdk-pixbuf-&gdk-pixbuf-version;">
18 <?dbhtml filename="gdk-pixbuf.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>gdk-pixbuf-&gdk-pixbuf-version;</title>
25
26 <indexterm zone="gdk-pixbuf">
27 <primary sortas="a-gdk-pixbuf">gdk-pixbuf</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Gdk Pixbuf</title>
32
33 <para>
34 The <application>Gdk Pixbuf</application> package is a toolkit for image
35 loading and pixel buffer manipulation. It is used by
36 <application>GTK+ 2</application> and <application>GTK+ 3</application> to
37 load and manipulate images. In the past it was distributed as part of
38 <application>GTK+ 2</application> but it was split off into a separate
39 package in preparation for the change to <application>GTK+ 3</application>.
40 </para>
41
42 &lfs110_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&gdk-pixbuf-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&gdk-pixbuf-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &gdk-pixbuf-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &gdk-pixbuf-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &gdk-pixbuf-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &gdk-pixbuf-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Gdk Pixbuf Dependencies</bridgehead>
79
80 <bridgehead renderas="sect4">Required</bridgehead>
81 <para role="required">
82 <xref linkend="glib2"/>,
83 <xref linkend="libjpeg"/>,
84 <xref linkend="libpng"/>, and
85 <xref linkend="shared-mime-info"/>
86 </para>
87
88 <bridgehead renderas="sect4">Recommended</bridgehead>
89 <para role="recommended">
90 <xref role="runtime" linkend="librsvg"/> (runtime dependency, needed for
91 loading symbolic icons) and
92 <xref linkend="libtiff"/>
93 </para>
94
95 <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
96 <para role="optional">
97 <xref linkend="gobject-introspection"/>
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <!--<xref linkend="jasper"/> and-->
103 <!--<xref linkend="gtk-doc"/> and-->
104 <ulink url="https://gitlab.gnome.org/ebassi/gi-docgen">gi-docgen</ulink>
105 (to generate documentation)
106 </para>
107
108 <para condition="html" role="usernotes">
109 User Notes: <ulink url="&blfs-wiki;/gdk-pixbuf"/>
110 </para>
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of Gdk Pixbuf</title>
115
116 <para>
117 Install <application>Gdk Pixbuf</application> by running the following
118 commands:
119 </para>
120
121<screen><userinput>mkdir build &amp;&amp;
122cd build &amp;&amp;
123
124meson --prefix=/usr --buildtype=release --wrap-mode=nofallback .. &amp;&amp;
125ninja</userinput></screen>
126
127 <para>
128 To test the results, issue: <command>ninja test</command>. The tests
129 make a heavy use of disk.
130 </para>
131
132 <para>
133 Now, as the <systemitem class="username">root</systemitem> user:
134 </para>
135
136<screen role="root"><userinput>ninja install</userinput></screen>
137
138 <note>
139 <para>
140 If you installed the package on to your system using a
141 <quote>DESTDIR</quote> method, an important file was not installed and
142 should be copied and/or generated. Generate it using the following
143 command as the <systemitem class="username">root</systemitem> user:
144 </para>
145
146<screen role="root"><userinput>gdk-pixbuf-query-loaders --update-cache</userinput></screen>
147 </note>
148 </sect2>
149
150 <sect2 role="commands">
151 <title>Command Explanations</title>
152
153 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
154 href="../../xincludes/meson-buildtype-release.xml"/>
155
156 <!-- gi-docgen can get installed without this, if deps exist -->
157 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
158 href="../../xincludes/meson-wrap-nofallback.xml"/>
159
160 <!-- gtk_doc replaced by gi-docgen
161 <para>
162 <option>-Dgtk_doc=true</option>: Use this parameter if
163 <application>GTK-Doc</application> is installed and you wish to rebuild
164 and install the API documentation.
165 <!\-\- -Dgtk_doc is set to "yield=true" in meson_options.txt \-\->
166 </para>-->
167<!-- Removed in 2.42.0
168 <para>
169 <option>-Djasper=true</option>: If you've installed
170 <xref linkend="jasper"/> and you want
171 <application>Gdk Pixbuf</application> to use it to compile a
172 JPEG2000 image loader, pass this switch to meson.
173 </para>
174-->
175 </sect2>
176
177 <sect2 role="content">
178 <title>Contents</title>
179
180 <segmentedlist>
181 <segtitle>Installed Programs</segtitle>
182 <segtitle>Installed Libraries</segtitle>
183 <segtitle>Installed Directories</segtitle>
184
185 <seglistitem>
186 <seg>
187 gdk-pixbuf-csource,
188 gdk-pixbuf-pixdata,
189 gdk-pixbuf-query-loaders, and
190 gdk-pixbuf-thumbnailer
191 </seg>
192 <seg>
193 libgdk_pixbuf-2.0.so
194 </seg>
195 <seg>
196 /usr/{include,lib}/gdk-pixbuf-2.0,
197 /usr/libexec/installed-tests/gdk-pixbuf,
198 /usr/share/installed-tests/gdk-pixbuf,
199 /usr/share/gtk-doc/html/gdk-pixbuf, and
200 /usr/share/thumbnailers
201 </seg>
202 </seglistitem>
203 </segmentedlist>
204
205 <variablelist>
206 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
207 <?dbfo list-presentation="list"?>
208 <?dbhtml list-presentation="table"?>
209
210 <varlistentry id="gdk-pixbuf-csource">
211 <term><command>gdk-pixbuf-csource</command></term>
212 <listitem>
213 <para>
214 is a small utility that generates C code containing images, used
215 for compiling images directly into programs
216 </para>
217 <indexterm zone="gdk-pixbuf gdk-pixbuf-csource">
218 <primary sortas="b-gdk-pixbuf-csource">gdk-pixbuf-csource</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="gdk-pixbuf-pixdata">
224 <term><command>gdk-pixbuf-pixdata</command></term>
225 <listitem>
226 <para>
227 is a tool used to convert GdkPixbuf to GdkPixdata
228 </para>
229 <indexterm zone="gdk-pixbuf gdk-pixbuf-pixdata">
230 <primary sortas="b-gdk-pixbuf-pixdata">gdk-pixbuf-pixdata</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="gdk-pixbuf-query-loaders">
236 <term><command>gdk-pixbuf-query-loaders</command></term>
237 <listitem>
238 <para>
239 collects information about loadable modules for
240 <application>Gdk Pixbuf</application> and writes it
241 to the default cache file location, or to stdout
242 </para>
243 <indexterm zone="gdk-pixbuf gdk-pixbuf-query-loaders">
244 <primary sortas="b-gdk-pixbuf-query-loaders">gdk-pixbuf-query-loaders</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="gdk-pixbuf-thumbnailer">
250 <term><command>gdk-pixbuf-thumbnailer</command></term>
251 <listitem>
252 <para>
253 creates thumbnails of pictures for use in other applications
254 </para>
255 <indexterm zone="gdk-pixbuf gdk-pixbuf-thumbnailer">
256 <primary sortas="b-gdk-pixbuf-thumbnailer">gdk-pixbuf-thumbnailer</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="libgdk_pixbuf-2">
262 <term><filename class="libraryfile">libgdk_pixbuf-2.0.so</filename></term>
263 <listitem>
264 <para>
265 contains functions used to load and render images
266 </para>
267 <indexterm zone="gdk-pixbuf libgdk_pixbuf-2">
268 <primary sortas="c-libgdk_pixbuf-2">libgdk_pixbuf-2.0.so</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <!-- Split off into gdk-pixbuf-xlib
274 <varlistentry id="libgdk_pixbuf_xlib-2">
275 <term><filename class="libraryfile">libgdk_pixbuf_xlib-2.0.so</filename></term>
276 <listitem>
277 <para>
278 contains functions used to manipulate images and interfaces with
279 <application>Xlib</application>
280 </para>
281 <indexterm zone="gdk-pixbuf libgdk_pixbuf_xlib-2">
282 <primary sortas="c-libgdk_pixbuf_xlib-2">libgdk_pixbuf_xlib-2.0.so</primary>
283 </indexterm>
284 </listitem>
285 </varlistentry>
286 -->
287 </variablelist>
288
289 </sect2>
290
291</sect1>
Note: See TracBrowser for help on using the repository browser.