dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/app/display/gimptoolline.h

100 lines
4.5 KiB
C
Raw Normal View History

app: add GimpToolLine, an subclass of GimpToolWidet Implements the "line with handles" known from the blend tool, behind a simple "x1, y1, x2, y2" interface.
2017-06-11 05:51:06 +08:00
/* GIMP - The GNU Image Manipulation Program
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
*
* gimptoolline.h
* Copyright (C) 2017 Michael Natterer <mitch@gimp.org>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (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
Change the license URL from http://www.gnu.org/licenses/ to https://
2018-07-12 05:27:07 +08:00
* along with this program. If not, see <https://www.gnu.org/licenses/>.
app: add GimpToolLine, an subclass of GimpToolWidet Implements the "line with handles" known from the blend tool, behind a simple "x1, y1, x2, y2" interface.
2017-06-11 05:51:06 +08:00
*/
#ifndef __GIMP_TOOL_LINE_H__
#define __GIMP_TOOL_LINE_H__
#include "gimptoolwidget.h"
app: add persistent handle selection to GimpToolLine En route to on-canvas gradient editing, add support for persistent handle selection to GimpToolLine (a handle being either an endpoint or a slider). Handles are selected through clicking, however, unlike before, the selection persists after the mouse is released. A new "selection" property specifies the currently-selected handle (who knows, maybe in the future we'll add multi-selection), and a new "selection-changed" signal is emitted when the selection changes. The visual feedback has been changed to better suit the new behavior, and the behaviors yet to be added: The selected handle is marked using highlighting; the highlighting doesn't change while hovering over other handles. Only the hit-test circle is used as hover indication, however, we use a fixed-size circle, and only show the circle for the currently hovered-over handle -- no more trippy expanding circles :) A few minor changes along the way: - The selected handle is now the (first) one that's closest to the cursor, instead of the first one to pass hit-testing. - We don't move the selectd handle upon button-press, only upon motion, so that handles can be selected without moving them. - Show a MOVE cursor modifier when hovering over a handle.
2017-07-20 02:48:09 +08:00
/* in the context of GimpToolLine, "handle" is a collective term for either an
* endpoint or a slider. a handle value may be either a (nonnegative) slider
* index, or one of the values below:
*/
#define GIMP_TOOL_LINE_HANDLE_NONE (-3)
#define GIMP_TOOL_LINE_HANDLE_START (-2)
#define GIMP_TOOL_LINE_HANDLE_END (-1)
#define GIMP_TOOL_LINE_HANDLE_IS_SLIDER(handle) ((handle) >= 0)
app: add GimpToolLine, an subclass of GimpToolWidet Implements the "line with handles" known from the blend tool, behind a simple "x1, y1, x2, y2" interface.
2017-06-11 05:51:06 +08:00
#define GIMP_TYPE_TOOL_LINE (gimp_tool_line_get_type ())
#define GIMP_TOOL_LINE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GIMP_TYPE_TOOL_LINE, GimpToolLine))
#define GIMP_TOOL_LINE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GIMP_TYPE_TOOL_LINE, GimpToolLineClass))
#define GIMP_IS_TOOL_LINE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GIMP_TYPE_TOOL_LINE))
#define GIMP_IS_TOOL_LINE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_TOOL_LINE))
#define GIMP_TOOL_LINE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GIMP_TYPE_TOOL_LINE, GimpToolLineClass))
typedef struct _GimpToolLine GimpToolLine;
typedef struct _GimpToolLinePrivate GimpToolLinePrivate;
typedef struct _GimpToolLineClass GimpToolLineClass;
struct _GimpToolLine
{
GimpToolWidget parent_instance;
GimpToolLinePrivate *private;
};
struct _GimpToolLineClass
{
GimpToolWidgetClass parent_class;
app: add persistent handle selection to GimpToolLine En route to on-canvas gradient editing, add support for persistent handle selection to GimpToolLine (a handle being either an endpoint or a slider). Handles are selected through clicking, however, unlike before, the selection persists after the mouse is released. A new "selection" property specifies the currently-selected handle (who knows, maybe in the future we'll add multi-selection), and a new "selection-changed" signal is emitted when the selection changes. The visual feedback has been changed to better suit the new behavior, and the behaviors yet to be added: The selected handle is marked using highlighting; the highlighting doesn't change while hovering over other handles. Only the hit-test circle is used as hover indication, however, we use a fixed-size circle, and only show the circle for the currently hovered-over handle -- no more trippy expanding circles :) A few minor changes along the way: - The selected handle is now the (first) one that's closest to the cursor, instead of the first one to pass hit-testing. - We don't move the selectd handle upon button-press, only upon motion, so that handles can be selected without moving them. - Show a MOVE cursor modifier when hovering over a handle.
2017-07-20 02:48:09 +08:00
/* signals */
app: add handle-clicked signal to GimpToolLine ... which is emitted when a handle is single/double/tripple clicked. The signal handler returns a boolean value. A return value of TRUE stops further event processing, while a return value of FALSE allows it.
2017-07-24 07:49:15 +08:00
gboolean (* can_add_slider) (GimpToolLine *line,
gdouble value);
gint (* add_slider) (GimpToolLine *line,
gdouble value);
void (* prepare_to_remove_slider) (GimpToolLine *line,
gint slider,
gboolean remove);
void (* remove_slider) (GimpToolLine *line,
gint slider);
void (* selection_changed) (GimpToolLine *line);
gboolean (* handle_clicked) (GimpToolLine *line,
gint handle,
GdkModifierType state,
GimpButtonPressType press_type);
app: add GimpToolLine, an subclass of GimpToolWidet Implements the "line with handles" known from the blend tool, behind a simple "x1, y1, x2, y2" interface.
2017-06-11 05:51:06 +08:00
};
app: add persistent handle selection to GimpToolLine En route to on-canvas gradient editing, add support for persistent handle selection to GimpToolLine (a handle being either an endpoint or a slider). Handles are selected through clicking, however, unlike before, the selection persists after the mouse is released. A new "selection" property specifies the currently-selected handle (who knows, maybe in the future we'll add multi-selection), and a new "selection-changed" signal is emitted when the selection changes. The visual feedback has been changed to better suit the new behavior, and the behaviors yet to be added: The selected handle is marked using highlighting; the highlighting doesn't change while hovering over other handles. Only the hit-test circle is used as hover indication, however, we use a fixed-size circle, and only show the circle for the currently hovered-over handle -- no more trippy expanding circles :) A few minor changes along the way: - The selected handle is now the (first) one that's closest to the cursor, instead of the first one to pass hit-testing. - We don't move the selectd handle upon button-press, only upon motion, so that handles can be selected without moving them. - Show a MOVE cursor modifier when hovering over a handle.
2017-07-20 02:48:09 +08:00
GType gimp_tool_line_get_type (void) G_GNUC_CONST;
GimpToolWidget * gimp_tool_line_new (GimpDisplayShell *shell,
gdouble x1,
gdouble y1,
gdouble x2,
gdouble y2);
app: add GimpToolLine, an subclass of GimpToolWidet Implements the "line with handles" known from the blend tool, behind a simple "x1, y1, x2, y2" interface.
2017-06-11 05:51:06 +08:00
app: add persistent handle selection to GimpToolLine En route to on-canvas gradient editing, add support for persistent handle selection to GimpToolLine (a handle being either an endpoint or a slider). Handles are selected through clicking, however, unlike before, the selection persists after the mouse is released. A new "selection" property specifies the currently-selected handle (who knows, maybe in the future we'll add multi-selection), and a new "selection-changed" signal is emitted when the selection changes. The visual feedback has been changed to better suit the new behavior, and the behaviors yet to be added: The selected handle is marked using highlighting; the highlighting doesn't change while hovering over other handles. Only the hit-test circle is used as hover indication, however, we use a fixed-size circle, and only show the circle for the currently hovered-over handle -- no more trippy expanding circles :) A few minor changes along the way: - The selected handle is now the (first) one that's closest to the cursor, instead of the first one to pass hit-testing. - We don't move the selectd handle upon button-press, only upon motion, so that handles can be selected without moving them. - Show a MOVE cursor modifier when hovering over a handle.
2017-07-20 02:48:09 +08:00
void gimp_tool_line_set_sliders (GimpToolLine *line,
const GimpControllerSlider *sliders,
gint n_sliders);
const GimpControllerSlider * gimp_tool_line_get_sliders (GimpToolLine *line,
gint *n_sliders);
app: add sliders to GimpToolLine; add slider-line controller Add supprt for placing sliders on a GimpToolLine -- handles that can be dragged over the line. The sliders are accesible through a new "sliders" property, and via the gimp_tool_line_{get,set}_sliders() functions. Add a slider-line controller, which works like a line controller, but whose callback also supplies/takes an array of sliders. Note that the data type for individual sliders is called GimpControllerSlider (in particular, it's not line specific), so that we may use it with other controller/tool-widget types in the future.
2017-07-04 02:48:34 +08:00
app: add persistent handle selection to GimpToolLine En route to on-canvas gradient editing, add support for persistent handle selection to GimpToolLine (a handle being either an endpoint or a slider). Handles are selected through clicking, however, unlike before, the selection persists after the mouse is released. A new "selection" property specifies the currently-selected handle (who knows, maybe in the future we'll add multi-selection), and a new "selection-changed" signal is emitted when the selection changes. The visual feedback has been changed to better suit the new behavior, and the behaviors yet to be added: The selected handle is marked using highlighting; the highlighting doesn't change while hovering over other handles. Only the hit-test circle is used as hover indication, however, we use a fixed-size circle, and only show the circle for the currently hovered-over handle -- no more trippy expanding circles :) A few minor changes along the way: - The selected handle is now the (first) one that's closest to the cursor, instead of the first one to pass hit-testing. - We don't move the selectd handle upon button-press, only upon motion, so that handles can be selected without moving them. - Show a MOVE cursor modifier when hovering over a handle.
2017-07-20 02:48:09 +08:00
void gimp_tool_line_set_selection (GimpToolLine *line,
gint handle);
gint gimp_tool_line_get_selection (GimpToolLine *line);
app: add GimpToolLine, an subclass of GimpToolWidet Implements the "line with handles" known from the blend tool, behind a simple "x1, y1, x2, y2" interface.
2017-06-11 05:51:06 +08:00
#endif /* __GIMP_TOOL_LINE_H__ */