/usr/lib/perl5/Gtk2/ImageView/Tool.pod is in libgtk2-imageview-perl 0.05-1build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 | =head1 NAME
Gtk2::ImageView::Tool - Interface for objects capable of being used as tools by Gtk2::ImageView
=cut
=for position DESCRIPTION
=head1 DESCRIPTION
Gtk2::ImageView::Tool is an interface that defines how Gtk2::ImageView interacts with objects that acts as tools. Gtk2::ImageView delegates many of its most important tasks (such as drawing) to its tool which carries out all the hard work. The Gtk2::ImageView package comes with two tools; Gtk2::ImageView::Tool::Dragger and Gtk2::ImageView::Tool::Selector, but by implementing your own tool it is possible to extend Gtk2::ImageView to do stuff its author didn't imagine.
Gtk2::ImageView uses Gtk2::ImageView::Tool::Dragger by default, as that tool is he most generally useful one. However, it is trivial to make it use another tool.
my $view = Gtk2::ImageView->new;
my $tool = Gtk2::ImageView::Tool::Selector ($view);
$view->set_tool ($tool);
Using the above code makes the view use the selector tool instead of the default dragger tool.
=cut
=head1 HIERARCHY
Glib::Interface
+----Gtk2::ImageView::Tool
=cut
=for object Gtk2::ImageView::Tool Interface for objects capable of being used as tools by Gtk2::ImageView
=cut
=head1 METHODS
=head2 boolean = $tool-E<gt>B<button_press> ($ev)
=over
=item * $ev (Gtk2::Gdk::Event)
=back
=head2 boolean = $tool-E<gt>B<button_release> ($ev)
=over
=item * $ev (Gtk2::Gdk::Event)
=back
=head2 cursor = $tool-E<gt>B<cursor_at_point> ($x, $y)
=over
=item * $x (integer)
=item * $y (integer)
=back
Returns the cursor to display at the given coordinates.
=head2 boolean = $tool-E<gt>B<motion_notify> ($ev)
=over
=item * $ev (Gtk2::Gdk::Event)
=back
=head2 $tool-E<gt>B<paint_image> ($opts, $drawable)
=over
=item * $opts (Gtk2::Gdk::Pixbuf::Draw::Opts)
=item * $drawable (Gtk2::Gdk::Drawable)
=back
Called whenever the image view decides that any part of the image it shows needs
to be redrawn.
=head2 $tool-E<gt>B<pixbuf_changed> ($reset_fit, $rect)
=over
=item * $reset_fit (boolean)
=item * $rect (Gtk2::Gdk::Rectangle)
=back
Indicate to the tool that either a part of, or the whole pixbuf that the image
view shows has changed. This method is called by the view whenever its pixbuf or
its tool changes. That is, when any of the following methods are used:
=over
=item Gtk2::ImageView::set_pixbuf()
=item Gtk2::ImageView::set_tool()
=item Gtk2::ImageView::damage_pixels()
=back
If the reset_fit parameter is TRUE, it means that a new pixbuf has been loaded
into the view.
=over
=item tool : the tool
=item reset_fit : whether the view is resetting its fit mode or not
=item rect : rectangle containing the changed area or NULL
=back
=cut
=head1 SEE ALSO
L<Gtk2::ImageView>, L<Glib::Interface>
=cut
=head1 COPYRIGHT
Copyright (C) 2007 by Jeffrey Ratcliffe.
This software is licensed under the GPL-3; see L<Gtk2::ImageView> for a full notice.
=cut
|