NAME

App::MathImage::Image::Base::Prima::Drawable -- draw into Prima window, image, etc

SYNOPSIS

 use App::MathImage::Image::Base::Prima::Drawable;
 my $image = App::MathImage::Image::Base::Prima::Drawable->new
               (-drawable => $d);
 $image->line (0,0, 99,99, '#FF00FF');
 $image->rectangle (10,10, 20,15, 'white');

CLASS HIERARCHY

App::MathImage::Image::Base::Prima::Drawable is a subclass of Image::Base,

    Image::Base
      App::MathImage::Image::Base::Prima::Drawable

DESCRIPTION

App::MathImage::Image::Base::Prima::Drawable extends Image::Base to draw into a Prima::Drawable drawables, meaning a widget window, off-screen image, printer, etc.

The native Prima drawing has lots more features, but this module is an easy way to point Image::Base style code at a Prima image etc.

Colours names for drawing are the "Blue" etc from the Prima colour constants cl::Blue etc (see "Color space" in Prima::Drawable), plus 2-digit #RRGGBB or 4-digit #RRRRGGGGBBBB hex. Internally Prima works in 8-bit RGB components, so 4-digit values are truncated.

X,Y coordinates are the usual Image::Base style 0,0 at the top-left corner. Prima works from 0,0 as the bottom-left but App::MathImage::Image::Base::Prima::Drawable converts. There's no support for the Prima "translate" origin shift yet.

None of the drawing functions do a $drawable->begin_paint. That's left to the application, and of course happens automatically for an onPaint handler. The symptom of forgetting is that lines, rectangles and ellipses don't draw anything. (In the current code xy might come out since it uses $drawable->pixel, but don't rely on that.)

FUNCTIONS

$image = App::MathImage::Image::Base::Prima::Drawable->new (key=>value,...)

Create and return a new image object. A Prima::Drawable object must be given.

    $image = App::MathImage::Image::Base::Prima::Drawable->new (-drawable => $d);

$colour = $image->xy ($x, $y)

$image->xy ($x, $y, $colour)

Get or set the pixel at $x,$y.

Currently colours returned by a get are always 2-digit hex #RRGGBB.

ATTRIBUTES

-drawable (XID integer)

The target drawable.

-width (integer, read-only)

-height (integer, read-only)

The width and height of the underlying drawable.

SEE ALSO

Image::Base, Prima::Drawable