NAME Tk::RotCanvas - Canvas widget with arbitrary rotation support SYNOPSIS $canvas = $parent->RotCanvas(?options?); my $obj = $canvas->create('polygon', @coords, %options); $canvas->rotate($obj, $angle, ?x, y?); DESCRIPTION This module is a small wrapper around the `Canvas' widget that adds a new rotate() method. This method allows the rotation of various canvas objects by arbitrary angles. NEW METHODS As mentioned previously, there is only one new method. All other canvas methods work as expected. *$canvas*->rotate(*TagOrID, angle* ?,*x, y*?) This method rotates the object identified by TagOrID by an angle *angle*. The angle is specified in *degrees*. If a coordinate is specified, then the object is rotated about that point. Else, the object is rotated about its center of mass. LIMITATIONS As it stands, the module can only handle the following object types: * Lines * Rectangles * Polygons All other object types (bitmap, image, arc, text, window and oval) can not be handled yet. A warning is issued if the user tries to rotate one of these object types. Hopefully, more types will be handled in the future. MORE DETAILS YOU DON'T NEED TO KNOW To be able to handle rectangles, the module intercepts any calls to createRectangle() and create() and changes all rectangles to polygons. The user should not be alarmed if type() returned *polygon* when a *rectangle* was expected. INSTALLATION You can install this module using the standard method: perl Makefile.PL make make test make install The above procedures will install the module in a place where Perl will find it. The last step assumes that you have the proper permissions. Alternatively, since the module is in pure Perl, you can untar the distribution, and find the Tk/RotCanvas.pm module, and put it in an appropriate local Perl subdirectory. AUTHOR Ala Qumsieh *aqumsieh@hyperchip.com* COPYRIGHTS This module is distributed under the same terms as Perl itself.