gs-pcl3.ref

openmeetings组件之GS openmeetings组件之GS openmeetings组件之GS

<row><entry><userinput>2</userinput></entry>
  <entry>Short edge; bottom of canonical page</entry></row>
<row><entry><userinput>3</userinput></entry>
  <entry>Long edge; left side of canonical page</entry></row>
</tbody></tgroup></informaltable>
</para>

<para>
As far as I know,
given a particular PCL-3+ printer and a particular media size,
you cannot choose between short edge first (0 or 2) and
long edge first (1 or 3):
this orientation is prescribed by the manufacturer and should be documented
in your printer's manual.
If in doubt, use short edge first when inserting the medium.
</para>

<para>
The default value for <replaceable>edge</replaceable> is
<userinput>null</userinput>.
This leads either to 0 or to 3,
depending on whether the subdevice normally expects media of this size
to be fed short edge first or long edge first.
See the subsection
<link linkend="sizesAndOrientations"><citetitle>Media Sizes and
Orientations</citetitle></link>
in the <citetitle>DESCRIPTION</citetitle> section above for details.
</para>

<para>
If you find that you can't set this parameter from PostScript but you can set
it from the command line,
ghostscript's <literal>setpagedevice</literal> definition probably does not
pass the parameter to drivers.
Read the <filename>gs-mods.txt</filename> file in the <command>pcl3</command>
distribution on how to fix this.
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-dManualFeed<optional>=<replaceable>boolean</replaceable></optional></userinput></term>
<listitem><para>
It is possible to request a DeskJet printer to wait before each page of a
document until the Load/Eject button is pressed on the printer.
This is intended for situations where some special medium is used or
the medium has to be inserted into an input slot holding only one sheet at a
time.
The default setting for this option is <userinput>false</userinput>.
</para>

<para>
In PCL, manual feed is established by requesting a particular media source (2),
hence you should expect that setting this parameter will interfere with the
input tray selection via <literal>InputAttributes</literal>
(see the
<link linkend="sourcesAndDestinations"><citetitle>Media Sources and Destinations</citetitle></link>
subsection in the <citetitle>CONFIGURATION</citetitle> section below).
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-sMediaConfigurationFile=<replaceable>pathname</replaceable
  ></userinput></term>
<listitem><para>
This option must specify an existing file containing a list of
supported media sizes, sheet orientations
and corresponding margin descriptions for the printer.
<!-- "-dMediaConfigurationFile=null" is also permitted, see below. -->
This will take precedence over the builtin subdevice-specific lists.
The format of the file is described in the
<link linkend="CONFIGURATION"><citetitle>CONFIGURATION</citetitle></link>
section below.
This option is primarily intended to be used with the subdevices
<userinput>unspecold</userinput> and <userinput>unspec</userinput>.
</para>

<para>
The default is not to use a media configuration file but the builtin lists.
<!-- This is the case "-dMediaConfigurationFile=null". -->
However,
a media file path can also be specified at compile time overriding the default
behaviour for <userinput>unspec</userinput> only.
Using the
<option>MediaConfigurationFile</option>
option in addition will take precedence over the compiled-in media file path.
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-dMediaPosition=<replaceable>position</replaceable></userinput></term>
<listitem><para>
This option sets the standard PostScript page device parameter
<literal>MediaPosition</literal> to the specified value.
The integer <replaceable>position</replaceable> identifies an input tray for
feeding media from and
must refer to an existing entry in the <literal>InputAttributes</literal>
dictionary (see the
<link linkend="sourcesAndDestinations"><citetitle
>Media Sources and Destinations</citetitle></link>
subsection in the <citetitle>CONFIGURATION</citetitle> section below)
in order to take effect.
The media selection process will use this entry in preference to others
provided it matches the media request.
The default is not to request a particular tray by position but to look for
a best match based on other properties.
As ghostscript's default configuration defines only one entry in
<literal>InputAttributes</literal>
this option is ineffective unless you modify <literal>InputAttributes</literal>.
</para>

<para>
With current ghostscript versions	<!-- VERIFIED: gs 6.01, 6.50, 7.00 -->
you can't use this parameter to select a
negative <replaceable>position</replaceable>.
The driver will issue a warning if you attempt it.
If the entry is actually selected,
a <literal>rangecheck</literal> error from ghostscript will follow.
This restriction applies only to this device parameter,
not to permissible values for position numbers in
<literal>InputAttributes</literal>:
if you want to use a negative <replaceable>position</replaceable>,
you can do so by making sure that it is the only matching entry
or by selecting it via <literal>Priority</literal>.
</para>
</listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-sMedium=<replaceable>medium</replaceable></userinput></term>
<listitem><para>
This option selects the type of medium you wish to print on
as far as the printer needs to know about it.
The possible choices are:

<informaltable><tgroup cols="2">
<tbody>
<row><entry><userinput>0</userinput></entry>
  <entry><userinput>plain paper</userinput></entry></row>
<row><entry><userinput>1</userinput></entry>
  <entry><userinput>bond paper</userinput></entry></row>
<row><entry><userinput>2</userinput></entry>
  <entry><userinput>HP Premium paper</userinput></entry></row>
<row><entry><userinput>3</userinput></entry>
  <entry><userinput>glossy paper</userinput></entry></row>
<row><entry><userinput>4</userinput></entry>
  <entry><userinput>transparency film</userinput></entry></row>
<row><entry><userinput>5</userinput></entry>
  <entry><userinput>quick dry glossy</userinput></entry></row>
<row><entry><userinput>6</userinput></entry>
  <entry><userinput>quick dry transparency</userinput></entry></row>
</tbody></tgroup></informaltable>

The default is <userinput>plain paper</userinput>.
For <replaceable>medium</replaceable>,
you can specify the full strings (these are the standard values),
the (in some cases) one-word strings resulting from dropping "paper", "film",
and "HP",
or an integer.
Out-of-range numerical values generate a warning but are passed through to the
printer if you are using a group-3 subdevice.
If you don't,
the effect is the same as specifying <userinput>plain paper</userinput>.
The values 5 and 6 are unknown to most DeskJets;
the only official exception I know of is the HP 2000C printer.
Your printer's manual should tell you which kinds of medium are supported.
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-dOnlyCRD<optional>=<replaceable>boolean</replaceable
></optional></userinput></term>
<listitem><para>
This parameter influences the PCL code generated
and should only be specified for group-3 DeskJets.
The default value is <userinput>false</userinput> and leads to the new
PCL command Configure Raster Data being used only when it is necessary.
Specifying <userinput>true</userinput> leads to Configure Raster Data
being used even in those cases where older commands would be sufficient.
</para>

<para>
There are indications that printers with a PCL dialect of
"PCL Level 3 enhanced" need a value of <userinput>true</userinput> for this
option to enable some of their functionality.
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-sPageCountFile=<replaceable>pathname</replaceable></userinput></term>
<listitem><para>
The <replaceable>pathname</replaceable>
must specify either a non-existent file in a directory with write permission
or a writable file with a single line containing a non-negative integer.
In the first case,
<command>pcl3</command>
will create the file and insert the number of pages printed,
<!-- Ghostscript interprets PageCount as meaning PostScript pages without
  counting copies (see gx_default_print_page_copies() in gs 6.50). This
  disagrees with PLR3 p. 752. pcl3 counts copies as well. -->
in the second case the number will be incremented by that amount.
Parallel invocations of
<command>gs</command>
are permitted to use the same file.
<command>pcl3</command>
will also make the initial page count available in its page device dictionary.
<!-- Only after the device has been opened, though. -->
</para>

<para>
This option is mainly intended for spooler backends calling
<command>pcl3</command>.
It can be used to keep track of the total number of pages printed and also for
per-job accounting.
I recommend using this option for the first purpose and to make a note of the
values in the resulting files whenever you insert a new ink cartridge.
This will enable you to get an indication of how much a printed page costs,
and hence why it is a good idea to use <userinput>draft</userinput> quality
whenever possible
and why you should have bought a laser printer.
</para>

<para>
The driver can be compiled without this option present
but on a UNIX system I would not expect this to be done unless
<command>gs</command>
offers the same functionality in a driver-independent manner
which it currently does not.
</para>

<para>
<command>pcl3</command>
is distributed with example files <filename>if-pcl3</filename> and
<filename>cups-pcl3</filename>
of Berkeley and CUPS spooler backends using this option.
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-sPCLInit1=<replaceable>string</replaceable></userinput
> and <userinput>-sPCLInit2=<replaceable>string</replaceable></userinput
></term>
<listitem><para>
These options can be used to insert additional PCL commands into
<command>pcl3</command>'s output.
Strings given to <option>PCLInit1</option> will be sent immediately after the
initial Printer Reset command,
the value of <option>PCLInit2</option> will be emitted shortly before the
raster data of the first page.
The default is not to send any additional commands.
</para>

<para>
Don't use any of these options unless you understand PCL or someone who does
tells you which value to choose under which circumstances.
</para>

<para>
Because not every possible <replaceable>string</replaceable> value can be
passed from the command line,
these parameters are best set from a PostScript file.
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-sPJLJob=<optional><replaceable>jobname</replaceable></optional></userinput></term>
<listitem><para>
This option can be used to surround the generated file with
Printer Job Language (PJL) commands declaring it to be a single print job
called <replaceable>jobname</replaceable>.
If you omit <replaceable>jobname</replaceable>, you create an unnamed job.
The string <replaceable>jobname</replaceable> may not contain double quotes
or control characters except HT
(the forbidden byte codes are 0 to&nbsp;8, 10 to&nbsp;31, and&nbsp;34).
</para>

<para>
Use this option if your printer understands PJL and
you discover either that settings for one job influence the following job
or that the printer does not recognize the end of the job (lights remain
flashing or a control panel still displays a processing message).
If you send the generated PCL file through a PJL filter,
in particular one querying the printer's state,
omit this option and use the filter for this purpose instead.
</para></listitem>
</varlistentry>

<!-- ______________________________________________________________________ -->

<varlistentry>
<term><userinput>-sPJLLanguage=<replaceable>language</replaceable></userinput></term>
<listitem><para>
If a printer supports several command languages and PCL&nbsp;3+ is not the
default,
the printer must be told to switch to PCL&nbsp;3+ at the beginning of the
print job.
Hewlett-Packard's printers use a Printer Job Language (PJL) command
for this purpose.
Specifying this option will switch the printer to
<replaceable>language</replaceable> for the duration of the job and back to the
default at the end.
</para>

<para>
This option is not usually necessary except that there are indications that
printers with a PCL dialect of "PCL Level 3 enhanced" need
<userinput>-sPJLLanguage=PCL3GUI</userinput>
to enable some of their functionality.
</para>

<para>
You should never use the option unless you have a reliable source for the values
of <replaceable>language</replaceable> accepted by your printer,
for example the output from <command>p