Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  PRIMA::PS::DRAWABLE (3)

.ds Aq ’


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



        use Prima;
        use Prima::PS::Drawable;

        my $x = Prima::PS::Drawable-> create( onSpool => sub {
                open F, ">> ./";
                print F $_[1];
                close F;
        die "error:$@" unless $x-> begin_doc;
        $x-> font-> size( 30);
        $x-> text_out( "hello!", 100, 100);
        $x-> end_doc;


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

    Inherited properties

::resolution Can be set while object is in normal stage - cannot be changed if document is opened. Applies to fillPattern realization and general pixel-to-point and vice versa calculations
::region - ::region is not realized ( yet?)

    Specific properties

::copies amount of copies that PS interpreter should print
::grayscale could be 0 or 1
::pageSize physical page dimension, in points
::pageMargins non-printable page area, an array of 4 integers: left, bottom, right and top margins in points.
::reversed if 1, a 90 degrees rotated document layout is assumed
::rotate and ::scale along with Prima::Drawable::translate provide PS-specific transformation matrix manipulations. ::rotate is number, measured in degrees, counter-clockwise. ::scale is array of two numbers, respectively x- and y-scale. 1 is 100%, 2 is 200% etc.
::useDeviceFonts 1 by default; optimizes greatly text operations, but takes the risk that a character could be drawn incorrectly or not drawn at all - this behavior depends on a particular PS interpreter.
::useDeviceFontsOnly If 1, the system fonts, available from Prima::Application interfaces can not be used. It is designed for developers and the outside-of-Prima applications that wish to use PS generation module without graphics. If 1, ::useDeviceFonts is set to 1 automatically.

Default value is 0

    Internal methods

emit Can be called for direct PostScript code injection. Example:

        $x-> emit(0.314159 setgray);
        $x-> bar( 10, 10, 20, 20);

pixel2point and point2pixel Helpers for translation from pixel to points and vice versa.
fill & stroke Wrappers for PS outline that is expected to be filled or stroked. Apply colors, line and fill styles if necessary.
spool Prima::PS::Drawable is not responsible for output of generated document, it just calls ::spool when document is closed through ::end_doc. By default just skips data. Prima::PS::Printer handles spooling logic.
fonts Returns Prima::Application::font plus those that defined into Prima::PS::Fonts module.
Search for    or go to Top of page |  Section 3 |  Main Index

perl v5.20.3 PRIMA::PS::DRAWABLE (3) 2015-10-27

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.