2006-12-10 05:33:38 +08:00
|
|
|
/* GIMP - The GNU Image Manipulation Program
|
1998-06-30 23:31:32 +08:00
|
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
|
|
|
*
|
2009-01-18 06:28:01 +08:00
|
|
|
* This program is free software: you can redistribute it and/or modify
|
1998-06-30 23:31:32 +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
|
1998-06-30 23:31:32 +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
|
2018-07-12 05:27:07 +08:00
|
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
1998-06-30 23:31:32 +08:00
|
|
|
*/
|
2000-10-28 23:43:56 +08:00
|
|
|
|
|
|
|
|
#ifndef __GIMP_DRAWABLE_H__
|
|
|
|
|
#define __GIMP_DRAWABLE_H__
|
1998-06-30 23:31:32 +08:00
|
|
|
|
2000-12-29 23:22:01 +08:00
|
|
|
|
2002-02-26 01:58:50 +08:00
|
|
|
#include "gimpitem.h"
|
1999-08-22 19:45:31 +08:00
|
|
|
|
2000-05-27 09:30:21 +08:00
|
|
|
|
2000-12-29 23:22:01 +08:00
|
|
|
#define GIMP_TYPE_DRAWABLE (gimp_drawable_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_DRAWABLE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GIMP_TYPE_DRAWABLE, GimpDrawable))
|
|
|
|
|
#define GIMP_DRAWABLE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GIMP_TYPE_DRAWABLE, GimpDrawableClass))
|
2001-10-26 07:08:20 +08:00
|
|
|
#define GIMP_IS_DRAWABLE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GIMP_TYPE_DRAWABLE))
|
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_IS_DRAWABLE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_DRAWABLE))
|
2001-10-26 07:08:20 +08:00
|
|
|
#define GIMP_DRAWABLE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GIMP_TYPE_DRAWABLE, GimpDrawableClass))
|
2000-12-29 23:22:01 +08:00
|
|
|
|
|
|
|
|
|
2009-02-04 07:57:11 +08:00
|
|
|
typedef struct _GimpDrawablePrivate GimpDrawablePrivate;
|
|
|
|
|
typedef struct _GimpDrawableClass GimpDrawableClass;
|
2000-12-29 23:22:01 +08:00
|
|
|
|
|
|
|
|
struct _GimpDrawable
|
|
|
|
|
{
|
2011-03-16 09:01:24 +08:00
|
|
|
GimpItem parent_instance;
|
2000-12-29 23:22:01 +08:00
|
|
|
|
2009-02-04 07:57:11 +08:00
|
|
|
GimpDrawablePrivate *private;
|
2000-12-29 23:22:01 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
struct _GimpDrawableClass
|
|
|
|
|
{
|
2002-02-26 01:58:50 +08:00
|
|
|
GimpItemClass parent_class;
|
2000-12-29 23:22:01 +08:00
|
|
|
|
2003-09-04 19:33:06 +08:00
|
|
|
/* signals */
|
2007-12-18 19:20:23 +08:00
|
|
|
void (* update) (GimpDrawable *drawable,
|
|
|
|
|
gint x,
|
|
|
|
|
gint y,
|
|
|
|
|
gint width,
|
|
|
|
|
gint height);
|
2018-12-28 15:06:40 +08:00
|
|
|
void (* format_changed) (GimpDrawable *drawable);
|
2007-12-18 19:20:23 +08:00
|
|
|
void (* alpha_changed) (GimpDrawable *drawable);
|
app: maintain drawable bounding box separately from its logical boundary
Maintain the bounding box of drawables (i.e., the bounds of their
actual rendered content) separately from their logical boundary (as
shown in the UI).
The bounding box is calculated through the new
GimpDrawable::get_bounding_box() virtual function, which has a
corresponding gimp_drawable_get_bounding_box() function; the
default implementation simply returns the drawable's logical
boundary. The bounding box is specified in drawable coordinates,
i.e., it's not affected by the drawable's offset.
The bounding box is recalculated through
gimp_drawable_update_bounding_box(), which should be called
whenever a change may affect the bounding box (for example, when
setting a new buffer, as done implicitly by GimpDrawable's
::set_buffer() implementation, or when a drawable filter's
properties change, as will be done by GimpDrawableFilter in a
following commit). When the bounding box changes, the affected
regions of the drawable are updated, and the
GimpDrawable::bounding-box-changed signal is emitted.
When gimp_drawable_update() is called with negative width/height
values, the entire drawable's bounding box is updated, rather than
only its logical boundary.
Likewise, GimpDrawableStack and GimpLayerStack are adapted to use
the bounding box, instead of the logical bounds, when updating the
drawable's area.
2019-08-02 02:52:40 +08:00
|
|
|
void (* bounding_box_changed) (GimpDrawable *drawable);
|
2003-09-04 19:33:06 +08:00
|
|
|
|
|
|
|
|
/* virtual functions */
|
2016-05-20 05:51:44 +08:00
|
|
|
gint64 (* estimate_memsize) (GimpDrawable *drawable,
|
2014-06-15 05:12:22 +08:00
|
|
|
GimpComponentType component_type,
|
2007-12-18 19:20:23 +08:00
|
|
|
gint width,
|
|
|
|
|
gint height);
|
app: add gimp_drawable_update_all()
Add a new GimpDrawable::update_all() virtual function, and a
corresponding gimp_drawable_update_all() function, which updates
the full contents of the drawable. Unlike calling
`gimp_drawable_update (drawable, 0, 0, -1, -1)`, which updates the
entire drawable area, gimp_drawable_update_all() only updates the
area that has actual content. While the default implentation does
simply update the entire drawable area, GimpGroupLayer overrides
this function to recursively update its child layers, rather than
the its entire area.
2019-06-10 15:42:07 +08:00
|
|
|
void (* update_all) (GimpDrawable *drawable);
|
2007-12-18 19:20:23 +08:00
|
|
|
void (* invalidate_boundary) (GimpDrawable *drawable);
|
2016-05-20 05:51:44 +08:00
|
|
|
void (* get_active_components) (GimpDrawable *drawable,
|
2007-12-18 19:20:23 +08:00
|
|
|
gboolean *active);
|
2016-05-20 05:51:44 +08:00
|
|
|
GimpComponentMask (* get_active_mask) (GimpDrawable *drawable);
|
2020-01-17 17:24:31 +08:00
|
|
|
gboolean (* supports_alpha) (GimpDrawable *drawable);
|
2009-09-12 03:23:35 +08:00
|
|
|
void (* convert_type) (GimpDrawable *drawable,
|
|
|
|
|
GimpImage *dest_image,
|
2012-10-14 04:56:32 +08:00
|
|
|
const Babl *new_format,
|
2018-08-06 04:19:17 +08:00
|
|
|
GimpColorProfile *src_profile,
|
2016-04-29 06:42:42 +08:00
|
|
|
GimpColorProfile *dest_profile,
|
2016-11-08 03:41:39 +08:00
|
|
|
GeglDitherMethod layer_dither_type,
|
|
|
|
|
GeglDitherMethod mask_dither_type,
|
2015-10-22 04:22:30 +08:00
|
|
|
gboolean push_undo,
|
|
|
|
|
GimpProgress *progress);
|
2012-03-23 06:45:11 +08:00
|
|
|
void (* apply_buffer) (GimpDrawable *drawable,
|
|
|
|
|
GeglBuffer *buffer,
|
|
|
|
|
const GeglRectangle *buffer_region,
|
2007-12-18 19:20:23 +08:00
|
|
|
gboolean push_undo,
|
|
|
|
|
const gchar *undo_desc,
|
|
|
|
|
gdouble opacity,
|
2017-01-09 06:00:19 +08:00
|
|
|
GimpLayerMode mode,
|
2017-02-13 06:49:26 +08:00
|
|
|
GimpLayerColorSpace blend_space,
|
|
|
|
|
GimpLayerColorSpace composite_space,
|
|
|
|
|
GimpLayerCompositeMode composite_mode,
|
2012-03-23 07:12:13 +08:00
|
|
|
GeglBuffer *base_buffer,
|
2012-03-24 07:57:11 +08:00
|
|
|
gint base_x,
|
2012-05-19 06:14:51 +08:00
|
|
|
gint base_y);
|
2012-03-22 07:07:48 +08:00
|
|
|
GeglBuffer * (* get_buffer) (GimpDrawable *drawable);
|
2012-03-22 06:37:16 +08:00
|
|
|
void (* set_buffer) (GimpDrawable *drawable,
|
2007-12-18 19:20:23 +08:00
|
|
|
gboolean push_undo,
|
|
|
|
|
const gchar *undo_desc,
|
2012-03-22 06:37:16 +08:00
|
|
|
GeglBuffer *buffer,
|
2019-08-02 02:41:47 +08:00
|
|
|
const GeglRectangle *bounds);
|
app: maintain drawable bounding box separately from its logical boundary
Maintain the bounding box of drawables (i.e., the bounds of their
actual rendered content) separately from their logical boundary (as
shown in the UI).
The bounding box is calculated through the new
GimpDrawable::get_bounding_box() virtual function, which has a
corresponding gimp_drawable_get_bounding_box() function; the
default implementation simply returns the drawable's logical
boundary. The bounding box is specified in drawable coordinates,
i.e., it's not affected by the drawable's offset.
The bounding box is recalculated through
gimp_drawable_update_bounding_box(), which should be called
whenever a change may affect the bounding box (for example, when
setting a new buffer, as done implicitly by GimpDrawable's
::set_buffer() implementation, or when a drawable filter's
properties change, as will be done by GimpDrawableFilter in a
following commit). When the bounding box changes, the affected
regions of the drawable are updated, and the
GimpDrawable::bounding-box-changed signal is emitted.
When gimp_drawable_update() is called with negative width/height
values, the entire drawable's bounding box is updated, rather than
only its logical boundary.
Likewise, GimpDrawableStack and GimpLayerStack are adapted to use
the bounding box, instead of the logical bounds, when updating the
drawable's area.
2019-08-02 02:52:40 +08:00
|
|
|
GeglRectangle (* get_bounding_box) (GimpDrawable *drawable);
|
2007-12-18 19:20:23 +08:00
|
|
|
void (* push_undo) (GimpDrawable *drawable,
|
|
|
|
|
const gchar *undo_desc,
|
2012-03-22 21:13:17 +08:00
|
|
|
GeglBuffer *buffer,
|
2007-12-18 19:20:23 +08:00
|
|
|
gint x,
|
|
|
|
|
gint y,
|
|
|
|
|
gint width,
|
|
|
|
|
gint height);
|
|
|
|
|
void (* swap_pixels) (GimpDrawable *drawable,
|
2012-03-22 21:13:17 +08:00
|
|
|
GeglBuffer *buffer,
|
2007-12-18 19:20:23 +08:00
|
|
|
gint x,
|
2012-03-22 21:25:45 +08:00
|
|
|
gint y);
|
2017-04-22 03:21:10 +08:00
|
|
|
GeglNode * (* get_source_node) (GimpDrawable *drawable);
|
2000-12-29 23:22:01 +08:00
|
|
|
};
|
1998-06-30 23:31:32 +08:00
|
|
|
|
|
|
|
|
|
2001-11-23 07:46:13 +08:00
|
|
|
GType gimp_drawable_get_type (void) G_GNUC_CONST;
|
2000-12-29 00:19:55 +08:00
|
|
|
|
2011-02-01 19:47:24 +08:00
|
|
|
GimpDrawable * gimp_drawable_new (GType type,
|
|
|
|
|
GimpImage *image,
|
|
|
|
|
const gchar *name,
|
2003-02-01 00:37:03 +08:00
|
|
|
gint offset_x,
|
|
|
|
|
gint offset_y,
|
2006-04-12 20:49:29 +08:00
|
|
|
gint width,
|
|
|
|
|
gint height,
|
2012-03-22 03:21:11 +08:00
|
|
|
const Babl *format);
|
2011-02-01 19:47:24 +08:00
|
|
|
|
2016-05-20 05:51:44 +08:00
|
|
|
gint64 gimp_drawable_estimate_memsize (GimpDrawable *drawable,
|
2014-06-15 05:12:22 +08:00
|
|
|
GimpComponentType component_type,
|
2011-02-01 19:47:24 +08:00
|
|
|
gint width,
|
|
|
|
|
gint height);
|
2001-01-20 21:21:49 +08:00
|
|
|
|
2001-07-08 06:49:01 +08:00
|
|
|
void gimp_drawable_update (GimpDrawable *drawable,
|
2006-04-12 20:49:29 +08:00
|
|
|
gint x,
|
|
|
|
|
gint y,
|
|
|
|
|
gint width,
|
|
|
|
|
gint height);
|
app: add gimp_drawable_update_all()
Add a new GimpDrawable::update_all() virtual function, and a
corresponding gimp_drawable_update_all() function, which updates
the full contents of the drawable. Unlike calling
`gimp_drawable_update (drawable, 0, 0, -1, -1)`, which updates the
entire drawable area, gimp_drawable_update_all() only updates the
area that has actual content. While the default implentation does
simply update the entire drawable area, GimpGroupLayer overrides
this function to recursively update its child layers, rather than
the its entire area.
2019-06-10 15:42:07 +08:00
|
|
|
void gimp_drawable_update_all (GimpDrawable *drawable);
|
2003-10-06 22:40:12 +08:00
|
|
|
|
|
|
|
|
void gimp_drawable_invalidate_boundary (GimpDrawable *drawable);
|
2016-05-20 05:51:44 +08:00
|
|
|
void gimp_drawable_get_active_components (GimpDrawable *drawable,
|
2003-10-06 22:40:12 +08:00
|
|
|
gboolean *active);
|
2016-05-20 05:51:44 +08:00
|
|
|
GimpComponentMask gimp_drawable_get_active_mask (GimpDrawable *drawable);
|
2003-10-06 22:40:12 +08:00
|
|
|
|
2020-01-17 17:24:31 +08:00
|
|
|
gboolean gimp_drawable_supports_alpha (GimpDrawable *drawable);
|
|
|
|
|
|
2009-09-12 03:23:35 +08:00
|
|
|
void gimp_drawable_convert_type (GimpDrawable *drawable,
|
|
|
|
|
GimpImage *dest_image,
|
2009-09-14 01:24:19 +08:00
|
|
|
GimpImageBaseType new_base_type,
|
2012-04-25 18:09:45 +08:00
|
|
|
GimpPrecision new_precision,
|
2016-10-04 07:39:15 +08:00
|
|
|
gboolean new_has_alpha,
|
2018-08-06 04:19:17 +08:00
|
|
|
GimpColorProfile *src_profile,
|
2016-04-29 06:42:42 +08:00
|
|
|
GimpColorProfile *dest_profile,
|
2016-11-08 03:41:39 +08:00
|
|
|
GeglDitherMethod layer_dither_type,
|
|
|
|
|
GeglDitherMethod mask_dither_type,
|
2015-10-22 04:22:30 +08:00
|
|
|
gboolean push_undo,
|
|
|
|
|
GimpProgress *progress);
|
2009-09-12 03:23:35 +08:00
|
|
|
|
2012-04-23 06:32:14 +08:00
|
|
|
void gimp_drawable_apply_buffer (GimpDrawable *drawable,
|
|
|
|
|
GeglBuffer *buffer,
|
2012-03-23 01:40:40 +08:00
|
|
|
const GeglRectangle *buffer_rect,
|
2012-04-23 06:32:14 +08:00
|
|
|
gboolean push_undo,
|
|
|
|
|
const gchar *undo_desc,
|
|
|
|
|
gdouble opacity,
|
2017-01-09 06:00:19 +08:00
|
|
|
GimpLayerMode mode,
|
2017-02-13 06:49:26 +08:00
|
|
|
GimpLayerColorSpace blend_space,
|
|
|
|
|
GimpLayerColorSpace composite_space,
|
|
|
|
|
GimpLayerCompositeMode composite_mode,
|
2012-04-23 06:32:14 +08:00
|
|
|
GeglBuffer *base_buffer,
|
|
|
|
|
gint base_x,
|
2012-05-19 06:14:51 +08:00
|
|
|
gint base_y);
|
2001-07-08 06:49:01 +08:00
|
|
|
|
2012-03-21 07:42:44 +08:00
|
|
|
GeglBuffer * gimp_drawable_get_buffer (GimpDrawable *drawable);
|
2012-03-21 08:01:24 +08:00
|
|
|
void gimp_drawable_set_buffer (GimpDrawable *drawable,
|
|
|
|
|
gboolean push_undo,
|
|
|
|
|
const gchar *undo_desc,
|
2012-03-22 06:37:16 +08:00
|
|
|
GeglBuffer *buffer);
|
2012-03-21 08:01:24 +08:00
|
|
|
void gimp_drawable_set_buffer_full (GimpDrawable *drawable,
|
|
|
|
|
gboolean push_undo,
|
|
|
|
|
const gchar *undo_desc,
|
|
|
|
|
GeglBuffer *buffer,
|
2019-08-02 02:41:47 +08:00
|
|
|
const GeglRectangle *bounds,
|
2018-08-04 00:58:03 +08:00
|
|
|
gboolean update);
|
2012-03-18 03:33:47 +08:00
|
|
|
|
2018-02-14 02:09:07 +08:00
|
|
|
void gimp_drawable_steal_buffer (GimpDrawable *drawable,
|
|
|
|
|
GimpDrawable *src_drawable);
|
|
|
|
|
|
2018-07-24 18:20:17 +08:00
|
|
|
void gimp_drawable_set_format (GimpDrawable *drawable,
|
|
|
|
|
const Babl *format,
|
|
|
|
|
gboolean copy_buffer,
|
|
|
|
|
gboolean push_undo);
|
|
|
|
|
|
2008-10-10 04:44:23 +08:00
|
|
|
GeglNode * gimp_drawable_get_source_node (GimpDrawable *drawable);
|
2008-10-15 02:32:07 +08:00
|
|
|
GeglNode * gimp_drawable_get_mode_node (GimpDrawable *drawable);
|
2008-10-10 04:44:23 +08:00
|
|
|
|
app: maintain drawable bounding box separately from its logical boundary
Maintain the bounding box of drawables (i.e., the bounds of their
actual rendered content) separately from their logical boundary (as
shown in the UI).
The bounding box is calculated through the new
GimpDrawable::get_bounding_box() virtual function, which has a
corresponding gimp_drawable_get_bounding_box() function; the
default implementation simply returns the drawable's logical
boundary. The bounding box is specified in drawable coordinates,
i.e., it's not affected by the drawable's offset.
The bounding box is recalculated through
gimp_drawable_update_bounding_box(), which should be called
whenever a change may affect the bounding box (for example, when
setting a new buffer, as done implicitly by GimpDrawable's
::set_buffer() implementation, or when a drawable filter's
properties change, as will be done by GimpDrawableFilter in a
following commit). When the bounding box changes, the affected
regions of the drawable are updated, and the
GimpDrawable::bounding-box-changed signal is emitted.
When gimp_drawable_update() is called with negative width/height
values, the entire drawable's bounding box is updated, rather than
only its logical boundary.
Likewise, GimpDrawableStack and GimpLayerStack are adapted to use
the bounding box, instead of the logical bounds, when updating the
drawable's area.
2019-08-02 02:52:40 +08:00
|
|
|
GeglRectangle gimp_drawable_get_bounding_box (GimpDrawable *drawable);
|
|
|
|
|
gboolean gimp_drawable_update_bounding_box
|
|
|
|
|
(GimpDrawable *drawable);
|
|
|
|
|
|
2004-03-15 22:10:30 +08:00
|
|
|
void gimp_drawable_swap_pixels (GimpDrawable *drawable,
|
2012-03-22 21:13:17 +08:00
|
|
|
GeglBuffer *buffer,
|
2004-03-15 22:10:30 +08:00
|
|
|
gint x,
|
2012-03-22 21:25:45 +08:00
|
|
|
gint y);
|
2004-03-13 21:56:09 +08:00
|
|
|
|
2003-02-14 22:14:29 +08:00
|
|
|
void gimp_drawable_push_undo (GimpDrawable *drawable,
|
|
|
|
|
const gchar *undo_desc,
|
2012-03-22 21:13:17 +08:00
|
|
|
GeglBuffer *buffer,
|
2009-06-17 04:59:07 +08:00
|
|
|
gint x,
|
|
|
|
|
gint y,
|
|
|
|
|
gint width,
|
2012-03-22 21:13:17 +08:00
|
|
|
gint height);
|
2001-07-08 06:49:01 +08:00
|
|
|
|
Initial space invasion commit in GIMP
All babl formats now have a space equivalent to a color profile,
determining the format's primaries and TRCs. This commit makes GIMP
aware of this.
libgimp:
- enum GimpPrecision: rename GAMMA values to NON_LINEAR and keep GAMMA
as deprecated aliases, add PERCEPTUAL values so we now have LINEAR,
NON_LINEAR and PERCPTUAL for each encoding, matching the babl
encoding variants RGB, R'G'B' and R~G~B~.
- gimp_color_transform_can_gegl_copy() now returns TRUE if both
profiles can return a babl space, increasing the amount of fast babl
color conversions significantly.
- TODO: no solution yet for getting libgimp drawable proxy buffers in
the right format with space.
plug-ins:
- follow the GimpPrecision change.
- TODO: everything else unchanged and partly broken or sub-optimal,
like setting a new image's color profile too late.
app:
- add enum GimpTRCType { LINEAR, NON_LINEAR, PERCEPTUAL } as
replacement for all "linear" booleans.
- change gimp-babl functions to take babl spaces and GimpTRCType
parameters and support all sorts of new perceptual ~ formats.
- a lot of places changed in the early days of goat invasion didn't
take advantage of gimp-babl utility functions and constructed
formats manually. They all needed revisiting and many now use much
simpler code calling gimp-babl API.
- change gimp_babl_format_get_color_profile() to really extract a
newly allocated color profile from the format, and add
gimp_babl_get_builtin_color_profile() which does the same as
gimp_babl_format_get_color_profile() did before. Visited all callers
to decide whether they are looking for the format's actual profile,
or for one of the builtin profiles, simplifying code that only needs
builtin profiles.
- drawables have a new get_space_api(), get_linear() is now get_trc().
- images now have a "layer space" and an API to get it,
gimp_image_get_layer_format() returns formats in that space.
- an image's layer space is created from the image's color profile,
change gimpimage-color-profile to deal with that correctly
- change many babl_format() calls to babl_format_with_space() and take
the space from passed formats or drawables
- add function gimp_layer_fix_format_space() which replaces the
layer's buffer with one that has the image's layer format, but
doesn't change pixel values
- use gimp_layer_fix_format_space() to make sure layers loaded from
XCF and created by plug-ins have the right space when added to the
image, because it's impossible to always assign the right space upon
layer creation
- "assign color profile" and "discard color profile" now require use
of gimp_layer_fix_format_space() too because the profile is now
embedded in all formats via the space. Add
gimp_image_assign_color_profile() which does all that and call it
instead of a simple gimp_image_set_color_profile(), also from the
PDB set-color-profile functions, which are essentially "assign" and
"discard" calls.
- generally, make sure a new image's color profile is set before
adding layers to it, gimp_image_set_color_profile() is more than
before considered know-what-you-are-doing API.
- take special precaution in all places that call
gimp_drawable_convert_type(), we now must pass a new_profile from
all callers that convert layers within the same image (such as
image_convert_type, image_convert_precision), because the layer's
new space can't be determined from the image's layer format during
the call.
- change all "linear" properties to "trc", in all config objects like
for levels and curves, in the histogram, in the widgets. This results
in some GUI that now has three choices instead of two.
TODO: we might want to reduce that back to two later.
- keep "linear" boolean properties around as compat if needed for file
pasring, but always convert the parsed parsed boolean to
GimpTRCType.
- TODO: the image's "enable color management" switch is currently
broken, will fix that in another commit.
2018-07-21 20:23:01 +08:00
|
|
|
const Babl * gimp_drawable_get_space (GimpDrawable *drawable);
|
2016-05-20 05:51:44 +08:00
|
|
|
const Babl * gimp_drawable_get_format (GimpDrawable *drawable);
|
|
|
|
|
const Babl * gimp_drawable_get_format_with_alpha(GimpDrawable *drawable);
|
|
|
|
|
const Babl * gimp_drawable_get_format_without_alpha
|
|
|
|
|
(GimpDrawable *drawable);
|
Initial space invasion commit in GIMP
All babl formats now have a space equivalent to a color profile,
determining the format's primaries and TRCs. This commit makes GIMP
aware of this.
libgimp:
- enum GimpPrecision: rename GAMMA values to NON_LINEAR and keep GAMMA
as deprecated aliases, add PERCEPTUAL values so we now have LINEAR,
NON_LINEAR and PERCPTUAL for each encoding, matching the babl
encoding variants RGB, R'G'B' and R~G~B~.
- gimp_color_transform_can_gegl_copy() now returns TRUE if both
profiles can return a babl space, increasing the amount of fast babl
color conversions significantly.
- TODO: no solution yet for getting libgimp drawable proxy buffers in
the right format with space.
plug-ins:
- follow the GimpPrecision change.
- TODO: everything else unchanged and partly broken or sub-optimal,
like setting a new image's color profile too late.
app:
- add enum GimpTRCType { LINEAR, NON_LINEAR, PERCEPTUAL } as
replacement for all "linear" booleans.
- change gimp-babl functions to take babl spaces and GimpTRCType
parameters and support all sorts of new perceptual ~ formats.
- a lot of places changed in the early days of goat invasion didn't
take advantage of gimp-babl utility functions and constructed
formats manually. They all needed revisiting and many now use much
simpler code calling gimp-babl API.
- change gimp_babl_format_get_color_profile() to really extract a
newly allocated color profile from the format, and add
gimp_babl_get_builtin_color_profile() which does the same as
gimp_babl_format_get_color_profile() did before. Visited all callers
to decide whether they are looking for the format's actual profile,
or for one of the builtin profiles, simplifying code that only needs
builtin profiles.
- drawables have a new get_space_api(), get_linear() is now get_trc().
- images now have a "layer space" and an API to get it,
gimp_image_get_layer_format() returns formats in that space.
- an image's layer space is created from the image's color profile,
change gimpimage-color-profile to deal with that correctly
- change many babl_format() calls to babl_format_with_space() and take
the space from passed formats or drawables
- add function gimp_layer_fix_format_space() which replaces the
layer's buffer with one that has the image's layer format, but
doesn't change pixel values
- use gimp_layer_fix_format_space() to make sure layers loaded from
XCF and created by plug-ins have the right space when added to the
image, because it's impossible to always assign the right space upon
layer creation
- "assign color profile" and "discard color profile" now require use
of gimp_layer_fix_format_space() too because the profile is now
embedded in all formats via the space. Add
gimp_image_assign_color_profile() which does all that and call it
instead of a simple gimp_image_set_color_profile(), also from the
PDB set-color-profile functions, which are essentially "assign" and
"discard" calls.
- generally, make sure a new image's color profile is set before
adding layers to it, gimp_image_set_color_profile() is more than
before considered know-what-you-are-doing API.
- take special precaution in all places that call
gimp_drawable_convert_type(), we now must pass a new_profile from
all callers that convert layers within the same image (such as
image_convert_type, image_convert_precision), because the layer's
new space can't be determined from the image's layer format during
the call.
- change all "linear" properties to "trc", in all config objects like
for levels and curves, in the histogram, in the widgets. This results
in some GUI that now has three choices instead of two.
TODO: we might want to reduce that back to two later.
- keep "linear" boolean properties around as compat if needed for file
pasring, but always convert the parsed parsed boolean to
GimpTRCType.
- TODO: the image's "enable color management" switch is currently
broken, will fix that in another commit.
2018-07-21 20:23:01 +08:00
|
|
|
GimpTRCType gimp_drawable_get_trc (GimpDrawable *drawable);
|
2016-05-20 05:51:44 +08:00
|
|
|
gboolean gimp_drawable_has_alpha (GimpDrawable *drawable);
|
|
|
|
|
GimpImageBaseType gimp_drawable_get_base_type (GimpDrawable *drawable);
|
|
|
|
|
GimpComponentType gimp_drawable_get_component_type (GimpDrawable *drawable);
|
|
|
|
|
GimpPrecision gimp_drawable_get_precision (GimpDrawable *drawable);
|
|
|
|
|
gboolean gimp_drawable_is_rgb (GimpDrawable *drawable);
|
|
|
|
|
gboolean gimp_drawable_is_gray (GimpDrawable *drawable);
|
|
|
|
|
gboolean gimp_drawable_is_indexed (GimpDrawable *drawable);
|
|
|
|
|
|
|
|
|
|
const Babl * gimp_drawable_get_component_format (GimpDrawable *drawable,
|
|
|
|
|
GimpChannelType channel);
|
|
|
|
|
gint gimp_drawable_get_component_index (GimpDrawable *drawable,
|
|
|
|
|
GimpChannelType channel);
|
|
|
|
|
|
2019-11-08 17:50:32 +08:00
|
|
|
guchar * gimp_drawable_get_colormap (GimpDrawable *drawable);
|
2000-12-29 00:19:55 +08:00
|
|
|
|
app: add gimp_drawable_{start,end,flush}_paint()
gimp_drawable_start/end_paint() are used to enter/exit paint mode
for a given drawable. While the drawable is in paint mode,
gimp_drawable_get_buffer() returns a copy of the real drawable's
buffer, referred to as the paint buffer, so that modifications to
the returned buffer don't immediately affect the projection, and
calls to gimp_drawable_update() queue the updated region, instead
of emitting an "update" signal.
gimp_drawable_flush_paint() can be called while the drawable is in
paint mode, in order to copy the updated region of the paint buffer
back to the drawable's real buffer, and to emit "update" signals
for the queued region.
We use these functions in the next commit, to move painting to a
separate thread in the paint tools.
2018-04-08 21:21:46 +08:00
|
|
|
void gimp_drawable_start_paint (GimpDrawable *drawable);
|
|
|
|
|
gboolean gimp_drawable_end_paint (GimpDrawable *drawable);
|
|
|
|
|
gboolean gimp_drawable_flush_paint (GimpDrawable *drawable);
|
2018-04-10 02:25:57 +08:00
|
|
|
gboolean gimp_drawable_is_painting (GimpDrawable *drawable);
|
app: add gimp_drawable_{start,end,flush}_paint()
gimp_drawable_start/end_paint() are used to enter/exit paint mode
for a given drawable. While the drawable is in paint mode,
gimp_drawable_get_buffer() returns a copy of the real drawable's
buffer, referred to as the paint buffer, so that modifications to
the returned buffer don't immediately affect the projection, and
calls to gimp_drawable_update() queue the updated region, instead
of emitting an "update" signal.
gimp_drawable_flush_paint() can be called while the drawable is in
paint mode, in order to copy the updated region of the paint buffer
back to the drawable's real buffer, and to emit "update" signals
for the queued region.
We use these functions in the next commit, to move painting to a
separate thread in the paint tools.
2018-04-08 21:21:46 +08:00
|
|
|
|
2001-01-10 11:13:03 +08:00
|
|
|
|
2000-10-28 23:43:56 +08:00
|
|
|
#endif /* __GIMP_DRAWABLE_H__ */
|