[gimp-help] Document pdf and ps import dialogs: closes #108
- From: Marco Ciampa <marcoc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help] Document pdf and ps import dialogs: closes #108
- Date: Sun, 31 May 2020 15:06:48 +0000 (UTC)
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">
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]