Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Prima::PS::Printer(3) User Contributed Perl DocumentationPrima::PS::Printer(3)

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 => '-d colorprinter');
	       }
	       $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,

perl v5.24.1			  2017-02-27		 Prima::PS::Printer(3)

NAME | SYNOPSIS | DESCRIPTION | SYNOPSIS | Printer options | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Prima::PS::Printer&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help