source: xsoft/other/gimp.xml@ 572f2ee

12.2 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since 572f2ee was 572f2ee, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Restore gim3 instructions.

  • Property mode set to 100644
File size: 18.0 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;/BLFS/gimp/gimp-&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;/BLFS/gimp/gimp-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 &lfs121_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 help files English version 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="harfbuzz"/>.
151 <xref linkend="libjpeg"/>,
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"/>,
159 <xref linkend="poppler"/> (including poppler-data) and
160 <!-- some parts of Xorg appear to be required, as are deps it pulls in -->
161 <xref linkend="x-window-system"/>
162 </para>
163
164 <bridgehead renderas="sect4">Recommended</bridgehead>
165 <para role="recommended">
166 <xref linkend="dbus-glib"/>,
167 <xref linkend="graphviz"/>,
168 <xref linkend="gs"/> (with libgs installed),
169 <xref linkend="iso-codes"/>,
170 <xref linkend="libgudev"/>, and
171 <xref linkend="xdg-utils"/>
172 </para>
173
174 <bridgehead renderas="sect4">Optional</bridgehead>
175 <para role="optional">
176 <xref linkend="aalib"/>,
177 <xref linkend="alsa-lib"/>,
178 <xref linkend="gvfs"/> (to access the online help),
179 <xref linkend="libmng"/>,
180 <xref linkend="libunwind"/>,
181 <xref linkend="libwebp"/>,
182 <xref linkend="openjpeg2"/>,
183 <xref linkend="gtk-doc"/>,
184 <ulink url="https://people.freedesktop.org/~hughsient/appstream-glib">appstream-glib</ulink>,
185 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
186 <ulink url="https://github.com/strukturag/libheif/">libheif</ulink> with
187 <ulink url="https://github.com/strukturag/libde265/">libde265</ulink>
188 (both needed to read macOS heic images),
189 <ulink url="https://wvware.sourceforge.net/libwmf.html">libwmf</ulink>, and
190 <ulink url="https://www.openexr.com/">OpenEXR</ulink>
191 </para>
192
193 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
194 <para role="optional">
195 <ulink url="https://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
196 <ulink url="https://pngnq.sourceforge.net/">pngnq</ulink> and
197 <ulink url="https://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
198 to optimize the png files, but see the note on the help download above
199 </para>
200
201 <para condition="html" role="usernotes">Editor Notes:
202 <ulink url="&blfs-wiki;/gimp"/>
203 </para>
204 </sect2>
205
206 <sect2 role="installation">
207 <title>Installation of Gimp</title>
208
209 <para>
210 Install <application>Gimp</application> by running
211 the following commands:
212 </para>
213
214<screen><userinput>mkdir gimp-build &amp;&amp;
215cd gimp-build &amp;&amp;
216
217meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
218ninja</userinput></screen>
219
220 <para>
221 To test the results (requires an X-Windowed terminal) issue:
222 <command>ninja test</command>.
223 <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
224
225 </para>
226
227 <para>
228 Now, as the &root; user:
229 </para>
230
231<screen role="root"><userinput>ninja test</userinput></screen>
232
233 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
234 href="../../xincludes/update-icons-and-desktop.xml"/>
235
236 </sect2>
237
238 <sect2 role="installation">
239 <title>Installation of Gimp-Help</title>
240
241 <para>
242 The <filename>gimp-help</filename> tarball contains images and English
243 text help for help files, together with translations.
244 If you wish to install local copies of the help files to read offline,
245 unpack the gimp-help tarball and change into the root of the newly
246 created source tree.
247
248 <!--
249 The documentation generated by gimp-help-2.10.34 and online help have
250 the same contents, so I comment this out. [pierre Nov. 2023]
251 Because of the
252 issues mentioned in the note above, you are recommended to use the online
253 help, either by building against <xref linkend="gvfs"/> so that 'help'
254 can open the latest XML files in your browser, or else you can manually
255 open the html in your browser by going to <ulink
256 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
257 (change the language code if desired).-->
258 </para>
259
260<screen><userinput>tar -xf ../../gimp3-help-&gimp-version;.tar.xz &amp;&amp;
261cd gimp3-help-&gimp-version;
262
263ALL_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; \
264./configure --prefix=/usr</userinput></screen>
265
266 <para>
267 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
268 you do not wish to install. Alternatively, remove the line starting with
269 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
270 </para>
271
272 <para>
273 Now build the help files:
274 </para>
275
276<screen><userinput>make</userinput></screen>
277
278 <para>
279 Issue the following commands as the &root; user to install the help files:
280 </para>
281
282<screen role="root"><userinput>make install &amp;&amp;
283chown -R root:root /usr/share/gimp/3.0/help</userinput></screen>
284
285 </sect2>
286
287 <sect2 role="commands" id="gimp-cmd-explanations">
288 <title>Command Explanations</title>
289
290 <para>
291 <envar>ALL_LINGUAS=&quot;ca cs da de en en_GB es fa...&quot;</envar>: by
292 default, the help files will be rendered in all the available languages.
293 Remove the codes of any languages you do not wish to build.
294 </para>
295
296 <para>
297 <parameter>--disable-python</parameter>: This option is necessary if
298 you have not installed <application>PyGTK</application>.
299 </para>
300
301 </sect2>
302
303 <sect2 role="configuration">
304 <title>Configuring The Gimp</title>
305
306 <sect3 id="gimp-config">
307 <title>Config Files</title>
308
309 <para>
310 <filename>/etc/gimp/3.0/*</filename>
311 </para>
312
313 <indexterm zone="gimp gimp-config">
314 <primary sortas="e-etc-gimp-3.0-star">/etc/gimp/3.0/*</primary>
315 </indexterm>
316
317 </sect3>
318
319 </sect2>
320
321 <sect2 role="content">
322 <title>Contents</title>
323
324 <segmentedlist>
325 <segtitle>Installed Programs</segtitle>
326 <segtitle>Installed Libraries</segtitle>
327 <segtitle>Installed Directories</segtitle>
328
329 <seglistitem>
330 <seg>
331 gimp-2.99,
332 gimp-console-2.99,
333 gimptool-2.99,
334 gimp-test-clipboard-2.99, and
335 gimp-script-fu-interpreter-3.0
336 </seg>
337 <seg>
338 libgimp-3.0.so,
339 libgimp-scriptfu-3.0,
340 libgimpbase-3.0.so,
341 libgimpcolor-3.0.so,
342 libgimpconfig-3.0.so,
343 libgimpmath-3.0.so,
344 libgimpmodule-3.0.so,
345 libgimpui-3.0.so, and
346 libgimpwidgets-3.0.so
347 </seg>
348 <seg>
349 /etc/gimp,
350 /usr/include/gimp-3.0,
351 /usr/lib/gimp-3.0,
352 /usr/lib/gimp/3.0,
353 /usr/share/gimp/3.0, and
354 /usr/share/doc/gimp-2.99
355 </seg>
356 </seglistitem>
357 </segmentedlist>
358
359 <variablelist>
360 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
361 <?dbfo list-presentation="list"?>
362 <?dbhtml list-presentation="table"?>
363
364 <varlistentry id="gimp-2.99">
365 <term><command>gimp-2.99</command></term>
366 <listitem>
367 <para>
368 is the Gnu Image Manipulation Program. It works with a variety
369 of image formats and provides a large selection of tools
370 </para>
371 <indexterm zone="gimp gimp-2.99">
372 <primary sortas="b-gimp-2.99">gimp-2.99</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 <varlistentry id="gimp-console-2.99">
378 <term><command>gimp-console-2.99</command></term>
379 <listitem>
380 <para>
381 is a console program that behaves as if The
382 <application>Gimp</application> was called with the
383 <option>--no-interface</option> command-line option
384 </para>
385 <indexterm zone="gimp gimp-console-2.99">
386 <primary sortas="b-gimp-console-2.99">gimp-console-2.99</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="gimptool-2.99">
392 <term><command>gimptool-2.99</command></term>
393 <listitem>
394 <para>
395 is a tool that can build plug-ins or scripts and install them
396 if they are distributed in one source file.
397 <command>gimptool-2.0</command> can also be used by programs that
398 need to know what libraries and include-paths The
399 <application>Gimp</application> was compiled with
400 </para>
401 <indexterm zone="gimp gimptool-2.99">
402 <primary sortas="b-gimptool-2.99">gimptool-2.99</primary>
403 </indexterm>
404 </listitem>
405 </varlistentry>
406
407 <varlistentry id="libgimp-3.0">
408 <term><filename class="libraryfile">libgimp-3.0.so</filename></term>
409 <listitem>
410 <para>
411 provides C bindings for The <application>Gimp</application>'s
412 Procedural Database (PDB) which offers an interface to core functions
413 and to functionality provided by plug-ins
414 </para>
415 <indexterm zone="gimp libgimp-3.0">
416 <primary sortas="c-libgimp-3.0">libgimp-3.0.so</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="libgimpbase-3.0">
422 <term><filename class="libraryfile">libgimpbase-3.0.so</filename></term>
423 <listitem>
424 <para>
425 provides the C functions for basic
426 <application>Gimp</application> functionality such as determining
427 enumeration data types, gettext translation, determining The
428 <application>Gimp</application>'s version number and capabilities,
429 handling data files and accessing the environment
430 </para>
431 <indexterm zone="gimp libgimpbase-3.0">
432 <primary sortas="c-libgimpbase-3.0">libgimpbase-3.0.so</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 <varlistentry id="libgimpcolor-3.0">
438 <term><filename class="libraryfile">libgimpcolor-3.0.so</filename></term>
439 <listitem>
440 <para>
441 provides the C functions relating to RGB, HSV and CMYK colors as
442 well as converting colors between different color models and
443 performing adaptive supersampling on an area
444 </para>
445 <indexterm zone="gimp libgimpcolor-3.0">
446 <primary sortas="c-libgimpcolor-3.0">libgimpcolor-3.0.so</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="libgimpconfig-3.0">
452 <term><filename class="libraryfile">libgimpconfig-3.0.so</filename></term>
453 <listitem>
454 <para>
455 contains C functions for reading and writing config information
456 </para>
457 <indexterm zone="gimp libgimpconfig-3.0">
458 <primary sortas="c-libgimpconfig-3.0">libgimpconfig-3.0.so</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 <varlistentry id="libgimpmath-3.0">
464 <term><filename class="libraryfile">libgimpmath-3.0.so</filename></term>
465 <listitem>
466 <para>
467 contains C functions which provide mathematical definitions and
468 macros, manipulate 3x3 transformation matrices, set up and manipulate
469 vectors and the MD5 message-digest algorithm
470 </para>
471 <indexterm zone="gimp libgimpmath-3.0">
472 <primary sortas="c-libgimpmath-3.0">libgimpmath-3.0.so</primary>
473 </indexterm>
474 </listitem>
475 </varlistentry>
476
477 <varlistentry id="libgimpmodule-3.0">
478 <term><filename class="libraryfile">libgimpmodule-3.0.so</filename></term>
479 <listitem>
480 <para>
481 provides the C functions which implement module loading using
482 GModule and supports keeping a list of GimpModule's found in a given
483 searchpath
484 </para>
485 <indexterm zone="gimp libgimpmodule-3.0">
486 <primary sortas="c-libgimpmodule-3.0">libgimpmodule-2.0.so</primary>
487 </indexterm>
488 </listitem>
489 </varlistentry>
490
491 <varlistentry id="libgimpthumb-3.0">
492 <term><filename class="libraryfile">libgimpthumb-3.0.so</filename></term>
493 <listitem>
494 <para>
495 provides the C functions for handling The
496 <application>Gimp</application>'s thumbnail objects
497 </para>
498 <indexterm zone="gimp libgimpthumb-3.0">
499 <primary sortas="c-libgimpthumb-3.0">libgimpthumb-3.0.so</primary>
500 </indexterm>
501 </listitem>
502 </varlistentry>
503
504 <varlistentry id="libgimpui-3.0">
505 <term><filename class="libraryfile">libgimpui-3.0.so</filename></term>
506 <listitem>
507 <para>
508 contains The <application>Gimp</application>'s common user
509 interface functions
510 </para>
511 <indexterm zone="gimp libgimpui-3.0">
512 <primary sortas="c-libgimpui-3.0">libgimpui-3.0.so</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517 <varlistentry id="libgimpwidgets-3.0">
518 <term><filename class="libraryfile">libgimpwidgets-3.0.so</filename></term>
519 <listitem>
520 <para>
521 contains The <application>Gimp</application>
522 and <application>GTK</application>'s widget creation and
523 manipulation functions
524 </para>
525 <indexterm zone="gimp libgimpwidgets-3.0">
526 <primary sortas="c-libgimpwidgets-3.0">libgimpwidgets-3.0.so</primary>
527 </indexterm>
528 </listitem>
529 </varlistentry>
530
531 </variablelist>
532
533 </sect2>
534
535</sect1>
Note: See TracBrowser for help on using the repository browser.