1. Manuals
  2. Tumbleweed
  3. perl-Prima
  4. Prima::PS::PostScript(3pm)

Scroll to navigation

Prima::PS::PostScript(3) User Contributed Perl Documentation Prima::PS::PostScript(3)

NAME

Prima::PS::PostScript - PostScript interface to Prima::Drawable

SYNOPSIS

Recommended usage:

        use Prima::PS::Printer;
        my $x = Prima::PS::File-> new( file => 'out.ps');

or

        my $x = Prima::PS::FileHandle-> new( handle => \&STDOUT);

Low-level:

        use Prima::PS::PostScript;
        my $x = Prima::PS::PostScript-> create( onSpool => sub {
                open F, ">> ./test.ps";
                print F $_[1];
                close F;
        });

Printing:

        die "error:$@" unless $x-> begin_doc;
        $x-> font-> size( 30);
        $x-> text_out( "hello!", 100, 100);
        $x-> end_doc;

DESCRIPTION

Implements the Prima library interface to PostScript level 2 document language. The module is designed to be compliant with the Prima::Drawable interface. All properties' behavior is as same as Prima::Drawable's except those described below.

Inherited properties

Can be set while the object is in the normal stage - cannot be changed if the document is opened. Applies to implementation of the fillPattern property and general pixel-to-point and vice versa calculations
"alpha" is not implemented

Specific properties

The number of copies that the PS interpreter should print
could be 0 or 1
The physical page dimension, in points
Non-printable page area, an array of 4 integers: left, bottom, right, and top margins in points.
if 1, a 90 degrees rotated document layout is assumed

Internal methods

Can be called for direct PostScript code injection. Example: 

        $x-> emit('0.314159 setgray');
        $x-> bar( 10, 10, 20, 20);
Helpers for translation from pixels to points and vice versa.
Wrappers for PS outline that are expected to be either filled or stroked. Apply colors, line, and fill styles if necessary.
Prima::PS::PostScript is not responsible for the output of the generated document, it only calls the "::spool" method when the document is closed through an "::end_doc" call. By default discards the data. The "Prima::PS::Printer" class handles the spooling logic.
Calls Prima::Application::fonts and returns its output filtered so that only the fonts that support the "iso10646-1" encoding are present. This effectively allows only unicode output.
2024-02-01 perl v5.38.2