source: xsoft/other/gimp.xml@ 7daf6144

12.2 lazarus trunk
Last change on this file since 7daf6144 was dfa5ffd, checked in by Douglas R. Reno <renodr@…>, 4 weeks ago

Tags

  • Property mode set to 100644
File size: 18.2 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 gimp-download-http "&sources-anduin-http;/gimp/gimp3-&gimp-version;.tar.xz">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "17fcd0bfc8e66fc61d672b4409cb3e3a">
10 <!ENTITY gimp-size "26 MB">
11 <!ENTITY gimp-buildsize "456 MB (162 MB installed)">
12 <!ENTITY gimp-time "1.2 SBU (Using parallelism=4)">
13
14 <!-- pro-tem, a pull of gimp-help, https://gitlab.gnome.org/GNOME/gimp-help.git
15 git archive - -format=tar - -prefix=${DIRNAME}/ HEAD | xz >../${DIRNAME}.tar.xz -->
16
17 <!-- renodr: I generated the git tarball using the following instructions:
18 cd /tmp &&
19 mkdir gimp-help &&
20 cd gimp-help &&
21 git clone https://gitlab.gnome.org/GNOME/gimp-help.git &&
22 cd gimp-help &&
23 git checkout gimp-help-2-10 &&
24 cd .. &&
25 rm -rv gimp-help/.git &&
26 mv -v gimp-help gimp-help-<DATE>
27 tar -cJvf gimp-help-<DATE>.tar.xz gimp-help-<DATE>
28
29 After you've completed this, run a test build, and upload the tarball to
30 anduin.-->
31
32 <!ENTITY gimp-help-version "&gimp-version;">
33 <!ENTITY gimp-help-download "&sources-anduin-http;/gimp/gimp3-help-&gimp-help-version;.tar.xz">
34<!-- <!ENTITY gimp-help-download "https://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">-->
35 <!ENTITY gimp-help-md5sum "162d57a67ff737ed221a8d7f274d119f">
36 <!ENTITY gimp-help-size "129 MB">
37 <!ENTITY gimp-help-buildsize "From 351 MB (74 MB installed) for en only to 1.5 GB for all
38 languages">
39 <!ENTITY gimp-help-time "0.4 SBU (en only), 5.1 SBU for all languages; using parallelism=4">
40]>
41
42<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
43 <?dbhtml filename="gimp.html" ?>
44
45 <title>Gimp-&gimp-version;</title>
46
47 <indexterm zone="gimp">
48 <primary sortas="a-Gimp">Gimp</primary>
49 </indexterm>
50
51 <sect2 role="package">
52 <title>Introduction to Gimp</title>
53
54 <para>
55 The <application>Gimp</application> package contains
56 the GNU Image Manipulation Program which is useful for
57 photo retouching, image composition and image authoring.
58 </para>
59
60 &lfs122_checked;
61
62 <bridgehead renderas="sect3">Package Information</bridgehead>
63 <itemizedlist spacing="compact">
64 <listitem>
65 <para>
66 Download (HTTP): <ulink url="&gimp-download-http;"/>
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download (FTP): <ulink url="&gimp-download-ftp;"/>
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Download MD5 sum: &gimp-md5sum;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Download size: &gimp-size;
82 </para>
83 </listitem>
84 <listitem>
85 <para>
86 Estimated disk space required: &gimp-buildsize;
87 </para>
88 </listitem>
89 <listitem>
90 <para>
91 Estimated build time: &gimp-time;
92 </para>
93 </listitem>
94 </itemizedlist>
95
96 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
97<!--
98 <note>
99 <para>
100 The creation of local html files with recent versions of the necessary
101 packages is somewhat broken (some png images are not sourced by the
102 generated HTML, only their captions are visible).
103 </para>
104 </note>
105-->
106 <note>
107 <para>
108 The English version of the help files is complete, but large
109 parts of the text for many other languages are not yet translated.
110 </para>
111 </note>
112
113
114 <itemizedlist spacing="compact">
115 <listitem>
116 <para>
117 Download (HTTP): <ulink url="&gimp-help-download;"/>
118 </para>
119 </listitem>
120 <listitem>
121 <para>
122 Download size: &gimp-help-size;
123 </para>
124 </listitem>
125 <listitem>
126 <para>
127 Download MD5 sum: &gimp-help-md5sum;
128 </para>
129 </listitem>
130 <listitem>
131 <para>
132 Estimated disk space required: &gimp-help-buildsize;
133 </para>
134 </listitem>
135 <listitem>
136 <para>
137 Estimated build time: &gimp-help-time;
138 </para>
139 </listitem>
140 </itemizedlist>
141
142 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
143
144 <bridgehead renderas="sect4">Required</bridgehead>
145 <para role="required">
146 <xref linkend="appstream-glib"/>,
147 <xref linkend="gegl"/>,
148 <xref linkend="gexiv2"/>,
149 <xref linkend="glib-networking"/>,
150 <xref linkend="gtk3"/>,
151 <xref linkend="harfbuzz"/>,
152 <xref linkend="libmypaint"/>,
153 <xref linkend="librsvg"/>,
154 <xref linkend="libtiff"/>,
155 <!-- en can be built without this -->
156 <xref linkend="libxml2"/> (to build the translated help files),
157 <xref linkend="lcms2"/>,
158 <xref linkend="mypaint-brushes"/>, and
159 <xref linkend="poppler"/> (including poppler-data)
160 </para>
161
162 <bridgehead renderas="sect4">Recommended</bridgehead>
163 <para role="recommended">
164 <xref linkend="graphviz"/>,
165 <xref linkend="gs"/> (with libgs installed),
166 <xref role='runtime' linkend="gvfs"/> and
167 <xref role='runtime' linkend='glib-networking'/>
168 (both runtime, to access the online help, open images from a HTTP
169 or HTTPS URL, drag and drop images from an external application,
170 etc.),
171 <xref linkend="iso-codes"/>,
172 <xref linkend="libgudev"/>,
173 <xref linkend="pygobject3"/>, and
174 <xref linkend="xdg-utils"/>
175 </para>
176
177 <bridgehead renderas="sect4">Optional</bridgehead>
178 <para role="optional">
179 <xref linkend="aalib"/>,
180 <xref linkend="alsa-lib"/>,
181 <xref linkend="gjs"/>,
182 <xref linkend="libjxl"/>,
183 <xref linkend="libmng"/>,
184 <xref linkend="libunwind"/>,
185 <xref linkend="libwebp"/>,
186 <xref linkend="lua"/>,
187 <xref linkend="openjpeg2"/>,
188 <xref linkend="gtk-doc"/>,
189 <ulink url="https://github.com/HEASARC/cfitsio">cfitsio</ulink>,
190 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
191 <ulink url="https://github.com/svanderburg/libiff">libiff</ulink>,
192 <ulink url="https://github.com/svanderburg/libilbm">libilbm</ulink>,
193 <ulink url="https://github.com/strukturag/libheif/">libheif</ulink> with
194 <ulink url="https://github.com/strukturag/libde265/">libde265</ulink>
195 (both needed to read macOS heic images),
196 <ulink url="https://wvware.sourceforge.net/libwmf.html">libwmf</ulink>,
197 <ulink url="https://www.openexr.com/">OpenEXR</ulink>, and
198 <ulink url="https://github.com/phoboslab/qoi">qoi</ulink>
199 </para>
200
201 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
202 <para role="optional">
203 <ulink url="https://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
204 <ulink url="https://pngnq.sourceforge.net/">pngnq</ulink> and
205 <ulink url="https://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
206 to optimize the png files, but see the note on the help download above
207 </para>
208
209 <para condition="html" role="usernotes">Editor Notes:
210 <ulink url="&blfs-wiki;/gimp"/>
211 </para>
212 </sect2>
213
214 <sect2 role="installation">
215 <title>Installation of Gimp</title>
216
217 <para>
218 Install <application>Gimp</application> by running
219 the following commands:
220 </para>
221
222<screen><userinput>mkdir gimp-build &amp;&amp;
223cd gimp-build &amp;&amp;
224
225meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
226ninja</userinput></screen>
227
228 <para>
229 To test the results (requires an X-Windowed terminal) issue:
230 <command>ninja test</command>.
231 <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
232
233 </para>
234
235 <para>
236 Now, as the &root; user:
237 </para>
238
239<screen role="root"><userinput>ninja install</userinput></screen>
240
241 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
242 href="../../xincludes/update-icons-and-desktop.xml"/>
243
244 </sect2>
245
246 <sect2 role="installation">
247 <title>Installation of Gimp-Help</title>
248
249 <para>
250 The <filename>gimp-help</filename> tarball contains images and English
251 text help for help files, together with translations.
252 If you wish to install local copies of the help files to read offline,
253 unpack the gimp-help tarball and change into the root of the newly
254 created source tree.
255
256 <!--
257 The documentation generated by gimp-help-2.10.34 and online help have
258 the same contents, so I comment this out. [pierre Nov. 2023]
259 Because of the
260 issues mentioned in the note above, you are recommended to use the online
261 help, either by building against <xref linkend="gvfs"/> so that 'help'
262 can open the latest XML files in your browser, or else you can manually
263 open the html in your browser by going to <ulink
264 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
265 (change the language code if desired).-->
266 </para>
267
268<screen><userinput>tar -xf ../../gimp3-help-&gimp-version;.tar.xz &amp;&amp;
269cd gimp3-help-&gimp-version;
270
271automake --add-missing
272
273ALL_LINGUAS=&quot;ca cs da de en en_GB es fa fr hr ko lt nl nn pt pt_BR ro sl sv uk zh_CN&quot; \
274./configure --prefix=/usr</userinput></screen>
275
276 <para>
277 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
278 you do not wish to install. Alternatively, remove the line starting with
279 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
280 </para>
281
282 <para>
283 Now build the help files:
284 </para>
285
286<screen><userinput>make</userinput></screen>
287
288 <para>
289 Issue the following commands as the &root; user to install the help files:
290 </para>
291
292<screen role="root"><userinput>make install &amp;&amp;
293chown -R root:root /usr/share/gimp/3.0/help</userinput></screen>
294
295 </sect2>
296
297 <sect2 role="commands" id="gimp-cmd-explanations">
298 <title>Command Explanations</title>
299
300 <para>
301 <envar>ALL_LINGUAS=&quot;ca cs da de en en_GB es fa...&quot;</envar>: by
302 default, the help files will be rendered in all the available languages.
303 Remove the codes of any languages you do not wish to build.
304 </para>
305
306 </sect2>
307
308 <sect2 role="configuration">
309 <title>Configuring The Gimp</title>
310
311 <sect3 id="gimp-config">
312 <title>Config Files</title>
313
314 <para>
315 <filename>/etc/gimp/3.0/*</filename>
316 </para>
317
318 <indexterm zone="gimp gimp-config">
319 <primary sortas="e-etc-gimp-3.0-star">/etc/gimp/3.0/*</primary>
320 </indexterm>
321
322 </sect3>
323
324 </sect2>
325
326 <sect2 role="content">
327 <title>Contents</title>
328
329 <segmentedlist>
330 <segtitle>Installed Programs</segtitle>
331 <segtitle>Installed Libraries</segtitle>
332 <segtitle>Installed Directories</segtitle>
333
334 <seglistitem>
335 <seg>
336 gimp-2.99,
337 gimp-console-2.99,
338 gimptool-2.99,
339 gimp-test-clipboard-2.99, and
340 gimp-script-fu-interpreter-3.0
341 </seg>
342 <seg>
343 libgimp-3.0.so,
344 libgimp-scriptfu-3.0,
345 libgimpbase-3.0.so,
346 libgimpcolor-3.0.so,
347 libgimpconfig-3.0.so,
348 libgimpmath-3.0.so,
349 libgimpmodule-3.0.so,
350 libgimpui-3.0.so, and
351 libgimpwidgets-3.0.so
352 </seg>
353 <seg>
354 /etc/gimp,
355 /usr/include/gimp-3.0,
356 /usr/lib/gimp-3.0,
357 /usr/lib/gimp/3.0,
358 /usr/share/gimp/3.0, and
359 /usr/share/doc/gimp-2.99
360 </seg>
361 </seglistitem>
362 </segmentedlist>
363
364 <variablelist>
365 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
366 <?dbfo list-presentation="list"?>
367 <?dbhtml list-presentation="table"?>
368
369 <varlistentry id="gimp-2.99">
370 <term><command>gimp-2.99</command></term>
371 <listitem>
372 <para>
373 is the Gnu Image Manipulation Program. It works with a variety
374 of image formats and provides a large selection of tools
375 </para>
376 <indexterm zone="gimp gimp-2.99">
377 <primary sortas="b-gimp-2.99">gimp-2.99</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="gimp-console-2.99">
383 <term><command>gimp-console-2.99</command></term>
384 <listitem>
385 <para>
386 is a console program that behaves as if The
387 <application>Gimp</application> was called with the
388 <option>--no-interface</option> command-line option
389 </para>
390 <indexterm zone="gimp gimp-console-2.99">
391 <primary sortas="b-gimp-console-2.99">gimp-console-2.99</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="gimptool-2.99">
397 <term><command>gimptool-2.99</command></term>
398 <listitem>
399 <para>
400 is a tool that can build plug-ins or scripts and install them
401 if they are distributed in one source file.
402 <command>gimptool-2.99</command> can also be used by programs that
403 need to know what libraries and include-paths The
404 <application>Gimp</application> was compiled with
405 </para>
406 <indexterm zone="gimp gimptool-2.99">
407 <primary sortas="b-gimptool-2.99">gimptool-2.99</primary>
408 </indexterm>
409 </listitem>
410 </varlistentry>
411
412 <varlistentry id="libgimp-3.0">
413 <term><filename class="libraryfile">libgimp-3.0.so</filename></term>
414 <listitem>
415 <para>
416 provides C bindings for The <application>Gimp</application>'s
417 Procedural Database (PDB), which offers an interface to core functions
418 and to functionality provided by plug-ins
419 </para>
420 <indexterm zone="gimp libgimp-3.0">
421 <primary sortas="c-libgimp-3.0">libgimp-3.0.so</primary>
422 </indexterm>
423 </listitem>
424 </varlistentry>
425
426 <varlistentry id="libgimpbase-3.0">
427 <term><filename class="libraryfile">libgimpbase-3.0.so</filename></term>
428 <listitem>
429 <para>
430 provides the C functions for basic
431 <application>Gimp</application> functionality such as determining
432 enumeration data types, gettext translation, determining The
433 <application>Gimp</application>'s version number and capabilities,
434 handling data files and accessing the environment
435 </para>
436 <indexterm zone="gimp libgimpbase-3.0">
437 <primary sortas="c-libgimpbase-3.0">libgimpbase-3.0.so</primary>
438 </indexterm>
439 </listitem>
440 </varlistentry>
441
442 <varlistentry id="libgimpcolor-3.0">
443 <term><filename class="libraryfile">libgimpcolor-3.0.so</filename></term>
444 <listitem>
445 <para>
446 provides the C functions relating to RGB, HSV and CMYK colors as
447 well as converting colors between different color models and
448 performing adaptive supersampling on an area
449 </para>
450 <indexterm zone="gimp libgimpcolor-3.0">
451 <primary sortas="c-libgimpcolor-3.0">libgimpcolor-3.0.so</primary>
452 </indexterm>
453 </listitem>
454 </varlistentry>
455
456 <varlistentry id="libgimpconfig-3.0">
457 <term><filename class="libraryfile">libgimpconfig-3.0.so</filename></term>
458 <listitem>
459 <para>
460 contains C functions for reading and writing config information
461 </para>
462 <indexterm zone="gimp libgimpconfig-3.0">
463 <primary sortas="c-libgimpconfig-3.0">libgimpconfig-3.0.so</primary>
464 </indexterm>
465 </listitem>
466 </varlistentry>
467
468 <varlistentry id="libgimpmath-3.0">
469 <term><filename class="libraryfile">libgimpmath-3.0.so</filename></term>
470 <listitem>
471 <para>
472 contains C functions which provide mathematical definitions and
473 macros, manipulate 3x3 transformation matrices, set up and manipulate
474 vectors and the MD5 message-digest algorithm
475 </para>
476 <indexterm zone="gimp libgimpmath-3.0">
477 <primary sortas="c-libgimpmath-3.0">libgimpmath-3.0.so</primary>
478 </indexterm>
479 </listitem>
480 </varlistentry>
481
482 <varlistentry id="libgimpmodule-3.0">
483 <term><filename class="libraryfile">libgimpmodule-3.0.so</filename></term>
484 <listitem>
485 <para>
486 provides the C functions which implement module loading using
487 GModule and supports keeping a list of GimpModule's found in a given
488 searchpath
489 </para>
490 <indexterm zone="gimp libgimpmodule-3.0">
491 <primary sortas="c-libgimpmodule-3.0">libgimpmodule-2.0.so</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="libgimpthumb-3.0">
497 <term><filename class="libraryfile">libgimpthumb-3.0.so</filename></term>
498 <listitem>
499 <para>
500 provides the C functions for handling The
501 <application>Gimp</application>'s thumbnail objects
502 </para>
503 <indexterm zone="gimp libgimpthumb-3.0">
504 <primary sortas="c-libgimpthumb-3.0">libgimpthumb-3.0.so</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508
509 <varlistentry id="libgimpui-3.0">
510 <term><filename class="libraryfile">libgimpui-3.0.so</filename></term>
511 <listitem>
512 <para>
513 contains The <application>Gimp</application>'s common user
514 interface functions
515 </para>
516 <indexterm zone="gimp libgimpui-3.0">
517 <primary sortas="c-libgimpui-3.0">libgimpui-3.0.so</primary>
518 </indexterm>
519 </listitem>
520 </varlistentry>
521
522 <varlistentry id="libgimpwidgets-3.0">
523 <term><filename class="libraryfile">libgimpwidgets-3.0.so</filename></term>
524 <listitem>
525 <para>
526 contains The <application>Gimp</application>
527 and <application>GTK</application>'s widget creation and
528 manipulation functions
529 </para>
530 <indexterm zone="gimp libgimpwidgets-3.0">
531 <primary sortas="c-libgimpwidgets-3.0">libgimpwidgets-3.0.so</primary>
532 </indexterm>
533 </listitem>
534 </varlistentry>
535
536 </variablelist>
537
538 </sect2>
539
540</sect1>
Note: See TracBrowser for help on using the repository browser.