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
|
#include "gtkimageviewperl.h"
MODULE = Gtk2::ImageView::Tool PACKAGE = Gtk2::ImageView::Tool PREFIX = gtk_iimage_tool_
=for object Gtk2::ImageView::Tool
=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
gboolean
gtk_iimage_tool_button_press (tool, ev)
GtkIImageTool * tool
GdkEvent * ev
C_ARGS:
tool, (GdkEventButton *) ev
gboolean
gtk_iimage_tool_button_release (tool, ev)
GtkIImageTool * tool
GdkEvent * ev
C_ARGS:
tool, (GdkEventButton *) ev
gboolean
gtk_iimage_tool_motion_notify (tool, ev)
GtkIImageTool * tool
GdkEvent * ev
C_ARGS:
tool, (GdkEventMotion *) ev
=for apidoc
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
void
gtk_iimage_tool_pixbuf_changed (tool, reset_fit, rect)
GtkIImageTool * tool
gboolean reset_fit
GdkRectangle * rect
=for apidoc
Called whenever the image view decides that any part of the image it shows needs to be redrawn.
=over
=item tool : the tool
=item opts : the Gtk2::Gdk::Pixbuf::DrawOpts to use in this draw
=item drawable : a Gtk2::Gdk::Drawable to draw on
=back
=cut
void
gtk_iimage_tool_paint_image (tool, opts, drawable)
GtkIImageTool * tool
GdkPixbufDrawOpts * opts
GdkDrawable * drawable
=for apidoc
Ask the tool what cursor it wants displayed.
=over
=item tool : the tool
=item x : the mouse pointers X-coordinate
=item y : the mouse pointers Y-coordinate
=back
=head3 Returns
=over
=item The appropriate cursor.
=back
=cut
GdkCursor *
gtk_iimage_tool_cursor_at_point (tool, x, y)
GtkIImageTool * tool
int x
int y
|
