procyberian/gimp
2
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/gimp.git synced 2025-07-03 17:33:25 +00:00
Code Issues 1 Projects 1 Releases Packages Wiki Activity Actions
gimp/libgimp/gimpprocedureconfig.h

88 lines
3.5 KiB
C
Raw Normal View History

libgimp: add GimpProcedureConfig which implements the GimpConfig interface It's the base for bringing proper management of saved settings (including the last used values) and generated GUI using prop_widgets to plug-ins.
2019-09-20 12:31:11 +02:00
/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
*
* gimpprocedureconfig.h
* Copyright (C) 2019 Michael Natterer <mitch@gimp.org>
*
* This library is free software: you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see
* <https://www.gnu.org/licenses/>.
*/
#if !defined (__GIMP_H_INSIDE__) && !defined (GIMP_COMPILATION)
#error "Only <libgimp/gimp.h> can be included directly."
#endif
#ifndef __GIMP_PROCEDURE_CONFIG_H__
#define __GIMP_PROCEDURE_CONFIG_H__
G_BEGIN_DECLS
/* For information look into the C source or the html documentation */
libgimp, libgimpmodule, libgimpwidgets: Port more widgets to derivable type
2024-08-03 02:48:07 +00:00
#define GIMP_TYPE_PROCEDURE_CONFIG (gimp_procedure_config_get_type ())
G_DECLARE_DERIVABLE_TYPE (GimpProcedureConfig, gimp_procedure_config, GIMP, PROCEDURE_CONFIG, GObject)
libgimp: add GimpProcedureConfig which implements the GimpConfig interface It's the base for bringing proper management of saved settings (including the last used values) and generated GUI using prop_widgets to plug-ins.
2019-09-20 12:31:11 +02:00
struct _GimpProcedureConfigClass
{
GObjectClass parent_class;
/* Padding for future expansion */
libgimp*: keep 10 reserved spots for future virtual functions in every derivable class. Hopefully this should be enough to add new features in the future without breaking ABI, at least until GIMP 4!
2024-10-31 20:23:24 +01:00
void (* _gimp_reserved0) (void);
libgimp: add GimpProcedureConfig which implements the GimpConfig interface It's the base for bringing proper management of saved settings (including the last used values) and generated GUI using prop_widgets to plug-ins.
2019-09-20 12:31:11 +02:00
void (* _gimp_reserved1) (void);
void (* _gimp_reserved2) (void);
void (* _gimp_reserved3) (void);
void (* _gimp_reserved4) (void);
void (* _gimp_reserved5) (void);
void (* _gimp_reserved6) (void);
void (* _gimp_reserved7) (void);
void (* _gimp_reserved8) (void);
libgimp*: keep 10 reserved spots for future virtual functions in every derivable class. Hopefully this should be enough to add new features in the future without breaking ABI, at least until GIMP 4!
2024-10-31 20:23:24 +01:00
void (* _gimp_reserved9) (void);
libgimp: add GimpProcedureConfig which implements the GimpConfig interface It's the base for bringing proper management of saved settings (including the last used values) and generated GUI using prop_widgets to plug-ins.
2019-09-20 12:31:11 +02:00
};
libgimp, libgimpbase: create special functions to get/set boxed array properties. While the work on NULL-terminated array types make it much easier in C, bindings don't have enough information to create native array/list types in some generic functions such as g_object_get|set(), or else we just don't know the right annotations to use for this to be possible. This is report gobject-introspection#492. So for the time being, we are creating dedicated functions for GeglColor arrays and for other core object arrays (arrays of images, items, etc.). E.g. in Python, while you can set a single GimpImage like this: > config.set_property('image', image) … you need to set a list of images like this: > config.set_core_object_array('images', [image1, image2])
2024-10-28 19:18:22 +01:00
GimpProcedure * gimp_procedure_config_get_procedure (GimpProcedureConfig *config);
libgimp: add gimp_procedure_config_get_procedure() and use it in gimp_procedure_dialog_new() to make sure that the passed config was created by the passed procedure.
2019-09-20 19:33:50 +02:00
libgimp, libgimpbase: create special functions to get/set boxed array properties. While the work on NULL-terminated array types make it much easier in C, bindings don't have enough information to create native array/list types in some generic functions such as g_object_get|set(), or else we just don't know the right annotations to use for this to be possible. This is report gobject-introspection#492. So for the time being, we are creating dedicated functions for GeglColor arrays and for other core object arrays (arrays of images, items, etc.). E.g. in Python, while you can set a single GimpImage like this: > config.set_property('image', image) … you need to set a list of images like this: > config.set_core_object_array('images', [image1, image2])
2024-10-28 19:18:22 +01:00
void gimp_procedure_config_save_metadata (GimpProcedureConfig *config,
GimpImage *exported_image,
GFile *file);
libgimp: add gimp_procedure_config_save_metadata() so the export's GimpMetadata can be written at any time during the export process, which is for example needed for TIFF export.
2020-06-05 18:40:18 +02:00
libgimp, libgimpbase: create special functions to get/set boxed array properties. While the work on NULL-terminated array types make it much easier in C, bindings don't have enough information to create native array/list types in some generic functions such as g_object_get|set(), or else we just don't know the right annotations to use for this to be possible. This is report gobject-introspection#492. So for the time being, we are creating dedicated functions for GeglColor arrays and for other core object arrays (arrays of images, items, etc.). E.g. in Python, while you can set a single GimpImage like this: > config.set_property('image', image) … you need to set a list of images like this: > config.set_core_object_array('images', [image1, image2])
2024-10-28 19:18:22 +01:00
/* Binding functions */
GObject ** gimp_procedure_config_get_core_object_array (GimpProcedureConfig *config,
const gchar *property_name);
void gimp_procedure_config_set_core_object_array (GimpProcedureConfig *config,
const gchar *property_name,
GObject **objects,
gsize n_objects);
GeglColor ** gimp_procedure_config_get_color_array (GimpProcedureConfig *config,
const gchar *property_name);
void gimp_procedure_config_set_color_array (GimpProcedureConfig *config,
const gchar *property_name,
GeglColor **colors,
gsize n_colors);
libgimp: new utility method gimp_procedure_config_get_choice_id(). This is just a method to simplify transforming a GimpChoice argument into an enum value, which is easier to deal with, in C. It also allows to benefit from switch() warnings or the like to make sure no cases are missing.
2023-08-03 21:17:45 +02:00
/* Utility functions */
libgimp, libgimpbase: create special functions to get/set boxed array properties. While the work on NULL-terminated array types make it much easier in C, bindings don't have enough information to create native array/list types in some generic functions such as g_object_get|set(), or else we just don't know the right annotations to use for this to be possible. This is report gobject-introspection#492. So for the time being, we are creating dedicated functions for GeglColor arrays and for other core object arrays (arrays of images, items, etc.). E.g. in Python, while you can set a single GimpImage like this: > config.set_property('image', image) … you need to set a list of images like this: > config.set_core_object_array('images', [image1, image2])
2024-10-28 19:18:22 +01:00
gint gimp_procedure_config_get_choice_id (GimpProcedureConfig *config,
const gchar *property_name);
libgimp: new utility method gimp_procedure_config_get_choice_id(). This is just a method to simplify transforming a GimpChoice argument into an enum value, which is easier to deal with, in C. It also allows to benefit from switch() warnings or the like to make sure no cases are missing.
2023-08-03 21:17:45 +02:00
libgimp: add GimpProcedureConfig which implements the GimpConfig interface It's the base for bringing proper management of saved settings (including the last used values) and generated GUI using prop_widgets to plug-ins.
2019-09-20 12:31:11 +02:00
G_END_DECLS
#endif /* __GIMP_PROCEDURE_CONFIG_H__ */
Reference in a new issue Copy permalink