Prima::...stScript(3)

💅 Prima::...stScript(3) — Prima::PS::PostScript 💅

okay bestie, welcome to the User Contributed Perl Documentation page for Prima::...stScript(3) — aka Prima::PS::PostScript. it's giving PostScript realness, and we're gonna get through it together 🫶

---

✨ 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 💖

• resolution — 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 — "alpha" is not implemented.

---

🦋 Specific properties 🦋

• copies — The number of copies that the PS interpreter should print.
• grayscale — could be 0 or 1.
• pageSize — The 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.

---

🧚 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 pixels to points and vice versa.
• fill & stroke — Wrappers for PS outline that are expected to be either filled or stroked. Apply colors, line, and fill styles if necessary.
• spool — 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.
• fonts — 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.

---

mwah 💋 — this page is from perl v5.42.0, dated 2024-08-20, and it belongs to Prima::...stScript(3). bye bestie 🫶✨