.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "Gnome2::Canvas 3pm"
.TH Gnome2::Canvas 3pm "2017-07-23" "perl v5.26.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Gnome2::Canvas \-  A structured graphics canvas
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 11
\&  use strict;
\&  use Gtk2 \-init;
\&  use Gnome2::Canvas;
\&  my $window = Gtk2::Window\->new;
\&  my $scroller = Gtk2::ScrolledWindow\->new;
\&  my $canvas = Gnome2::Canvas\->new;
\&  $scroller\->add ($canvas);
\&  $window\->add ($scroller);
\&  $window\->set_default_size (150, 150);
\&  $canvas\->set_scroll_region (0, 0, 200, 200);
\&  $window\->show_all;
\&
\&  my $root = $canvas\->root;
\&  Gnome2::Canvas::Item\->new ($root, \*(AqGnome2::Canvas::Text\*(Aq,
\&                             x => 20,
\&                             y => 15,
\&                             fill_color => \*(Aqblack\*(Aq,
\&                             font => \*(AqSans 14\*(Aq,
\&                             anchor => \*(AqGTK_ANCHOR_NW\*(Aq,
\&                             text => \*(AqHello, World!\*(Aq);
\&  my $box = Gnome2::Canvas::Item\->new ($root, \*(AqGnome2::Canvas::Rect\*(Aq,
\&                                       x1 => 10, y1 => 5,
\&                                       x2 => 150, y2 => 135,
\&                                       fill_color => \*(Aqred\*(Aq,
\&                                       outline_color => \*(Aqblack\*(Aq);
\&  $box\->lower_to_bottom;
\&  $box\->signal_connect (event => sub {
\&          my ($item, $event) = @_;
\&          warn "event ".$event\->type."\en";
\&  });
\&
\&  Gtk2\->main;
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The Gnome Canvas is an engine for structured graphics that offers a
rich imaging model, high-performance rendering, and a powerful,
high level \s-1API.\s0  It offers a choice of two rendering back-ends,
one based on \s-1GDK\s0 for extremely fast display, and another based on
Libart, a sophisticated, antialiased, alpha-compositing engine.
This widget can be used for flexible display of graphics and for
creating interactive user interface elements.
.PP
To create a new Gnome2::Canvas widget call \f(CW\*(C`Gnome2::Canvas\->new\*(C'\fR or
\&\f(CW\*(C`Gnome2::Canvas\->new_aa\*(C'\fR for an anti-aliased mode canvas.
.PP
A Gnome2::Canvas contains one or more Gnome2::CanvasItem
objects. Items consist of graphing elements like lines, ellipses,
polygons, images, text, and curves.  These items are organized using
Gnome2::CanvasGroup objects, which are themselves derived from
Gnome2::CanvasItem.  Since a group is an item it can be contained within
other groups, forming a tree of canvas items.  Certain operations, like
translating and scaling, can be performed on all items in a group.
.PP
There is a special root group created by a Gnome2::Canvas.  This is the top
level group under which all items in a canvas are contained.  The root group
is available as \f(CW\*(C`$canvas\->root\*(C'\fR.
.PP
There are several different coordinate systems used by Gnome2::Canvas
widgets.  The primary system is a logical, abstract coordinate space
called world coordinates.  World coordinates are expressed as unbounded
double floating point numbers.  When it comes to rendering to a screen
the canvas pixel coordinate system (also referred to as just canvas
coordinates) is used.  This system uses integers to specify screen
pixel positions.  A user defined scaling factor and offset are used to
convert between world coordinates and canvas coordinates.  Each item in
a canvas has its own coordinate system called item coordinates.  This
system is specified in world coordinates but they are relative to an
item (0.0, 0.0 would be the top left corner of the item).  The final
coordinate system of interest is window coordinates.  These are like
canvas coordinates but are offsets from within a window a canvas is
displayed in.  This last system is rarely used, but is useful when
manually handling \s-1GDK\s0 events (such as drag and drop) which are 
specified in window coordinates (the events processed by the canvas
are already converted for you).
.PP
Along with different coordinate systems come methods to convert
between them.  \f(CW\*(C`$canvas\->w2c\*(C'\fR converts world to canvas pixel
coordinates and \f(CW\*(C`canvas\->c2w\*(C'\fR converts from canvas to
world.  To get the affine transform matrix for converting
from world coordinates to canvas coordinates call \f(CW\*(C`$canvas\->w2c_affine\*(C'\fR.
\&\f(CW\*(C`$canvas\->window_to_world\*(C'\fR converts from window to world
coordinates and \f(CW\*(C`$canvas\->world_to_window\*(C'\fR converts in the other
direction.  There are no methods for converting between canvas and
window coordinates, since this is just a matter of subtracting the
canvas scrolling offset.  To convert to/from item coordinates use the
methods defined for Gnome2::CanvasItem objects.
.PP
To set the canvas zoom factor (canvas pixels per world unit, the
scaling factor) call \f(CW\*(C`$canvas\->set_pixels_per_unit\*(C'\fR; setting this
to 1.0 will cause the two coordinate systems to correspond (e.g., [5, 6]
in pixel units would be [5.0, 6.0] in world units).
.PP
Defining the scrollable area of a canvas widget is done by calling
\&\f(CW\*(C`$canvas\->set_scroll_region\*(C'\fR and to get the current region
\&\f(CW\*(C`$canvas\->get_scroll_region\*(C'\fR can be used.  If the window is
larger than the canvas scrolling region it can optionally be centered
in the window.  Use \f(CW\*(C`$canvas\->set_center_scroll_region\*(C'\fR to enable or
disable this behavior.  To scroll to a particular canvas pixel coordinate
use \f(CW\*(C`$canvas\->scroll_to\*(C'\fR (typically not used since scrollbars are
usually set up to handle the scrolling), and to get the current canvas pixel
scroll offset call \f(CW\*(C`$canvas\->get_scroll_offsets\*(C'\fR.
.SH "HIERARCHY"
.IX Header "HIERARCHY"
.Vb 7
\&  Glib::Object
\&  +\-\-\-\-Glib::InitiallyUnowned
\&       +\-\-\-\-Gtk2::Object
\&            +\-\-\-\-Gtk2::Widget
\&                 +\-\-\-\-Gtk2::Container
\&                      +\-\-\-\-Gtk2::Layout
\&                           +\-\-\-\-Gnome2::Canvas
.Ve
.SH "INTERFACES"
.IX Header "INTERFACES"
.Vb 2
\&  Glib::Object::_Unregistered::AtkImplementorIface
\&  Gtk2::Buildable
.Ve
.SH "METHODS"
.IX Header "METHODS"
.SS "widget = Gnome2::Canvas\->\fBnew\fP"
.IX Subsection "widget = Gnome2::Canvas->new"
Create a new empty canvas in non-antialiased mode.
.SS "widget = Gnome2::Canvas\->\fBnew_aa\fP"
.IX Subsection "widget = Gnome2::Canvas->new_aa"
Create a new empty canvas in antialiased mode.
.ie n .SS "boolean = $canvas\->\fBaa\fP"
.el .SS "boolean = \f(CW$canvas\fP\->\fBaa\fP"
.IX Subsection "boolean = $canvas->aa"
Returns true if \fI\f(CI$canvas\fI\fR was created in anti-aliased mode.
.ie n .SS "($bx1, $by1, $bx2, $by2) = Gnome2::Canvas\->\fBget_butt_points\fP ($x1, $y1, $x2, $y2, $width, $project)"
.el .SS "($bx1, \f(CW$by1\fP, \f(CW$bx2\fP, \f(CW$by2\fP) = Gnome2::Canvas\->\fBget_butt_points\fP ($x1, \f(CW$y1\fP, \f(CW$x2\fP, \f(CW$y2\fP, \f(CW$width\fP, \f(CW$project\fP)"
.IX Subsection "($bx1, $by1, $bx2, $by2) = Gnome2::Canvas->get_butt_points ($x1, $y1, $x2, $y2, $width, $project)"
.IP "\(bu" 4
\&\f(CW$x1\fR (double)
.IP "\(bu" 4
\&\f(CW$y1\fR (double)
.IP "\(bu" 4
\&\f(CW$x2\fR (double)
.IP "\(bu" 4
\&\f(CW$y2\fR (double)
.IP "\(bu" 4
\&\f(CW$width\fR (double)
.IP "\(bu" 4
\&\f(CW$project\fR (integer)
.ie n .SS "(wx, wy) = $canvas\->\fBc2w\fP ($cx, $cy)"
.el .SS "(wx, wy) = \f(CW$canvas\fP\->\fBc2w\fP ($cx, \f(CW$cy\fP)"
.IX Subsection "(wx, wy) = $canvas->c2w ($cx, $cy)"
.IP "\(bu" 4
\&\f(CW$cx\fR (integer)
.IP "\(bu" 4
\&\f(CW$cy\fR (integer)
.ie n .SS "boolean = $canvas\->\fBget_center_scroll_region\fP"
.el .SS "boolean = \f(CW$canvas\fP\->\fBget_center_scroll_region\fP"
.IX Subsection "boolean = $canvas->get_center_scroll_region"
.ie n .SS "$canvas\->\fBset_center_scroll_region\fP ($center_scroll_region)"
.el .SS "\f(CW$canvas\fP\->\fBset_center_scroll_region\fP ($center_scroll_region)"
.IX Subsection "$canvas->set_center_scroll_region ($center_scroll_region)"
.IP "\(bu" 4
\&\f(CW$center_scroll_region\fR (boolean)
.ie n .SS "list = $canvas\->\fBget_color\fP ($spec)"
.el .SS "list = \f(CW$canvas\fP\->\fBget_color\fP ($spec)"
.IX Subsection "list = $canvas->get_color ($spec)"
.IP "\(bu" 4
\&\f(CW$spec\fR (string)
.PP
Returns an integer indicating the success of the color allocation and a
GdkColor.
.ie n .SS "unsigned = $canvas\->\fBget_color_pixel\fP ($rgba)"
.el .SS "unsigned = \f(CW$canvas\fP\->\fBget_color_pixel\fP ($rgba)"
.IX Subsection "unsigned = $canvas->get_color_pixel ($rgba)"
.IP "\(bu" 4
\&\f(CW$rgba\fR (integer)
.ie n .SS "rgbdither = $canvas\->\fBget_dither\fP"
.el .SS "rgbdither = \f(CW$canvas\fP\->\fBget_dither\fP"
.IX Subsection "rgbdither = $canvas->get_dither"
.ie n .SS "$canvas\->\fBset_dither\fP ($dither)"
.el .SS "\f(CW$canvas\fP\->\fBset_dither\fP ($dither)"
.IX Subsection "$canvas->set_dither ($dither)"
.IP "\(bu" 4
\&\f(CW$dither\fR (Gtk2::Gdk::RgbDither)
.ie n .SS "item = $canvas\->\fBget_item_at\fP ($x, $y)"
.el .SS "item = \f(CW$canvas\fP\->\fBget_item_at\fP ($x, \f(CW$y\fP)"
.IX Subsection "item = $canvas->get_item_at ($x, $y)"
.IP "\(bu" 4
\&\f(CW$x\fR (double)
.IP "\(bu" 4
\&\f(CW$y\fR (double)
.ie n .SS "($mx1, $my1, $mx2, $my2) = Gnome2::Canvas\->\fBget_miter_points\fP ($x1, $y1, $x2, $y2, $x3, $y3, $width)"
.el .SS "($mx1, \f(CW$my1\fP, \f(CW$mx2\fP, \f(CW$my2\fP) = Gnome2::Canvas\->\fBget_miter_points\fP ($x1, \f(CW$y1\fP, \f(CW$x2\fP, \f(CW$y2\fP, \f(CW$x3\fP, \f(CW$y3\fP, \f(CW$width\fP)"
.IX Subsection "($mx1, $my1, $mx2, $my2) = Gnome2::Canvas->get_miter_points ($x1, $y1, $x2, $y2, $x3, $y3, $width)"
.IP "\(bu" 4
\&\f(CW$x1\fR (double)
.IP "\(bu" 4
\&\f(CW$y1\fR (double)
.IP "\(bu" 4
\&\f(CW$x2\fR (double)
.IP "\(bu" 4
\&\f(CW$y2\fR (double)
.IP "\(bu" 4
\&\f(CW$x3\fR (double)
.IP "\(bu" 4
\&\f(CW$y3\fR (double)
.IP "\(bu" 4
\&\f(CW$width\fR (double)
.ie n .SS "double = $canvas\->\fBget_pixels_per_unit\fP"
.el .SS "double = \f(CW$canvas\fP\->\fBget_pixels_per_unit\fP"
.IX Subsection "double = $canvas->get_pixels_per_unit"
Fetch \fI\f(CI$canvas\fI\fR' scale factor.
.ie n .SS "$canvas\->\fBset_pixels_per_unit\fP ($n)"
.el .SS "\f(CW$canvas\fP\->\fBset_pixels_per_unit\fP ($n)"
.IX Subsection "$canvas->set_pixels_per_unit ($n)"
.IP "\(bu" 4
\&\f(CW$n\fR (double)
.PP
Set the zooming factor of \fI\f(CI$canvas\fI\fR by specifying the number of screen
pixels that correspond to one canvas unit.
.ie n .SS "double = Gnome2::Canvas\->\fBpolygon_to_point\fP ($poly_ref, $x, $y)"
.el .SS "double = Gnome2::Canvas\->\fBpolygon_to_point\fP ($poly_ref, \f(CW$x\fP, \f(CW$y\fP)"
.IX Subsection "double = Gnome2::Canvas->polygon_to_point ($poly_ref, $x, $y)"
.IP "\(bu" 4
\&\f(CW$poly_ref\fR (arrayref) coordinate pairs that make up the polygon
.IP "\(bu" 4
\&\f(CW$x\fR (double)
.IP "\(bu" 4
\&\f(CW$y\fR (double)
.PP
Return the distance from the point \fI\f(CI$x\fI\fR,\fI\f(CI$y\fI\fR to the polygon described by
the vertices in \fI\f(CI$poly_ref\fI\fR, or zero if the point is inside the polygon.
.ie n .SS "$canvas\->\fBrequest_redraw\fP ($x1, $y1, $x2, $y2)"
.el .SS "\f(CW$canvas\fP\->\fBrequest_redraw\fP ($x1, \f(CW$y1\fP, \f(CW$x2\fP, \f(CW$y2\fP)"
.IX Subsection "$canvas->request_redraw ($x1, $y1, $x2, $y2)"
.IP "\(bu" 4
\&\f(CW$x1\fR (integer)
.IP "\(bu" 4
\&\f(CW$y1\fR (integer)
.IP "\(bu" 4
\&\f(CW$x2\fR (integer)
.IP "\(bu" 4
\&\f(CW$y2\fR (integer)
.ie n .SS "group = $canvas\->\fBroot\fP"
.el .SS "group = \f(CW$canvas\fP\->\fBroot\fP"
.IX Subsection "group = $canvas->root"
.ie n .SS "(cx, cy) = $canvas\->\fBget_scroll_offsets\fP"
.el .SS "(cx, cy) = \f(CW$canvas\fP\->\fBget_scroll_offsets\fP"
.IX Subsection "(cx, cy) = $canvas->get_scroll_offsets"
.ie n .SS "(x1, y1, x2, y2) = $canvas\->\fBget_scroll_region\fP"
.el .SS "(x1, y1, x2, y2) = \f(CW$canvas\fP\->\fBget_scroll_region\fP"
.IX Subsection "(x1, y1, x2, y2) = $canvas->get_scroll_region"
.ie n .SS "$canvas\->\fBset_scroll_region\fP ($x1, $y1, $x2, $y2)"
.el .SS "\f(CW$canvas\fP\->\fBset_scroll_region\fP ($x1, \f(CW$y1\fP, \f(CW$x2\fP, \f(CW$y2\fP)"
.IX Subsection "$canvas->set_scroll_region ($x1, $y1, $x2, $y2)"
.IP "\(bu" 4
\&\f(CW$x1\fR (double)
.IP "\(bu" 4
\&\f(CW$y1\fR (double)
.IP "\(bu" 4
\&\f(CW$x2\fR (double)
.IP "\(bu" 4
\&\f(CW$y2\fR (double)
.ie n .SS "$canvas\->\fBscroll_to\fP ($cx, $cy)"
.el .SS "\f(CW$canvas\fP\->\fBscroll_to\fP ($cx, \f(CW$cy\fP)"
.IX Subsection "$canvas->scroll_to ($cx, $cy)"
.IP "\(bu" 4
\&\f(CW$cx\fR (integer)
.IP "\(bu" 4
\&\f(CW$cy\fR (integer)
.ie n .SS "$canvas\->\fBset_stipple_origin\fP ($gc)"
.el .SS "\f(CW$canvas\fP\->\fBset_stipple_origin\fP ($gc)"
.IX Subsection "$canvas->set_stipple_origin ($gc)"
.IP "\(bu" 4
\&\f(CW$gc\fR (Gtk2::Gdk::GC)
.ie n .SS "$canvas\->\fBupdate_now\fP"
.el .SS "\f(CW$canvas\fP\->\fBupdate_now\fP"
.IX Subsection "$canvas->update_now"
.ie n .SS "(cx, cy) = $canvas\->\fBw2c\fP ($wx, $wy)"
.el .SS "(cx, cy) = \f(CW$canvas\fP\->\fBw2c\fP ($wx, \f(CW$wy\fP)"
.IX Subsection "(cx, cy) = $canvas->w2c ($wx, $wy)"
.IP "\(bu" 4
\&\f(CW$wx\fR (double)
.IP "\(bu" 4
\&\f(CW$wy\fR (double)
.ie n .SS "$affine = $canvas\->\fBw2c_affine\fP"
.el .SS "\f(CW$affine\fP = \f(CW$canvas\fP\->\fBw2c_affine\fP"
.IX Subsection "$affine = $canvas->w2c_affine"
Fetch the affine transform that converts from world coordinates to canvas
pixel coordinates.
.PP
Note: This method was completely broken for all
\&\f(CW$Gnome2::Canvas::VERSION\fR < 1.002.
.ie n .SS "(cx, cy) = $canvas\->\fBw2c_d\fP ($wx, $wy)"
.el .SS "(cx, cy) = \f(CW$canvas\fP\->\fBw2c_d\fP ($wx, \f(CW$wy\fP)"
.IX Subsection "(cx, cy) = $canvas->w2c_d ($wx, $wy)"
.IP "\(bu" 4
\&\f(CW$wx\fR (double)
.IP "\(bu" 4
\&\f(CW$wy\fR (double)
.ie n .SS "(worldx, worldy) = $canvas\->\fBwindow_to_world\fP ($winx, $winy)"
.el .SS "(worldx, worldy) = \f(CW$canvas\fP\->\fBwindow_to_world\fP ($winx, \f(CW$winy\fP)"
.IX Subsection "(worldx, worldy) = $canvas->window_to_world ($winx, $winy)"
.IP "\(bu" 4
\&\f(CW$winx\fR (double)
.IP "\(bu" 4
\&\f(CW$winy\fR (double)
.ie n .SS "(winx, winy) = $canvas\->\fBworld_to_window\fP ($worldx, $worldy)"
.el .SS "(winx, winy) = \f(CW$canvas\fP\->\fBworld_to_window\fP ($worldx, \f(CW$worldy\fP)"
.IX Subsection "(winx, winy) = $canvas->world_to_window ($worldx, $worldy)"
.IP "\(bu" 4
\&\f(CW$worldx\fR (double)
.IP "\(bu" 4
\&\f(CW$worldy\fR (double)
.SH "PROPERTIES"
.IX Header "PROPERTIES"
.IP "'aa' (boolean : default false : readable / writable / construct-only)" 4
.IX Item "'aa' (boolean : default false : readable / writable / construct-only)"
The antialiasing mode of the canvas.
.IP "'focused\-item' (Gnome2::Canvas::Item : default undef : readable / writable)" 4
.IX Item "'focused-item' (Gnome2::Canvas::Item : default undef : readable / writable)"
.SH "SIGNALS"
.IX Header "SIGNALS"
.PD 0
.IP "\fBdraw-background\fR (Gnome2::Canvas, Gtk2::Gdk::Drawable, integer, integer, integer, integer)" 4
.IX Item "draw-background (Gnome2::Canvas, Gtk2::Gdk::Drawable, integer, integer, integer, integer)"
.IP "\fBrender-background\fR (Gnome2::Canvas, gpointer)" 4
.IX Item "render-background (Gnome2::Canvas, gpointer)"
.PD
.SH "ENUMS AND FLAGS"
.IX Header "ENUMS AND FLAGS"
.SS "enum Gtk2::Gdk::RgbDither"
.IX Subsection "enum Gtk2::Gdk::RgbDither"
.IP "\(bu" 4
\&'none' / '\s-1GDK_RGB_DITHER_NONE\s0'
.IP "\(bu" 4
\&'normal' / '\s-1GDK_RGB_DITHER_NORMAL\s0'
.IP "\(bu" 4
\&'max' / '\s-1GDK_RGB_DITHER_MAX\s0'
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIGnome2::Canvas::index\fR\|(3pm) lists the generated Perl \s-1API\s0 reference PODs.
.PP
Frederico Mena Quintero's whitepaper on the \s-1GNOME\s0 Canvas:
http://developer.gnome.org/doc/whitepapers/canvas/canvas.html
.PP
The real GnomeCanvas is implemented in a C library; the Gnome2::Canvas module
allows a Perl developer to use the canvas like a normal gtk2\-perl object.
Like the Gtk2 module on which it depends, Gnome2::Canvas follows the C \s-1API\s0 of
libgnomecanvas\-2.0 as closely as possible while still being perlish.
Thus, the C \s-1API\s0 reference remains the canonical documentation; the Perl
reference documentation lists call signatures and argument types, and is
meant to be used in conjunction with the C \s-1API\s0 reference.
.PP
\&\s-1GNOME\s0 Canvas Library Reference Manual
http://developer.gnome.org/doc/API/2.0/libgnomecanvas/index.html
.PP
\&\fIperl\fR\|(1), \fIGlib\fR\|(3pm), \fIGtk2\fR\|(3pm).
.PP
To discuss gtk2\-perl, ask questions and flame/praise the authors,
join gtk\-perl\-list@gnome.org at lists.gnome.org.
.SH "AUTHOR"
.IX Header "AUTHOR"
muppet <scott at asofyet dot org>, with patches from
Torsten Schoenfeld <kaffetisch at web dot de>.
.PP
The \s-1DESCRIPTION\s0 section of this page is adapted from the documentation of
libgnomecanvas.
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright 2003\-2004 by the gtk2\-perl team.
.PP
This library is free software; you can redistribute it and/or
modify it under the terms of the \s-1GNU\s0 Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
.PP
This library is distributed in the hope that it will be useful,
but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0  See the \s-1GNU\s0
Library General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 Library General Public
License along with this library; if not, write to the 
Free Software Foundation, Inc., 59 Temple Place \- Suite 330, 
Boston, \s-1MA\s0  02111\-1307  \s-1USA.\s0