[gimp-help] Document pdf and ps import dialogs: closes #108

[Marco Ciampa <marcoc src gnome org>]

commit 6df1284b4b577ab5284bb2635d185efcea3fb2e2
Author: Richard Poole <rp guests deus net>
Date:   Mon May 25 21:38:09 2020 +0100

    Document pdf and ps import dialogs: closes #108
    
    Add subsections to chapter 5, section 3, describing the meaning of
    the options in the PDF and PostScript import dialogs.

 src/concepts/images-loading.xml | 143 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 143 insertions(+)
---
diff --git a/src/concepts/images-loading.xml b/src/concepts/images-loading.xml
index 028853366..7dd3a59b4 100644
--- a/src/concepts/images-loading.xml
+++ b/src/concepts/images-loading.xml
@@ -112,6 +112,149 @@
         image file, it is either corrupt or not a supported format.
       </para>
     </note>
+    <sect3 id="file-pdf-load">
+    <title>Import from PDF</title>
+    <para>
+      If you select a PDF file to open, GIMP will show an extra dialog with
+      options specific to this file type.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term>Page selection</term>
+        <listitem>
+          <para>
+            You can select pages by typing one or more page numbers or
+            ranges, separated by commas. For example, <userinput>4-7,9</userinput>
+            selects pages 4, 5, 6, 7, and 9 of the document. The default is to
+            select all of the pages in the document.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Open pages as</term>
+        <listitem>
+          <para>
+            If this is set to <guilabel>Images</guilabel>, then GIMP will open
+            each of the selected pages as a separate image. If it is set to
+            <guilabel>Layers</guilabel>, then GIMP will create one image with
+            each of the selected pages in its own layer.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Image size</term>
+        <listitem>
+          <para>
+            The size of the image created is controlled by the
+            <guilabel>Width</guilabel>, <guilabel>Height</guilabel>,
+            and <guilabel>Resolution</guilabel> settings. A PDF document
+            contains information about its width and height in units
+            of physical length so it is meaningful to set the width or
+            height of the image in pixels or its resolution in pixels
+            per physical unit of length: as you set any of these three
+            parameters, the other two will automatically adjust to match.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use Anti-Aliasing</term>
+        <listitem>
+          <para>
+            Check this box to apply
+            <link linkend="glossary-antialiasing">antialiasing</link>
+            to text in the image.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </sect3>
+    <sect3 id="file-ps-load">
+    <title>Import from PostScript</title>
+    <para>
+      If you select a PostScript file to open, GIMP will show an extra dialog with
+      options specific to this file type.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term>Page selection</term>
+        <listitem>
+          <para>
+            You can select pages by typing one or more page numbers or
+            ranges, separated by commas. For example, <userinput>4-7,9</userinput>
+            selects pages 4, 5, 6, 7, and 9 of the document. The default is to
+            select all of the pages in the document.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Open pages as</term>
+        <listitem>
+          <para>
+            If this is set to <guilabel>Images</guilabel>, then GIMP will open
+            each of the selected pages as a separate image. If it is set to
+            <guilabel>Layers</guilabel>, then GIMP will create one image with
+            each of the selected pages in its own layer.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Rendering</term>
+        <listitem>
+          <para>
+            The size of the image created is controlled by the
+            <guilabel>Width</guilabel>, <guilabel>Height</guilabel>,
+            and <guilabel>Resolution</guilabel> settings. A PostScript
+            document contains information about its width and height in
+            units of physical length so it is meaningful to set the width
+            or height of the image in pixels or its resolution in pixels
+            per physical unit of length: as you set any of these three
+            parameters, the other two will automatically adjust to match.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Colouring</term>
+        <listitem>
+          <para>
+            Select <guilabel>B/W</guilabel> to have GIMP create the image
+            as a 2-color indexed image, <guilabel>Gray</guilabel> for a
+            grayscale image, or <guilabel>Color</guilabel> for an RGB image.
+            (See <link linkend="gimp-concept-image-types">Image Types</link>
+            for a full explanation of these different image modes.)
+            If you select <guilabel>Automatic</guilabel> then GIMP will try
+            to determine the most suitable mode from the contents of the
+            file.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Try Bounding Box</term>
+        <listitem>
+          <para>
+            If this is checked, GIMP will use the bounding box information
+            in the PostScript file to determine how much of the page to use:
+            effectively, this is equivalent to cropping whitespace from the
+            edges of the image. It is possible for a PostScript file to contain
+            no bounding box information, in which case this option will be
+            ignored.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Antialiasing</term>
+        <listitem>
+          <para>
+            You can choose to have GIMP apply
+            <link linkend="glossary-antialiasing">antialiasing</link>
+            separately for text and for graphics in the imported image. Either
+            <guilabel>Weak</guilabel> or <guilabel>Strong</guilabel>
+            antialiasing may be applied: usually you should select <guilabel>
+            Strong</guilabel>.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </sect3>
   </sect2>
 
   <sect2 id="gimp-using-open-location">