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


NAME

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


SYNOPSIS

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


DESCRIPTION

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.

::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 routines

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 transformation from pixel to points and vice versa.

fill and 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.

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