1Prima::PS::Printer(3) User Contributed Perl DocumentationPrima::PS::Printer(3)
2
6 Prima::PS::Printer - PostScript interface to Prima::Printer
7
9 use Prima; use Prima::PS::Printer;
10
12 Realizes the Prima printer interface to PostScript level 2 document
13 language through Prima::PS::Drawable module. Allows different user
14 profiles to be created and managed with GUI setup dialog. The module is
15 designed to be compliant with Prima::Printer interface.
16 Also contains convenience classes (File, LPR, Pipe) for non-GUI use.
18
20 use Prima::PS::Printer;
21 my $x;
23 if ( $preview) {
24 $x = Prima::PS::Pipe-> new( command => 'gv $');
25 } elsif ( $print_in_file) {
26 $x = Prima::PS::File-> new( file => 'out.ps');
27 } elsif ( $print_on_device) {
28 $x = Prima::PS::LPR-> new( args => '-d colorprinter');
29 } else {
30 $x = Prima::PS::FileHandle-> new( handle => \*STDOUT );
31 }
32 $x-> begin_doc;
33 $x-> font-> size( 300);
34 $x-> text_out( "hello!", 100, 100);
35 $x-> end_doc;
36
38 Below is the list of options supported by "options" method:
39 Color STRING
41 One of : "Color, Monochrome"
42 Resolution INTEGER
44 Dots per inch.
45 PageSize STRING
47 One of: "Ainteger, Binteger, Executive, Folio, Ledger, Legal,
48 Letter, Tabloid, US Common #10 Envelope".
49 Copies INTEGER
51 Scaling FLOAT
52 1 is 100%, 1.5 is 150%, etc.
53 Orientation
55 One of : "Portrait", "Landscape".
56 MediaType STRING
58 An arbitrary string representing special attributes of the medium
59 other than its size, color, and weight. This parameter can be used
60 to identify special media such as envelopes, letterheads, or
61 preprinted forms.
62 MediaColor STRING
64 A string identifying the color of the medium.
65 MediaWeight FLOAT
67 The weight of the medium in grams per square meter. "Basis weight"
68 or or null "ream weight" in pounds can be converted to grams per
69 square meter by multiplying by 3.76; for example, 10-pound paper is
70 approximately 37.6 grams per square meter.
71 MediaClass STRING
73 (Level 3) An arbitrary string representing attributes of the medium
74 that may require special action by the output device, such as the
75 selection of a color rendering dictionary. Devices should use the
76 value of this parameter to trigger such media-related actions,
77 reserving the MediaType parameter (above) for generic attributes
78 requiring no device-specific action. The MediaClass entry in the
79 output device dictionary defines the allowable values for this
80 parameter on a given device; attempting to set it to an unsupported
81 value will cause a configuration error.
82 InsertSheet BOOLEAN
84 (Level 3) A flag specifying whether to insert a sheet of some
85 special medium directly into the output document. Media coming from
86 a source for which this attribute is Yes are sent directly to the
87 output bin without passing through the device's usual imaging
88 mechanism (such as the fuser assembly on a laser printer).
89 Consequently, nothing painted on the current page is actually
90 imaged on the inserted medium.
91 LeadingEdge BOOLEAN
93 (Level 3) A value specifying the edge of the input medium that will
94 enter the printing engine or imager first and across which data
95 will be imaged. Values reflect positions relative to a canonical
96 page in portrait orientation (width smaller than height). When
97 duplex printing is enabled, the canonical page orientation refers
98 only to the front (recto) side of the medium.
99 ManualFeed BOOLEAN
101 Flag indicating whether the input medium is to be fed manually by a
102 human operator (Yes) or automatically (No). A Yes value asserts
103 that the human operator will manually feed media conforming to the
104 specified attributes ( MediaColor, MediaWeight, MediaType,
105 MediaClass, and InsertSheet). Thus, those attributes are not used
106 to select from available media sources in the normal way, although
107 their values may be presented to the human operator as an aid in
108 selecting the correct medium. On devices that offer more than one
109 manual feeding mechanism, the attributes may select among them.
110 TraySwitch BOOLEAN
112 (Level 3) A flag specifying whether the output device supports
113 automatic switching of media sources. When the originally selected
114 source runs out of medium, some devices with multiple media sources
115 can switch automatically, without human intervention, to an
116 alternate source with the same attributes (such as PageSize and
117 MediaColor) as the original.
118 MediaPosition STRING
120 (Level 3) The position number of the media source to be used. This
121 parameter does not override the normal media selection process
122 described in the text, but if specified it will be honored -
123 provided it can satisfy the input media request in a manner
124 consistent with normal media selection - even if the media source
125 it specifies is not the best available match for the requested
126 attributes.
127 DeferredMediaSelection BOOLEAN
129 (Level 3) A flag determining when to perform media selection. If
130 Yes, media will be selected by an independent printing subsystem
131 associated with the output device itself.
132 MatchAll BOOLEAN
134 A flag specifying whether input media request should match to all
135 non-null values - MediaColor, MediaWeight etc.
136
138 Dmitry Karasik, <dmitry@karasik.eu.org>.
139
141 Prima, Prima::Printer, Prima::Drawable,
142perl v5.32.0 2020-07-28 Prima::PS::Printer(3)