source: x/lib/gdk-pixbuf.xml@ 5841c65

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 5841c65 was 5841c65, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Most remaing tags for genlibs
There are 10 genlib tags left that need to wait for some
dependencies to be tagged.

  • Property mode set to 100644
File size: 9.2 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 </para>
106
107 <para condition="html" role="usernotes">
108 User Notes: <ulink url="&blfs-wiki;/gdk-pixbuf"/>
109 </para>
110 </sect2>
111
112 <sect2 role="installation">
113 <title>Installation of Gdk Pixbuf</title>
114
115 <para>
116 Install <application>Gdk Pixbuf</application> by running the following
117 commands:
118 </para>
119
120<screen><userinput>mkdir build &amp;&amp;
121cd build &amp;&amp;
122
123meson --prefix=/usr --buildtype=release -Dgtk_doc=false .. &amp;&amp;
124ninja</userinput></screen>
125
126 <para>
127 To test the results, issue: <command>ninja test</command>. The tests
128 make a heavy use of disk.
129 </para>
130
131 <para>
132 Now, as the <systemitem class="username">root</systemitem> user:
133 </para>
134
135<screen role="root"><userinput>ninja install</userinput></screen>
136
137 <note>
138 <para>
139 If you installed the package on to your system using a
140 <quote>DESTDIR</quote> method, an important file was not installed and
141 should be copied and/or generated. Generate it using the following
142 command as the <systemitem class="username">root</systemitem> user:
143 </para>
144
145<screen role="root"><userinput>gdk-pixbuf-query-loaders --update-cache</userinput></screen>
146 </note>
147 </sect2>
148
149 <sect2 role="commands">
150 <title>Command Explanations</title>
151
152 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
153 href="../../xincludes/meson-buildtype-release.xml"/>
154
155 <para>
156 <option>-Dgtk_doc=true</option>: Use this parameter if
157 <application>GTK-Doc</application> is installed and you wish to rebuild
158 and install the API documentation.
159 <!-- -Dgtk_doc is set to "yield=true" in meson_options.txt -->
160 </para>
161<!-- Removed in 2.42.0
162 <para>
163 <option>-Djasper=true</option>: If you've installed
164 <xref linkend="jasper"/> and you want
165 <application>Gdk Pixbuf</application> to use it to compile a
166 JPEG2000 image loader, pass this switch to meson.
167 </para>
168-->
169 </sect2>
170
171 <sect2 role="content">
172 <title>Contents</title>
173
174 <segmentedlist>
175 <segtitle>Installed Programs</segtitle>
176 <segtitle>Installed Libraries</segtitle>
177 <segtitle>Installed Directories</segtitle>
178
179 <seglistitem>
180 <seg>
181 gdk-pixbuf-csource,
182 gdk-pixbuf-pixdata,
183 gdk-pixbuf-query-loaders, and
184 gdk-pixbuf-thumbnailer
185 </seg>
186 <seg>
187 libgdk_pixbuf-2.0.so
188 </seg>
189 <seg>
190 /usr/{include,lib}/gdk-pixbuf-2.0,
191 /usr/libexec/installed-tests/gdk-pixbuf,
192 /usr/share/installed-tests/gdk-pixbuf,
193 /usr/share/gtk-doc/html/gdk-pixbuf, and
194 /usr/share/thumbnailers
195 </seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="gdk-pixbuf-csource">
205 <term><command>gdk-pixbuf-csource</command></term>
206 <listitem>
207 <para>
208 is a small utility that generates C code containing images, used
209 for compiling images directly into programs
210 </para>
211 <indexterm zone="gdk-pixbuf gdk-pixbuf-csource">
212 <primary sortas="b-gdk-pixbuf-csource">gdk-pixbuf-csource</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="gdk-pixbuf-pixdata">
218 <term><command>gdk-pixbuf-pixdata</command></term>
219 <listitem>
220 <para>
221 is a tool used to convert GdkPixbuf to GdkPixdata
222 </para>
223 <indexterm zone="gdk-pixbuf gdk-pixbuf-pixdata">
224 <primary sortas="b-gdk-pixbuf-pixdata">gdk-pixbuf-pixdata</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="gdk-pixbuf-query-loaders">
230 <term><command>gdk-pixbuf-query-loaders</command></term>
231 <listitem>
232 <para>
233 collects information about loadable modules for
234 <application>Gdk Pixbuf</application> and writes it
235 to the default cache file location, or to stdout
236 </para>
237 <indexterm zone="gdk-pixbuf gdk-pixbuf-query-loaders">
238 <primary sortas="b-gdk-pixbuf-query-loaders">gdk-pixbuf-query-loaders</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 <varlistentry id="gdk-pixbuf-thumbnailer">
244 <term><command>gdk-pixbuf-thumbnailer</command></term>
245 <listitem>
246 <para>
247 creates thumbnails of pictures for use in other applications
248 </para>
249 <indexterm zone="gdk-pixbuf gdk-pixbuf-thumbnailer">
250 <primary sortas="b-gdk-pixbuf-thumbnailer">gdk-pixbuf-thumbnailer</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="libgdk_pixbuf-2">
256 <term><filename class="libraryfile">libgdk_pixbuf-2.0.so</filename></term>
257 <listitem>
258 <para>
259 contains functions used to load and render images
260 </para>
261 <indexterm zone="gdk-pixbuf libgdk_pixbuf-2">
262 <primary sortas="c-libgdk_pixbuf-2">libgdk_pixbuf-2.0.so</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <!-- Split off into gdk-pixbuf-xlib
268 <varlistentry id="libgdk_pixbuf_xlib-2">
269 <term><filename class="libraryfile">libgdk_pixbuf_xlib-2.0.so</filename></term>
270 <listitem>
271 <para>
272 contains functions used to manipulate images and interfaces with
273 <application>Xlib</application>
274 </para>
275 <indexterm zone="gdk-pixbuf libgdk_pixbuf_xlib-2">
276 <primary sortas="c-libgdk_pixbuf_xlib-2">libgdk_pixbuf_xlib-2.0.so</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280 -->
281 </variablelist>
282
283 </sect2>
284
285</sect1>
Note: See TracBrowser for help on using the repository browser.