NAME

Tk::Image::Cut - Perl extension for a graphic user interface to cut pictures.

SYNOPSIS

 use Tk::Image::Cut;
 my $mw = MainWindow->new();
 $mw->title("Picture-Cutter");
 $mw->geometry("+5+5");
 my $cut = $mw->Cut()->grid();
 $mw->Button(
        -text           => "Exit",
        -command        => sub { exit(); },
        )->grid();
 for(qw/
        ButtonSelectImage
        LabelShape
        bEntryShape
        ButtonColor
        LabelWidthOut
        EntryWidthOut
        LabelHeightOut
        EntryHeightOut
        ButtonIncrease
        ButtonReduce
        LabelNameOut
        EntryNameOut
        ButtonCut
        /)
        {
        $cut->Subwidget($_)->configure(
                -font           => "{Times New Roman} 10 {bold}",
                );
        }
 for(qw/
        bEntryShape
        EntryWidthOut
        EntryHeightOut
        EntryNameOut
        Canvas
        /)
        {
        $cut->Subwidget($_)->configure(
                -background     => "#FFFFFF",
                );
        }
 for(qw/
        bEntryShape
        EntryWidthOut
        EntryHeightOut
        /)
        {
        $cut->Subwidget($_)->configure(
                -width          => 6,
                );
        }
 $cut->Subwidget("EntryNameOut")->configure(
                -width          => 40,
                );
 $cut->Subwidget("Canvas")->configure(
        -width          => 1000,
        -height         => 800,
        );
 MainLoop();

DESCRIPTION

 Perl extension for a graphic user interface to cut pictures.
 The module is a mixed widget from Buttons, Labels, BrowseEntry, Entrys and Canvas widgets.
 I hope the graphic user interface is simple enough to be understood without great declarations.
 It can be used as an independent application or just like how any other widget. 
 Try out the test.pl program.You can select between four cutting forms.
 "rectangle", "oval", "circle" or "polygon"
 In order to cut out pictures in circular form or ovally click
 with the left mouse button onto the upper left corner and hold the
 button pressed while the mouse is moved.
 In order to cut pictures in polygon form you click with the left mouse button 
 on the first point and draw the mouse to the next point. If you have drawn 
 the last point you click with the right mouse button.

 You can use all standard widget options.

CONSTRUCTOR AND INITIALIZATION

 use Tk;
 use Tk::Image::Cut;
 my $mw = MainWidow->new();
 my $cut = $mw->Cut(
        -aperturewidth  => 2,
        -aperturecolor  => "#0000FF",
        -shape          => "oval",
        -zoom           => 2,
        -shrink         => 1
        )->pack();
 $cut->Subwidget("Canvas")->configure(
        -width          => 1000,
        -height         => 800,
        );
 MainLoop();

WIDGET SPECIFIC OPTINOS

-aperturecolor

The margin color of the aperture. default: "#00FF00" (green)

-aperturewidth

The border of the aperture. default: 4

-shape

The shape of the aperture "rectangle", "oval", "circle" or "polygon". default: "rectangle"

-zoom

default: 1

-shrink

default: 1

INSERTED WIDGETS

<ButtonSelectImage>

Selecting the picture to be worked on.

<LabelShape>

<bEntryShape>

You can select between three cutting forms. "rectangle", "oval", "circle" or "polygon" default: "rectangle"

<ButtonColor>

Define the background color for the picture. Is no color indicated then transparent is used.

<LabelWidthOut>

<EntryWidthOut>

Shows the width of the new picture.

<LabelHeightOut>

<EntryHeightOut>

Shows the height of the new picture.

<ButtonIncrease>

Extend the new picture.

<ButtonReduce>

Reduce the new picture.

<LabelNameOut>

<EntryNameOut>

Shows the name of the new picture. Of course this can be changed any.

<ButtonCut>

Creates the new picture.

<Canvas>

Shows the picture.

EXPORT

None by default.

SEE ALSO

 Tk::Image
 Tk::Photo
 Tk::Image::Calculation
 http://www.planet-interkom.de/t.knorr/index.html

KEYWORDS

image, photo, cut, picture, widget

BUGS

 Maybe you'll find some. Please let me know.

AUTHOR

Torsten Knorr, <torstenknorr@tiscali.de>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Torsten Knorr

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.9.2 or, at your option, any later version of Perl 5 you may have available.