devices.htm

GhostScript的源代码

<dd>Enable the printer's "microweave" feature; see
"<a href="#What_is_weaving">What is weaving?</a>" below.
</dl>

<dl>
<dt><b><tt>-dnoWeave</tt></b>
<dd>Disable any Weaving (overrides <b><tt>-dMicroweave</tt></b>)
</dl>

<dl>
<dt><b><tt>-dSoftweave</tt></b>
<dd>Enable the driver's internal weaving.  Note that <b><tt>Softweave</tt></b> works <b>only</b> with the original Stylus Color and the PRO-Series.
</dl>

<dl>
<dt><b><tt>-sDithering=</tt></b><em>{name}</em>
<dd>Select another dithering algorithm (name) from among
<blockquote><table cellpadding=0 cellspacing=0>
<tr valign=top>	<td><b><tt>gscmyk</tt></b>
	<td>&nbsp;&nbsp;&nbsp;&nbsp;
	<td>fast color output, CMYK process color model (default)
<tr valign=top>	<td><b><tt>gsmono</tt></b>
	<td>&nbsp;
	<td>fast monochrome output
<tr valign=top>	<td><b><tt>gsrgb</tt></b>
	<td>&nbsp;
	<td>fast color output, RGB process color model
<tr valign=top>	<td><b><tt>fsmono</tt></b>
	<td>&nbsp;
	<td>Floyd-Steinberg, monochrome
<tr valign=top>	<td><b><tt>fsrgb</tt></b>
	<td>&nbsp;
	<td>Floyd-Steinberg, RGB process color model (almost identical to the <b><tt>cdj550</tt></b>/<b><tt>bjc</tt></b> algorithm)
<tr valign=top>	<td><b><tt>fsx4</tt></b>
	<td>&nbsp;
	<td>Floyd-Steinberg, CMYK process color model (shares code with <b><tt>fsmono</tt></b> and <b><tt>fsrgb</tt></b>, but is algorithmically really bad)
<tr valign=top>	<td><b><tt>fscmyk</tt></b>
	<td>&nbsp;
	<td>Floyd-Steinberg, CMYK process color model and proper modifications for CMYK
<tr valign=top>	<td><b><tt>hscmyk</tt></b>
	<td>&nbsp;
	<td>modified Floyd-Steinberg with CMYK model ("hs" stands for "hess" not for "high speed", but the major difference from <b><tt>fscmyk</tt></b> is speed)
<tr valign=top>	<td><b><tt>fs2</tt></b>
	<td>&nbsp;
	<td>algorithm by Steven Singer (RGB) should be identical to <b><tt>escp2cfs2</tt></b>.
</table></blockquote>
</dl>

<dl>
<dt><b><tt>-dBitsPerPixel=</tt></b><em>{1...32}</em>
<dd>number of bits used for pixel storage; the larger the value, the better
the quality -- at least in theory. In <b><tt>fsrgb</tt></b> one can gain
some speed by restricting to 24 bits rather than the default 30.
</dl>

<dl>
<dt><b><tt>-dFlag0</tt></b>
<dd>causes some algorithms to select a uniform initialisation rather than a
set of random values.  May yield a sharper image impression at the cost of
dithering artifacts.  (Applies to <b><tt>hscmyk</tt></b> and all fs modes,
except for fs2, which always uses a constant initialization.)
</dl>

<dl>
<dt><b><tt>-dFlag1</tt></b> ... <b><tt>-dFlag4</tt></b>
<dd>Available for future algorithms.
</dl>

<dl>
<dt><b><tt>-dColorAdjustMatrix='{</tt></b><em>three, nine, or sixteen
floating-point values</em><b><tt>}'</tt></b>
<dd>This is a matrix to adjust the colors.  Values should be between -1.0
and 1.0, and the number of values depends on the color model the selected
algorithm uses. In RGB and CMYK modes a matrix with 1.0 on the diagonal
produces no transformation.  This feature is really required, but I could
not identify a similar feature at the language level, so I implemented it,
but I don't know reasonable values yet.
</dl>

<dl>
<dt><b><tt>-dCtransfer='{</tt></b><em>float float ...</em><b><tt>}'</tt></b> or
<dt><b><tt>-dMtransfer=</tt></b>..., <b><tt>-dY</tt></b>..., <b><tt>-dK</tt></b>... or
<dt><b><tt>-dRtransfer='{</tt></b><em>float float ...</em><b><tt>}'</tt></b> or
<dt><b><tt>-dG</tt></b>..., <b><tt>-dB</tt></b>... or
<dt><b><tt>-dKtransfer='{</tt></b><em>float float ...</em><b><tt>}'</tt></b>
<dd>Which you use depends on the algorithm, which may be either either
CMYK, RGB or monochrome. The values are arrays of floats in the range from
0 to 1.0, representing the visible color intensity for the device.  One may
achieve similar effects with <b><tt>setcolortransfer</tt></b> at the
language level, but this takes more time and the underlying code for the
driver-specific parameters is still required.  The size of the arrays is
arbitrary and the defaults are "<b><tt>{0.0&nbsp;1.0}</tt></b>", which is a
linear characteristic.  Most of the code in <b><tt>stcolor.ps</tt></b> are
better transfer arrays.
</dl>

<dl>
<dt><b><tt>-dKcoding='{</tt></b><em>float...</em><b><tt>}'</tt></b>
<dt><b><tt>-dC</tt></b>..., <b><tt>-dM</tt></b>... etc.
<dd>Arrays between 0.0 and 1.0, controlling the internal coding of the
color values.  Clever use of these arrays may yield further enhancements,
but I have no experience yet.  (To be discontinued with version 2.x.)
</dl>

<dl>
<dt><b><tt>-sModel=st800</tt></b>
<dd>Causes output to be suitable for the monochrome Stylus 800 (no weaving,
no color).
</dl>

<dl>
<dt><b><tt>-sOutputCode=</tt></b><em>{name}</em>
<dd>Can be either "<b><tt>plain</tt></b>", "<b><tt>runlength</tt></b>" or
"<b><tt>deltarow</tt></b>" and changes the ESC/P2 coding technique
used by the driver. The default is to use runlength encoding.
"<b><tt>plain</tt></b>" selects uncompressed encoding and generates
enormous amounts of data.
</dl>

<dl>
<dt><b><tt>-descp_Band=</tt></b><em>1/8/15/24</em>
<dd>Number of nozzles of scanlines used in printing, Useful only with
<b><tt>-dnoWeave</tt></b>.  Larger Values yield smaller code, but this
doesn't increase the printing speed.
</dl>

<dl>
<dt><b><tt>-descp_Width=</tt></b><em>N</em>
<dd>Number of pixels Printed in each scan Line.  (Useful only when tuning
margins; see below)
</dl>

<dl>
<dt><b><tt>-descp_Height=</tt></b><em>pixels</em>
<dd>Length of the entire page in pixels.  (Parameter of
"<b><tt>ESC(C</tt></b>" in default initialization.)
</dl>

<dl>
<dt><b><tt>-descp_Top=</tt></b><em>scan lines</em>
<dd>Top margin in scan lines.  (First parameter of "<b><tt>ESC(c</tt></b>"
in default initialization.)
</dl>

<dl>
<dt><b><tt>-descp_Bottom=</tt></b><em>scan lines</em>
<dd>Bottom margin in scan lines.  (Second parameter of
"<b><tt>ESC(c</tt></b>" in default initialization.)
</dl>

<dl>
<dt><b><tt>-sescp_Init=</tt></b>"<em>string</em>"
<dd>Override for the initialization sequence.  (Must set graphics mode 1
and units.)
</dl>

<dl>
<dt><b><tt>-sescp_Release=</tt></b>"<em>string</em>"
<dd>Overrides the release sequence, "<b><tt>ESC&nbsp;@&nbsp;FF</tt></b>" by
default.
</dl>

<p>
ESC/P2 allows any resolutions to be valid in theory, but only
<b><tt>-r360x360</tt></b> (the default) and <b><tt>-r720x720</tt></b> (not
on STC-IIs ? and st800) are known to work with most printers.

<p>

<blockquote><table cellpadding=0 cellspacing=0>
<tr><th colspan=7 bgcolor="#CCCC00"><hr><font size="+1">Valid option combinations<br>Stylus I &amp; Pro-Series only</font><hr>
<tr valign=bottom>
	<th valign=bottom align=left>Resolution
	<td>&nbsp;&nbsp;&nbsp;&nbsp;
	<th valign=bottom align=left><b><tt>escp_Band</tt></b>
	<td>&nbsp;&nbsp;&nbsp;&nbsp;
	<th valign=bottom align=left>Weave usable
	<td>&nbsp;&nbsp;&nbsp;&nbsp;
	<th valign=bottom align=left><b><tt>escp_Band</tt></b> &amp;<br>number of passes
<tr>	<td colspan=7><hr>
<tr valign=top>	<td>180x90
	<td>&nbsp;
	<td>15
	<td>&nbsp;
	<td><b><tt>noWeave</tt></b>
	<td>&nbsp;
	<td>&nbsp;
<tr valign=top>	<td>180x180
	<td>&nbsp;
	<td>1 , 8, 24
	<td>&nbsp;
	<td><b><tt>noWeave</tt></b>, <b><tt>Microweave</tt></b>
	<td>&nbsp;
	<td>15/2 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>180x360
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>15/4 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>180x720
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>15/8 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>360x90
	<td>&nbsp;
	<td>15
	<td>&nbsp;
	<td><b><tt>noWeave</tt></b>
	<td>&nbsp;
	<td>&nbsp;
<tr valign=top>	<td>360x180
	<td>&nbsp;
	<td>1, 8, 24
	<td>&nbsp;
	<td><b><tt>noWeave</tt></b>, <b><tt>Microweave</tt></b>
	<td>&nbsp;
	<td>15/2 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>360x360
	<td>&nbsp;
	<td>1, 8, 24
	<td>&nbsp;
	<td><b><tt>noWeave</tt></b>, <b><tt>Microweave</tt></b>
	<td>&nbsp;
	<td>15/4 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>360x720
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>15/8 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>720x90
	<td>&nbsp;
	<td>15
	<td>&nbsp;
	<td><b><tt>noWeave</tt></b>
	<td>&nbsp;
	<td>&nbsp;
<tr valign=top>	<td>720x180
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>15/2 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>720x360
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>&nbsp;
	<td>15/4 <b><tt>SoftWeave</tt></b>
<tr valign=top>	<td>720x720
	<td>&nbsp;
	<td>1
	<td>&nbsp;
	<td><b><tt>noWeave</tt></b>, <b><tt>Microweave</tt></b>
	<td>&nbsp;
	<td>15/8 <b><tt>SoftWeave</tt></b>
</table></blockquote>

<blockquote>
<b>Beware:</b> there are only few validity checks for parameters.  A good
example is <b><tt>escp_Band</tt></b>: if you set this, the driver uses your
value even if the value is not supported by the printer.  <b>You asked for
it and you got it!</b>
</blockquote>

<h2><a name="STC_FAQ"></a>Application note and FAQ</h2>

<p>
Quite a bunch of parameters.  Hopefully you never need any of them, besides
feeding <b><tt>stcolor.ps</tt></b> to Ghostscript in front of your input.

<p>
After answering some questions over fifty times I prepared a FAQ.  Here is
version 1.3 of the FAQ, as of <b><tt>stcolor</tt></b> version 1.20 (for
Ghostscript 3.50).

<h3><a name="STC_FAQ_A3"></a>Support for A3 paper</h3>

<p>
Yes, this driver supports the A3-size printer: merely set the required
pagesize and margins.  A simple way to do this is to specify the
command-line switch "<b><tt>-sPAPERSIZE=a3</tt></b>" or include the
procedure call "<b><tt>a3</tt></b>" in the PostScript prolog section.  To
optimize the printable area or set the proper margins, see the next
paragraph.

<h3><a name="STC_FAQ_margins"></a>Margins, PageSize</h3>

<p>
I refuse to add code to <b><tt>stcolor</tt></b> that tries to guess the
proper margins or page size, because I found that such guessing is usually
wrong and needs correction in either the source or the parameters.  You can
modify <b><tt>stcolor.ps</tt></b> to do that, however.  After the line

<blockquote><b><tt>
mark % prepare stack for "putdeviceprops"
</tt></b></blockquote>

<p>
insert these lines, which define page size and margins in points:

<blockquote><font size="-1">
<pre>/.HWMargins [9.0 39.96 12.6 9.0]     % Left, bottom, right, top (1/72")
/PageSize   [597.6 842.4]            % Paper, including margins (1/72")
/Margins [ % neg. Offset to Left/Top in Pixels
   4 index 0 get STCold /HWResolution get 0 get mul 72 div neg
   5 index 3 get STCold /HWResolution get 1 get mul 72 div neg
]</pre></font></blockquote>

<p>
Feel free to change the values of <b><tt>.HWMargins</tt></b> and
<b><tt>PageSize</tt></b> to match your needs; the values given are the
defaults when the driver is compiled with "<b><tt>-DA4</tt></b>".  This
option or its omission may cause trouble: the Stylus Color can print up to
exactly 8 inches (2880 pixels) at 360dpi.  The remaining paper is the
margin, where the left margin varies only slightly with the paper size,
while the right margin is significantly increased for wider paper, such as
U.S. letter size.

<p>
<b>Note</b> that if you are using an ISO paper size with a version of
<b><tt>stcolor</tt></b> after 1.20 and compiled without
"<b><tt>-DA4</tt></b>", then the default margin is too large, and you need
to add the proper "<b><tt>.HWMargins</tt></b>" to the command line or to
<b><tt>stcolor.ps</tt></b>.

<h3><a name="STC_FAQ_II_IIS_1500"></a>Stylus Color II / IIs and 1500</h3>

<p>
First the good news: the driver can print on the Stylus Color II.
Now the bad news:
<ul>
<li>According to Epson support the driver "abuses" the color
capabilities.  (See "Future Plans" for details.)
<li>You need some parameters on the command line (or in
<b><tt>stcolor.ps</tt></b>).
<li>I doubted that it would be usable with the Stylus Color IIs, but
it <b>is</b> us