1Prima::PS::Printer(3) User Contributed Perl DocumentationPrima::PS::Printer(3)
2
3
4

NAME

6       Prima::PS::Printer - PostScript interface to Prima::Printer
7

SYNOPSIS

9       use Prima; use Prima::PS::Printer;
10

DESCRIPTION

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
17       Also contains convenience classes (File, LPR, Pipe) for non-GUI use.
18

SYNOPSIS

20               use Prima::PS::Printer;
21
22               my $x;
23               if ( $preview) {
24                       $x = Prima::PS::Pipe-> create( command => 'gv -');
25               } elsif ( $print_in_file) {
26                       $x = Prima::PS::File-> create( file => 'out.ps');
27               } else {
28                       $x = Prima::PS::LPR-> create( args => '-d colorprinter');
29               }
30               $x-> begin_doc;
31               $x-> font-> size( 300);
32               $x-> text_out( "hello!", 100, 100);
33               $x-> end_doc;
34

Printer options

36       Below is the list of options supported by "options" method:
37
38       Color STRING
39           One of : "Color, Monochrome"
40
41       Resolution INTEGER
42           Dots per inch.
43
44       PageSize STRING
45           One of: "Ainteger, Binteger, Executive, Folio, Ledger, Legal,
46           Letter, Tabloid, US Common #10 Envelope".
47
48       Copies INTEGER
49       Scaling FLOAT
50           1 is 100%, 1.5 is 150%, etc.
51
52       Orientation
53           One of : "Portrait", "Landscape".
54
55       UseDeviceFonts BOOLEAN
56           If 1, use limited set of device fonts in addition to exported
57           bitmap fonts.
58
59       UseDeviceFontsOnly BOOLEAN
60           If 1, use limited set of device fonts instead of exported bitmap
61           fonts.  Its usage may lead to that some document fonts will be
62           mismatched.
63
64       MediaType STRING
65           An arbitrary string representing special attributes of the medium
66           other than its size, color, and weight. This parameter can be used
67           to identify special media such as envelopes, letterheads, or
68           preprinted forms.
69
70       MediaColor STRING
71           A string identifying the color of the medium.
72
73       MediaWeight FLOAT
74           The weight of the medium in grams per square meter. "Basis weight"
75           or or null "ream weight" in pounds can be converted to grams per
76           square meter by multiplying by 3.76; for example, 10-pound paper is
77           approximately 37.6 grams per square meter.
78
79       MediaClass STRING
80           (Level 3) An arbitrary string representing attributes of the medium
81           that may require special action by the output device, such as the
82           selection of a color rendering dictionary. Devices should use the
83           value of this parameter to trigger such media-related actions,
84           reserving the MediaType parameter (above) for generic attributes
85           requiring no device-specific action.  The MediaClass entry in the
86           output device dictionary defines the allowable values for this
87           parameter on a given device; attempting to set it to an unsupported
88           value will cause a configuration error.
89
90       InsertSheet BOOLEAN
91           (Level 3) A flag specifying whether to insert a sheet of some
92           special medium directly into the output document. Media coming from
93           a source for which this attribute is Yes are sent directly to the
94           output bin without passing through the device's usual imaging
95           mechanism (such as the fuser assembly on a laser printer).
96           Consequently, nothing painted on the current page is actually
97           imaged on the inserted medium.
98
99       LeadingEdge BOOLEAN
100           (Level 3) A value specifying the edge of the input medium that will
101           enter the printing engine or imager first and across which data
102           will be imaged.  Values reflect positions relative to a canonical
103           page in portrait orientation (width smaller than height). When
104           duplex printing is enabled, the canonical page orientation refers
105           only to the front (recto) side of the medium.
106
107       ManualFeed BOOLEAN
108           Flag indicating whether the input medium is to be fed manually by a
109           human operator (Yes) or automatically (No). A Yes value asserts
110           that the human operator will manually feed media conforming to the
111           specified attributes ( MediaColor, MediaWeight, MediaType,
112           MediaClass, and InsertSheet). Thus, those attributes are not used
113           to select from available media sources in the normal way, although
114           their values may be presented to the human operator as an aid in
115           selecting the correct medium. On devices that offer more than one
116           manual feeding mechanism, the attributes may select among them.
117
118       TraySwitch BOOLEAN
119           (Level 3)  A flag specifying whether the output device supports
120           automatic switching of media sources. When the originally selected
121           source runs out of medium, some devices with multiple media sources
122           can switch automatically, without human intervention, to an
123           alternate source with the same attributes (such as PageSize and
124           MediaColor) as the original.
125
126       MediaPosition STRING
127           (Level 3) The position number of the media source to be used.  This
128           parameter does not override the normal media selection process
129           described in the text, but if specified it will be honored -
130           provided it can satisfy the input media request in a manner
131           consistent with normal media selection - even if the media source
132           it specifies is not the best available match for the requested
133           attributes.
134
135       DeferredMediaSelection BOOLEAN
136           (Level 3) A flag determining when to perform media selection.  If
137           Yes, media will be selected by an independent printing subsystem
138           associated with the output device itself.
139
140       MatchAll BOOLEAN
141           A flag specifying whether input media request should match to all
142           non-null values - MediaColor, MediaWeight etc.
143

AUTHOR

145       Dmitry Karasik, <dmitry@karasik.eu.org>.
146

SEE ALSO

148       Prima, Prima::Printer, Prima::Drawable,
149
150
151
152perl v5.30.1                      2020-01-30             Prima::PS::Printer(3)
Impressum