diff options
Diffstat (limited to 'doc/Use.htm')
| -rw-r--r-- | doc/Use.htm | 91 |
1 files changed, 58 insertions, 33 deletions
diff --git a/doc/Use.htm b/doc/Use.htm index 6a81c1f5..0d82ec49 100644 --- a/doc/Use.htm +++ b/doc/Use.htm @@ -271,11 +271,18 @@ On other systems the executable may have a different name:</p> <tr><td>VMS</td> <td><code>gs</code></td></tr> <tr><td>MS Windows 95 and later</td> - <td><code>gswin32c</code></td></tr> + <td><code>gswin32.exe</code></td> + <td><code>gswin32c.exe</code></td> + <td><code>gswin64.exe</code></td> + <td><code>gswin64c.exe</code></td> +</tr> <tr><td>OS/2</td> <td><code>gsos2</code></td></tr> </table></blockquote> - +<p>On Windows, the two digit number indicates the word length of the system for which the binary was built (so +<code>gswin32.exe</code> is for x86 Windows systems, whilst <code>gswin64.exe</code> is for x86_64 Windows +systems). And the <code>"c"</code> suffix indicates a Windows console based binary (note that the +<code>"display device"</code> window will still appear). <hr> <h2><a name="Output_device"></a>Selecting an output device</h2> @@ -700,18 +707,18 @@ This option is also set by the <code>-dFitPage</code> option.</p> <dl> <dt><code>-dShowAnnots=false</code></dt> <dd> - Don't enumerate anntoations associated with the page objects through - <code>Annots</code> attribute. Annotations are shown by default.</dd> + Don't enumerate annotations associated with the page + <code>Annots</code> key. Annotations are shown by default.</dd> <p> In addition, finer control is available by defining an array -<code>/ShowAnnotTypes</code>. Annoation types listed in this array will +<code>/ShowAnnotTypes</code>. Annotation types listed in this array will be drawn, whilst those not listed will not be drawn.</p> <p> To use this feature: -<code>-c "/ShowAnnotTypes [....]" -f <input file></code> +<code>-c "/ShowAnnotTypes [....] def" -f <input file></code> <br> Where the array can contain one or more of the following names: <code>/Stamp</code>, <code>/Squiggly</code>, <code>/Underline</code>, <code>/Link</code>, <code>/Text</code>, <code>/Highlight</code>, <code>/Ink</code>, <code>/FreeText</code>, <code>/StrikeOut</code> and <code>/stamp_dict</code>.</p> <p> For example, adding the follow to the command line: -<code>-c "/ShowAnnotTypes [/Text /UnderLine]" -f <input file></code> - <br> would draw only annoations with the subtypes "Text" and "UnderLine"</p> +<code>-c "/ShowAnnotTypes [/Text /UnderLine] def" -f <input file></code> + <br> would draw only annotations with the subtypes "Text" and "UnderLine"</p> </dl> <dl> @@ -1592,12 +1599,11 @@ possibly a specific one for each document.</p> <h3><a name="UnicodeTT"></a>Using Unicode True Type fonts</h3> -<p>Ghostscript can handle True Type fonts with the full Unicode character set. -For doing that, a third-party software should generate a Postscript -or PDF document with a text, which is encoded with the -UTF-16 encoding. Ghostscript may be used for converting -such Postscript documents to PDF and for -re-distilling such PDF documents to PDF subsets.</p> +<p>Ghostscript can make use of Truetype fonts with a Unicode character set. +To do so, you should generate a (<b>NOTE:</b> non-standard!) Postscript or PDF +job where the relevant text is encoded as UTF-16. Ghostscript may be used for +converting such jobs to other formats (Postscript, PDF, PXL etc). +The resulting output will be compliant with the spec (unlike the input).</p> <p> To render an UTF-16 encoded text, one must do the following :</p> @@ -1611,12 +1617,12 @@ It must have a <code>cmap</code> table with and <code>SpecificID</code> eqials to 1 (Unicode).</li> <li> -Describe the font in <code>lib/cidfmap</code> +Describe the font in <code>Resource/Init/cidfmap</code> with special values for the <code>CSI</code> key : <code>[(Artifex) (Unicode) 0]</code>.</li> <li> -In the PS or PDF document combine the font +In the PS or PDF job combine the font with one of CMap <code>Identity-UTF16-H</code> (for the horizontal writing mode) or <code>Identity-UTF16-V</code> @@ -1836,7 +1842,6 @@ RECORD </pre></blockquote> <li>If the FTP transfer was in binary mode:</li> -<li>If the FTP transfer was in binary mode:</li> <blockquote><code> $ set file/attribute=(rfm:stmlf) @@ -1861,8 +1866,8 @@ and then run Ghostscript by typing <code>gs</code> at the command line.</p> <p> The name of the Ghostscript command line executable on MS Windows is -<code>gswin32c</code> so use this instead of the plain '<code>gs</code>' in -the quickstart examples.</p> +<code>gswin32c</code>/<code>gswin64c</code> so use this instead of the +plain '<code>gs</code>' in the quickstart examples.</p> <p> To run the batch files in the ghostscript <code>lib</code> directory, @@ -1884,8 +1889,8 @@ the command shell.</p> <p> There is also an older version for MS Windows called just <code>gswin32</code> that provides its own window for the interactive postscript prompt. -The executable <code>gswin32c</code> is usually the better option since -it uses the native command prompt window.</p> +The executable <code>gswin32c</code>/<code>gswin64c</code> is usually the better +option since it uses the native command prompt window.</p> <p> For printer devices, the default output is the default printer. @@ -2549,6 +2554,20 @@ incorrect) rendering of pages containing PDF 1.4 transparency and blending.</dd> </dl> +<a name="ALLOWPSTRANSPARENCY"></a> +<dl> + <dt><code>-dALLOWPSTRANSPARENCY</code></dt> +<dd> +Enables the use of the Ghostscript custom transparency operators +(<a href="Language.htm#Transparency">Transparency</a>) from +Postscript input. Normally, these operators are not accessible from Postscript +jobs, being primarily intended to be called by the PDF interpreter. Using +<code>-dALLOWPSTRANSPARENCY</code> leaves them available. It is important that +these operators are used correctly, especially the order in which they are called, +otherwise unintended, even undefined behavior may result. +</dd> +</dl> + <dl> <dt><code>-dNO_TN5044</code></dt> <dd>Turns off the TN 5044 psuedo operators. These psuedo operators are not a part @@ -2561,8 +2580,10 @@ files from Corel 9 and Illustrator 88 do not operate properly if these operators <dl> <dt><code>-dDOPS</code></dt> -<dd>Enables processing of DoPS directives in PDF files. DoPS has in -fact been deprecated for some time. Use of this option is not +<dd>Enables processing of Subtype /PS streams in PDF files and the DoPS operator. +DoPS has in fact been deprecated for some time. Also the "PS" operator that was +removed from the 1.3 2nd edition specification is also disabled by default, and +enabled by <code>-dDOPS</code>. Use of this option is <b>NOT</b> recommended in security-conscious applications, as it increases the scope for malicious code. <code>-dDOPS</code> has no effect on processing of PostScript source files. Note: in releases 7.30 and @@ -2746,7 +2767,10 @@ names are separated by "<code>:</code>" on Unix systems, by <dt><code>-sFONTPATH=</code><em>dir1</em><code>;</code><em>dir2</em><code>;</code><em>...</em></dt> <dd>Specifies a list of directories that will be scanned when looking for fonts not found on the search path, overriding the environment variable - <code>GS_FONTPATH</code>.</dd> + <code>GS_FONTPATH</code>. +<p>By implication, any paths specified by <code>FONTPATH</code> or <code>GS_FONTPATH</code> are automatically +added to the <code>permit file read</code> list (see "<a href="#Safer">-dSAFER</a>"). +</dd> </dl> <dl> @@ -3246,8 +3270,9 @@ to the output device profile. To achieve this, one should <dl> <dt><code>-dUseFastColor=</code><em>true/false</em></dt> <dd> -This is used to avoid the use of ICC profiles for source colors that -are defined by DeviceGray, DeviceRGB and DeviceCMYK definitions. With +This is used to avoid the use of ICC profiles for source colors. This +includes those that are defined by DeviceGray, DeviceRGB and DeviceCMYK definitions +as well as ICC-based color spaces in the source document. With UseFastColor set to true, the traditional Postscript 255 minus operations are used to convert between RGB and CMYK with black generation and undercolor removal mappings.</dd> @@ -3462,7 +3487,7 @@ Ghostscript development team) uses this interface, we have no control over third code. <p> This is an entirely new implementation of <code>SAFER</code> for Ghostscript versions -9.28 and later. Earlier versions (see "<a href="#OldSafer">-dOLDSAFER</a>") relied on +9.50 and later. Earlier versions (see "<a href="#OldSafer">-dOLDSAFER</a>") relied on storing the file permission lists in Postscript VM (Virtual Memory), and only applied file access permissions to the Postscript file related operators. It relied on restricting the function of <code>setpagedevice</code> to avoid the device code from being manipulated @@ -3479,7 +3504,7 @@ access controls are enabled (see <a href="Language.htm#.activatepathcontrol">.ac any call to <code>.addcontrolpath</code> after <code>.activatepathcontrol</code> will result in a <code>Fatal</code> error causing the interpreter to immediately exit. <p> -An incompatibility exists between the pre-9.28 and 9.28 and later <code>SAFER</code>. +An incompatibility exists between the pre-9.50 and 9.50 and later <code>SAFER</code>. By removing storage and application entirely from the Postscript language environment and internal context, SAFER is no longer affected by Postscript <code>save</code>/<code>restore</code> operations. Previously, it was possible @@ -3494,7 +3519,7 @@ to do the equivalent of: In that sequence, the <code>Postscript ops</code> would run with <code>SAFER</code> protection but after the restore, <code>SAFER</code> would no longer be in force. This is no longer the case. After the call to <code>.setsafe</code> the file controls are in force until the -interpreter exits. As the 9.28 and later implementation no longer restricts the +interpreter exits. As the 9.50 and later implementation no longer restricts the operation of <code>setpagedevice</code>, and because this capability is <i>extremely</i> rarely used, we feel the improvement in security warrants the small reduction in flexibility. @@ -3571,8 +3596,8 @@ are automatically added to the permit read lists. <dd> <strong>NOTE: This enables deprecated code which will shortly be removed</strong> <p>Used in combination with <code>-dSAFER</code> (or <code>.setsafe</code>) enables -the pre-9.28 SAFER implementation. It is included (for now) in case any users find -a case where the 9.28 and later <code>SAFER</code> does not work for them. It means +the pre-9.50 SAFER implementation. It is included (for now) in case any users find +a case where the 9.50 and later <code>SAFER</code> does not work for them. It means such users can keep working until we have assessed the issue, and distributed a solution. <p> Disables the <code>deletefile</code> and <code>renamefile</code> @@ -5242,12 +5267,12 @@ implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that -license. Refer to licensing information at http://www.artifex.com/ +license. Refer to licensing information at <a href="https://www.artifex.com">https://www.artifex.com</a> 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.50, 15 October 2019 +<small>Ghostscript version 9.52, 19 March 2020 <!-- [3.0 end visible trailer] ============================================= --> |