source: x/lib/gdk-pixbuf.xml@ 28448a7

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 28448a7 was 49e37e2, checked in by Xi Ruoyao <xry111@…>, 15 months ago

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