source: xsoft/other/gimp.xml@ 9063b654

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

Update gimp3-pre page.

Added instructions foro gimp-help.
Many editorial changes.

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