source: xsoft/other/gimp.xml@ cef8a63

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

Typos and minor corrections.

  • Property mode set to 100644
File size: 17.8 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 "https://anduin.linuxfromscratch.org/BLFS/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 *** Review after gim3 stable is released.
32 -->
33
34 <!ENTITY gimp-help-version "&gimp-version;">
35 <!ENTITY gimp-help-download "https://anduin.linuxfromscratch.org/BLFS/gimp/gimp3-help-&gimp-help-version;.tar.xz">
36 <!ENTITY gimp-help-md5sum "162d57a67ff737ed221a8d7f274d119f">
37 <!ENTITY gimp-help-size "129 MB">
38 <!ENTITY gimp-help-buildsize "From 351 MB (74 MB installed) for en only to 722 MB (1.5 GB installed) for all 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 <note>
61 <para>
62 This package is a snapshot of the upcoming stable release of
63 gimp3. It avoids several deprecated dependencies, notably gtk2.
64 </para>
65 </note>
66
67 &lfs121_checked;
68
69 <bridgehead renderas="sect3">Package Information</bridgehead>
70 <itemizedlist spacing="compact">
71 <listitem>
72 <para>
73 Download (HTTP): <ulink url="&gimp-download-http;"/>
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Download (FTP): <ulink url="&gimp-download-ftp;"/>
79 </para>
80 </listitem>
81 <listitem>
82 <para>
83 Download MD5 sum: &gimp-md5sum;
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 Download size: &gimp-size;
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Estimated disk space required: &gimp-buildsize;
94 </para>
95 </listitem>
96 <listitem>
97 <para>
98 Estimated build time: &gimp-time;
99 </para>
100 </listitem>
101 </itemizedlist>
102
103 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
104
105 <note>
106 <para>
107 The help files English version is complete, but large
108 parts of the text for many other languages are not yet translated.
109 </para>
110 </note>
111
112 <itemizedlist spacing="compact">
113 <listitem>
114 <para>
115 Download (HTTP): <ulink url="&gimp-help-download;"/>
116 </para>
117 </listitem>
118 <listitem>
119 <para>
120 Download size: &gimp-help-size;
121 </para>
122 </listitem>
123 <listitem>
124 <para>
125 Download MD5 sum: &gimp-help-md5sum;
126 </para>
127 </listitem>
128 <listitem>
129 <para>
130 Estimated disk space required: &gimp-help-buildsize;
131 </para>
132 </listitem>
133 <listitem>
134 <para>
135 Estimated build time: &gimp-help-time;
136 </para>
137 </listitem>
138 </itemizedlist>
139
140 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
141
142 <bridgehead renderas="sect4">Required</bridgehead>
143 <para role="required">
144 <xref linkend="appstream-glib"/>,
145 <xref linkend="gegl"/>,
146 <xref linkend="gexiv2"/>,
147 <xref linkend="glib-networking"/>,
148 <xref linkend="gtk3"/>,
149 <xref linkend="harfbuzz"/>,
150 <xref linkend="libjpeg"/>,
151 <xref linkend="libmypaint"/>,
152 <xref linkend="librsvg"/>,
153 <xref linkend="libtiff"/>,
154 <xref linkend="lcms2"/>,
155 <xref linkend="mypaint-brushes"/>, and
156 <xref linkend="poppler"/> (including poppler-data)
157 </para>
158
159 <bridgehead renderas="sect4">Recommended</bridgehead>
160 <para role="recommended">
161 <xref linkend="graphviz"/>,
162 <xref linkend="gs"/> (with libgs installed),
163 <xref linkend="iso-codes"/>,
164 <xref linkend="libgudev"/>,
165 <xref linkend="pygobject3"/>, and
166 <xref linkend="xdg-utils"/>
167 </para>
168
169 <bridgehead renderas="sect4">Optional</bridgehead>
170 <para role="optional">
171 <xref linkend="aalib"/>,
172 <xref linkend="alsa-lib"/>,
173 <xref linkend="gjs"/>,
174 <xref linkend="gvfs"/> (to access the online help),
175 <xref linkend="libmng"/>,
176 <xref linkend="libunwind"/>,
177 <xref linkend="libjxl"/>,
178 <xref linkend="libwebp"/>,
179 <xref linkend="lua"/>,
180 <xref linkend="openjpeg2"/>,
181 <xref linkend="gtk-doc"/>,
182 <ulink url="https://github.com/HEASARC/cfitsio">cfitsio</ulink>,
183 <ulink url="https://github.com/phoboslab/qoi">goi</ulink>,
184 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
185 <ulink url="https://github.com/strukturag/libheif/">libheif</ulink> with
186 <ulink url="https://github.com/strukturag/libde265/">libde265</ulink>
187 (both needed to read macOS heic images),
188 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
189 <ulink url="https://github.com/svanderburg/libiff">libiff</ulink>,
190 <ulink url="https://github.com/svanderburg/libilbm">libilbm</ulink>, and
191 <ulink url="https://www.openexr.com/">OpenEXR</ulink>
192 </para>
193
194 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
195 <para role="optional">
196 <ulink url="https://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
197 <ulink url="https://pngnq.sourceforge.net/">pngnq</ulink> and
198 <ulink url="https://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
199 to optimize the png files, but see the note on the help download above
200 </para>
201 </sect2>
202
203 <sect2 role="installation">
204 <title>Installation of Gimp</title>
205
206 <para>
207 Install <application>Gimp</application> by running
208 the following commands:
209 </para>
210
211<screen><userinput>mkdir gimp-build &amp;&amp;
212cd gimp-build &amp;&amp;
213
214meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
215ninja</userinput></screen>
216
217
218 <para>
219 To test the results (requires an X-Windowed terminal) issue:
220 <command>ninja test</command>.
221 <!-- In 3.0-pre, 2 failures: gimp:app/save-and-export and gimp:app/ui; bdubbs -->
222 </para>
223
224 <para>
225 Now, as the &root; user:
226 </para>
227
228<screen role="root"><userinput>ninja install</userinput></screen>
229
230 </sect2>
231
232 <sect2 role="installation">
233 <title>Installation of Gimp-Help</title>
234
235 <para>
236 The <filename>gimp-help</filename> tarball contains images and English
237 text help for help files, together with translations.
238 If you wish to install local copies of the help files to read
239 offline, unpack the <filename>gimp-help</filename> tarball
240 and change into the root of the newly created source tree.
241 </para>
242
243<screen><userinput>tar -xf ../../gimp3-help-&gimp-help-version;.tar.xz &amp;&amp;
244cd gimp3-help-&gimp-help-version;
245
246ALL_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; \
247./configure --prefix=/usr</userinput></screen>
248
249 <para>
250 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
251 you do not wish to install. Alternatively, remove the line starting with
252 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
253 </para>
254
255 <para>
256 Now build the help files:
257 </para>
258
259<screen><userinput>make</userinput></screen>
260
261 <para>
262 Issue the following commands as the &root; user to install the help files:
263 </para>
264
265<screen role="root"><userinput>make install &amp;&amp;
266chown -R root:root /usr/share/gimp/3.0/help</userinput></screen>
267
268 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
269 href="../../xincludes/update-icons-and-desktop.xml"/>
270
271 </sect2>
272 <sect2 role="commands" id="gimp-cmd-explanations">
273 <title>Command Explanations</title>
274
275 <para>
276 <envar>ALL_LINGUAS=&quot;ca cs da de en en_GB es fa...&quot;</envar>: by
277 default, the help files will be rendered in all the available languages.
278 Remove the codes of any languages you do not wish to build.
279 </para>
280 </sect2>
281
282 <sect2 role="configuration">
283 <title>Configuring The Gimp</title>
284
285 <sect3 id="gimp-config">
286 <title>Config Files</title>
287
288 <para>
289 <filename>/etc/gimp/3.0/*</filename>
290 </para>
291
292 <indexterm zone="gimp gimp-config">
293 <primary sortas="e-etc-gimp-3.0-star">/etc/gimp/3.0/*</primary>
294 </indexterm>
295 </sect3>
296 </sect2>
297
298 <sect2 role="content">
299 <title>Contents</title>
300
301 <segmentedlist>
302 <segtitle>Installed Programs</segtitle>
303 <segtitle>Installed Libraries</segtitle>
304 <segtitle>Installed Directories</segtitle>
305
306 <seglistitem>
307 <seg>
308 gimp-2.99,
309 gimp-console-2.99,
310 gimptool-2.99,
311 gimp-test-clipboard-2.99, and
312 gimp-script-fu-interpreter-3.0
313 </seg>
314 <seg>
315 libgimp-3.0.so,
316 libgimp-scriptfu-3.0,
317 libgimpbase-3.0.so,
318 libgimpcolor-3.0.so,
319 libgimpconfig-3.0.so,
320 libgimpmath-3.0.so,
321 libgimpmodule-3.0.so,
322 libgimpui-3.0.so, and
323 libgimpwidgets-3.0.so
324 </seg>
325 <seg>
326 /etc/gimp,
327 /usr/include/gimp-3.0,
328 /usr/lib/gimp/3.0,
329 /usr/share/gimp/3.0, and
330 /usr/share/doc/gimp-2.99
331 </seg>
332 </seglistitem>
333 </segmentedlist>
334
335 <variablelist>
336 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
337 <?dbfo list-presentation="list"?>
338 <?dbhtml list-presentation="table"?>
339<!--
340 <varlistentry id="gimp-prog">
341 <term><command>gimp</command></term>
342 <listitem>
343 <para>
344 is a symbolic link to <command>gimp-2.10</command>
345 </para>
346 <indexterm zone="gimp gimp-prog">
347 <primary sortas="b-gimp">gimp</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351-->
352 <varlistentry id="gimp-2.99">
353 <term><command>gimp-2.99</command></term>
354 <listitem>
355 <para>
356 is the Gnu Image Manipulation Program. It works with a variety
357 of image formats and provides a large selection of tools
358 </para>
359 <indexterm zone="gimp gimp-2.99">
360 <primary sortas="b-gimp-2.99">gimp-2.99</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364<!--
365 <varlistentry id="gimp-console">
366 <term><command>gimp-console</command></term>
367 <listitem>
368 <para>
369 is a symbolic link to <command>gimp-console-2.10</command>
370 </para>
371 <indexterm zone="gimp gimp-console">
372 <primary sortas="b-gimp-console">gimp-console</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376-->
377 <varlistentry id="gimp-console-2.99">
378 <term><command>gimp-console-2.10</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.99</command> can also be used by programs that
398 need to know what libraries and include-paths used when
399 <application>gimp</application> was compiled
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-3.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</sect1>
Note: See TracBrowser for help on using the repository browser.