diff options
Diffstat (limited to 'doc/Use.htm')
| -rw-r--r-- | doc/Use.htm | 82 |
1 files changed, 62 insertions, 20 deletions
diff --git a/doc/Use.htm b/doc/Use.htm index 64339dfc..1fca0569 100644 --- a/doc/Use.htm +++ b/doc/Use.htm @@ -619,6 +619,20 @@ Ghostscript is normally built to interpret both PostScript and PDF files, examin <p>Here are some command line options specific to PDF</p> <dl> +<dt><code>-dNEWPDF</code></dt> +<dd>From release 9.55.0 Ghostscript incorporates two complete PDF interpreters; the original +long-standing interpreter is written in PostScript but there is now a new interpreter written +in C. +<p>At present the old PostScript-based interpreter remains the default, in future releases the +new C-based interpreter will become the default, though we would encourage people to experiment +with the new interpreter and send us feedback. While there are two interpreters the command-line +switch NEWPDF will allow selection of the existing interpreter when false and the new interpreter +when true.</p> + +</dd> +</dl> + + <dl> <dt><code>-dPDFFitPage</code></dt> <dd>Rather than selecting a PageSize given by the PDF MediaBox, BleedBox (see -dUseBleedBox), TrimBox (see -dUseTrimBox), ArtBox (see -dUseArtBox), or CropBox (see -dUseCropBox), @@ -2776,7 +2790,7 @@ The only option strings are as follows: to the leftmost place on the next row until the nest is complete. <p> A partially filled nest will be output when the <code>-sNupControl=</code> string is changed, - or when Ghostscript exits. + when Ghostscript exits, or when the page size changes. <p> Pages are scaled to fit the requested number horizontally and vertically, maintaining the aspect ratio. If the scaling selected for fitting the nested pages leaves space horizontally @@ -2790,6 +2804,14 @@ The only option strings are as follows: the partially filled master page will be output. </li> </ul> +<p>Printer devices typically reallocate their memory whenever the transparency use +of a page changes (from one page having transparency, to the next page not having +transparency, or vice versa). This would cause problems with Nup, possibly leading +to lost or corrupt pages in the output. To avoid this, the Nup device changes +the parameters of the page to always set the PageUsesTransparency flag. While this +should be entirely transparent for the user and not cause extra transparency blending +operations during the standard rendering processes for most devices, it may cause +devices to use the clist rather than PageMode. </dd> </dl> @@ -3116,18 +3138,38 @@ device supports those colorants. It is also possible for these devices to <dt><code>-sICCOutputColors=</code><em>"Cyan, Magenta, Yellow, Black, Orange, Violet"</em></dt> <dd>For the psdcmyk and tiffsep separation devices, the device ICC profile can be an NCLR profile, which means something that includes non-traditional inks -like Orange, Violet, etc. In this case, the list of the colorant names in the +like Orange, Violet, etc. In this case, the list of the color names in the order that they exist in the profile must be provided with this command line -option. Note that if a colorant name that is specified for the profile occurs also within -the document (e.g. "Orange" above), then these colorants will be associated with -the same separation. It is possible through a compile time option LIMIT_TO_ICC -defined in gdevdevn.h to restrict the output colorants of the psdcmyk and tiffsep -device to the colorants of the ICC profile or to allow additional spot colorants -in the document to be created as different separations. If restricted, the other -spot colorants will go through the alternate tint transform and then be mapped to -the color space defined by the NCLR profile. If an NCLR ICC profile is specified +option. Note that if a color name that is specified for the profile occurs also within +the document (e.g. "Orange" above), then these color names will be associated with +the same separation. Additional names beyond those of the ICC profile component count +can be included. In this case, those components will be installed into the tiffsep +or psdcmyk device list of colors, following the ICC profile colors. +The number of spot colors (those that go beyond the standard CMYK colors) +allowed by tiffsep or psdcmyk can be set using -dMaxSpots=#. The default +value for this is currently set to 10 (GS_SOFT_MAX_SPOTS). +As an example consider the case where we wish to use a 6CLR ICC profile that +includes Orange and Violet, but +need the device to include a specialty color component such as +Varnish, which does not appear in the document and is not handled by the 6CLR ICC +profile. In addition, we desire +to allow one more spot color of the document to come through to our device. For +this case using + <code>-sICCOutputColors=</code><em>"Cyan, Magenta, Yellow, Black, Orange, Violet, Varnish"</em> + <code>-dMaxSpots=</code><em>4</em> + <code>-sOutputICCProfile=</code><em>My_6CLR_Profile.icc</em> +would provide the desired outcome. Note that it is up to the device or +through the use of -sNamedProfile (see below) to involve the setting +of any values in the Varnish channel. However, if an All color value is encountered +in the document, the Varnish component will have its value +set as will the Orange and Violet values (Likewise if a spot color named Varnish is +encountered in the document the Varnish component will be used for the values). +The All value is typically used +for placing registration targets on separations. +Finally, note that if an NCLR ICC profile is specified and ICCOutputColors is not used, then a set of default names will be used for - the extra colorants (non-CMYK) in the profile.</dd> +the extra colorants (non-CMYK) in the profile. These names are given as ICC_COLOR_N for +the Nth non-CMYK channel.</dd> </dl> <dl> @@ -3213,7 +3255,7 @@ PRESERVE_K_PLANE approach. This is only valid when using littleCMS for </dl> <dl> - <dt><code>-sGraphicICCProfile=</code><em>filename</em></dt> + <dt><code>-sVectorICCProfile=</code><em>filename</em></dt> <dd>Set the ICC profile that will be associated with the output device for vector-based graphics (e.g. Fill, Stroke operations). @@ -3224,20 +3266,20 @@ as the profile. This can be used to obtain more saturated </dl> <dl> - <dt><code>-dGraphicIntent=</code><em>0/1/2/3</em></dt> -<dd>Set the rendering intent that should be used with graphic objects. The + <dt><code>-dVectorIntent=</code><em>0/1/2/3</em></dt> +<dd>Set the rendering intent that should be used with vector-based graphic objects. The options are the same as specified for -dRenderIntent.</dd> </dl> <dl> - <dt><code>-dGraphicBlackPt=</code><em>0/1</em></dt> - <dd>Specify if black point compensation should be used for graphic objects.</dd> + <dt><code>-dVectorBlackPt=</code><em>0/1</em></dt> + <dd>Specify if black point compensation should be used for vector-based graphic objects.</dd> </dl> <dl> - <dt><code>-dGraphicKPreserve=</code><em>0/1/2</em></dt> + <dt><code>-dVectorKPreserve=</code><em>0/1/2</em></dt> <dd>Specify if black preservation should be used when mapping -from CMYK to CMYK for graphic objects. The +from CMYK to CMYK for vector-based graphic objects. The options are the same as specified for -dKPreserve.</dd> </dl> @@ -3312,7 +3354,7 @@ control in the specification of source colors see <dd> This option provides an extreme level of override control to specify the source color spaces and rendering intents to use -with graphics, images and text for both RGB and CMYK source +with vector-based graphics, images and text for both RGB and CMYK source objects. The specification is made through a file that contains on a line a key name to specify the object type (e.g. Image_CMYK) followed by an ICC profile file name, a rendering intent @@ -5367,7 +5409,7 @@ or contact Artifex Software, Inc., 1305 Grant Avenue - Suite 200, Novato, CA 94945, U.S.A., +1(415)492-9861, for further information. <p> -<small>Ghostscript version 9.54.0, 30 March 2021 +<small>Ghostscript version 9.55.0, 27 September 2021 <!-- [3.0 end visible trailer] ============================================= --> |