diff options
| author | Jamie Lemon <jamie.lemon@artifex.com> | 2021-11-11 14:42:52 +0000 |
|---|---|---|
| committer | Robin Watts <Robin.Watts@artifex.com> | 2021-11-15 16:22:57 +0000 |
| commit | 613275b352466d8b42c6fe6cb9a6d4f9fad9e6f3 (patch) | |
| tree | 1978ef5f06735dceeb74b8d489b694842e4fb075 /doc | |
| parent | e7b93ff9ede26bcbaf21259dfd191bd93b64ef0e (diff) | |
| download | ghostpdl-613275b352466d8b42c6fe6cb9a6d4f9fad9e6f3.tar.gz | |
Updates HTML tables and some typos in the documentation
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/DLL.htm | 50 | ||||
| -rw-r--r-- | doc/Deprecated.htm | 1063 | ||||
| -rw-r--r-- | doc/Drivers.htm | 137 | ||||
| -rw-r--r-- | doc/Fonts.htm | 28 | ||||
| -rw-r--r-- | doc/Install.htm | 12 | ||||
| -rw-r--r-- | doc/Language.htm | 220 | ||||
| -rw-r--r-- | doc/Lib.htm | 319 | ||||
| -rw-r--r-- | doc/Make.htm | 69 | ||||
| -rw-r--r-- | doc/Ps2epsi.htm | 12 | ||||
| -rw-r--r-- | doc/Source.htm | 56 | ||||
| -rw-r--r-- | doc/Use.htm | 269 |
11 files changed, 1098 insertions, 1137 deletions
diff --git a/doc/DLL.htm b/doc/DLL.htm index 0864b4911..d9c34d369 100644 --- a/doc/DLL.htm +++ b/doc/DLL.htm @@ -236,26 +236,26 @@ code = gsdll_execute_cont(command, strlen(command)); <a name="cont_returns"></a> <table> <tr> - <th colspan="3">Return codes from gsdll_execute_cont()</th> + <th colspan="2">Return codes from gsdll_execute_cont()</th> </tr> <tr> <th align="left">Code</th> - <th> </th> + <th align="left">Status</th> </tr> <tr> <td align="left">0</td> - <td> </td> + <td>No errors</td> </tr> <tr> <td align="left">< 0</td> - <td> </td> + <td>Error</td> </tr> <tr> <td align="left"><= -100</td> - <td> </td> + <td>"<code>quit</code>" has been executed, or fatal error. <code>gsdll_exit()</code> must then be called: do not call <code>gsdll_execute_end()</code>.</td> @@ -324,16 +324,16 @@ locking. <table> <tr> - <th colspan="3">Locking and unlocking devices</th> + <th colspan="2">Locking and unlocking devices</th> </tr> <tr> <td>To lock a device</td> - <td> </td> + <td><code>gsdll_lock_device(device, 1)</code>;</td> </tr> <tr> <td>To unlock a device</td> - <td> </td> + <td><code>gsdll_lock_device(device, 0)</code>;</td> </tr> </table> @@ -420,67 +420,67 @@ char *p; <table> <tr> - <th colspan="5">Messages used by callback</th> + <th colspan="3">Messages used by callback</th> </tr> <tr> <th align="left">Symbol</th> - <th> </th> + <th align="left"></th> - <th> </th> + <th align="left">Use</th> </tr> <tr> <td><code>GSDLL_STDIN</code></td> - <td> </td> + <td>1</td> - <td> </td> + <td>get <code>count</code> characters to <code>str</code> from stdin, return number of characters read</td> </tr> <tr> <td><code>GSDLL_STDOUT</code></td> - <td> </td> + <td>2</td> - <td> </td> + <td>put <code>count</code> characters from <code>str</code> to stdout, return number of characters written</td> </tr> <tr> <td><code>GSDLL_DEVICE</code></td> - <td> </td> + <td>3</td> - <td> </td> + <td>device <code>str</code> has been opened if <code>count</code> = 1, closed if <code>count</code> = 0</td> </tr> <tr> <td><code>GSDLL_SYNC</code></td> - <td> </td> + <td>4</td> - <td> </td> + <td>sync_output for device <code>str</code></td> </tr> <tr> <td><code>GSDLL_PAGE</code></td> - <td> </td> + <td>5</td> - <td> </td> + <td>output_page for device <code>str</code></td> </tr> <tr> <td><code>GSDLL_SIZE</code></td> - <td> </td> + <td>6</td> - <td> </td> + <td>resize for device <code>str</code>: LOWORD(<code>count</code>) is new <code>xsize</code>, HIWORD(<code>count</code>) is new <code>ysize</code></td> </tr> <tr> <td><code>GSDLL_POLL</code></td> - <td> </td> + <td>7</td> - <td> </td> + <td>Called from <code>gp_check_interrupt()</code><br> Can be used by the caller to poll the message queue. Normally returns 0. To abort diff --git a/doc/Deprecated.htm b/doc/Deprecated.htm index 0473aa27c..de60944a1 100644 --- a/doc/Deprecated.htm +++ b/doc/Deprecated.htm @@ -217,22 +217,26 @@ The source module <code>gdevcd8.c</code> contains four generic drivers:</p> and hp1600 was added by Martin Gerbershagen.</p> <blockquote> <table> + <tr> + <th width="20%">Date</th> + <th width="20%">Version</th> + <th width="60%">Comments</th> +</tr> + <tr> <td>11.11.96</td> - <td> </td> - <td colspan="1">Version 1.0</td> + <td>Version 1.0</td> + <td></td> </tr> <tr> <td>25.08.97</td> - <td> </td> - <td colspan="1">Version 1.2</td> - <td colspan="2">Resolved all but one of the known bugs, introduced a couple of perfomance improvements. Complete new color-transfer-function handling (see gamma).</td> + <td>Version 1.2</td> + <td>Resolved all but one of the known bugs, introduced a couple of perfomance improvements. Complete new color-transfer-function handling (see gamma).</td> </tr> <tr> <td>01.06.98</td> - <td> </td> - <td colspan="1">Version 1.3</td> - <td colspan="2">Due to the most welcome contribution of Martin Gerbershagen + <td>Version 1.3</td> + <td>Due to the most welcome contribution of Martin Gerbershagen (ger@ulm.temic.de), support for the hp670, hp690 and hp890 and hp1600 has been added. Martin has also resolved all known bugs.<br> Problems:Dark colors are still pale.</td> @@ -251,88 +255,84 @@ switches to be invoked except <code>-sDEVICE=cdj850</code>, <table> <tr> <td><code>-dPapertype=</code></td> - <td> </td> + <td>0</td> - <td> </td> + <td>plain paper [default]</td> </tr> <tr> <td></td> - <td> </td> + <td>1</td> - <td> </td> + <td>bond paper</td> </tr> <tr> <td></td> - <td> </td> + <td>2</td> - <td> </td> + <td>special paper</td> </tr> <tr> <td></td> - <td> </td> + <td>3</td> - <td> </td> + <td>glossy film</td> </tr> <tr> <td></td> - <td> </td> + <td>4</td> - <td> </td> + <td>transparency film</td> </tr> <tr> <td></td> <td> </td> - <td> </td> - <td> </td> <td>Currently the lookup tables are unsuited for printing on special paper or transparencies. For these please revert to the gamma functions.</td> </tr> <tr> <td><code>-dQuality=</code></td> - <td> </td> + <td>-1</td> - <td> </td> + <td>draft</td> </tr> <tr> <td></td> - <td> </td> <td>0</td> - <td> </td> + <td>normal [default]</td> </tr> <tr> <td></td> - <td> </td> <td>1</td> - <td> </td> + <td>presentation</td> </tr> <tr> <td><code>-dRetStatus=</code></td> - <td> </td> + <td>0</td> - <td> </td> + <td>C-RET off</td> </tr> <tr> <td></td> - <td> </td> + <td>1</td> - <td> </td> + <td>C-RET on [default]</td> </tr> <tr> <td><code>-dMasterGamma=</code></td> - <td> </td> + <td>3.0</td> - <td> </td> + <td>[default = 1.0]</td> </tr> </table> @@ -427,7 +427,6 @@ The source module <code>gdevcd8.c</code> contains one generic driver:</p> <table> <tr> <td><code>cdj880</code></td> - <td> </td> <td>HP DeskJet 812, 815, 832, 880, 882, 895, and 970</td> </tr> </table> @@ -441,18 +440,24 @@ internal structure, although the PCL3+ interpretation has changed.</p> <blockquote> <table> + <tr> + <th width="20%">Date</th> + <th width="20%">Version</th> + <th width="60%">Comments</th> +</tr> + <tr> <td>15.03.99</td> - <td> </td> + <td>Version 1.3</td> - <td> </td> + <td>Initial version, based on Version 1.3 of Uli Wortmann's driver.</td> </tr> <tr> <td>26.02.00</td> - <td> </td> + <td>Version 1.4beta</td> - <td> </td> + <td>Greatly improved color handling & dithering, but not yet complete enough to use for text.</td> </tr> @@ -467,74 +472,71 @@ All printers are supported through the cdj880 device. Invoke with <table> <tr> <td><code>-dPapertype=</code></td> - <td> </td> + <td>0</td> - <td> </td> + <td>plain paper [default]</td> </tr> <tr> <td></td> - <td> </td> <td>1</td> - <td> </td> + <td>bond paper</td> </tr> <tr> <td></td> - <td> </td> + <td>2</td> - <td> </td> + <td>special paper</td> </tr> <tr> <td></td> - <td> </td> + <td>3</td> - <td> </td> + <td>glossy film</td> </tr> <tr> <td></td> - <td> </td> + <td>4</td> - <td> </td> + <td>transparency film</td> </tr> <tr> <td></td> <td> </td> - <td> </td> - <td> </td> <td>Currently the lookup tables are unsuited for printing on special paper or transparencies. For these please revert to the gamma functions.</td> </tr> <tr> <td><code>-dQuality=</code></td> - <td> </td> + <td>-1</td> - <td> </td> + <td>draft</td> </tr> <tr> <td></td> - <td> </td> + <td>0</td> - <td> </td> + <td>normal [default]</td> </tr> <tr> <td></td> - <td> </td> + <td>1</td> - <td> </td> + <td>presentation</td> </tr> <tr> <td><code>-dMasterGamma=</code></td> - <td> </td> + <td>3.0</td> - <td> </td> + <td>[default = 1.0]</td> </tr> </table> @@ -582,32 +584,26 @@ The source module <code>gdevcdj.c</code> contains six generic drivers:</p> <table> <tr> <td><code>cdj500</code></td> - <td> </td> <td>HP DeskJet 500C and 540C</td> </tr> <tr> <td><code>cdj550</code></td> - <td> </td> <td>HP DeskJet 550C, 560C, 660C, 660Cse</td> </tr> <tr> <td><code>pjxl300</code></td> - <td> </td> <td>HP PaintJet XL300, DeskJet 1200C, and CopyJet</td> </tr> <tr> <td><code>pjtest</code></td> - <td> </td> <td>HP PaintJet</td> </tr> <tr> <td><code>pjxltest</code></td> - <td> </td> <td>HP PaintJet XL</td> </tr> <tr> <td><code>declj250</code></td> - <td> </td> <td>DEC LJ250</td> </tr> </table> @@ -634,12 +630,10 @@ drivers above (and <code>cDeskJet</code> is identical to <table> <tr> <td><code>gs -sDEVICE=cdj500 -dBitsPerPixel=24</code></td> - <td> </td> <td>for <code>cdjcolor</code>, and</td> </tr> <tr> <td><code>gs -sDEVICE=cdj500 -dBitsPerPixel=1</code></td> - <td> </td> <td>for <code>cdjmono</code></td> </tr> </table> @@ -706,6 +700,10 @@ quality, colour, etc. The valid numbers are:</p> <blockquote> <table> + <tr> + <th width="15%">BITSPERPIXEL</th> + <th width="85%">Comments</th> + </tr> <tr> <td><strong>1</strong></td> <td>A standard Ghostscript monochrome driver, using black ink (by @@ -746,8 +744,8 @@ quality, colour, etc. The valid numbers are:</p> colour cartridge simultaneously (that is, CMYK printing). This printer can both be faster and give higher quality than the DeskJet 500C, because of the true black ink. (Note that the 24-bit mode also permits CMYK printing - on this printer, and uses less memory. Any differences between 24-bit and - 32-bit should be small</td> + on this printer, and uses less memory). Any differences between 24-bit and + 32-bit should be small.</td> </tr> </table> </blockquote> @@ -757,31 +755,29 @@ quality, colour, etc. The valid numbers are:</p> <blockquote> <table> <tr> - <th>Name</th> - <th> </th> - <th>Type</th> - <th> </th> - <th> </th> + <th width="20%">Name</th> + <th width="20%">Type</th> + <th width="60%">Comments</th> </tr> <tr> <td><code>BlackCorrect</code></td> - <td> </td> + <td><code>int</code></td> - <td> </td> + <td>Colour correction to give better blacks when using the DJ500C in colour mode. For example, the default of 4 reduces the cyan component to 4/5. Range accepted: 0 - 9 (0 = none).</td> </tr> <tr> <td><code>Shingling</code></td> - <td> </td> + <td><code>int</code></td> - <td> </td> + <td>Interlaced, multi-pass printing: 0 = none, 1 = 50%, 2 = 25%, 2 is best and slowest.</td> </tr> <tr> <td><code>Depletion</code></td> - <td> </td> + <td><code>int</code></td> - <td> </td> + <td>"Intelligent" dot-removal: 0 = none, 1 = 25%, 2 = 50%, 1 best for graphics? Use 0 for transparencies.</td> </tr> </table> @@ -792,36 +788,34 @@ quality, colour, etc. The valid numbers are:</p> <blockquote> <table> <tr> - <th>Name</th> - <th> </th> - <th>Type</th> - <th> </th> - <th> </th> + <th width="20%">Name</th> + <th width="20%">Type</th> + <th width="60%">Comments</th> </tr> <tr> <td><code>PrintQuality</code></td> - <td> </td> + <td><code>int</code></td> - <td> </td> + <td>Mechanical print quality: -1 = fast, 0 = normal, 1 = presentation. Fast mode reduces ink usage and uses single-pass operation for some media types. Presentation uses more ink and the maximum number of passes, giving slowest printing for highest quality</td> </tr> <tr> <td><code>RenderType</code></td> - <td> </td> + <td><code>int</code></td> - <td> </td> + <td><dl> - <dt><b>0</b><dd>driver does dithering</dd></dt> - <dt><b>1</b><dd>snap to primaries</dd></dt> - <dt><b>2</b><dd>snap black to white, others to black</dd></dt> - <dt><b>3</b><dd>ordered dither</dd></dt> - <dt><b>4</b><dd>error diffusion</dd></dt> - <dt><b>5</b><dd>monochrome ordered dither</dd></dt> - <dt><b>6</b><dd>monochrome error diffusion</dd></dt> - <dt><b>7</b><dd>cluster ordered dither</dd></dt> - <dt><b>8</b><dd>monochrome cluster ordered dither</dd></dt> - <dt><b>9</b><dd>user-defined dither (not supported)</dd></dt> - <dt><b>10</b><dd>monochrome user-defined dither ns.</dd></dt> + <dt><dd><code>0 </code>driver does dithering</dd></dt> + <dt><dd><code>1 </code>snap to primaries</dd></dt> + <dt><dd><code>2 </code>snap black to white, others to black</dd></dt> + <dt><dd><code>3 </code>ordered dither</dd></dt> + <dt><dd><code>4 </code>error diffusion</dd></dt> + <dt><dd><code>5 </code>monochrome ordered dither</dd></dt> + <dt><dd><code>6 </code>monochrome error diffusion</dd></dt> + <dt><dd><code>7 </code>cluster ordered dither</dd></dt> + <dt><dd><code>8 </code>monochrome cluster ordered dither</dd></dt> + <dt><dd><code>9 </code>user-defined dither (not supported)</dd></dt> + <dt><dd><code>10 </code>monochrome user-defined dither ns.</dd></dt> </dl></td> </tr> </table> @@ -1322,36 +1316,39 @@ dithering takes also place but because of the low point density it is usually not efficient, and thus invisible).</p> <blockquote> + + +<h4>Descriptions of printing modes by bpp and Colors</h4> + + <table> + <tr> - <th colspan="5">Descriptions of printing modes by bpp and Colors</th> -</tr> -<tr> - <th>bpp</th> - <th> </th> - <th>Colors</th> - <th> </th> - <th align="left">Mode</th> + <th width="15%">bpp</th> + + <th width="15%">Colors</th> + + <th align="left" width="70%">Mode</th> </tr> <tr> <td>32</td> - <td> </td> + <td align="center">4</td> - <td> </td> + <td>CMYK colour printing, Floyd-Steinberg dithering</td> </tr> <tr> <td>24</td> - <td> </td> + <td align="center">4</td> - <td> </td> + <td>The same. (But each primary colour is stored on 6 bits instead of 8.)</td> </tr> <tr> <td>24</td> - <td> </td> + <td align="center">3</td> - <td> </td> + <td>RGB colour printing, Floyd-Steinberg dithering. This mode does <code>not</code> use the black cartridge (that's why it exists, for when you don't want to use it <code>;-)</code>). @@ -1362,25 +1359,25 @@ usually not efficient, and thus invisible).</p> </tr> <tr> <td>16</td> - <td> </td> + <td align="center">4</td> - <td> </td> + <td>CMYK colour printing, halftoned by Ghostscript. F-S dithering is still visible here (but the halftone patterns are visible too!).</td> </tr> <tr> <td>8</td> - <td> </td> + <td align="center">4</td> - <td> </td> + <td>The same.(But each primary colour is stored in 2 bits instead of 4.)</td> </tr> <tr> <td>8</td> - <td> </td> + <td align="center">3</td> - <td> </td> + <td>RGB colour printing. This mode is not intended for use. What I mean is that it should be used only if you want to use custom halftone screens <b>and</b> the halftoning is broken using the @@ -1388,16 +1385,16 @@ usually not efficient, and thus invisible).</p> </tr> <tr> <td>8</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td>Gray-level printing, Floyd-Steinberg dithering</td> </tr> <tr> <td>1</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td>Gray-level printing halftoned by Ghostscript</td> </tr> </table> @@ -1453,16 +1450,15 @@ When both are present it means that the dithering of halftones is visible. Default choices are indicated by asterisk "*".</p> <blockquote> + <h4>Valid colors values for allowed BitsPerPixel values</h4> <table> + <tr> - <th colspan="5">Valid colors values for allowed BitsPerPixel values</th> -</tr> -<tr> - <th align="center">bpp</th> - <th align="center">Colors</th> - <th></th> - <th align="left">Color model</th> - <th align="left">Dithering</th> + <th>bpp</th> + <th>Colors</th> + <th>Default</th> + <th>Color model</th> + <th>Dithering</th> </tr> <tr> <td align="center">32</td> @@ -1652,7 +1648,7 @@ printer will be set to use thick paper. <th>Value</th> <th>bjc600</th> <th>bjc800</th> - <th></th> + <th>Comments</th> </tr> <tr> <td><code>Low</code></td> @@ -1943,52 +1939,57 @@ somehow related to their use during the printing process:</p> <dl> <dt><code>-sDithering=</code><em>{name}</em> -<dd>Select another dithering algorithm (name) from among +<dd>Select another dithering algorithm (name) from among: <blockquote> <table> + + <tr> + <th width="25%">Dithering name</th> + <th width="75%">Comments</th> + </tr> <tr> <td><code>gscmyk</code></td> - <td> </td> + <td>fast color output, CMYK process color model (default)</td> </tr> <tr> <td><code>gsmono</code></td> - <td> </td> + <td>fast monochrome output</td> </tr> <tr> <td><code>gsrgb</code></td> - <td> </td> + <td>fast color output, RGB process color model</td> </tr> <tr> <td><code>fsmono</code></td> - <td> </td> + <td>Floyd-Steinberg, monochrome</td> </tr> <tr> <td><code>fsrgb</code></td> - <td> </td> + <td>Floyd-Steinberg, RGB process color model (almost identical to the <code>cdj550</code>/<code>bjc</code> algorithm)</td> </tr> <tr> <td><code>fsx4</code></td> - <td> </td> + <td>Floyd-Steinberg, CMYK process color model (shares code with <code>fsmono</code> and <code>fsrgb</code>, but is algorithmically really bad)</td> </tr> <tr> <td><code>fscmyk</code></td> - <td> </td> + <td>Floyd-Steinberg, CMYK process color model and proper modifications for CMYK</td> </tr> <tr> <td><code>hscmyk</code></td> - <td> </td> + <td>modified Floyd-Steinberg with CMYK model ("hs" stands for "hess" not for "high speed", but the major difference from <code>fscmyk</code> is speed)</td> </tr> <tr> <td><code>fs2</code></td> - <td> </td> + <td>algorithm by Steven Singer (RGB) should be identical to <code>escp2cfs2</code>.</td> </tr> </table> @@ -2154,7 +2155,6 @@ on STC-IIs ? and st800) are known to work with most printers.</p> <td>15</td> <td><code>noWeave</code></td> <td> </td> - <td> </td> </tr> <tr> <td>360x180</td> @@ -3646,496 +3646,496 @@ gs @stc.upp -sOutputFile=/dev/lp1 tiger.eps -c quit <blockquote> <table> <tr> - <th colspan="6">Unified Printer Parameter files distributed with Ghostscript</th> + <th colspan="3">Unified Printer Parameter files distributed with Ghostscript</th> </tr> <tr> - <th align="left" colspan="6">Canon BJC 610 (color, rendered)</th> + <th align="left" colspan="3">Canon BJC 610 (color, rendered)</th> </tr> <tr> - <td> </td> + <td><code>bjc610a0.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>plain paper, high speed</td> </tr> <tr> - <td> </td> + <td><code>bjc610a1.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>plain paper</td> </tr> <tr> - <td> </td> + <td><code>bjc610a2.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>coated paper</td> </tr> <tr> - <td> </td> + <td><code>bjc610a3.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>transparency film</td> </tr> <tr> - <td> </td> + <td><code>bjc610a4.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>back print film</td> </tr> <tr> - <td> </td> + <td><code>bjc610a5.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>fabric sheet</td> </tr> <tr> - <td> </td> + <td><code>bjc610a6.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>glossy paper</td> </tr> <tr> - <td> </td> + <td><code>bjc610a7.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>high gloss film</td> </tr> <tr> - <td> </td> + <td><code>bjc610a8.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>high resolution paper</td> </tr> <tr> - <th colspan="6"></th> + <th colspan="3"></th> </tr> <tr> - <td> </td> + <td><code>bjc610b1.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>plain paper</td> </tr> <tr> - <td> </td> + <td><code>bjc610b2.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>coated paper</td> </tr> <tr> - <td> </td> + <td><code>bjc610b3.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>transparency film</td> </tr> <tr> - <td> </td> + <td><code>bjc610b4.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>back print film</td> </tr> <tr> - <td> </td> + <td><code>bjc610b6.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>glossy paper</td> </tr> <tr> - <td> </td> + <td><code>bjc610b7.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>high-gloss paper</td> </tr> <tr> - <td> </td> + <td><code>bjc610b8.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>high resolution paper</td> </tr> <tr> - <th align="left" colspan="6">HP Ink-Printers</th> + <th align="left" colspan="3">HP Ink-Printers</th> </tr> <tr> - <td> </td> + <td><code>cdj550.upp</code></td> - <td> </td> + <td>300×300dpi</td> - <td> </td> + <td>32-bit CMYK</td> </tr> <tr> - <td> </td> + <td><code>cdj690.upp</code></td> - <td> </td> + <td>300×300dpi</td> - <td> </td> + <td>Normal mode</td> </tr> <tr> - <td> </td> + <td><code>cdj690ec.upp</code></td> - <td> </td> + <td>300×300dpi</td> - <td> </td> + <td>Economy mode</td> </tr> <tr> - <td> </td> + <td><code>dnj750c.upp</code></td> - <td> </td> + <td>300×300dpi</td> - <td> </td> + <td>Color – also good for 450C</td> </tr> <tr> - <td> </td> + <td><code>dnj750m.upp</code></td> - <td> </td> + <td>600×600dpi</td> - <td> </td> + <td>Monochrome</td> </tr> <tr> - <th align="left" colspan="6">NEC P2X</th> + <th align="left" colspan="3">NEC P2X</th> </tr> <tr> - <td> </td> + <td><code>necp2x.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>8-bit (Floyd-Steinberg)</td> </tr> <tr> - <th align="left" colspan="6">Any Epson Stylus Color</th> + <th align="left" colspan="3">Any Epson Stylus Color</th> </tr> <tr> - <td> </td> + <td><code>stcany.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>4-bit, PostScript halftoning</td> </tr> <tr> - <td> </td> + <td><code>stcany_h.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>4-bit, PostScript halftoning</td> </tr> <tr> - <th align="left" colspan="6">Original Epson Stylus and Stylus Pro Color</th> + <th align="left" colspan="3">Original Epson Stylus and Stylus Pro Color</th> </tr> <tr> - <td> </td> + <td><code>stc.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>32-bit CMYK, 15-pin</td> </tr> <tr> - <td> </td> + <td><code>stc_l.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>4-bit, PostScript halftoning, weaved noWeave</td> </tr> <tr> - <td> </td> + <td><code>stc_h.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>32-bit CMYK, 15-pin Weave</td> </tr> <tr> - <th align="left" colspan="6">Epson Stylus Color II</th> + <th align="left" colspan="3">Epson Stylus Color II</th> </tr> <tr> - <td> </td> + <td><code>stc2.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>32-bit CMYK, 20-pin, Epson Stylus Color II(s)</td> </tr> <tr> - <td> </td> + <td><code>stc2_h.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>32-bit CMYK, 20-pin, Epson Stylus Color II</td> </tr> <tr> - <td> </td> + <td><code>stc2s_h.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>32-bit CMYK, 20-pin, Epson Stylus Color IIs</td> </tr> <tr> - <th align="left" colspan="6">Epson Stylus Color 200</th> + <th align="left" colspan="3">Epson Stylus Color 200</th> </tr> <tr> - <td> </td> + <td><code>stc200.upp</code></td> - <td> </td> + <td>360×720dpi</td> - <td> </td> + <td>Plain Paper</td> </tr> <tr> - <th align="left" colspan="6">Epson Stylus Color 300</th> + <th align="left" colspan="3">Epson Stylus Color 300</th> </tr> <tr> - <td> </td> + <td><code>stc300.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>32-bit CMYK, plain paper</td> </tr> <tr> - <td> </td> + <td><code>stc300bl.upp</code></td> - <td> </td> + <td>180×180dpi</td> - <td> </td> + <td>black only, plain paper</td> </tr> <tr> - <td> </td> + <td><code>stc300bm.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>black only, plain paper</td> </tr> <tr> - <th align="left" colspan="6">Epson Stylus Color 500 (good transfer curves for plain paper)</th> + <th align="left" colspan="3">Epson Stylus Color 500 (good transfer curves for plain paper)</th> </tr> <tr> - <td> </td> + <td><code>stc500p.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>32-bit CMYK, noWeave, plain paper</td> </tr> <tr> - <td> </td> + <td><code>stc500ph.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>32-bit CMYK, noWeave, plain paper</td> </tr> <tr> - <th align="left" colspan="6">Epson Stylus Color 600, 32/90-inch weaving</th> + <th align="left" colspan="3">Epson Stylus Color 600, 32/90-inch weaving</th> </tr> <tr> - <td> </td> + <td><code>stc600pl.upp</code></td> - <td> </td></td> - <td>360×360dpi - <td> </td> + + <td>360×360dpi</td> + <td>32-bit CMYK, 32-pin, plain paper</td> </tr> <tr> - <td> </td> + <td><code>stc600p.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>32-bit CMYK, 32-pin, plain paper</td> </tr> <tr> - <td> </td> + <td><code>stc600ih.upp</code></td> - <td> </td> + <td>1440×720dpi</td> - <td> </td> + <td>32-bit CMYK, 30-pin, inkjet paper</td> </tr> <tr> - <th align="left" colspan="6">Epson Stylus Color 640</th> + <th align="left" colspan="3">Epson Stylus Color 640</th> </tr> <tr> - <td> </td> + <td><code>stc640p.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>plain paper?</td> </tr> <tr> - <td> </td> + <td><code>st640p.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>CMYK, plain paper</td> </tr> <tr> - <td> </td> + <td><code>st640pg.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>grayscale, plain paper</td> </tr> <tr> - <td> </td> + <td><code>st640pl.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>CMYK, plain paper</td> </tr> <tr> - <td> </td> + <td><code>st640plg.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>grayscale, plain paper</td> </tr> <tr> - <td> </td> + <td><code>st640ih.upp</code></td> - <td> </td> + <td>1440×720dpi</td> - <td> </td> + <td>CMYK, inkjet paper</td> </tr> <tr> - <td> </td> + <td><code>st640ihg.upp</code></td> - <td> </td> + <td>1440×720dpi</td> - <td> </td> + <td>grayscale, inkjet paper</td> </tr> <tr> - <th align="left" colspan="6">Epson Stylus Color 800, 64/180-inch weaving</th> + <th align="left" colspan="3">Epson Stylus Color 800, 64/180-inch weaving</th> </tr> <tr> - <td> </td> + <td><code>stc800pl.upp</code></td> - <td> </td> + <td>360×360dpi</td> - <td> </td> + <td>32-bit CMYK, 64-pin, plain paper</td> </tr> <tr> - <td> </td> + <td><code>stc800p.upp</code></td> - <td> </td> + <td>720×720dpi</td> - <td> </td> + <td>32-bit CMYK, 64-pin, plain paper</td> </tr> <tr> - <td> </td> + <td><code>stc800ih.upp</code></td> - <td> </td> + <td>1440×720dpi</td> - <td> </td> + <td>32-bit CMYK, 62-pin, inkjet paper</td> </tr> <tr> - <td> </td> + <td><code>stc1520.upp</code></td> - <td> </td> + <td>1440×720dpi</td> - <td> </td> + <td>32-bit CMYK, 62-pin, inkjet paper</td> </tr> <tr> - <th align="left" colspan="6">Sun raster file</th> + <th align="left" colspan="3">Sun raster file</th> </tr> <tr> - <td> </td> + <td><code>ras1.upp</code></td> - <td> </td> + <td>1-bit</td> - <td> </td> + <td>monochrome (Ghostscript)</td> </tr> <tr> - <td> </td> + <td><code>ras3.upp</code></td> - <td> </td> + <td>3-bit</td> - <td> </td> + <td>RGB (Ghostscript)</td> </tr> <tr> - <td> </td> + <td><code>ras4.upp</code></td> - <td> </td> + <td>4-bit</td> - <td> </td> + <td>CMYK (Ghostscript)</td> </tr> <tr> - <td> </td> + <td><code>ras8m.upp</code></td> - <td> </td> + <td>8-bit</td> - <td> </td> + <td>grayscale (Floyd-Steinberg)</td> </tr> <tr> - <td> </td> + <td><code>ras24.upp</code></td> - <td> </td> + <td>24-bit</td> - <td> </td> + <td>RGB (Floyd-Steinberg)</td> </tr> <tr> - <td> </td> + <td><code>ras32.upp</code></td> - <td> </td> + <td>32-bit</td> - <td> </td> + <td>CMYK (CMYK-Floyd-Steinberg)</td> </tr> </table> @@ -4320,27 +4320,27 @@ while <code>/FSCMYK32</code> is (almost) identical to <table> <tr> <td><code>/SunRaster</code></td> - <td> </td> + <td>creates Sun raster files and requires no other parameters</td> </tr> <tr> <td><code>/Epson</code></td> - <td> </td> + <td>is used for the elderly ESC/P format (used by many printers)</td> </tr> <tr> <td><code>/EscP2</code></td> - <td> </td> + <td>is used by more recent Epson printers (no X weaving supported)</td> </tr> <tr> <td><code>/EscP2XY</code></td> - <td> </td> + <td>supports X-Weaving, used with 1440dpi printers and in <code>stc2s_h</code></td> </tr> <tr> <td><code>/Pcl</code></td> - <td> </td> + <td>HP PCL/RTL-style output formatter without weaving</td> </tr> </table> @@ -4368,70 +4368,70 @@ numbers given corresponds to a component which depends on the selected <table> <tr> <td align="center"> </td> - <td> </td> + <td align="center"><code>/DeviceGray</code></td> - <td> </td> + <td align="center"><code>/DeviceRGBW</code></td> - <td> </td> + <td align="center"><code>/DeviceRGB</code></td> - <td> </td> + <td align="center"><code>/DeviceCMYK</code></td> - <td> </td> + <td align="center"><code>/DeviceCMYKgenerate</code></td> </tr> <tr> - <td colspan="11"></td> + <td colspan="6"></td> </tr> <tr> <td align="center">0</td> - <td> </td> + <td align="center">White</td> - <td> </td> + <td align="center">White</td> - <td> </td> + <td align="center">Red</td> - <td> </td> + <td align="center">Black</td> - <td> </td> + <td align="center">Black</td> </tr> <tr> <td align="center">1</td> - <td> </td> + <td align="center">--</td> - <td> </td> + <td align="center">Red</td> - <td> </td> + <td align="center">Green</td> - <td> </td> + <td align="center">Cyan</td> - <td> </td> + <td align="center">Cyan</td> </tr> <tr> <td align="center">2</td> - <td> </td> + <td align="center">--</td> - <td> </td> + <td align="center">Green</td> - <td> </td> + <td align="center">Blue</td> - <td> </td> + <td align="center">Magenta</td> - <td> </td> + <td align="center">Magenta</td> </tr> <tr> <td align="center">3</td> - <td> </td> + <td align="center">--</td> - <td> </td> + <td align="center">Blue</td> - <td> </td> + <td align="center">--</td> - <td> </td> + <td align="center">Yellow</td> - <td> </td> + <td align="center">Yellow</td> </tr> </table> @@ -4550,523 +4550,523 @@ denotes that a parameter is an array, and "(RO)" that it is read-only.</p> <blockquote> <table> <tr> - <th colspan="5">All uniprint parameters</th> + <th colspan="3">All uniprint parameters</th> </tr> <tr> <th align="left">Parameter</th> - <th> </th> + <th align="left">Type</th> - <th> </th> + <th align="left">Use</th> </tr> <tr> <td><code>upAbortCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>End of page and file on interrupt</td> </tr> <tr> <td><code>upAdjustBottomMarginCommand</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Manipulate bottom margin in <code>upBeginPageCommand</code></td> </tr> <tr> <td><code>upAdjustMediaSizeCommand</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Manipulate <code>Mediasize</code> [intended]</td> </tr> <tr> <td><code>upAdjustPageLengthCommand</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Manipulate page length in <code>upBeginPageCommand</code></td> </tr> <tr> <td><code>upAdjustPageWidthCommand</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Manipulate page width in <code>upBeginPageCommand</code></td> </tr> <tr> <td><code>upAdjustResolutionCommand</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Manipulate resolution</td> </tr> <tr> <td><code>upAdjustTopMarginCommand</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Manipulate top margin in <code>upBeginPageCommand</code></td> </tr> <tr> <td><code>upBeginJobCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>Begin each output file</td> </tr> <tr> <td><code>upBeginPageCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>Begin each page</td> </tr> <tr> <td><code>upBlackTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>Black transfer (CMYK only!)</td> </tr> <tr> <td><code>upBlueTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>Blue transfer</td> </tr> <tr> <td><code>upColorInfo</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>struct <code>gx_device_color_info</code></td> </tr> <tr> <td><code>upColorModel</code></td> - <td> </td> + <td>Name</td> - <td> </td> + <td>Select color mapping</td> </tr> <tr> <td><code>upColorModelInitialized</code></td> - <td> </td> + <td>Bool (RO)</td> - <td> </td> + <td>Color mapping OK</td> </tr> <tr> <td><code>upComponentBits</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>Bits stored per component</td> </tr> <tr> <td><code>upComponentShift</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>Positioning within <code>gx_color_index</code></td> </tr> <tr> <td><code>upCyanTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>Cyan transfer</td> </tr> <tr> <td><code>upEndJobCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>End each file unless <code>upAbortCommand</code></td> </tr> <tr> <td><code>upEndPageCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>End each page unless <code>upAbortCommand</code></td> </tr> <tr> <td><code>upErrorDetected</code></td> - <td> </td> + <td>Bool (RO)</td> - <td> </td> + <td>Severe (VM) error, not fully operational</td> </tr> <tr> <td><code>upFSFixedDirection</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Inhbits direction toggling in rendering</td> </tr> <tr> <td><code>upFSProcessWhiteSpace</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Causes white-space rendering</td> </tr> <tr> <td><code>upFSReverseDirection</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Run rendering in reverse (if fixed)</td> </tr> <tr> <td><code>upFSZeroInit</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Non-random rendering initialization</td> </tr> <tr> <td><code>upFormatXabsolute</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Write absolute X coordinates</td> </tr> <tr> <td><code>upFormatYabsolute</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Write absolute Y coordinates</td> </tr> <tr> <td><code>upGreenTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>Green transfer</td> </tr> <tr> <td><code>upMagentaTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>Magenta transfer</td> </tr> <tr> <td><code>upMargins</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>L/B/R/T margins in points</td> </tr> <tr> <td><code>upModel</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>Comment string, holds some info</td> </tr> <tr> <td><code>upOutputAborted</code></td> - <td> </td> + <td>Bool (RO)</td> - <td> </td> + <td>Caught an interrupt</td> </tr> <tr> <td><code>upOutputBuffers</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Number of rendering buffers (2^<small><sup><b>N</b></sup></small>)</td> </tr> <tr> <td><code>upOutputComponentOrder</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>Order of components when printing</td> </tr> <tr> <td><code>upOutputComponents</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Number of written components, not fully operational</td> <tr> <td><code>upOutputFormat</code></td> - <td> </td> + <td>Name</td> - <td> </td> + <td>Select output format</td> </tr> <tr> <td><code>upOutputFormatInitialized</code></td> - <td> </td> + <td>Bool (RO)</td> - <td> </td> + <td>Format data OK</td> </tr> <tr> <td><code>upOutputHeight</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Output height in pixels</td> </tr> <tr> <td><code>upOutputPins</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Number of pins / nozzles per command</td> </tr> <tr> <td><code>upOutputWidth</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Output width in pixels</td> </tr> <tr> <td><code>upOutputXOffset</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Offset in pixels, if <code>upFormatXabsolute</code></td> </tr> <tr> <td><code>upOutputXStep</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Divisor or multiplier for X coords</td> </tr> <tr> <td><code>upOutputYOffset</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Offset in pixels, if <code>upFormatYabsolute</code></td> </tr> <tr> <td><code>upOutputYStep</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Divisor or multiplier for Y coords</td> </tr> <tr> <td><code>upRasterBufferInitialized</code></td> - <td> </td> + <td>Bool (RO)</td> - <td> </td> + <td>GS buffer OK</td> </tr> <tr> <td><code>upRedTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>Red transfer</td> </tr> <tr> <td><code>upRendering</code></td> - <td> </td> + <td>Name</td> - <td> </td> + <td>Select rendering algorithm</td> </tr> <tr> <td><code>upRenderingInitialized</code></td> - <td> </td> + <td>Bool (RO)</td> - <td> </td> + <td>Rendering parameters OK</td> </tr> <tr> <td><code>upSelectComponentCommands</code></td> - <td> </td> + <td>String[ ]</td> - <td> </td> + <td>Establish color (output order!)</td> </tr> <tr> <td><code>upSetLineFeedCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>Adjust linefeed (Epson only)</td> </tr> <tr> <td><code>upVersion</code></td> - <td> </td> + <td>String (RO)</td> - <td> </td> + <td>Source code version</td> </tr> <tr> <td><code>upWeaveFinalPins</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>Number of bottom pins on EOP passes</td> </tr> <tr> <td><code>upWeaveFinalScan</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Begin EOP passes (Y-coord)</td> </tr> <tr> <td><code>upWeaveFinalXStarts</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>X-pass indices for EOP passes</td> </tr> <tr> <td><code>upWeaveFinalYFeeds</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>Y increments for EOP passes</td> </tr> <tr> <td><code>upWeaveInitialPins</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>Number of top pins on BOP passes</td> </tr> <tr> <td><code>upWeaveInitialScan</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>End BOP passes (Y coord)</td> </tr> <tr> <td><code>upWeaveInitialXStarts</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>X-pass indices for BOP passes</td> </tr> <tr> <td><code>upWeaveInitialYFeeds</code></td> - <td> </td> + <td>int[ ]</td> - <td> </td> + <td>Y increments for BOP passes</td> </tr> <tr> <td><code>upWeavePasses</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>XPasses × YPasses</td> </tr> <tr> <td><code>upWeaveXPasses</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Number of X passes</td> </tr> <tr> <td><code>upWeaveXStarts</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>X-pass indices for normal passes</td> </tr> <tr> <td><code>upWeaveYFeeds</code></td> - <td> </td> + <td>Int[ ]</td> - <td> </td> + <td>Y increments for normal passes</td> </tr> <tr> <td><code>upWeaveYOffset</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Number of blank or incomplete scans at BOP</td> </tr> <tr> <td><code>upWeaveYPasses</code></td> - <td> </td> + <td>Int</td> - <td> </td> + <td>Number of X passes</td> </tr> <tr> <td><code>upWhiteTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>White transfer (monochrome devices!)</td> </tr> <tr> <td><code>upWriteComponentCommands</code></td> - <td> </td> + <td>String[ ]</td> - <td> </td> + <td>Commands to write each component</td> </tr> <tr> <td><code>upWroteData</code></td> - <td> </td> + <td>Bool (RO)</td> - <td> </td> + <td>Something (<code>BeginJob</code>) written to output</td> </tr> <tr> <td><code>upXMoveCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>X positioning command</td> </tr> <tr> <td><code>upXStepCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>Single step to the right</td> </tr> <tr> <td><code>upYFlip</code></td> - <td> </td> + <td>Bool</td> - <td> </td> + <td>Flips output along the Y axis</td> </tr> <tr> <td><code>upYMoveCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>Y positioning command</td> </tr> <tr> <td><code>upYStepCommand</code></td> - <td> </td> + <td>String</td> - <td> </td> + <td>Single step down</td> </tr> <tr> <td><code>upYellowTransfer</code></td> - <td> </td> + <td>Float[ ]</td> - <td> </td> + <td>Yellow transfer</td> </tr> </table> @@ -5112,6 +5112,7 @@ Germany<br> +49 203 376273 telephone (MET evening hours)<br> <<a href="mailto:ghess@elmos.de">ghess@elmos.de</a>> </address> +<p/> <h3><a name="Uni_weaving_howto"></a><tt>Uniprint</tt> weaving parameters howto</h3> <p>This section was contributed by Glenn Ramsey.</p> <p>I wrote this because the documentation was very brief and I really struggled @@ -5404,7 +5405,7 @@ The extension adds a format that I have called EscNozzleMap and adds some <tbody> <tr valign="Top"> <td><code>/EscNozzleMap</code></td> - <td> </td> + <td>produces output for the Epson Stylus Color 300 </td> </tr> @@ -5416,59 +5417,50 @@ The extension adds a format that I have called EscNozzleMap and adds some <blockquote> <table> <tr> - <th colspan="5">uniprint parameters for the EscNozzleMap format</th> + <th colspan="3">uniprint parameters for the EscNozzleMap format</th> </tr> <tr> <th align="Left">Parameter</th> - <th></th> + <th align="Left">Type</th> - <th> </th> + <th align="Left">Use</th> </tr> <tr> - <td colspan="5"></td> + <td colspan="3"></td> </tr> <tr> <td><code>upNozzleMapRowsPerPass</code></td> - <td> </td> + <td>Int </td> - <td> - </td> + + <td>output rows to generate for each pass of the head </td> </tr> <tr> <td><code>upNozzleMapPatternRepeat</code></td> - <td> - </td> + <td>Int </td> - <td> - </td> + <td>no. of rows that correspond to the repeat pattern of the nozzles </td> </tr> <tr> <td><code>upNozzleMapRowMask</code></td> - <td> - </td> <td>Int[] </td> - <td> - </td> <td>mask indicating the colour of the nozzles </td> </tr> <tr> <td><code>upNozzleMapMaskScanOffset</code></td> - <td> - </td> + <td>Int[] </td> - <td> - </td> <td>mask indicating the physical position of the nozzles </td> </tr> @@ -5500,42 +5492,36 @@ The extension adds a format that I have called EscNozzleMap and adds some <tr> <th align="center">colour </th> - <th> - </th> + <th align="center">mask value </th> </tr> <tr valign="Top" align="center"> <td><code>K</code></td> - <td> - </td> + <td>1 </td> </tr> <tr valign="Top" align="center"> <td><code>C</code></td> - <td> - </td> + <td>2 </tr> <tr valign="Top" align="center"> <td><code>M</code></td> - <td> - </td> + <td>3 </td> </tr> <tr valign="Top" align="center"> <td><code>Y</code></td> - <td> - </td> + <td>4 </td> </tr> <tr valign="Top" align="center"> <td><code>no data</code></td> - <td> - </td> + <td>0 </td> </tr> @@ -5766,7 +5752,6 @@ Novato, CA 94945, U.S.A., +1(415)492-9861, for further information. <!-- [3.0 end visible trailer] ============================================= --> - <!--FINISH EDITING HERE--> </div><!-- close inner --> </div><!-- close outer --> diff --git a/doc/Drivers.htm b/doc/Drivers.htm index 3e7852ee9..8c10ee12e 100644 --- a/doc/Drivers.htm +++ b/doc/Drivers.htm @@ -342,19 +342,20 @@ structure for ordinary drivers are:</p> <blockquote><table> <tr valign="top"> <td><code>const char *dname;</code></td> - <td> </td> + <td>The device name</td></tr> + <tr valign="top"> <td><code>bool is_open;</code></td> - <td> </td> + <td>True if device has been opened</td></tr> <tr valign="top"> <td><code>gx_device_color_info color_info;</code></td> - <td> </td> + <td>Color information</td></tr> <tr valign="top"> <td><code>int width;</code></td> - <td> </td> + <td>Width in pixels</td></tr> <tr valign="top"> <td><code>int height;</code></td> - <td> </td> + <td>Height in pixels</td></tr> </table></blockquote> @@ -2139,32 +2140,32 @@ consult the source code, specifically:</p> <blockquote><table> <tr valign="top"> <th align="left">Header</th> - <th> </th> + <th align="left">Defines</th></tr> <tr valign="top"> <td><a href="../base/gxpaint.h">gxpaint.h</a></td> - <td> </td> + <td><code>gx_fill_params</code>, <code>gx_stroke_params</code></td></tr> <tr valign="top"> <td><a href="../base/gxfixed.h">gxfixed.h</a></td> - <td> </td> + <td><code>fixed</code>, <code>gs_fixed_point</code> (used by <code>gx_*_params</code>)</td></tr> <tr valign="top"> <td><a href="../base/gxgstate.h">gxgstate.h</a></td> - <td> </td> + <td><code>gs_imager_state</code> (used by <code>gx_*_params</code>)</td></tr> <tr valign="top"> <td><a href="../base/gxline.h">gxline.h</a></td> - <td> </td> + <td><code>gx_line_params</code> (used by <code>gs_imager_state</code>)</td></tr> <tr valign="top"> <td><a href="../base/gslparam.h">gslparam.h</a></td> - <td> </td> + <td>line cap/join values (used by <code>gx_line_params</code>)</td></tr> <tr valign="top"> <td><a href="../base/gxmatrix.h">gxmatrix.h</a></td> - <td> </td> + <td><code>gs_matrix_fixed</code> (used by <code>gs_imager_state</code>)</td></tr> <tr valign="top"> <td><a href="../base/gspath.h">gspath.h</a>, <a href="../base/gxpath.h">gxpath.h</a>, <a href="../base/gzpath.h">gzpath.h</a></td> - <td> </td> + <td><code>gx_path</code></td></tr> <tr valign="top"> <td><a href="../base/gxcpath.h">gxcpath.h</a>, <a href="../base/gzcpath.h">gzcpath.h</a></td> - <td> </td> + <td><code>gx_clip_path</code></td></tr> </table></blockquote> @@ -2222,36 +2223,36 @@ with the given color and logical operation. The clip path pointer may be command is as below.</dd> </dl> -<h5><a name="F_spec"></a>The function specification f</h5> +<h4><a name="F_spec"></a>The function specification f</h4> <p> "Command" indicates the raster operation and transparency as follows:</p> <blockquote><table> <tr valign="bottom"> - <th colspan ="3">Bits</th> + <th colspan ="2">Bits</th> </tr> <tr valign="top"> <td>7-0</td> - <td> </td> + <td>raster op</td></tr> <tr valign="top"> <td>8</td> - <td> </td> + <td>0 if source opaque, 1 if source transparent</td></tr> <tr valign="top"> <td>9</td> - <td> </td> + <td>0 if texture opaque, 1 if texture transparent</td></tr> <tr valign="top"> <td>10</td> - <td> </td> + <td>1 if pdf transparency is in use, 0 otherwise. This makes no difference to the rendering, but forces the raster operation to be considered non-idempotent by internal routines.</td></tr> <tr valign="top"> <td>11</td> - <td> </td> + <td>1 if the target of this operation is a specific plane, rather than all planes. The plane in question is given by bits 13 upwards. This is only used by the planar device.</td></tr> <tr valign="top"> <td>12-</td> - <td> </td> + <td>If bit 11 = 1, then bits 12 upwards give the plane number to operate on. Otherwise, should be set to 0.</td></tr> </table></blockquote> @@ -2268,67 +2269,67 @@ possible 2×2×2 input values as follows:</p> <blockquote><table> <tr valign="bottom"> <th>Bit</th> - <th> </th> + <th>Texture</th> - <th> </th> + <th>Source</th> - <th> </th> + <th>Destination</th></tr> <tr valign="top"> <td align="center">7</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">1</td></tr> <tr valign="top"> <td align="center">6</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">0</td></tr> <tr valign="top"> <td align="center">5</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">1</td></tr> <tr valign="top"> <td align="center">4</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">0</td></tr> <tr valign="top"> <td align="center">3</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">1</td></tr> <tr valign="top"> <td align="center">2</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">1</td> - <td> </td> + <td align="center">0</td></tr> <tr valign="top"> <td align="center">1</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">1</td></tr> <tr valign="top"> <td align="center">0</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">0</td> - <td> </td> + <td align="center">0</td></tr> </table></blockquote> @@ -2521,8 +2522,8 @@ gx_image_enum_common_t **pinfo)</code> <b><em>[OPTIONAL]</em></b></dt> are as follows:</dd> <blockquote><table> -<tr valign="top"> <td><code>pis</code></td> - <td> </td> +<tr valign="top"><td><code>pis</code></td> + <td>pointer to an imager state. The only relevant elements of the imager state are the CTM (coordinate transformation matrix), the logical operation (<code>RasterOp</code> or @@ -2530,34 +2531,34 @@ are as follows:</dd> mask images, if <code>pmat</code> is not NULL and the color is pure, <code>pis</code> may be NULL.</td></tr> <tr valign="top"> <td><code>pmat</code></td> - <td> </td> + <td>pointer to a <code>gs_matrix</code> structure that defines the image transformation matrix. If <code>pis</code> is non-NULL, and <code>pmat</code> is NULL, then the <code>ctm</code> from <code>pis</code> should be used.</td></tr> <tr valign="top"> <td><code>pim</code></td> - <td> </td> + <td>pointer to the <code>gs_image_t</code> structure that defines the image parameters</td></tr> <tr valign="top"> <td><code>prect</code></td> - <td> </td> + <td>if not <code>NULL</code>, defines a subrectangle of the image; only the data for this subrectangle will be passed to <code>image_plane_data</code>, and only this subrectangle should be drawn</td></tr> <tr valign="top"> <td><code>pdcolor</code></td> - <td> </td> + <td>defines a drawing color, only needed for masks or if <code>CombineWithColor</code> is true</td></tr> <tr valign="top"> <td><code>pcpath</code></td> - <td> </td> + <td>if not <code>NULL</code>, defines an optional clipping path</td></tr> <tr valign="top"> <td><code>memory</code></td> - <td> </td> + <td>defines the allocator to be used for allocating bookkeeping information</td></tr> <tr valign="top"> <td><code>pinfo</code></td> - <td> </td> + <td>the implementation should return a pointer to its state structure here</td></tr> </table></blockquote> @@ -2705,26 +2706,26 @@ follows:</dd> <blockquote><table> <tr valign="top"> <td><code>dev</code></td> - <td> </td> + <td>The usual pointer to the device.</td></tr> <tr valign="top"> <td><code>pis</code></td> - <td> </td> + <td>A pointer to an imager state. All elements may be relevant, depending on how the text is rendered. </td></tr> <tr valign="top"> <td><code>text</code></td> - <td> </td> + <td>A pointer to the structure that defines the text operation and parameters. See <a href="../base/gstext.h">gstext.h</a> for details.</td></tr> <tr valign="top"> <td><code>font</code></td> - <td> </td> + <td>Defines the font for drawing.</td></tr> <tr valign="top"> <td><code>pcpath</code></td> - <td> </td> + <td>If not <code>NULL</code>, defines an optional clipping path. Only relevant if the text operation includes <code>TEXT_DO_DRAW</code>.</td></tr> <tr valign="top"> <td><code>ppte</code></td> - <td> </td> + <td>The implementation should return a pointer to its state structure here.</td></tr> </table></blockquote> @@ -2845,16 +2846,16 @@ structure consists of:</dd></p> <table> <tr valign="top"> <td><code>options</code></td> - <td> </td> + <td>the allowable formats for returning the data</td></tr> <tr valign="top"> <td><code>data[32]</code></td> - <td> </td> + <td>pointers to the returned data</td></tr> <tr valign="top"> <td><code>x_offset</code></td> - <td> </td> + <td>the X offset of the first returned pixel in data</td></tr> <tr valign="top"> <td><code>raster</code></td> - <td> </td> + <td>the distance between scan lines in the returned data</td></tr> </table> diff --git a/doc/Fonts.htm b/doc/Fonts.htm index 6c63eed8e..cca8bc990 100644 --- a/doc/Fonts.htm +++ b/doc/Fonts.htm @@ -204,39 +204,39 @@ bdftops BDF_filename [AFM_file1_name ...] gsf_filename The arguments have these meanings:</p> <blockquote><table> <tr valign="top"> <td><code>BDF_filename</code></td> - <td> </td> + <td>Input bitmap file in BDF format</td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td><code>AFM_file1_name</code></td> - <td> </td> + <td>AFM files giving metrics</td> - <td> </td> + <td>(Optional)</td></tr> <tr valign="top"> <td><code>gsf_filename</code></td> - <td> </td> + <td>Output file</td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td><code>fontname</code></td> - <td> </td> + <td>Name of the font</td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td><code>UniqueID</code></td> - <td> </td> + <td>UniqueID (<a href="#Unique_IDs">as described below</a>)</td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td><code>XUID</code></td> - <td> </td> + <td>XUID, in the form <code>n1.n2.n3...</code> (<a href="#Unique_IDs">as described below</a>)</td> - <td> </td> + <td>(Optional)</td></tr> <tr valign="top"> <td><code>encodingname</code></td> - <td> </td> + <td>"StandardEncoding" (the default), "ISOLatin1Encoding",<br>"SymbolEncoding", "DingbatsEncoding"</td> - <td> </td> + <td>(Optional)</td></tr> </table></blockquote> diff --git a/doc/Install.htm b/doc/Install.htm index ae42488ab..6e2f88c1c 100644 --- a/doc/Install.htm +++ b/doc/Install.htm @@ -238,14 +238,14 @@ subdirectory, are:</p> <blockquote><table> <tr><td><code>GSWIN32C.EXE</code></td> - <td> </td> + <td>Ghostscript as a 32-bit Windows command line program. This is usually the preferred executable.</td></tr> <tr><td><code>GSWIN32.EXE</code></td> - <td> </td> + <td>32-bit Ghostscript using its own window for commands</td></tr> <tr><td><code>GSDLL32.DLL</code></td> - <td> </td> + <td>32-bit dynamic link library containing most of Ghostscript's functionality</td></tr> </table></blockquote> @@ -255,14 +255,14 @@ For the 64-bit Windows install, also in the <code>gs<em>#.##</em>\bin</code> <blockquote><table> <tr><td><code>GSWIN64C.EXE</code></td> - <td> </td> + <td>Ghostscript as a 64-bit Windows command line program. This is usually the preferred executable.</td></tr> <tr><td><code>GSWIN64.EXE</code></td> - <td> </td> + <td>64-bit Ghostscript using its own window for commands</td></tr> <tr><td><code>GSDLL64.DLL</code></td> - <td> </td> + <td>64-bit dynamic link library containing most of Ghostscript's functionality</td></tr> </table></blockquote> diff --git a/doc/Language.htm b/doc/Language.htm index 87e9e686e..df8984a5e 100644 --- a/doc/Language.htm +++ b/doc/Language.htm @@ -224,77 +224,77 @@ shown.</p> <h3><a name="Architectural_limits"></a>Architectural limits</h3> <blockquote><table> -<tr><th colspan="7">Architectural limits (corresponds to Adobe table B.1)</th></tr> +<tr><th colspan="4">Architectural limits (corresponds to Adobe table B.1)</th></tr> <tr valign="bottom"> <th align="left">Quantity</th> - <th> </th> + <th align="left">Limit</th> - <th> </th> + <th align="left">Type</th> - <th> </th> + <th align="left">Adobe</th></tr> <tr valign="top"> <td>integer</td> - <td> </td> + <td>32-bit</td> - <td> </td> + <td>twos complement integer</td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td>real</td> - <td> </td> + <td>single-precision</td> - <td> </td> + <td>IEEE float</td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td>array</td> - <td> </td> + <td>16777216</td> - <td> </td> + <td>elements</td> - <td> </td> + <td>65535</td></tr> <tr valign="top"> <td>dictionary</td> - <td> </td> + <td>16777215</td> - <td> </td> + <td>elements</td> - <td> </td> + <td>65535</td></tr> <tr valign="top"> <td>string</td> - <td> </td> + <td>16777216</td> - <td> </td> + <td>characters</td> - <td> </td> + <td>65535</td></tr> <tr valign="top"> <td>name</td> - <td> </td> + <td>16383</td> - <td> </td> + <td>characters</td> - <td> </td> + <td>127</td></tr> <tr valign="top"> <td>filename</td> - <td> </td> + <td>128*</td> - <td> </td> + <td>characters</td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td><code>save</code> level</td> - <td> </td> + <td>none</td> - <td> </td> + <td>(capacity of memory)</td> - <td> </td> + <td>15</td></tr> <tr valign="top"> <td><code>gsave</code> level</td> - <td> </td> + <td>none</td> - <td> </td> + <td>(capacity of memory)</td> - <td> </td> + <td>13</td></tr> </table></blockquote> @@ -306,96 +306,96 @@ starts with a %...% IODevice designation, or 124 characters if it does not.</p> <blockquote><table> -<tr><th colspan="7">Memory limits (corresponds to Adobe table B.2)</th></tr> +<tr><th colspan="4">Memory limits (corresponds to Adobe table B.2)</th></tr> <tr valign="bottom"> <th align="left">Quantity</th> - <th> </th> + <th align="left">Limit</th> - <th> </th> + <th align="left">Type</th> - <th> </th> + <th align="left">Adobe</th></tr> <tr valign="top"> <td><code>userdict</code></td> - <td> </td> + <td>200</td> + <td> </td> - <td> </td> - <td> </td> + <td> </td></tr> <tr valign="top"> <td><code>FontDirectory</code></td> - <td> </td> + <td>100</td> <td> </td> + <td> </td> - <td> </td> - <td> </td></tr> + </tr> <tr valign="top"> <td>operand stack</td> - <td> </td> + <td>800</td> + <td> </td> - <td> </td> - <td> </td> + <td>500</td></tr> <tr valign="top"> <td>dictionary stack</td> - <td> </td> + <td>20</td> <td> </td> + <td> </td> - <td> </td> - <td> </td></tr> + </tr> <tr valign="top"> <td>execution stack</td> - <td> </td> + <td>250</td> - <td> </td> - <td> </td></tr> + + <td> </td><td> </td></tr> <tr valign="top"> <td>interpreter level</td> - <td> </td> + <td>none</td> - <td> </td> + <td>(capacity of memory)</td> - <td> </td> + <td>10</td></tr> <tr valign="top"> <td>path</td> - <td> </td> + <td>none</td> - <td> </td> + <td>(capacity of memory)</td> - <td> </td> + <td>1500</td></tr> <tr valign="top"> <td>dash</td> - <td> </td> + <td>11</td> <td> </td> - <td> </td> - <td> </td> + + <td> </td></tr> <tr valign="top"> <td>VM</td> - <td> </td> + <td>none</td> - <td> </td> + <td>(capacity of memory)</td> - <td> </td> + <td>240000</td></tr> <tr valign="top"> <td>file</td> - <td> </td> + <td>none</td> - <td> </td> + <td>(determined by operating system)</td> - <td> </td> + <td>6</td></tr> <tr valign="top"> <td>image</td> - <td> </td> + <td>65535</td> - <td> </td> + <td>values (samples × components)<br>for 1-, 2-, 4-, or 8-bit samples</td> - <td> </td> + <td>3300</td></tr> <tr valign="top"> <td> </td> - <td> </td> + <td>32767</td> - <td> </td> + <td>values for 12-bit samples</td> - <td> </td> + <td>3300</td></tr> </table></blockquote> @@ -847,10 +847,10 @@ that resides in the /Root directory.</p> <blockquote><table> <tr valign="bottom"> <th valign="bottom" align="left">Flag</th> - <th> </th> + <th valign="bottom" align="left">Definition</th></tr> <tr valign="top"> <td>DELAYBIND</td> - <td> </td> + <td>returns the argument, stores the argument for later use by <code>.bindnow</code></td></tr> </table></blockquote> @@ -1123,16 +1123,16 @@ These are interpreted as:</p> <blockquote><table> <tr valign="bottom"> <th valign="bottom" align="left">Palette</th> - <th> </th> + <th valign="bottom" align="left">Bits allocated per color</th></tr> <tr valign="top"> <td>16</td> - <td> </td> + <td>5 red, 6 green, 5 blue</td></tr> <tr valign="top"> <td>24</td> - <td> </td> + <td>8 red, 8 green, 8 blue</td></tr> <tr valign="top"> <td>32</td> - <td> </td> + <td>8C, 8M, 8Y, 8K</td></tr> </table></blockquote> @@ -1326,32 +1326,32 @@ See the Adobe <a href="http://partners.adobe.com/public/developer/pdf/index_refe graphics format</a>. Recognized keys are:</p> <blockquote><table> -<tr><th colspan="5">Keys recognized in PNG filter algorithms</th></tr> +<tr><th colspan="3">Keys recognized in PNG filter algorithms</th></tr> <tr valign="bottom"> <th align="left">Key</th> - <th> </th> + <th align="left">Range</th> - <th> </th> + <th align="left">Default</th></tr> <tr valign="top"> <td><code>Colors <integer></code></td> - <td> </td> + <td>1 to 16</td> - <td> </td> + <td>16</td></tr> <tr valign="top"> <td><code>BitsPerComponent <integer></code></td> - <td> </td> + <td>1, 2, 4, 8, or 16</td> - <td> </td> + <td>8</td></tr> <tr valign="top"> <td><code>Columns <integer></code></td> - <td> </td> + <td>>= 0</td> - <td> </td> + <td>1</td></tr> <tr valign="top"> <td><code>Predictor <integer></code></td> - <td> </td> + <td>10 to 15</td> - <td> </td> + <td>15</td></tr> </table></blockquote> @@ -2115,70 +2115,66 @@ calling sequence</p> <blockquote><table> <tr valign="bottom"> <th align="left">Function</th> - <th> </th> + <th align="left">Calls</th> - <th> </th> + <th align="left">Calls</th> - <th> </th> + <th align="left">Calls</th></tr> <tr valign="top"> <td>runpdf</td> - <td> </td> + <td>runpdfbegin</td> - <td> </td> + <td>pdfopen</td> - <td> </td> + <td> </td></tr> <tr valign="top"> - <td> </td> + <td> </td> <td>process_trailer_attrs</td> + <td> </td> - <td> </td></tr> -<tr valign="top"> <td> </td> +</tr> +<tr valign="top"> + <td> </td> <td>runpdfpagerange</td> - <td> </td> - <td> </td> + + <td> </td> <td> </td></tr> <tr valign="top"> - <td> </td> + <td> </td> <td>dopdfpages</td> - <td> </td> + <td>pdfgetpage</td> <td> </td></tr> <tr valign="top"> <td> </td> <td> </td> - <td> </td> - <td> </td> <td>pdfshowpage</td> - <td> </td> + <td>pdfshowpage_init</td></tr> <tr valign="top"> - <td> </td> - <td> </td> - <td> </td> + <td> </td> <td> </td> <td> </td> <td>pdfshowpage_setpage</td></tr> <tr valign="top"> - <td> </td> - <td> </td> - <td> </td> + <td> </td> <td> </td> <td> </td> <td>pdfshowpage_finish</td></tr> <tr valign="top"> - <td> </td> + <td> </td> <td>runpdfend</td> - <td> </td> + <td>pdfclose</td> <td> </td></tr> </table></blockquote> diff --git a/doc/Lib.htm b/doc/Lib.htm index 4b42f5a05..4f787cbc7 100644 --- a/doc/Lib.htm +++ b/doc/Lib.htm @@ -113,65 +113,65 @@ inverted control structure. <blockquote><table> <tr> <th align="left">Section<br>(operators)</th> - <th> </th> + <th align="left">Headers</th> - <th> </th> + <th align="left">Omissions</th> </tr> <tr> <td>Graphics state – device-independent</td> - <td> </td> + <td><code>gscolor.h</code>(<code>gsstate.h</code>)<br><code>gscolor1.h</code><br><code>gscolor2.h</code><br><code>gscspace.h</code><br><code>gshsb.h</code><br><code>gsline.h</code>(<code>gsstate.h</code>)<br><code>gsstate.h</code></td> - <td> </td> + <td> </td> </tr> <tr> <td>Graphics state – device-dependent</td> - <td> </td> + <td><code>gscolor.h</code>(<code>gsstate.h</code>)<br><code>gscolor1.h</code><br><code>gscolor2.h</code><br><code>gsht.h</code>(<code>gsht1.h</code>,<code>gsstate.h</code>)<br><code>gsht1.h</code><br><code>gsline.h</code>(<code>gsstate.h</code>)</td> - <td> </td> + <td> </td> </tr> <tr> <td>Coordinate system and matrix</td> - <td> </td> + <td><code>gscoord.h</code><br><code>gsmatrix.h</code></td> - <td> </td> + <td><code>*matrix</code>, <code>*identmatrix</code>, <code>*concatmatrix</code>, <code>*invertmatrix</code></td> </tr> <tr> <td>Path construction</td> - <td> </td> + <td><code>gspath.h</code><br><code>gspath2.h</code></td> - <td> </td> + <td><code>*arct</code>, <code>*pathforall</code>, <code>ustrokepath</code>, <code>uappend</code>, <code>upath</code>, <code>ucache</code></td> </tr> <tr> <td>Painting</td> - <td> </td> + <td><code>gsimage.h</code><br><code>gspaint.h</code><br><code>gspath2.h</code></td> - <td> </td> + <td><code>*image</code>, <code>*colorimage</code>, <code>*imagemask</code>, <code>ufill</code>, <code>ueofill</code>, <code>ustroke</code></td> </tr> <tr> <td>Form and pattern</td> - <td> </td> + <td><code>gscolor2.h</code></td> - <td> </td> + <td><code>execform</code></td> </tr> <tr> <td>Device setup and output</td> - <td> </td> + <td><code>gsdevice.h</code></td> - <td> </td> + <td><code>*showpage</code>, <code>*set</code>/<code>currentpagedevice</code></td> </tr> <tr> <td>Character and font</td> - <td> </td> + <td><code>gschar.h</code><br><code>gsfont.h</code></td> - <td> </td> + <td>*(all the <code>show</code> operators), <code>definefont</code>, <code>undefinefont</code>, <code>findfont</code>, <code>*scalefont</code>, <code>*makefont</code>, <code>selectfont</code>, <code>[Global]FontDirectory</code>, <code>Standard</code>/<code>ISOLatin1Encoding</code>, <code>findencoding</code></td> </tr> </table></blockquote> @@ -255,23 +255,23 @@ sections of the Manual: <blockquote><table> <tr> <th align="left">Section<br>(operators)</th> - <th> </th> + <th align="left">Headers</th> - <th> </th> + <th align="left">Operators</th> </tr> <tr> <td>Interpreter parameter</td> - <td> </td> + <td><code>gsfont.h</code></td> - <td> </td> + <td><code>cachestatus</code>, <code>setcachelimit</code>, <code>*set/currentcacheparams</code></td> </tr> <tr> <td>Display PostScript</td> - <td> </td> + <td><code>gsstate.h</code></td> - <td> </td> + <td><code>set/currenthalftonephase</code></td> </tr> </table></blockquote> @@ -310,27 +310,27 @@ using the color are two separate operations. <blockquote><table> <tr> <td><code>gs_client_color *</code></td> - <td> </td> + <td>The resulting <code>Pattern</code> color is stored here. This is different from PostScript, which has no color objects <em>per se</em>, and hence returns a modified copy of the dictionary.</td> </tr> <tr> <td><code>const gs_client_pattern *</code></td> - <td> </td> + <td>The analogue of the original <code>Pattern</code> dictionary, described in detail just below.</td> </tr> <tr> <td><code>const gs_matrix *</code></td> - <td> </td> + <td>Corresponds to the matrix argument of the <code>makepattern</code> operator.</td> </tr> <tr> <td><code>gs_state *</code></td> - <td> </td> + <td>The current graphics state.</td> </tr> <tr> <td><code>gs_memory_t *</code></td> - <td> </td> + <td>The allocator to use for allocating the saved data for the <code>Pattern</code> color. If this is <code>NULL</code>, <code>gs_makepattern</code> uses the @@ -437,271 +437,272 @@ The following table explains the semantics of Visual Trace instructions. <table> <tr> - <th colspan="5">Visual Trace instructions</th> + <th colspan="3">Visual Trace instructions</th> </tr> <tr> <th align="left">Instruction</th> - <th> </th> + <th align="left">Function</th> - <th> </th> + <th align="left">Parameters</th> </tr> <tr> <td><code>vd_get_dc</code></td> - <td> </td> + <td>Obtain drawing context</td> - <td> </td> + <td><code>-T</code> option flag value, for which the subsequent output is enabled.</td> </tr> <tr> <td><code>vd_release_dc</code></td> - <td> </td> + <td>Release drawing context</td> - <td> </td> + <td> </td> </tr> <tr> <td><code>vd_enabled</code></td> - <td> </td> + <td>Is trace currently enabled ?</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_get_size_unscaled_x</code></td> - <td> </td> + <td>Get the horizontal size of the output window in pixels.</td> - <td> </td> + <td></td> </tr> - <tr> <td><code>vd_get_size_unscaled_y</code></td> - <td> </td> + <tr><td><code>vd_get_size_unscaled_y</code></td> + <td>Get the vertical size of the output window in pixels.</td> - <td> </td> + <td></td></tr> <tr> <td><code>vd_get_size_caled_x</code></td> - <td> </td> + <td>Get the horizontal size of the output window in debuggee coordinate units.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_get_size_caled_y</code></td> - <td> </td> + <td>Get the vertical size of the output window in debuggee coordinate units.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_get_scale_x</code></td> - <td> </td> + <td>Get the horizontal scale.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_get_scale_y</code></td> - <td> </td> + <td>Get the vertical scale.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_get_origin_x</code></td> - <td> </td> + <td>Get the horizontal position of the draft origin in debuggee coordinate space.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_get_origin_y</code></td> - <td> </td> + <td>Get the vertical position of the draft origin in debuggee coordinate space.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_set_scale(s)</code></td> - <td> </td> + <td>Set isotripic scale.</td> - <td> </td> + <td>Debugee space to window space mapping scale, same for both dimentions.</td> </tr> <tr> <td><code>vd_set_scaleXY(sx,sy)</code></td> - <td> </td> + <td>Set anisotripic scale.</td> - <td> </td> + <td>Debugee space to window space mapping scale, one for each dimention.</td> </tr> <tr> <td><code>vd_set_origin(x,y)</code></td> - <td> </td> + <td>Set the draft origin.</td> - <td> </td> + <td>Origin of the draft in debugee space.</td> </tr> <tr> <td><code>vd_set_shift(x,y)</code></td> - <td> </td> + <td>Set the draft position.</td> - <td> </td> + <td>Position of the draft origin in window space (in pixels).</td> </tr> -<tr> <td><code>vd_set_central_shift</code></td> - <td> </td> +<tr><td><code>vd_set_central_shift</code></td> + <td>Set the draft position to window center.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_erase(c)</code></td> - <td> </td> + <td>Fill entire window.</td> - <td> </td> + <td>Color to fill.</td> </tr> <tr> <td><code>vd_beg_path</code></td> - <td> </td> + <td>Begin path construction.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_end_path</code></td> - <td> </td> + <td>End path construction.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_moveto(x,y)</code></td> - <td> </td> + <td>Path construction : Set the draft current point.</td> - <td> </td> + <td>Debugee coordinates.</td> </tr> <tr> <td><code>vd_lineto(x,y)</code></td> - <td> </td> + <td>Path construction : Line from current point to specified point.</td> - <td> </td> + <td>Debugee coordinates.</td> </tr> <tr> <td><code>vd_lineto_mupti(p,n)</code></td> - <td> </td> + <td>Path construction : Poliline from current point to specified points.</td> - <td> </td> + <td>Array of points and its size, debugee coordinates.</td> </tr> <tr> <td><code>vd_curveto(x0,y0,x1,y1,x2,y2)</code></td> - <td> </td> + <td>Path construction : Curve (3rd-order Bezier) from current point to specified point, with specified poles.</td> - <td> </td> + <td>2 poles and the curve ending point, debuggee coordinates.</td> </tr> <tr> <td><code>vd_closepath</code></td> - <td> </td> + <td>Path construction : Close the path (is necessary for filling an area).</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_bar(x0,y0,x1,y1,w,c)</code></td> - <td> </td> + <td>Bar from point to point.</td> - <td> </td> + <td>2 points (debugee coordinates), width (in pixels) and color.</td> </tr> <tr> <td><code>vd_square(x0,y0,w,c)</code></td> - <td> </td> + <td>Square with specified center and size.</td> - <td> </td> + <td>The center (debugee coordinates), size (in pixels) and color.</td> </tr> <tr> <td><code>vd_rect(x0,y0,x1,y1,w,c)</code></td> - <td> </td> + <td>Canonic rectangle with specified coordinites.</td> - <td> </td> + <td>Coordinates of boundaries (debugee coordinates), line width (in pixels) and color.</td> </tr> <tr> <td><code>vd_quad(x0,y0,x1,y1,x2,y2,x3,y3,w,c)</code></td> - <td> </td> + <td>Quadrangle with specified coordinites.</td> - <td> </td> + <td>Coordinates of vertices (debugee coordinates), line width (in pixels) and color.</td> </tr> <tr> <td><code>vd_curve(x0,y0,x1,y1,x2,y2,x3,y3,c,w)</code></td> - <td> </td> + <td>Curve with width.</td> - <td> </td> + <td>4 curve poles (debugee coordinates), color, and width (in pixels).</td> </tr> -<tr> <td><code>vd_circle(x,y,r,c)</code></td> - <td> </td> +<tr> + <td><code>vd_circle(x,y,r,c)</code></td> + <td>Circle.</td> - <td> </td> + <td>Center (debugee coordinates), radius (in pixels) and color.</td> </tr> <tr> <td><code>vd_round(x,y,r,c)</code></td> - <td> </td> + <td>Filled circle.</td> - <td> </td> + <td>Center (debugee coordinates), radius (in pixels) and color.</td> </tr> <tr> <td><code>vd_stroke</code></td> - <td> </td> + <td>Stroke a path constructed with vd_beg_path, vd_moveto, vd_lineto, vd_curveto, vd_closepath, vd_end_path.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_fill</code></td> - <td> </td> + <td>Fill a path constructed with vd_beg_path, vd_moveto, vd_lineto, vd_curveto, vd_closepath, vd_end_path.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>vd_setcolor(c)</code></td> - <td> </td> + <td>Set a color.</td> - <td> </td> + <td>Color (an integer consisting of red, green, blue bytes).</td> </tr> <tr> <td><code>vd_setlinewidth(w)</code></td> - <td> </td> + <td>Set line width.</td> - <td> </td> + <td>Width (in pixels).</td> </tr> <tr> <td><code>vd_text(x,y,s,c)</code></td> - <td> </td> + <td>Paint a text.</td> - <td> </td> + <td>Origin point (debugee coordinates), a string, and a color.</td> </tr> <tr> <td><code>vd_wait</code></td> - <td> </td> + <td>Delay execution until a resuming command is entered through user interface.</td> - <td> </td> + <td></td> </tr> </table> @@ -718,177 +719,177 @@ the structure <code>vd_trace_interface</code>, explained in the table below. <table> <tr> - <th colspan="5">vd_trace_interface structure</th> + <th colspan="3">vd_trace_interface structure</th> </tr> <tr> <th align="left">Field</th> - <th> </th> + <th align="left">Purpose</th> - <th> </th> + <th align="left">Parameters</th> </tr> <tr> <td><code>host</code></td> - <td> </td> + <td>A pointer to the rasterizer control block - to be provided by client application. The type of the fild is client dependent.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>scale_x, scale_y</code></td> - <td> </td> + <td>Scale of debugee coordinate to window coordinate mapping - internal work data, don't change.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>orig_x, orig_y</code></td> - <td> </td> + <td>Draft origin in debugee coordinates - internal work data, don't change.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>shift_x, shift_y</code></td> - <td> </td> + <td>Draft shift in window coordinates - internal work data, don't change.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>get_size_x(I)</code></td> - <td> </td> + <td>Get window width in pixels.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>get_size_y(I)</code></td> - <td> </td> + <td>Get window height in pixels.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>get_dc(I,I1)</code></td> - <td> </td> + <td>Obtain drawing context.</td> - <td> </td> + <td>Pointer to interface block, and pointer to copy of the pointer. Implementation must set *I1 if it succeeds to get a drawing context.</td> </tr> <tr> <td><code>release_dc(I,I1)</code></td> - <td> </td> + <td>Release drawing context.</td> - <td> </td> + <td>Pointer to interface block, and pointer to copy of the pointer. Implementation must reset *I1 if it succeeds to release the drawing context.</td> </tr> <tr> <td><code>erase(I,c)</code></td> - <td> </td> + <td>Erase entire window.</td> - <td> </td> + <td>Background color.</td> </tr> <tr> <td><code>beg_path(I)</code></td> - <td> </td> + <td>Begin path construction.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>end_path(I)</code></td> - <td> </td> + <td>End path construction.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>moveto(I,x,y)</code></td> - <td> </td> + <td>Set current point.</td> - <td> </td> + <td>A point in window coordinates.</td> </tr> <tr> <td><code>lineto(I,x,y)</code></td> - <td> </td> + <td>Line from current point to specified point.</td> - <td> </td> + <td>A point in window coordinates.</td> </tr> <tr> <td><code>curveto(I,x0,y0,x1,y1,x2,y2)</code></td> - <td> </td> + <td>Curve from current point with specified poles to specified point.</td> - <td> </td> + <td>3 points in window coordinates.</td> </tr> <tr> <td><code>closepath(I)</code></td> - <td> </td> + <td>Close the path.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>circle(I,x,y,r)</code></td> - <td> </td> + <td>Circle.</td> - <td> </td> + <td>Center and radius, window coordinates.</td> </tr> <tr> <td><code>round(I,x,y,r)</code></td> - <td> </td> + <td>Filled circle.</td> - <td> </td> + <td>Center and radius, window coordinates.</td> </tr> <tr> <td><code>fill(I)</code></td> - <td> </td> + <td>Fill the path.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>stroke(I)</code></td> - <td> </td> + <td>Stroke the path.</td> - <td> </td> + <td></td> </tr> <tr> <td><code>setcolor(I,c)</code></td> - <td> </td> - <td>Set color.</td> - <td> </td> + + <td>Set color.</td> + <td>An integer, consisting of red, green, blue bytes.</td> </tr> <tr> <td><code>setlinewidth(I,w)</code></td> - <td> </td> + <td>Set line width.</td> - <td> </td> + <td>Line width in pixels.</td> </tr> <tr> <td><code>text(I,x,y,s)</code></td> - <td> </td> + <td>Draw a text.</td> - <td> </td> + <td>Coodrinates in pixels, and a string.</td> </tr> <tr> <td><code>wait(I)</code></td> - <td> </td> + <td>Delay execution untill resume command is inputted from user.</td> - <td> </td> + <td></td> </tr> </table> diff --git a/doc/Make.htm b/doc/Make.htm index 5bc71ec1f..6548eee60 100644 --- a/doc/Make.htm +++ b/doc/Make.htm @@ -295,14 +295,14 @@ source, make the <b><em>parent</em></b> of the (new) gs directory the current di <blockquote><table> <tr><th align="left" valign="top">2-step:</th> - <td> </td> + <td><code>gzip -d ghostscript-</code>#.##<code>.tar.gz</code><br><code>tar -xf ghostscript-</code>#.##<code>.tar</code></td></tr> <tr><th align="left" valign="top">Pipe:</th> - <td> </td> + <td><code>gzip -d -c ghostscript-</code>#.##<code>.tar.gz | tar -xf -</code></td></tr> <tr><th align="left" valign="top">GNU tar:</th> - <td> </td> + <td><code>tar -zxf ghostscript-</code>#.##<code>.tar.gz</code></td></tr> </table></blockquote> @@ -311,48 +311,47 @@ All the Ghostscript source files are now in subdirectories of the gs directory.</p> <blockquote><table> - <tr><th colspan="5">Ghostscript Core Source subdirectories</th></tr> + <tr><th colspan="2">Ghostscript Core Source subdirectories</th></tr> <tr><th valign="bottom" align="left">Subdirectory</th> - <th> </th> <th valign="bottom" align="left">Contents</th></tr> <tr><td><code>arch/</code></td> - <td> </td> + <td>Pre-defined architecture header files</td></tr> <tr><td><code>base/</code></td> - <td> </td> + <td>Graphics library C source code and makefiles</td></tr> <tr><td><code>contrib/</code></td> - <td> </td> + <td>Community contributed/supported output devices</td></tr> <tr><td><code>devices/</code></td> - <td> </td> + <td>The output devices supported by the Ghostscript team</td></tr> <tr><td><code>psi/</code></td> - <td> </td> + <td>PS interpreter C source code and makefiles</td></tr> <tr><td><code>Resource/</code></td> - <td> </td> + <td>Postscript initialization, resource and font files</td></tr> <tr><td><code>lib/</code></td> - <td> </td> + <td>PostScript utilities and scripts used with Ghostscript</td></tr> <tr><td><code>doc/</code></td> - <td> </td> + <td>Documentation</td></tr> <tr><td><code>man/</code></td> - <td> </td> + <td>Unix <code>man</code> pages</td></tr> <tr><td><code>examples/</code></td> - <td> </td> + <td>Sample PostScript files</td></tr> <tr><td><code>iccprofiles/</code></td> - <td> </td> + <td>Default set of ICC profiles</td></tr> <tr><td><code>windows/</code></td> - <td> </td> + <td>Visual Studio for Windows specific project and solution files</td></tr> <tr><td><code>toolbin/</code></td> - <td> </td> + <td>Useful (non-Postscript) tools, mostly for developer use only</td></tr> </table> </blockquote> @@ -360,15 +359,15 @@ directory.</p> <p>Optionally, if you downloaded the GhostPDL archive, you may also have:</p> <blockquote><table> -<tr><th colspan="5">Additional GhostPDL source subdirectories</th></tr> +<tr><th colspan=2>Additional GhostPDL source subdirectories</th></tr> <tr><th valign="bottom" align="left">Subdirectory</th> - <th> </th> + <th valign="bottom" align="left">Contents</th></tr> <tr><td><code>pcl/</code></td> - <td> </td> + <td>PCL/PXL interpreter C source code, makefiles, fonts etc</td></tr> <tr><td><code>xps/</code></td> - <td> </td> + <td>XPS interpreter C source code and makefiles</td></tr> </table> </blockquote> @@ -432,21 +431,21 @@ Fortunately, the only makefiles you're likely to want to change are relatively small ones containing platform-specific information.</p> <blockquote><a name="Platform-specific_makefiles"></a><table> - <tr><th colspan="3">Platform-specific makefiles</th></tr> + <tr><th colspan="2">Platform-specific makefiles</th></tr> <tr><th align="left">Makefile</th> - <th> </th> + <th align="left">Used for</th></tr> <tr><td><code>Makefile.in</code></td> - <td> </td> + <td>Template makefile for the autoconf build</td></tr> <tr><td><code>psi/msvc.mak</code></td> - <td> </td> + <td>MS Windows with Microsoft Visual Studio 2003 and later.</td></tr> <tr><td><code>base/unix-gcc.mak</code></td> - <td> </td> + <td>Unix with gcc</td></tr> <tr><td><code>base/unixansi.mak</code></td> - <td> </td> + <td>Unix with ANSI C compilers other than gcc</td></tr> </table> </blockquote> @@ -811,21 +810,21 @@ All Ghostscript builds in PC (DOS and MS Windows) environments are 32- or 64-bit: 16-bit builds are not supported. The relevant makefiles are</p> <blockquote><table> - <tr><th colspan="5">PC makefiles</th></tr> + <tr><th colspan="3">PC makefiles</th></tr> <tr><th align="left">Makefile</th> - <th> </th> + <th align="left">Construction tools</th> - <th> </th> + <th align="left">For environment</th></tr> <tr><td valign="top"><code>msvc.mak</code></td> - <td> </td> + <td valign="top"><a href="#Microsoft_build">Microsoft Visual Studio .NET 2003 (or later)</a></td> - <td> </td> + <td valign="top">MS Windows 32/64-bit</td></tr> <tr><td valign="top"><code>Makefile.in</code></td> - <td> </td> + <td valign="top"><a href="#Cygwin_build">Cygwin/gcc</a></td> - <td> </td> + <td valign="top"><a href="https://www.cygwin.com/">Cygwin</a> (Use Unix <code>configure</code>)</td></tr> </table></blockquote> diff --git a/doc/Ps2epsi.htm b/doc/Ps2epsi.htm index 1e2c36d22..2c449a704 100644 --- a/doc/Ps2epsi.htm +++ b/doc/Ps2epsi.htm @@ -139,31 +139,31 @@ encapsulation fails because of the nature of the original PostScript file. <blockquote><table> <tr> - <th colspan="3">ps2epsi files</th> + <th colspan="2">ps2epsi files</th> </tr> <tr> <th align="left">File</th> - <th> </th> + <th align="left">Contents</th> </tr> <tr> <td><code>ps2epsi.htm</code></td> - <td> </td> + <td>This document</td> </tr> <tr> <td><code>ps2epsi.bat</code></td> - <td> </td> + <td>MS-DOS batch file</td> </tr> <tr> <td><code>ps2epsi</code></td> - <td> </td> + <td>Unix shell script</td> </tr> <tr> <td><code>ps2epsi.ps</code></td> - <td> </td> + <td>Ghostscript program which does the work</td> </tr> </table></blockquote> diff --git a/doc/Source.htm b/doc/Source.htm index 607340c82..6d5e03152 100644 --- a/doc/Source.htm +++ b/doc/Source.htm @@ -61,60 +61,60 @@ The Ghostscript source code is divided conceptually as follows: <blockquote><table> <tr> <a href="#PostScript_interpreter"></a> - <th align="left" colspan="4">PostScript interpreter:</th> + <th align="left" colspan="2">PostScript interpreter:</th> </tr> <tr> - <td> </td> + <td>PostScript operators</td> - <td> </td> + <td><code>z</code>*<code>.h</code> and <code>z</code>*<code>.c</code></td> </tr> <tr> - <td> </td> + <td>Other interpreter code</td> - <td> </td> + <td><code>i</code>*<code>.h</code> and <code>i</code>*<code>.c</code></td> </tr> <tr> - <td> </td> + <td>PostScript code</td> - <td> </td> + <td><code>gs_</code>*<code>.ps</code></td> </tr> <tr> <a href="#PDF_interpreter"></a> - <th align="left" colspan="4">PDF interpreter:</th> + <th align="left" colspan="2">PDF interpreter:</th> </tr> <tr> - <td> </td> + <td>PostScript code</td> - <td> </td> + <td><code>pdf_</code>*<code>.ps</code></td> </tr> <tr> <a href="#Graphics_library"></a> - <th align="left" colspan="4">Graphics library:</th> + <th align="left" colspan="2">Graphics library:</th> </tr> <tr> - <td> </td> + <td>Main library code</td> - <td> </td> + <td><code>g</code>*<code>.h</code> and <code>g</code>*<code>.c</code></td> </tr> <tr> - <td> </td> + <td>Streams</td> - <td> </td> + <td><code>s</code>*<code>.h</code> and <code>s</code>*<code>.c</code></td> </tr> <tr> - <td> </td> + <td><a href="#Drivers">Device drivers</a></td> - <td> </td> + <td><code>gdev</code>*<code>.h</code> and <code>gdev</code>*<code>.c</code></td> </tr> <tr> - <td> </td> + <td><a href="#Platform_specific_code">Platform-specific code</a></td> - <td> </td> + <td><code>gp</code>*<code>.h</code> and <code>gp</code>*<code>.c</code></td> </tr> </table></blockquote> @@ -246,71 +246,61 @@ The platform-specific implementations of the <blockquote><table> <tr> - <th colspan="3">Platform-specific interfaces</th> + <th colspan="2">Platform-specific interfaces</th> </tr> <tr> <th align="left">Routine</th> - <th> </th> <th align="left">Platform</th> </tr> <tr> <td><code>gp_dosfb.c</code></td> - <td> </td> <td>DOS</td> </tr> <tr> <td><code>gp_dosfs.c</code></td> - <td> </td> <td>DOS and MS Windows</td> </tr> <tr> <td><code>gp_itbc.c</code></td> - <td> </td> <td>DOS, Borland compilers</td> </tr> <tr> <td><code>gp_iwatc.c</code></td> - <td> </td> <td>DOS, Watcom or Microsoft compiler</td> </tr> <tr> <td><code>gp_msdos.c</code></td> - <td> </td> <td>DOS and MS Windows</td> </tr> <tr> <td><code>gp_ntfs.c</code></td> - <td> </td> <td>MS Windows NT</td> </tr> <tr> <td><code>gp_os2.c</code></td> - <td> </td> <td>OS/2</td> </tr> <tr> <td><code>gp_os9.c</code></td> - <td> </td> <td>OS-9</td> </tr> <tr> <td><code>gp_unifs.c</code></td> - <td> </td> <td>Unix, OS-9, and QNX</td> </tr> <tr> <td><code>gp_unix.c</code></td> - <td> </td> + <td>Unix and QNX</td> </tr> <tr> <td><code>gp_vms.c</code></td> - <td> </td> + <td>VMS</td> </tr> <tr> <td><code>gp_win32.c</code></td> - <td> </td> + <td>MS Windows NT</td> </tr> </table></blockquote> diff --git a/doc/Use.htm b/doc/Use.htm index 127511ae2..9b2607a9f 100644 --- a/doc/Use.htm +++ b/doc/Use.htm @@ -253,10 +253,10 @@ 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>gswin32.exe</code></td> - <td><code>gswin32c.exe</code></td> - <td><code>gswin64.exe</code></td> - <td><code>gswin64c.exe</code></td> + <td><code>gswin32.exe</code><br/> + <code>gswin32c.exe</code><br/> + <code>gswin64.exe</code><br/> + <code>gswin64c.exe</code></td> </tr> <tr><td>OS/2</td> <td><code>gsos2</code></td></tr> @@ -950,21 +950,21 @@ files named on the command line, and resource files, Ghostscript first tests whe file name specifies an absolute path.</p> <blockquote><table> -<tr><th colspan="3">Testing a file name for an absolute path</th></tr> +<tr><th colspan="2">Testing a file name for an absolute path</th></tr> <tr><th align="left">System</th> - <th> </th> + <th align="left">Does the name ...</th></tr> -<tr><td colspan="3"></td></tr> +<tr><td colspan="2"></td></tr> <tr><td valign="top">Unix</td> - <td> </td> + <td>Begin with <code><u>/</u></code> ?</td></tr> <tr><td valign="top">MS Windows</td> - <td> </td> + <td>Have <code><u>:</u></code> as its second character, or begin with <code><u>/</u></code>, <code><u>\</u></code>, or <code><u>//servername/share/</u></code> ?</td></tr> <tr><td valign="top">VMS</td> - <td> </td> + <td>Contain a node, device, or root specification?</td></tr> </table></blockquote> @@ -1181,30 +1181,30 @@ from among the standard 35 fonts.</li> are found using a different method.</p> <blockquote><table> -<tr><th colspan="3">Differences between search path and font path</th></tr> +<tr><th colspan="2">Differences between search path and font path</th></tr> <tr><th>Search path</th> - <th> </th> + <th>Font path</th></tr> <tr><td><code>-I</code> switch</td> - <td> </td> + <td><code>-sFONTPATH=</code> switch</td></tr> <tr><td><code>GS_LIB</code> and <code>GS_LIB_DEFAULT</code> environment variables</td> - <td> </td> + <td><code>GS_FONTPATH</code> environment variable</td></tr> <tr><td valign="top">Consulted first</td> - <td> </td> + <td valign="top">Consulted only if search path and <code>FontResourceDir</code> don't provide the file.</td></tr> <tr><td valign="top">Font-name-to-file-name mapping given in Fontmap files; aliases are possible, and there need not be any relation between the font name in the Fontmap and the <code>FontName</code> in the file.</td> - <td> </td> <td valign="top">Font-name-to-file-name mapping is + <td valign="top">Font-name-to-file-name mapping is implicit – the <code>FontName</code> in the file is used. Aliases are not possible.</td></tr> <tr><td valign="top">Only fonts and files named in Fontmap are used.</td> - <td> </td> + <td valign="top">Every Type 1 font file in each directory is available; if TrueType fonts are supported (the <code>ttfont.dev</code> feature was included when the @@ -1219,64 +1219,64 @@ installed Type 1 (and, if supported, TrueType) fonts (but see below for notes on systems marked with "*"):</p> <blockquote><table> -<tr><th colspan="5">Suggested GS_FONTPATH for different systems</th></tr> +<tr><th colspan="3">Suggested GS_FONTPATH for different systems</th></tr> <tr><th> </th> - <th> </th> + <th align="left">System type</th> - <th> </th> + <th valign="bottom" align="left">GS_FONTPATH</th></tr> <tr><td> </td> - <td> </td> + <td valign="top">Digital Unix</td> - <td> </td> + <td><code>/usr/lib/X11/fonts/Type1Adobe</code></td></tr> <tr><td> </td> - <td> </td> + <td valign="top">Ultrix</td> - <td> </td> + <td><code>/usr/lib/DPS/outline/decwin</code></td></tr> <tr><td> </td> - <td> </td> + <td valign="top">HP-UX 9</td> - <td> </td> + <td><code>/usr/lib/X11/fonts/type1.st/typefaces</code></td></tr> <tr><td> </td> - <td> </td> + <td valign="top">IBM AIX</td> - <td> </td> + <td><code>/usr/lpp/DPS/fonts/outlines <br>/usr/lpp/X11/lib/X11/fonts/Type1 <br>/usr/lpp/X11/lib/X11/fonts/Type1/DPS</code></td></tr> <tr><td> </td> - <td> </td> + <td valign="top">NeXT</td> - <td> </td> + <td><code>/NextLibrary/Fonts/outline</code></td></tr> <tr><td>*</td> - <td> </td> + <td valign="top">SGI IRIX</td> - <td> </td> + <td><code>/usr/lib/DPS/outline/base <br>/usr/lib/X11/fonts/Type1</code></td></tr> <tr><td> </td> - <td> </td> + <td valign="top">SunOS 4.x<br>(NeWSprint only)</td> - <td> </td> + <td valign="top"><code>newsprint_2.5/SUNWsteNP/reloc/$BASEDIR/NeWSprint/<br> small_openwin/lib/fonts</code></td></tr> <tr><td>**</td> - <td> </td> + <td valign="top">SunOS 4.x</td> - <td> </td> + <td><code>/usr/openwin/lib/X11/fonts/Type1/outline</code></td></tr> <tr><td>**</td> - <td> </td> + <td valign="top">Solaris 2.x</td> - <td> </td> + <td><code>/usr/openwin/lib/X11/fonts/Type1/outline</code></td></tr> <tr><td> </td> - <td> </td> + <td valign="top">VMS</td> - <td> </td> + <td><code>SYS$COMMON:[SYSFONT.XDPS.OUTLINE]</code></td></tr> </table> @@ -1647,27 +1647,27 @@ especially for the searchability feature <h3><a name="Temp_files"></a>Temporary files</h3> <blockquote><table> -<tr><th colspan="5">Where Ghostscript puts temporary files</th></tr> +<tr><th colspan="3">Where Ghostscript puts temporary files</th></tr> <tr> <th align="left">Platform</th> - <th> </th> + <th align="left">Filename</th> - <th> </th> + <th align="left">Location</th></tr> <tr valign="top"> <td>MS Windows and OpenVMS</td> - <td> </td> + <td><code>_temp_</code>XX.XXX</td> - <td> </td> + <td>Current directory</td></tr> <tr valign="top"> <td>OS/2</td> - <td> </td> + <td><code>gs</code>XXXXXX</td> - <td> </td> + <td>Current directory</td></tr> <tr valign="top"> <td>Unix</td> - <td> </td> + <td><code>gs_</code>XXXXX</td> - <td> </td> + <td><code>/tmp</code></td></tr> </table></blockquote> @@ -1930,101 +1930,101 @@ Ghostscript looks for the following resources under the program name calculated from display metrics:</p> <blockquote><table> -<tr><th colspan="5">X Windows resources</th></tr> +<tr><th colspan="3">X Windows resources</th></tr> <tr><th align="left">Name</th> - <th> </th> + <th align="left">Class</th> - <th> </th> + <th align="left">Default</th></tr> <tr><td><code>background</code></td> - <td> </td> + <td><code>Background</code></td> - <td> </td> + <td><code>white</code></td></tr> <tr><td><code>foreground</code></td> - <td> </td> + <td><code>Foreground</code></td> - <td> </td> + <td><code>black</code></td></tr> <tr><td><code>borderColor</code></td> - <td> </td> + <td><code>BorderColor</code></td> - <td> </td> + <td><code>black</code></td></tr> <tr><td><code>borderWidth</code></td> - <td> </td> + <td><code>BorderWidth</code></td> - <td> </td> + <td><code>1</code></td></tr> <tr><td><code>geometry</code></td> - <td> </td> + <td><code>Geometry</code></td> - <td> </td> + <td><code>NULL</code></td></tr> <tr><td><code>xResolution</code></td> - <td> </td> + <td><code>Resolution</code></td> - <td> </td> + <td>**</td></tr> <tr><td><code>yResolution</code></td> - <td> </td> + <td><code>Resolution</code></td> - <td> </td> + <td>**</td></tr> <tr><td><code>useExternalFonts</code></td> - <td> </td> + <td><code>UseExternalFonts</code></td> - <td> </td> + <td><code>true</code></td></tr> <tr><td><code>useScalableFonts</code></td> - <td> </td> + <td><code>UseScalableFonts</code></td> - <td> </td> + <td><code>true</code></td></tr> <tr><td><code>logExternalFonts</code></td> - <td> </td> + <td><code>LogExternalFonts</code></td> - <td> </td> + <td><code>false</code></td></tr> <tr><td><code>externalFontTolerance</code></td> - <td> </td> + <td><code>ExternalFontTolerance</code></td> - <td> </td> + <td><code>10.0</code></td></tr> <tr><td><code>palette</code></td> - <td> </td> + <td><code>Palette</code></td> - <td> </td> + <td><code>Color</code></td></tr> <tr><td><code>maxGrayRamp</code></td> - <td> </td> + <td><code>MaxGrayRamp</code></td> - <td> </td> + <td><code>128</code></td></tr> <tr><td><code>maxRGBRamp</code></td> - <td> </td> + <td><code>MaxRGBRamp</code></td> - <td> </td> + <td><code>5</code></td></tr> <tr> <td><code>maxDynamicColors</code></td> - <td> </td> + <td><code>MaxDynamicColors</code></td> - <td> </td> + <td><code>256</code></td></tr> <tr><td><code>useBackingPixmap</code></td> - <td> </td> + <td><code>UseBackingPixmap</code></td> - <td> </td> + <td><code>true</code></td></tr> <tr><td><code>useXPutImage</code></td> - <td> </td> + <td><code>UseXPutImage</code></td> - <td> </td> + <td><code>true</code></td></tr> <tr><td><code>useXSetTile</code></td> - <td> </td> + <td><code>UseXSetTile</code></td> - <td> </td> + <td><code>true</code></td></tr> </table></blockquote> @@ -2036,9 +2036,9 @@ To set X resources, put them in a file (such as <code>~/.Xdefaults</code> on Unix) in a form like this:</li> <blockquote><table> - <tr><td><code>Ghostscript*geometry:</code></td><td><code> </code></td><td><code>595x842-0+0</code></td></tr> - <tr><td><code>Ghostscript*xResolution:</code></td><td><code> </code></td><td><code>72</code></td></tr> - <tr><td><code>Ghostscript*yResolution:</code></td><td><code> </code></td><td><code>72</code></td></tr> + <tr><td><code>Ghostscript*geometry:</code></td><td><code>595x842-0+0</code></td></tr> + <tr><td><code>Ghostscript*xResolution:</code></td><td><code>72</code></td></tr> + <tr><td><code>Ghostscript*yResolution:</code></td><td><code>72</code></td></tr> </table></blockquote> <p> @@ -3683,25 +3683,25 @@ in that it now supports (although does not enforce) case sensitivity. Four command line parameters permit explicit control of the paths included in the access control lists: <ul> -<li><dt><code>--permit-file-read=<code><em>pathlist</em></dt> +<li><dt><code>--permit-file-read=</code><em>pathlist</em></dt> <p> Adds a path, or list of paths, to the "permit read" list. A list of paths is a series of paths separated by the appropriate path list separator for your platform (for example, on Unix-like systems it is ":" and on MS Windows it is ";"). </li> -<li><dt><code>--permit-file-write=<code><em>pathlist</em></dt> +<li><dt><code>--permit-file-write=</code><em>pathlist</em></dt> <p> Adds a path, or list of paths, to the "permit write" list. A list of paths is a series of paths separated by the appropriate path list separator for your platform (for example, on Unix-like systems it is ":" and on MS Windows it is ";"). </li> -<li><dt><code>--permit-file-control=<code><em>pathlist</em></dt> +<li><dt><code>--permit-file-control=</code><em>pathlist</em></dt> <p> Adds a path, or list of paths, to the "permit control" list. A list of paths is a series of paths separated by the appropriate path list separator for your platform (for example, on Unix-like systems it is ":" and on MS Windows it is ";"). </li> -<li><dt><code>--permit-file-all=<code><em>pathlist</em></dt> +<li><dt><code>--permit-file-all=</code><em>pathlist</em></dt> <p> Adds a path, or list of paths, to the all the above lists. A list of paths is a series of paths separated by the appropriate path list separator for your platform (for example, on Unix-like systems it is ":" @@ -3906,20 +3906,20 @@ needed to investigate particular areas. For backward compatibilty, the <code>-dDEBUG</code> option will set all of the subset switches.</p> <table> - <tr><td><code>-dCCFONTDEBUG</code></td><td></td><td>Compiled Fonts</td></tr> - <tr><td><code>-dCFFDEBUG</code></td><td></td><td>CFF Fonts</td></tr> - <tr><td><code>-dCMAPDEBUG</code></td><td></td><td>CMAP</td></tr> - <tr><td><code>-dDOCIEDEBUG</code></td><td></td><td>CIE color</td></tr> - <tr><td><code>-dEPSDEBUG</code></td><td></td><td>EPS handling</td></tr> - <tr><td><code>-dFAPIDEBUG</code></td><td></td><td>Font API</td></tr> - <tr><td><code>-dINITDEBUG</code></td><td></td><td>Initialization</td></tr> - <tr><td><code>-dPDFDEBUG</code></td><td></td><td>PDF Interpreter</td></tr> - <tr><td><code>-dPDFWRDEBUG</code></td><td></td><td>PDF Writer</td></tr> - <tr><td><code>-dSETPDDEBUG</code></td><td></td><td>setpagedevice</td></tr> - <tr><td><code>-dSTRESDEBUG</code></td><td></td><td>Static Resources</td></tr> - <tr><td><code>-dTTFDEBUG</code></td><td></td><td>TTF Fonts</td></tr> - <tr><td><code>-dVGIFDEBUG</code></td><td></td><td>ViewGIF</td></tr> - <tr><td><code>-dVJPGDEBUG</code></td><td></td><td>ViewJPEG</td></tr> + <tr><td><code>-dCCFONTDEBUG</code></td><td>Compiled Fonts</td></tr> + <tr><td><code>-dCFFDEBUG</code></td><td>CFF Fonts</td></tr> + <tr><td><code>-dCMAPDEBUG</code></td><td>CMAP</td></tr> + <tr><td><code>-dDOCIEDEBUG</code></td><td>CIE color</td></tr> + <tr><td><code>-dEPSDEBUG</code></td><td>EPS handling</td></tr> + <tr><td><code>-dFAPIDEBUG</code></td><td>Font API</td></tr> + <tr><td><code>-dINITDEBUG</code></td><td>Initialization</td></tr> + <tr><td><code>-dPDFDEBUG</code></td><td>PDF Interpreter</td></tr> + <tr><td><code>-dPDFWRDEBUG</code></td><td>PDF Writer</td></tr> + <tr><td><code>-dSETPDDEBUG</code></td><td>setpagedevice</td></tr> + <tr><td><code>-dSTRESDEBUG</code></td><td>Static Resources</td></tr> + <tr><td><code>-dTTFDEBUG</code></td><td>TTF Fonts</td></tr> + <tr><td><code>-dVGIFDEBUG</code></td><td>ViewGIF</td></tr> + <tr><td><code>-dVJPGDEBUG</code></td><td>ViewJPEG</td></tr> </table> <p> @@ -3927,9 +3927,9 @@ The PDF interpreter normally tries to repair, or ignore, all problems encountere Setting <code>-dPDFSTOPONERROR</code> instead causes the interpreter to signal an error and stop processing the PDF file, instead of printing a warning. </p><p> -The <code>-dPDFSTOPONWARNING</code> switch behves the same, but will stop if a condition +The <code>-dPDFSTOPONWARNING</code> switch behaves the same, but will stop if a condition which would normally merit a warning (instead of an error) is encountered. Note that -setting <code>-dPDFSTOPONWARNING</code> also sets <code>-dPDFSTOPONERROR</code> +setting <code>-dPDFSTOPONWARNING</code> also sets <code>-dPDFSTOPONERROR</code>. </p> <p> @@ -3939,61 +3939,49 @@ configuration</a>. In the table below, the first column is a debugging switch, the second is an equivalent switch (if any) and the third is its usage.</p> +<blockquote> <table> - <tr><th colspan="5">Switches used in debugging</th></tr> + <tr><th colspan="2">Switches used in debugging</th></tr> <tr> <th align="left">Switch</th> - <th> </th> - <th align="left"> </th> - <th> </th> + + + <th align="left"> Description</th></tr> <tr> <td valign="top"><code>-B</code><em>size</em></td> - <td> </td> - <td> </td> - <td> </td> + <td>Run all subsequent files named on the command line (except for <code>-F</code>) through the run_string interface, using a buffer of <em>size</em> bytes</td></tr> <tr> <td valign="top"><code>-B-</code></td> - <td> </td> - <td> </td> - <td> </td> + <td>Turn off <code>-B</code>: run subsequent files (except for <code>-F</code>) directly in the normal way</td></tr> <tr> <td valign="top"><code>-F</code><em>file</em></td> - <td> </td> - <td> </td> - <td> </td> + <td>Execute the file with <code>-B1</code> temporarily in effect</td></tr> <tr> <td valign="top"><code>-K</code><em>n</em></td> - <td> </td> - <td> </td> - <td> </td> + <td>Limit the total amount of memory that the interpreter can have allocated at any one time to <b><em>n</em></b>K bytes. <b><em>n</em></b> is a positive decimal integer.</td></tr> <tr> <td valign="top"><code>-M</code><em>n</em></td> - <td> </td> - <td> </td> - <td> </td> + <td>Force the interpreter's allocator to acquire additional memory in units of <b><em>n</em></b>K bytes, rather than the default 20K. <b><em>n</em></b> is a positive decimal integer, on 16-bit systems no greater than 63.</td></tr> <tr> <td valign="top"><code>-N</code><em>n</em></td> - <td> </td> - <td> </td> - <td> </td> + <td>Allocate space for <b><em>n</em></b>K names, rather than the default (normally 64K). <b><em>n</em></b> may be greater than 64 only if <code>EXTEND_NAMES</code> was defined (in inameidx.h) when the interpreter was compiled .</td></tr> <tr> <td valign="top"><code>-Z</code><em>xxx</em><br><code>-Z-</code><em>xxx</em></td> - <td> </td> - <td> </td> - <td> </td> + <td>Turn debugging printout on (off). Each of the <em>xxx</em> characters selects an option. Case is significant: "a" and "A" have different meanings.</td></tr> +</table> <dl compact> <dt><code>0</code><dd>garbage collector, minimal detail</dd></dt> @@ -4098,7 +4086,7 @@ storage with a marker (a1, c1, and f1 respectively)</dd></dt> <dt><code>s</code><dd>the shading algorithm</dd></dt> <dt><code>S</code><dd>the stroking algorithm</dd></dt> </dl> -</table> +</blockquote> <p>In addition, calling ghostscript with <code>--debug</code> will list all the currently defined (non visual trace) debugging flags, both in their short form (as listed @@ -4977,7 +4965,8 @@ e.g., <code>b0</code> becomes the same as <code>jisb0</code>.</p> <h4><a name="X_regular_fonts"></a>Regular fonts</h4> -<pre>AvantGarde-Book: -Adobe-ITC Avant Garde Gothic-Book-R-Normal--\n\ +<pre> + AvantGarde-Book: -Adobe-ITC Avant Garde Gothic-Book-R-Normal--\n\ AvantGarde-BookOblique: -Adobe-ITC Avant Garde Gothic-Book-O-Normal--\n\ AvantGarde-Demi: -Adobe-ITC Avant Garde Gothic-Demi-R-Normal--\n\ AvantGarde-DemiOblique: -Adobe-ITC Avant Garde Gothic-Demi-O-Normal--\n\ @@ -5189,7 +5178,7 @@ The second element is a dictionary with entries :</p> <td>Absolute path to font file, or relative path to font file from the FontPath value, being specified in <code>FAPIconfig</code>.</td></tr> <tr> <td>FontType</td> - <td>interger</td> + <td>integer</td> <td>PostScript type for this font. Only 1 and 42 are currently allowed. Note that this is unrelated to the real type of the font file - the bridge will perform a format conversion.</td></tr> @@ -5257,7 +5246,7 @@ The format is similar to <code>FAPIfontmap</code>, <td>Absolute path to font file, or relative path to font file from the CIDFontPath value, being specified in <code>FAPIconfig</code>.</td></tr> <tr> <td>CIDFontType</td> - <td>interger</td> + <td>integer</td> <td>PostScript type for this CID font. Only 0, 1 and 2 are currently allowed. Note that this is unrelated to the real type of the font file - the bridge will perform format conversion.</td></tr> |