2006-12-10 05:33:38 +08:00
|
|
|
/* GIMP - The GNU Image Manipulation Program
|
2002-03-29 11:50:29 +08:00
|
|
|
* Copyright (C) 1995-2002 Spencer Kimball, Peter Mattis, and others
|
1997-11-25 06:05:25 +08:00
|
|
|
*
|
2009-01-18 06:28:01 +08:00
|
|
|
* This program is free software: you can redistribute it and/or modify
|
1997-11-25 06:05:25 +08:00
|
|
|
* it under the terms of the GNU General Public License as published by
|
2009-01-18 06:28:01 +08:00
|
|
|
* the Free Software Foundation; either version 3 of the License, or
|
1997-11-25 06:05:25 +08:00
|
|
|
* (at your option) any later version.
|
|
|
|
|
*
|
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
|
*
|
|
|
|
|
* You should have received a copy of the GNU General Public License
|
2009-01-18 06:28:01 +08:00
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
1997-11-25 06:05:25 +08:00
|
|
|
*/
|
2000-12-17 05:37:03 +08:00
|
|
|
|
2001-02-22 05:56:39 +08:00
|
|
|
#ifndef __GIMP_TOOL_H__
|
|
|
|
|
#define __GIMP_TOOL_H__
|
1997-11-25 06:05:25 +08:00
|
|
|
|
2003-04-16 00:05:52 +08:00
|
|
|
|
2003-04-15 22:20:19 +08:00
|
|
|
#include "core/gimpobject.h"
|
2000-01-20 03:06:13 +08:00
|
|
|
|
|
|
|
|
|
2001-02-21 20:18:09 +08:00
|
|
|
#define GIMP_TYPE_TOOL (gimp_tool_get_type ())
|
Port to glib/gtk+ 2.0 episode I (every segfault has it's beginning)
2001-07-24 Michael Natterer <mitch@gimp.org>
Port to glib/gtk+ 2.0 episode I (every segfault has it's beginning)
* configure.in: require glib/gtk+ >= 1.3.7, commented out the
gtkxmhtml stuff.
From now on, you will need glib, pango, atk and gtk+ HEAD from CVS
to hack or use GIMP HEAD.
Beware, it crashes randomly :)
* app/core/Makefile.am
* app/core/gimpmarshal.list: new file plus rules to generate
gimpmarshal.[ch] from it.
* app/core/*
* app/tools/*
* app/widgets/*
* libgimpwidgets/*: started to use the glib object system. All
core/ objects are still gtk objects however. All signals are
created using g_signal_new(). There are many gtk+ artefacts left.
Finally, we will _not_ use the gtk_signal_foo() wrappers and
friends any more.
* app/colormaps.c
* app/devices.[ch]
* app/disp_callbacks.c
* app/errorconsole.c
* app/file-save.[ch]
* app/interface.c
* app/module_db.c
* app/nav_window.c
* app/ops_buttons.c
* app/scroll.c
* app/user_install.c
* app/gui/about-dialog.c
* app/gui/brush-editor.c
* app/gui/brushes-commands.c
* app/gui/color-notebook.c
* app/gui/colormap-dialog.c
* app/gui/dialogs-commands.c
* app/gui/dialogs-constructors.c
* app/gui/file-commands.c
* app/gui/file-dialog-utils.c
* app/gui/file-new-dialog.c
* app/gui/file-open-dialog.[ch]
* app/gui/file-save-dialog.c
* app/gui/gradient-editor.c
* app/gui/gradients-commands.c
* app/gui/image-commands.c
* app/gui/info-dialog.[ch]
* app/gui/layer-select.c
* app/gui/layers-commands.c
* app/gui/menus.c
* app/gui/offset-dialog.c
* app/gui/palette-editor.c
* app/gui/palettes-commands.c
* app/gui/patterns-commands.c
* app/gui/preferences-dialog.c
* app/gui/resize-dialog.[ch]
* app/gui/splash.c
* app/gui/tips-dialog.c
* app/gui/tool-options-dialog.c
* app/gui/toolbox.c
* app/gui/tools-commands.c
* libgimp/gimpbrushmenu.c
* libgimp/gimpmenu.c
* libgimp/gimppatternmenu.c
* libgimp/gimpui.c
* libgimpbase/gimpenv.c: tons and tons of changes like "const
gchar*", switch from GdkDeviceInfo to GdkDevice (very incomplete
and currently disables), lots of s/gtk_signal/g_signal/,
removal/replacement of deprecated stuff,
s/GtkSignalFunc/GCallback/ and lots of small changes and fixes
while I was on it, zillions of warnings left...
* modules/Makefile.am: disabled the water color selector
temporarily (XInput issues).
* plug-ins/Makefile.am
* plug-ins/common/.cvsignore
* plug-ins/common/Makefile.am
* plug-ins/common/plugin-defs.pl: simply excluded all plug-ins
which did not build (including Script-Fu). They are trivial to
fix.
2001-07-25 05:27:11 +08:00
|
|
|
#define GIMP_TOOL(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GIMP_TYPE_TOOL, GimpTool))
|
|
|
|
|
#define GIMP_TOOL_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GIMP_TYPE_TOOL, GimpToolClass))
|
|
|
|
|
#define GIMP_IS_TOOL(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GIMP_TYPE_TOOL))
|
|
|
|
|
#define GIMP_IS_TOOL_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_TOOL))
|
|
|
|
|
#define GIMP_TOOL_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GIMP_TYPE_TOOL, GimpToolClass))
|
2000-12-29 23:22:01 +08:00
|
|
|
|
2006-09-06 02:25:31 +08:00
|
|
|
#define GIMP_TOOL_GET_OPTIONS(t) (gimp_tool_get_options (GIMP_TOOL (t)))
|
|
|
|
|
|
2001-02-14 12:55:21 +08:00
|
|
|
|
|
|
|
|
typedef struct _GimpToolClass GimpToolClass;
|
2000-12-29 23:22:01 +08:00
|
|
|
|
2001-02-14 12:55:21 +08:00
|
|
|
struct _GimpTool
|
1997-11-25 06:05:25 +08:00
|
|
|
{
|
2003-04-16 00:05:52 +08:00
|
|
|
GimpObject parent_instance;
|
1999-07-03 01:40:10 +08:00
|
|
|
|
2003-04-16 00:05:52 +08:00
|
|
|
GimpToolInfo *tool_info;
|
2001-10-29 19:47:11 +08:00
|
|
|
|
2006-03-29 01:55:52 +08:00
|
|
|
gint ID; /* unique tool ID */
|
2001-03-31 22:47:44 +08:00
|
|
|
|
2003-04-16 00:05:52 +08:00
|
|
|
GimpToolControl *control;
|
2002-03-29 11:50:29 +08:00
|
|
|
|
2006-03-29 01:55:52 +08:00
|
|
|
GimpDisplay *display; /* pointer to currently active display */
|
|
|
|
|
GimpDrawable *drawable; /* pointer to the tool's current drawable */
|
2008-04-14 02:04:27 +08:00
|
|
|
|
|
|
|
|
gdouble max_coord_smooth;
|
2003-10-14 19:14:28 +08:00
|
|
|
|
2007-02-28 05:40:35 +08:00
|
|
|
/* private state of gimp_tool_set_focus_display() and
|
|
|
|
|
* gimp_tool_set_[active_]modifier_state()
|
2003-10-14 19:14:28 +08:00
|
|
|
*/
|
|
|
|
|
GimpDisplay *focus_display;
|
|
|
|
|
GdkModifierType modifier_state;
|
2006-09-13 02:41:09 +08:00
|
|
|
GdkModifierType button_press_state;
|
|
|
|
|
GdkModifierType active_modifier_state;
|
2007-02-28 05:11:35 +08:00
|
|
|
|
2007-02-28 05:40:35 +08:00
|
|
|
/* private state for click detection
|
|
|
|
|
*/
|
2007-02-28 05:11:35 +08:00
|
|
|
gboolean in_click_distance;
|
2007-03-10 23:07:56 +08:00
|
|
|
gboolean got_motion_event;
|
2007-02-28 05:40:35 +08:00
|
|
|
GimpCoords button_press_coords;
|
|
|
|
|
guint32 button_press_time;
|
2007-03-15 05:33:09 +08:00
|
|
|
|
|
|
|
|
/* private list of displays which have a status message from this tool
|
|
|
|
|
*/
|
|
|
|
|
GList *status_displays;
|
1997-11-25 06:05:25 +08:00
|
|
|
};
|
|
|
|
|
|
2001-02-14 12:55:21 +08:00
|
|
|
struct _GimpToolClass
|
1997-11-25 06:05:25 +08:00
|
|
|
{
|
2001-02-14 12:55:21 +08:00
|
|
|
GimpObjectClass parent_class;
|
|
|
|
|
|
2001-11-20 22:20:17 +08:00
|
|
|
/* virtual functions */
|
|
|
|
|
|
2008-10-27 00:25:24 +08:00
|
|
|
gboolean (* has_display) (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
GimpDisplay * (* has_image) (GimpTool *tool,
|
|
|
|
|
GimpImage *image);
|
|
|
|
|
|
|
|
|
|
gboolean (* initialize) (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
|
|
|
|
GError **error);
|
|
|
|
|
void (* control) (GimpTool *tool,
|
|
|
|
|
GimpToolAction action,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
void (* button_press) (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2008-10-27 00:25:24 +08:00
|
|
|
guint32 time,
|
|
|
|
|
GdkModifierType state,
|
2009-06-20 23:37:31 +08:00
|
|
|
GimpButtonPressType press_type,
|
2008-10-27 00:25:24 +08:00
|
|
|
GimpDisplay *display);
|
|
|
|
|
void (* button_release) (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2008-10-27 00:25:24 +08:00
|
|
|
guint32 time,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpButtonReleaseType release_type,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void (* motion) (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2008-10-27 00:25:24 +08:00
|
|
|
guint32 time,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
gboolean (* key_press) (GimpTool *tool,
|
|
|
|
|
GdkEventKey *kevent,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void (* modifier_key) (GimpTool *tool,
|
|
|
|
|
GdkModifierType key,
|
|
|
|
|
gboolean press,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void (* active_modifier_key) (GimpTool *tool,
|
|
|
|
|
GdkModifierType key,
|
|
|
|
|
gboolean press,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
void (* oper_update) (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2008-10-27 00:25:24 +08:00
|
|
|
GdkModifierType state,
|
|
|
|
|
gboolean proximity,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void (* cursor_update) (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2008-10-27 00:25:24 +08:00
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
GimpUIManager * (* get_popup) (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2008-10-27 00:25:24 +08:00
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display,
|
|
|
|
|
const gchar **ui_path);
|
2001-02-14 12:55:21 +08:00
|
|
|
};
|
2001-03-31 22:10:22 +08:00
|
|
|
|
|
|
|
|
|
2006-09-13 02:41:09 +08:00
|
|
|
GType gimp_tool_get_type (void) G_GNUC_CONST;
|
|
|
|
|
|
|
|
|
|
GimpToolOptions * gimp_tool_get_options (GimpTool *tool);
|
|
|
|
|
|
|
|
|
|
gboolean gimp_tool_has_display (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
GimpDisplay * gimp_tool_has_image (GimpTool *tool,
|
|
|
|
|
GimpImage *image);
|
|
|
|
|
|
|
|
|
|
gboolean gimp_tool_initialize (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void gimp_tool_control (GimpTool *tool,
|
|
|
|
|
GimpToolAction action,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
void gimp_tool_button_press (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2006-09-13 02:41:09 +08:00
|
|
|
guint32 time,
|
|
|
|
|
GdkModifierType state,
|
2009-06-20 23:37:31 +08:00
|
|
|
GimpButtonPressType press_type,
|
2006-09-13 02:41:09 +08:00
|
|
|
GimpDisplay *display);
|
|
|
|
|
void gimp_tool_button_release (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2006-09-13 02:41:09 +08:00
|
|
|
guint32 time,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void gimp_tool_motion (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2006-09-13 02:41:09 +08:00
|
|
|
guint32 time,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
gboolean gimp_tool_key_press (GimpTool *tool,
|
|
|
|
|
GdkEventKey *kevent,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
void gimp_tool_set_focus_display (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void gimp_tool_set_modifier_state (GimpTool *tool,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void gimp_tool_set_active_modifier_state (GimpTool *tool,
|
|
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
|
|
|
|
void gimp_tool_oper_update (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2006-09-13 02:41:09 +08:00
|
|
|
GdkModifierType state,
|
|
|
|
|
gboolean proximity,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
void gimp_tool_cursor_update (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2006-09-13 02:41:09 +08:00
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
2008-10-27 00:25:24 +08:00
|
|
|
GimpUIManager * gimp_tool_get_popup (GimpTool *tool,
|
2008-11-01 23:17:36 +08:00
|
|
|
const GimpCoords *coords,
|
2008-10-27 00:25:24 +08:00
|
|
|
GdkModifierType state,
|
|
|
|
|
GimpDisplay *display,
|
|
|
|
|
const gchar **ui_path);
|
|
|
|
|
|
2006-09-13 02:41:09 +08:00
|
|
|
void gimp_tool_push_status (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
2006-09-28 19:07:55 +08:00
|
|
|
const gchar *format,
|
|
|
|
|
...) G_GNUC_PRINTF(3,4);
|
2006-09-13 02:41:09 +08:00
|
|
|
void gimp_tool_push_status_coords (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
2008-08-21 00:22:09 +08:00
|
|
|
GimpCursorPrecision precision,
|
2006-09-13 02:41:09 +08:00
|
|
|
const gchar *title,
|
|
|
|
|
gdouble x,
|
|
|
|
|
const gchar *separator,
|
2007-01-21 09:24:51 +08:00
|
|
|
gdouble y,
|
|
|
|
|
const gchar *help);
|
2006-09-13 02:41:09 +08:00
|
|
|
void gimp_tool_push_status_length (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
|
|
|
|
const gchar *title,
|
|
|
|
|
GimpOrientationType axis,
|
2007-01-21 09:24:51 +08:00
|
|
|
gdouble value,
|
|
|
|
|
const gchar *help);
|
2006-09-13 02:41:09 +08:00
|
|
|
void gimp_tool_replace_status (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
2006-09-28 19:07:55 +08:00
|
|
|
const gchar *format,
|
|
|
|
|
...) G_GNUC_PRINTF(3,4);
|
2006-09-13 02:41:09 +08:00
|
|
|
void gimp_tool_pop_status (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display);
|
|
|
|
|
|
2006-09-28 16:32:09 +08:00
|
|
|
void gimp_tool_message (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
2006-09-28 19:07:55 +08:00
|
|
|
const gchar *format,
|
|
|
|
|
...) G_GNUC_PRINTF(3,4);
|
2008-11-04 20:33:09 +08:00
|
|
|
void gimp_tool_message_literal (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
|
|
|
|
const gchar *message);
|
2006-09-28 16:32:09 +08:00
|
|
|
|
2006-09-13 02:41:09 +08:00
|
|
|
void gimp_tool_set_cursor (GimpTool *tool,
|
|
|
|
|
GimpDisplay *display,
|
|
|
|
|
GimpCursorType cursor,
|
|
|
|
|
GimpToolCursorType tool_cursor,
|
|
|
|
|
GimpCursorModifier modifier);
|
2001-02-22 05:56:39 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
#endif /* __GIMP_TOOL_H__ */
|