mirror of https://github.com/GNOME/gimp.git
436 lines
25 KiB
C
436 lines
25 KiB
C
/* GIMP - The GNU Image Manipulation Program
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattisbvf
|
|
*
|
|
* 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
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __GIMP_IMAGE_H__
|
|
#define __GIMP_IMAGE_H__
|
|
|
|
|
|
#include "gimpviewable.h"
|
|
|
|
|
|
#define GIMP_IMAGE_ACTIVE_PARENT ((gpointer) 1)
|
|
|
|
|
|
#define GIMP_TYPE_IMAGE (gimp_image_get_type ())
|
|
#define GIMP_IMAGE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GIMP_TYPE_IMAGE, GimpImage))
|
|
#define GIMP_IMAGE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GIMP_TYPE_IMAGE, GimpImageClass))
|
|
#define GIMP_IS_IMAGE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GIMP_TYPE_IMAGE))
|
|
#define GIMP_IS_IMAGE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_IMAGE))
|
|
#define GIMP_IMAGE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GIMP_TYPE_IMAGE, GimpImageClass))
|
|
|
|
|
|
typedef struct _GimpImageClass GimpImageClass;
|
|
|
|
struct _GimpImage
|
|
{
|
|
GimpViewable parent_instance;
|
|
|
|
Gimp *gimp; /* the GIMP the image belongs to */
|
|
};
|
|
|
|
struct _GimpImageClass
|
|
{
|
|
GimpViewableClass parent_class;
|
|
|
|
/* signals */
|
|
void (* mode_changed) (GimpImage *image);
|
|
void (* precision_changed) (GimpImage *image);
|
|
void (* alpha_changed) (GimpImage *image);
|
|
void (* floating_selection_changed) (GimpImage *image);
|
|
void (* active_layer_changed) (GimpImage *image);
|
|
void (* active_channel_changed) (GimpImage *image);
|
|
void (* active_vectors_changed) (GimpImage *image);
|
|
void (* component_visibility_changed) (GimpImage *image,
|
|
GimpChannelType channel);
|
|
void (* component_active_changed) (GimpImage *image,
|
|
GimpChannelType channel);
|
|
void (* mask_changed) (GimpImage *image);
|
|
void (* resolution_changed) (GimpImage *image);
|
|
void (* size_changed_detailed) (GimpImage *image,
|
|
gint previous_origin_x,
|
|
gint previous_origin_y,
|
|
gint previous_width,
|
|
gint previous_height);
|
|
void (* unit_changed) (GimpImage *image);
|
|
void (* quick_mask_changed) (GimpImage *image);
|
|
void (* selection_invalidate) (GimpImage *image);
|
|
|
|
void (* clean) (GimpImage *image,
|
|
GimpDirtyMask dirty_mask);
|
|
void (* dirty) (GimpImage *image,
|
|
GimpDirtyMask dirty_mask);
|
|
void (* saved) (GimpImage *image,
|
|
const gchar *uri);
|
|
void (* exported) (GimpImage *image,
|
|
const gchar *uri);
|
|
|
|
void (* guide_added) (GimpImage *image,
|
|
GimpGuide *guide);
|
|
void (* guide_removed) (GimpImage *image,
|
|
GimpGuide *guide);
|
|
void (* guide_moved) (GimpImage *image,
|
|
GimpGuide *guide);
|
|
void (* sample_point_added) (GimpImage *image,
|
|
GimpSamplePoint *sample_point);
|
|
void (* sample_point_removed) (GimpImage *image,
|
|
GimpSamplePoint *sample_point);
|
|
void (* sample_point_moved) (GimpImage *image,
|
|
GimpSamplePoint *sample_point);
|
|
void (* parasite_attached) (GimpImage *image,
|
|
const gchar *name);
|
|
void (* parasite_detached) (GimpImage *image,
|
|
const gchar *name);
|
|
void (* colormap_changed) (GimpImage *image,
|
|
gint color_index);
|
|
void (* undo_event) (GimpImage *image,
|
|
GimpUndoEvent event,
|
|
GimpUndo *undo);
|
|
};
|
|
|
|
|
|
GType gimp_image_get_type (void) G_GNUC_CONST;
|
|
|
|
GimpImage * gimp_image_new (Gimp *gimp,
|
|
gint width,
|
|
gint height,
|
|
GimpImageBaseType base_type,
|
|
GimpPrecision precision);
|
|
|
|
gint64 gimp_image_estimate_memsize (const GimpImage *image,
|
|
GimpComponentType component_type,
|
|
gint width,
|
|
gint height);
|
|
|
|
GimpImageBaseType gimp_image_get_base_type (const GimpImage *image);
|
|
GimpComponentType gimp_image_get_component_type (const GimpImage *image);
|
|
GimpPrecision gimp_image_get_precision (const GimpImage *image);
|
|
|
|
const Babl * gimp_image_get_format (const GimpImage *image,
|
|
GimpImageBaseType base_type,
|
|
GimpPrecision precision,
|
|
gboolean with_alpha);
|
|
const Babl * gimp_image_get_layer_format (const GimpImage *image,
|
|
gboolean with_alpha);
|
|
const Babl * gimp_image_get_channel_format (const GimpImage *image);
|
|
const Babl * gimp_image_get_mask_format (const GimpImage *image);
|
|
|
|
gint gimp_image_get_ID (const GimpImage *image);
|
|
GimpImage * gimp_image_get_by_ID (Gimp *gimp,
|
|
gint id);
|
|
|
|
const gchar * gimp_image_get_uri (const GimpImage *image);
|
|
const gchar * gimp_image_get_uri_or_untitled (const GimpImage *image);
|
|
const gchar * gimp_image_get_imported_uri (const GimpImage *image);
|
|
const gchar * gimp_image_get_exported_uri (const GimpImage *image);
|
|
const gchar * gimp_image_get_save_a_copy_uri (const GimpImage *image);
|
|
const gchar * gimp_image_get_any_uri (const GimpImage *image);
|
|
|
|
void gimp_image_set_uri (GimpImage *image,
|
|
const gchar *uri);
|
|
void gimp_image_set_imported_uri (GimpImage *image,
|
|
const gchar *uri);
|
|
void gimp_image_set_exported_uri (GimpImage *image,
|
|
const gchar *uri);
|
|
void gimp_image_set_save_a_copy_uri (GimpImage *image,
|
|
const gchar *uri);
|
|
|
|
void gimp_image_set_filename (GimpImage *image,
|
|
const gchar *filename);
|
|
gchar * gimp_image_get_filename (const GimpImage *image);
|
|
|
|
const gchar * gimp_image_get_display_name (GimpImage *image);
|
|
const gchar * gimp_image_get_display_path (GimpImage *image);
|
|
|
|
void gimp_image_set_load_proc (GimpImage *image,
|
|
GimpPlugInProcedure *proc);
|
|
GimpPlugInProcedure * gimp_image_get_load_proc (const GimpImage *image);
|
|
void gimp_image_set_save_proc (GimpImage *image,
|
|
GimpPlugInProcedure *proc);
|
|
GimpPlugInProcedure * gimp_image_get_save_proc (const GimpImage *image);
|
|
void gimp_image_saved (GimpImage *image,
|
|
const gchar *uri);
|
|
void gimp_image_set_export_proc (GimpImage *image,
|
|
GimpPlugInProcedure *proc);
|
|
GimpPlugInProcedure * gimp_image_get_export_proc (const GimpImage *image);
|
|
void gimp_image_exported (GimpImage *image,
|
|
const gchar *uri);
|
|
|
|
void gimp_image_set_resolution (GimpImage *image,
|
|
gdouble xres,
|
|
gdouble yres);
|
|
void gimp_image_get_resolution (const GimpImage *image,
|
|
gdouble *xres,
|
|
gdouble *yres);
|
|
void gimp_image_resolution_changed (GimpImage *image);
|
|
|
|
void gimp_image_set_unit (GimpImage *image,
|
|
GimpUnit unit);
|
|
GimpUnit gimp_image_get_unit (const GimpImage *image);
|
|
void gimp_image_unit_changed (GimpImage *image);
|
|
|
|
gint gimp_image_get_width (const GimpImage *image);
|
|
gint gimp_image_get_height (const GimpImage *image);
|
|
|
|
gboolean gimp_image_has_alpha (const GimpImage *image);
|
|
gboolean gimp_image_is_empty (const GimpImage *image);
|
|
|
|
void gimp_image_set_floating_selection (GimpImage *image,
|
|
GimpLayer *floating_sel);
|
|
GimpLayer * gimp_image_get_floating_selection (const GimpImage *image);
|
|
void gimp_image_floating_selection_changed (GimpImage *image);
|
|
|
|
GimpChannel * gimp_image_get_mask (const GimpImage *image);
|
|
void gimp_image_mask_changed (GimpImage *image);
|
|
|
|
|
|
/* image components */
|
|
|
|
const Babl * gimp_image_get_component_format (const GimpImage *image,
|
|
GimpChannelType channel);
|
|
gint gimp_image_get_component_index (const GimpImage *image,
|
|
GimpChannelType channel);
|
|
|
|
void gimp_image_set_component_active (GimpImage *image,
|
|
GimpChannelType type,
|
|
gboolean active);
|
|
gboolean gimp_image_get_component_active (const GimpImage *image,
|
|
GimpChannelType type);
|
|
void gimp_image_get_active_array (const GimpImage *image,
|
|
gboolean *components);
|
|
GimpComponentMask gimp_image_get_active_mask (const GimpImage *image);
|
|
|
|
void gimp_image_set_component_visible (GimpImage *image,
|
|
GimpChannelType type,
|
|
gboolean visible);
|
|
gboolean gimp_image_get_component_visible (const GimpImage *image,
|
|
GimpChannelType type);
|
|
void gimp_image_get_visible_array (const GimpImage *image,
|
|
gboolean *components);
|
|
GimpComponentMask gimp_image_get_visible_mask (const GimpImage *image);
|
|
|
|
|
|
/* emitting image signals */
|
|
|
|
void gimp_image_mode_changed (GimpImage *image);
|
|
void gimp_image_precision_changed (GimpImage *image);
|
|
void gimp_image_alpha_changed (GimpImage *image);
|
|
void gimp_image_invalidate (GimpImage *image,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
void gimp_image_guide_added (GimpImage *image,
|
|
GimpGuide *guide);
|
|
void gimp_image_guide_removed (GimpImage *image,
|
|
GimpGuide *guide);
|
|
void gimp_image_guide_moved (GimpImage *image,
|
|
GimpGuide *guide);
|
|
|
|
void gimp_image_sample_point_added (GimpImage *image,
|
|
GimpSamplePoint *sample_point);
|
|
void gimp_image_sample_point_removed (GimpImage *image,
|
|
GimpSamplePoint *sample_point);
|
|
void gimp_image_sample_point_moved (GimpImage *image,
|
|
GimpSamplePoint *sample_point);
|
|
void gimp_image_colormap_changed (GimpImage *image,
|
|
gint col);
|
|
void gimp_image_selection_invalidate (GimpImage *image);
|
|
void gimp_image_quick_mask_changed (GimpImage *image);
|
|
void gimp_image_size_changed_detailed (GimpImage *image,
|
|
gint previous_origin_x,
|
|
gint previous_origin_y,
|
|
gint previous_width,
|
|
gint previous_height);
|
|
void gimp_image_undo_event (GimpImage *image,
|
|
GimpUndoEvent event,
|
|
GimpUndo *undo);
|
|
|
|
|
|
/* dirty counters */
|
|
|
|
gint gimp_image_dirty (GimpImage *image,
|
|
GimpDirtyMask dirty_mask);
|
|
gint gimp_image_clean (GimpImage *image,
|
|
GimpDirtyMask dirty_mask);
|
|
void gimp_image_clean_all (GimpImage *image);
|
|
void gimp_image_export_clean_all (GimpImage *image);
|
|
gint gimp_image_is_dirty (const GimpImage *image);
|
|
gboolean gimp_image_is_export_dirty (const GimpImage *image);
|
|
gint gimp_image_get_dirty_time (const GimpImage *image);
|
|
|
|
|
|
/* flush this image's displays */
|
|
|
|
void gimp_image_flush (GimpImage *image);
|
|
|
|
|
|
/* display / instance counters */
|
|
|
|
gint gimp_image_get_display_count (const GimpImage *image);
|
|
void gimp_image_inc_display_count (GimpImage *image);
|
|
void gimp_image_dec_display_count (GimpImage *image);
|
|
|
|
gint gimp_image_get_instance_count (const GimpImage *image);
|
|
void gimp_image_inc_instance_count (GimpImage *image);
|
|
|
|
|
|
/* parasites */
|
|
|
|
const GimpParasite * gimp_image_parasite_find (const GimpImage *image,
|
|
const gchar *name);
|
|
gchar ** gimp_image_parasite_list (const GimpImage *image,
|
|
gint *count);
|
|
gboolean gimp_image_parasite_validate (GimpImage *image,
|
|
const GimpParasite *parasite,
|
|
GError **error);
|
|
void gimp_image_parasite_attach (GimpImage *image,
|
|
const GimpParasite *parasite);
|
|
void gimp_image_parasite_detach (GimpImage *image,
|
|
const gchar *name);
|
|
|
|
|
|
/* tattoos */
|
|
|
|
GimpTattoo gimp_image_get_new_tattoo (GimpImage *image);
|
|
gboolean gimp_image_set_tattoo_state (GimpImage *image,
|
|
GimpTattoo val);
|
|
GimpTattoo gimp_image_get_tattoo_state (GimpImage *image);
|
|
|
|
|
|
/* projection */
|
|
|
|
GimpProjection * gimp_image_get_projection (const GimpImage *image);
|
|
|
|
|
|
/* layers / channels / vectors */
|
|
|
|
GimpItemTree * gimp_image_get_layer_tree (const GimpImage *image);
|
|
GimpItemTree * gimp_image_get_channel_tree (const GimpImage *image);
|
|
GimpItemTree * gimp_image_get_vectors_tree (const GimpImage *image);
|
|
|
|
GimpContainer * gimp_image_get_layers (const GimpImage *image);
|
|
GimpContainer * gimp_image_get_channels (const GimpImage *image);
|
|
GimpContainer * gimp_image_get_vectors (const GimpImage *image);
|
|
|
|
gint gimp_image_get_n_layers (const GimpImage *image);
|
|
gint gimp_image_get_n_channels (const GimpImage *image);
|
|
gint gimp_image_get_n_vectors (const GimpImage *image);
|
|
|
|
GList * gimp_image_get_layer_iter (const GimpImage *image);
|
|
GList * gimp_image_get_channel_iter (const GimpImage *image);
|
|
GList * gimp_image_get_vectors_iter (const GimpImage *image);
|
|
|
|
GList * gimp_image_get_layer_list (const GimpImage *image);
|
|
GList * gimp_image_get_channel_list (const GimpImage *image);
|
|
GList * gimp_image_get_vectors_list (const GimpImage *image);
|
|
|
|
GimpDrawable * gimp_image_get_active_drawable (const GimpImage *image);
|
|
GimpLayer * gimp_image_get_active_layer (const GimpImage *image);
|
|
GimpChannel * gimp_image_get_active_channel (const GimpImage *image);
|
|
GimpVectors * gimp_image_get_active_vectors (const GimpImage *image);
|
|
|
|
GimpLayer * gimp_image_set_active_layer (GimpImage *image,
|
|
GimpLayer *layer);
|
|
GimpChannel * gimp_image_set_active_channel (GimpImage *image,
|
|
GimpChannel *channel);
|
|
GimpChannel * gimp_image_unset_active_channel (GimpImage *image);
|
|
GimpVectors * gimp_image_set_active_vectors (GimpImage *image,
|
|
GimpVectors *vectors);
|
|
|
|
GimpLayer * gimp_image_get_layer_by_tattoo (const GimpImage *image,
|
|
GimpTattoo tattoo);
|
|
GimpChannel * gimp_image_get_channel_by_tattoo (const GimpImage *image,
|
|
GimpTattoo tattoo);
|
|
GimpVectors * gimp_image_get_vectors_by_tattoo (const GimpImage *image,
|
|
GimpTattoo tattoo);
|
|
|
|
GimpLayer * gimp_image_get_layer_by_name (const GimpImage *image,
|
|
const gchar *name);
|
|
GimpChannel * gimp_image_get_channel_by_name (const GimpImage *image,
|
|
const gchar *name);
|
|
GimpVectors * gimp_image_get_vectors_by_name (const GimpImage *image,
|
|
const gchar *name);
|
|
|
|
gboolean gimp_image_reorder_item (GimpImage *image,
|
|
GimpItem *item,
|
|
GimpItem *new_parent,
|
|
gint new_index,
|
|
gboolean push_undo,
|
|
const gchar *undo_desc);
|
|
gboolean gimp_image_raise_item (GimpImage *image,
|
|
GimpItem *item,
|
|
GError **error);
|
|
gboolean gimp_image_raise_item_to_top (GimpImage *image,
|
|
GimpItem *item);
|
|
gboolean gimp_image_lower_item (GimpImage *image,
|
|
GimpItem *item,
|
|
GError **error);
|
|
gboolean gimp_image_lower_item_to_bottom (GimpImage *image,
|
|
GimpItem *item);
|
|
|
|
gboolean gimp_image_add_layer (GimpImage *image,
|
|
GimpLayer *layer,
|
|
GimpLayer *parent,
|
|
gint position,
|
|
gboolean push_undo);
|
|
void gimp_image_remove_layer (GimpImage *image,
|
|
GimpLayer *layer,
|
|
gboolean push_undo,
|
|
GimpLayer *new_active);
|
|
|
|
void gimp_image_add_layers (GimpImage *image,
|
|
GList *layers,
|
|
GimpLayer *parent,
|
|
gint position,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height,
|
|
const gchar *undo_desc);
|
|
|
|
gboolean gimp_image_add_channel (GimpImage *image,
|
|
GimpChannel *channel,
|
|
GimpChannel *parent,
|
|
gint position,
|
|
gboolean push_undo);
|
|
void gimp_image_remove_channel (GimpImage *image,
|
|
GimpChannel *channel,
|
|
gboolean push_undo,
|
|
GimpChannel *new_active);
|
|
|
|
gboolean gimp_image_add_vectors (GimpImage *image,
|
|
GimpVectors *vectors,
|
|
GimpVectors *parent,
|
|
gint position,
|
|
gboolean push_undo);
|
|
void gimp_image_remove_vectors (GimpImage *image,
|
|
GimpVectors *vectors,
|
|
gboolean push_undo,
|
|
GimpVectors *new_active);
|
|
|
|
gboolean gimp_image_coords_in_active_pickable (GimpImage *image,
|
|
const GimpCoords *coords,
|
|
gboolean sample_merged,
|
|
gboolean selected_only);
|
|
|
|
void gimp_image_invalidate_previews (GimpImage *image);
|
|
|
|
const gchar * gimp_image_get_string_untitled (void);
|
|
|
|
|
|
#endif /* __GIMP_IMAGE_H__ */
|