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
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
// SPDX-License-Identifier: GPL-2.0-or-later
#ifndef SEEN_SP_KNOT_H
#define SEEN_SP_KNOT_H
/** \file
* Declarations for SPKnot: Desktop-bound visual control object.
*/
/*
* Authors:
* Lauris Kaplinski <lauris@kaplinski.com>
*
* Copyright (C) 1999-2002 authors
* Copyright (C) 2001-2002 Ximian, Inc.
*
* Released under GNU GPL v2+, read the file 'COPYING' for more information.
*/
#include <2geom/point.h>
#include <sigc++/sigc++.h>
#include <glibmm/ustring.h>
#include <glibmm/refptr.h>
#include <gdkmm/cursor.h>
#include "knot-enums.h"
#include "display/control/canvas-item-enums.h"
#include "enums.h"
class SPDesktop;
class SPItem;
typedef union _GdkEvent GdkEvent;
typedef unsigned int guint32;
#define SP_KNOT(obj) (dynamic_cast<SPKnot*>(static_cast<SPKnot*>(obj)))
#define SP_IS_KNOT(obj) (dynamic_cast<const SPKnot*>(static_cast<const SPKnot*>(obj)) != NULL)
namespace Inkscape {
class CanvasItemCtrl;
}
/**
* Desktop-bound visual control object.
*
* A knot is a draggable object, with callbacks to change something by
* dragging it, visually represented by a canvas item (mostly square).
*
* See also KnotHolderEntity.
* See also ControlPoint (which does the same kind of things).
*/
class SPKnot {
public:
SPKnot(SPDesktop *desktop, char const *tip, Inkscape::CanvasItemCtrlType type, Glib::ustring const & name = Glib::ustring("unknown"));
virtual ~SPKnot();
SPKnot(SPKnot const&) = delete;
SPKnot& operator=(SPKnot const&) = delete;
int ref_count; // FIXME encapsulation
SPDesktop *desktop = nullptr; /**< Desktop we are on. */
Inkscape::CanvasItemCtrl *ctrl = nullptr; /**< Our CanvasItemCtrl. */
SPItem *owner = nullptr; /**< Optional Owner Item */
SPItem *sub_owner = nullptr; /**< Optional SubOwner Item */
unsigned int flags = SP_KNOT_VISIBLE;
unsigned int size = 9; /**< Always square. Must be odd. */
bool size_set = false; /**< Use default size unless explicitly set. */
double angle = 0.0; /**< Angle of mesh handle. */
Geom::Point pos; /**< Our desktop coordinates. */
Geom::Point grabbed_rel_pos; /**< Grabbed relative position. */
Geom::Point drag_origin; /**< Origin of drag. */
SPAnchorType anchor = SP_ANCHOR_CENTER; /**< Anchor. */
bool grabbed = false;
bool moved = false;
int xp = 0.0; /**< Where drag started */
int yp = 0.0; /**< Where drag started */
int tolerance = 0;
bool within_tolerance = false;
bool transform_escaped = false; // true iff resize or rotate was cancelled by esc.
Inkscape::CanvasItemCtrlShape shape = Inkscape::CANVAS_ITEM_CTRL_SHAPE_SQUARE; /**< Shape type. */
bool shape_set = false; /**< Use default shape unless explicitly set. */
Inkscape::CanvasItemCtrlMode mode = Inkscape::CANVAS_ITEM_CTRL_MODE_XOR;
guint32 fill[SP_KNOT_VISIBLE_STATES];
guint32 stroke[SP_KNOT_VISIBLE_STATES];
unsigned char *image[SP_KNOT_VISIBLE_STATES];
Glib::RefPtr<Gdk::Cursor> _cursors[SP_KNOT_VISIBLE_STATES];
void* pixbuf = nullptr;
char *tip = nullptr;
sigc::connection _event_connection;
double pressure = 0.0; /**< The tablet pen pressure when the knot is being dragged. */
// FIXME: signals should NOT need to emit the object they came from, the callee should
// be able to figure that out
sigc::signal<void, SPKnot *, unsigned int> click_signal;
sigc::signal<void, SPKnot*, unsigned int> doubleclicked_signal;
sigc::signal<void, SPKnot*, unsigned int> mousedown_signal;
sigc::signal<void, SPKnot*, unsigned int> grabbed_signal;
sigc::signal<void, SPKnot *, unsigned int> ungrabbed_signal;
sigc::signal<void, SPKnot *, Geom::Point const &, unsigned int> moved_signal;
sigc::signal<bool, SPKnot*, GdkEvent*> event_signal;
sigc::signal<bool, SPKnot*, Geom::Point*, unsigned int> request_signal;
//TODO: all the members above should eventualle become private, accessible via setters/getters
void setSize(unsigned int i);
void setShape(Inkscape::CanvasItemCtrlShape s);
void setAnchor(unsigned int i);
void setMode(Inkscape::CanvasItemCtrlMode m);
void setPixbuf(void* p);
void setAngle(double i);
void setFill(guint32 normal, guint32 mouseover, guint32 dragging, guint32 selected);
void setStroke(guint32 normal, guint32 mouseover, guint32 dragging, guint32 selected);
void setImage(unsigned char* normal, unsigned char* mouseover, unsigned char* dragging, unsigned char* selected);
void setCursor(SPKnotStateType type, Glib::RefPtr<Gdk::Cursor> cursor);
/**
* Show knot on its canvas.
*/
void show();
/**
* Hide knot on its canvas.
*/
void hide();
/**
* Set flag in knot, with side effects.
*/
void setFlag(unsigned int flag, bool set);
/**
* Update knot's pixbuf and set its control state.
*/
void updateCtrl();
/**
* Request or set new position for knot.
*/
void requestPosition(Geom::Point const &pos, unsigned int state);
/**
* Update knot for dragging and tell canvas an item was grabbed.
*/
void startDragging(Geom::Point const &p, int x, int y, guint32 etime);
/**
* Move knot to new position and emits "moved" signal.
*/
void setPosition(Geom::Point const &p, unsigned int state);
/**
* Move knot to new position, without emitting a MOVED signal.
*/
void moveto(Geom::Point const &p);
/**
* Select knot.
*/
void selectKnot(bool select);
/**
* Returns position of knot.
*/
Geom::Point position() const;
/**
* Event handler (from CanvasItem's).
*/
bool eventHandler(GdkEvent *event);
bool is_visible() const { return (flags & SP_KNOT_VISIBLE) != 0; }
bool is_selected() const { return (flags & SP_KNOT_SELECTED) != 0; }
bool is_mouseover() const { return (flags & SP_KNOT_MOUSEOVER) != 0; }
bool is_dragging() const { return (flags & SP_KNOT_DRAGGING) != 0; }
bool is_grabbed() const { return (flags & SP_KNOT_GRABBED) != 0; }
private:
/**
* Set knot control state (dragging/mouseover/normal).
*/
void _setCtrlState();
};
void knot_ref(SPKnot* knot);
void knot_unref(SPKnot* knot);
void sp_knot_handler_request_position(GdkEvent *event, SPKnot *knot);
#endif // SEEN_SP_KNOT_H
/*
Local Variables:
mode:c++
c-file-style:"stroustrup"
c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
indent-tabs-mode:nil
fill-column:99
End:
*/
// vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:fileencoding=utf-8:textwidth=99 :
|
