NAME
Prima::PS::Printer - PostScript interface to Prima::Printer
SYNOPSIS
use Prima; use Prima::PS::Printer;
DESCRIPTION
Realizes the Prima printer interface to PostScript level 2 document
language through Prima::PS::Drawable module. Allows different user
profiles to be created and managed with GUI setup dialog. The module is
designed to be compliant with Prima::Printer interface.
Also contains convenience classes (File, LPR, Pipe) for non-GUI use.
SYNOPSIS
use Prima::PS::Printer;
my $x;
if ( $preview) {
$x = Prima::PS::Pipe-> create( command => 'gv -');
} elsif ( $print_in_file) {
$x = Prima::PS::File-> create( file => 'out.ps');
} else {
$x = Prima::PS::LPR-> create( args => '-Pcolorprinter');
}
$x-> begin_doc;
$x-> font-> size( 300);
$x-> text_out( "hello!", 100, 100);
$x-> end_doc;
Printer options
Below is the list of options supported by "options" method:
Color STRING
One of : "Color, Monochrome"
Resolution INTEGER
Dots per inch.
PageSize STRING
One of: "Ainteger, Binteger, Executive, Folio, Ledger, Legal,
Letter, Tabloid, US Common #10 Envelope".
Copies INTEGER
Scaling FLOAT
1 is 100%, 1.5 is 150%, etc.
Orientation
One of : "Portrait", "Landscape".
UseDeviceFonts BOOLEAN
If 1, use limited set of device fonts in addition to exported
bitmap fonts.
UseDeviceFontsOnly BOOLEAN
If 1, use limited set of device fonts instead of exported bitmap
fonts. Its usage may lead to that some document fonts will be
mismatched.
MediaType STRING
An arbitrary string representing special attributes of the medium
other than its size, color, and weight. This parameter can be used
to identify special media such as envelopes, letterheads, or
preprinted forms.
MediaColor STRING
A string identifying the color of the medium.
MediaWeight FLOAT
The weight of the medium in grams per square meter. "Basis weight"
or or null "ream weight" in pounds can be converted to grams per
square meter by multiplying by 3.76; for example, 10-pound paper is
approximately 37.6 grams per square meter.
MediaClass STRING
(Level 3) An arbitrary string representing attributes of the medium
that may require special action by the output device, such as the
selection of a color rendering dictionary. Devices should use the
value of this parameter to trigger such media-related actions,
reserving the MediaType parameter (above) for generic attributes
requiring no device-specific action. The MediaClass entry in the
output device dictionary defines the allowable values for this
parameter on a given device; attempting to set it to an unsupported
value will cause a configuration error.
InsertSheet BOOLEAN
(Level 3) A flag specifying whether to insert a sheet of some
special medium directly into the output document. Media coming from
a source for which this attribute is Yes are sent directly to the
output bin without passing through the device’s usual imaging
mechanism (such as the fuser assembly on a laser printer).
Consequently, nothing painted on the current page is actually
imaged on the inserted medium.
LeadingEdge BOOLEAN
(Level 3) A value specifying the edge of the input medium that will
enter the printing engine or imager first and across which data
will be imaged. Values reflect positions relative to a canonical
page in portrait orientation (width smaller than height). When
duplex printing is enabled, the canonical page orientation refers
only to the front (recto) side of the medium.
ManualFeed BOOLEAN
Flag indicating whether the input medium is to be fed manually by a
human operator (Yes) or automatically (No). A Yes value asserts
that the human operator will manually feed media conforming to the
specified attributes ( MediaColor, MediaWeight, MediaType,
MediaClass, and InsertSheet). Thus, those attributes are not used
to select from available media sources in the normal way, although
their values may be presented to the human operator as an aid in
selecting the correct medium. On devices that offer more than one
manual feeding mechanism, the attributes may select among them.
TraySwitch BOOLEAN
(Level 3) A flag specifying whether the output device supports
automatic switching of media sources. When the originally selected
source runs out of medium, some devices with multiple media sources
can switch automatically, without human intervention, to an
alternate source with the same attributes (such as PageSize and
MediaColor) as the original.
MediaPosition STRING
(Level 3) The position number of the media source to be used. This
parameter does not override the normal media selection process
described in the text, but if specified it will be honored -
provided it can satisfy the input media request in a manner
consistent with normal media selection - even if the media source
it specifies is not the best available match for the requested
attributes.
DeferredMediaSelection BOOLEAN
(Level 3) A flag determining when to perform media selection. If
Yes, media will be selected by an independent printing subsystem
associated with the output device itself.
MatchAll BOOLEAN
A flag specifying whether input media request should match to all
non-null values - MediaColor, MediaWeight etc.
AUTHOR
Dmitry Karasik, <dmitry@karasik.eu.org>.
SEE ALSO
Prima, Prima::Printer, Prima::Drawable,