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,