From cf056ad9ccf42b8c31e6c84ed0ee6d30e0fb7455 Mon Sep 17 00:00:00 2001 From: Michael Vrhel Date: Wed, 27 Jul 2011 22:12:41 -0700 Subject: Update of Use.htm to include new color control options. --- gs/doc/Use.htm | 146 +++++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 131 insertions(+), 15 deletions(-) diff --git a/gs/doc/Use.htm b/gs/doc/Use.htm index 59c040e23..b740550d5 100644 --- a/gs/doc/Use.htm +++ b/gs/doc/Use.htm @@ -2483,9 +2483,9 @@ proves its reliability. The value is platform dependent. It must end with a directory separator.

-A note for Windows users, Artifex recommends the use of the +A note for Windows users, Artifex recommends the use of the forward slash delimiter due to the special interpretation of \" by -the Microsoft C startup code. See +the Microsoft C startup code. See Parsing C Command-Line Arguments for more information. @@ -2729,14 +2729,130 @@ In this case, spot colors will pass through unprocessed assuming the device supports those colorants. +

+
-sRenderIntent=intent +
Set the rendering intent that should be used with the +profile specified above by -sOutputICCProfile. The +options for intent are per, col , sat, and abs, +which correspond to the ICC intents of Perceptual, Colorimetric, +Saturation, and Absolute Colorimetric. +Also see OverrideRI. +
+ +
+
-sGraphicICCProfile=filename +
Set the ICC profile that will be associated with +the output device for vector-based graphics (e.g. Fill, +Stroke operations). +Care should be taken to ensure that the +number of colorants associated with the device is the same +as the profile. This can be used to obtain more saturated +colors for graphics. +
+ +
+
-sGraphicIntent=intent +
Set the rendering intent that should be used with the +profile specified above by -sGraphicICCProfile. The +options are the same as specified for -sRenderIntent. +Also see OverrideRI. +
+ +
+
-sImageICCProfile=filename +
Set the ICC profile that will be associated with +the output device for images. +Care should be taken to ensure that the +number of colorants associated with the device is the same +as the profile. This can be used to obtain perceptually +pleasing images. +
+ +
+
-sImageIntent=intent +
Set the rendering intent that should be used with the +profile specified above by -sImageICCProfile. The +options are the same as specified for -sRenderIntent. +Also see OverrideRI. +
+ +
+
-sTextICCProfile=filename +
Set the ICC profile that will be associated with +the output device for text. +Care should be taken to ensure that the +number of colorants associated with the device is the same +as the profile. This can be used ensure K only text. +
+ +
+
-sTextIntent=intent +
Set the rendering intent that should be used with the +profile specified above by -sTextICCProfile. The +options are the same as specified for -sRenderIntent. +Also see OverrideRI. +
+ +
+
-dOverrideICC +
Override any ICC profiles contained in the source +document with the profiles specified by +sDefaultGrayProfile, sDefaultRGBProfile, sDefaultCMYKProfile. +Note that if no profiles are specified for the default +Device color spaces, then +the system default profiles will be used. For detailed override +control in the specification of source colors see +SourceObjectICC. +
+ +
+
-dOverrideRI +
Override the rendering intent contained in the source +document with the rendering intents specified by -sRenderIntent, +-sGraphicIntent, -sTextIntent, -sGraphicIntent. Note that +unless -dOverrideRI is specified, the above rendering intent +settings are essentially ignored. For detailed control over +rendering intent with specific object types, see +SourceObjectICC. +
+ +
+
-sSourceObjectICC=filename +
+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 +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 and a rendering intent +number (0 for perceptual, 1 for colorimetric, 2 for saturation, +3 for absolute colorimetric). An example file is given in +./gs/toolbin/color/src_color/objsrc_profiles_example.txt. +Profiles to demonstrate this method of specification are also +included in this folder. Note that if objects are colorimetrically +specified through this mechanism other operations like -sImageIntent, +-dOverrideICC, have no real affect. +
+ +
+
-dDeviceGrayToK=true/false +
+By default, Ghostscript will map DeviceGray color spaces to +pure K when the output device is CMYK based. This may not +always be desired. In particular, it may be desired to map +from the gray ICC profile specified by -sDefaultGrayProfile +to the output device profile. To achieve this, one should +specify -dDeviceGrayToK=false. +
+
-sICCProfilesDir=path -
Set a directory in which to search for the above profiles. -The directory path must end with a file system delimiter. +
Set a directory in which to search for the above profiles. +The directory path must end with a file system delimiter.

-If the user doesn't use the -sICCProfilesDir= command line option, -Ghostscript creates a default value for it by looking on the -directory paths explained in How +If the user doesn't use the -sICCProfilesDir= command line option, +Ghostscript creates a default value for it by looking on the +directory paths explained in How Ghostscript finds files. If the current directory is the first path a test is made for the iccprofiles directory. Next, the remaining paths with the string Resource in it are tested. The prefix up to @@ -2744,16 +2860,16 @@ the path separator character preceding the string Resource, concatenated with the string iccprofiles is used and if this exists, then this path will be used for ICCProfilesDir.

-Note that if the build is performed with COMPILE_INITS=1, -then the profiles contained in gs/iccprofiles will be placed in -the ROM file system. If a directory is specified on the command -line using -sICCProfilesDir=, that directory is searched before +Note that if the build is performed with COMPILE_INITS=1, +then the profiles contained in gs/iccprofiles will be placed in +the ROM file system. If a directory is specified on the command +line using -sICCProfilesDir=, that directory is searched before the iccprofiles/ directory of the ROM file system is searched.

-A note for Windows users, Artifex recommends the use of the +A note for Windows users, Artifex recommends the use of the forward slash delimiter due to the special interpretation of \" by -the Microsoft C startup code. See +the Microsoft C startup code. See Parsing C Command-Line Arguments for more information. @@ -2947,7 +3063,7 @@ be used to adjust this threshold, smaller to reduce memory requirements and larger to avoid performance impacts due to clist based pattern handling.

For example, -dMaxPatternBitmap=200000 will use clist based -patterns for pattern tiles larger than 200,000 bytes. +patterns for pattern tiles larger than 200,000 bytes.

Summary of environment variables

@@ -3039,7 +3155,7 @@ Normally, PDF interpreter tries to repair all problems in PDF files. -dPDFSTOPONERROR skips some of the stopped contexts. On error, instead of printing a warning and continue, PDF interpreter drops into a PostScript error handler that prints detailed information about the problem and -kills the job. +kills the job.

With switching to freetype 2 as the default font renderer in April 2010, we -- cgit v1.2.3