dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/libgimp/gimpitem_pdb.c

1357 lines
37 KiB
C
Raw Normal View History

pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
*
* gimpitem_pdb.c
*
* 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
Change the license URL from http://www.gnu.org/licenses/ to https://
2018-07-12 05:27:07 +08:00
* <https://www.gnu.org/licenses/>.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*/
/* NOTE: This file is auto-generated by pdbgen.pl */
#include "config.h"
Issue #4201: meson: pdbgen not working. Fix the dependency by making the stamp an actual (yet empty/no-op) header file which is included by all generated source file. This way, we ensure that meson rebuild .o files when the .pdb sources are changed. This is the second solution proposed by eli-schwartz here: https://github.com/mesonbuild/meson/issues/10196#issuecomment-1080053413
2022-03-28 21:13:17 +08:00
#include "stamp-pdbgen.h"
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
#include "gimp.h"
/**
Revert "pdb, libgimp: append _pdb for gtk-doc SECTION names of pdb files." This reverts commit 833666d462e52337a224cc2c6637ed9b826ee570. The _pdb files are an implementation detail and we do not want separate doc sections for them, the conflicts need so be resolved in another way.
2019-07-31 16:04:43 +08:00
* SECTION: gimpitem
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
* @title: gimpitem
* @short_description: Functions to manipulate items.
*
* Functions to manipulate items.
**/
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_id_is_valid:
* @item_id: The item ID to check.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* Returns %TRUE if the item ID is valid.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* This procedure checks if the given item ID is valid and refers to an
* existing item.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. If you
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* got a [class@Gimp.Item] from the API, you should trust it is valid.
* This function is mostly for internal usage.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Returns: Whether the item ID is valid.
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Since: 3.0
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
**/
gboolean
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gimp_item_id_is_valid (gint item_id)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean valid = FALSE;
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-id-is-valid",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
valid = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return valid;
}
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_id_is_drawable:
* @item_id: The item ID.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns whether the item ID is a drawable.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a drawable.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. See
app, libgimp, pdb: fixing broken GIR links. The 'help' field needs to be single-quoted so that @-values do not look like perl variables, hence breaking GIR annotations. Fixing: > Possible unintended interpolation of @Gimp in string at /home/jehan/dev/src/gimp/pdb/groups/item.pdb line 64.
2024-08-27 06:24:26 +08:00
* [func@Gimp.Item.id_is_layer] for a discussion on alternatives.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns: TRUE if the item ID is a drawable, FALSE otherwise.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Since: 3.0
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
gboolean
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gimp_item_id_is_drawable (gint item_id)
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gboolean drawable = FALSE;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-id-is-drawable",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
drawable = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
return drawable;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
}
pdb: deprecate gimp-drawable-is-text-layer and add gimp-item-is-text-layer
2010-09-16 03:51:53 +08:00
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_id_is_layer:
* @item_id: The item ID.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns whether the item ID is a layer.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a layer.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. If the
app, libgimp, pdb: fixing broken GIR links. The 'help' field needs to be single-quoted so that @-values do not look like perl variables, hence breaking GIR annotations. Fixing: > Possible unintended interpolation of @Gimp in string at /home/jehan/dev/src/gimp/pdb/groups/item.pdb line 64.
2024-08-27 06:24:26 +08:00
* goal is to verify the accurate type for a [class@Gimp.Item], you
* should either use [method@Gimp.Item.is_layer] or the specific
* type-checking methods for the used language.
app, libgimp, pdb: support triple-backticks unformatted desc sections. The previous PDB generation was losing pre-formatting inside triple-backticked blocks. In particular we were losing indentation (which was already ugly in C, but even syntactically wrong when displaying Python code samples). And it was also making us add double-newlines between every code lines, which was annoying. This updated code now leaves triple-backticked sections as-is. Unfortunately I was completely unable to do this by modifying the existing functions, which were modifying the input arg in-place. So I made them into functions returning the result. But then there is another part of code (niceargs()) where changing array contents doesn't work properly, and worse it seems to corrupt the array somehow (because I have generation breakage in completely-different pieces of the PDB generation code). I believe there is some passing-by reference/value concepts in perl which I don't quite get (they use `&`, `\` and other symbols and even searching for these, I don't quite understand how to use them the right way) but I've spent already too much time on this. So since I've got something working now by having duplicate functions, I'll let someone else from the future, who knows better perl, re-merge these functions if they know how.
2024-08-27 17:39:31 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* For instance, in C:
app, libgimp, pdb: support triple-backticks unformatted desc sections. The previous PDB generation was losing pre-formatting inside triple-backticked blocks. In particular we were losing indentation (which was already ugly in C, but even syntactically wrong when displaying Python code samples). And it was also making us add double-newlines between every code lines, which was annoying. This updated code now leaves triple-backticked sections as-is. Unfortunately I was completely unable to do this by modifying the existing functions, which were modifying the input arg in-place. So I made them into functions returning the result. But then there is another part of code (niceargs()) where changing array contents doesn't work properly, and worse it seems to corrupt the array somehow (because I have generation breakage in completely-different pieces of the PDB generation code). I believe there is some passing-by reference/value concepts in perl which I don't quite get (they use `&`, `\` and other symbols and even searching for these, I don't quite understand how to use them the right way) but I've spent already too much time on this. So since I've got something working now by having duplicate functions, I'll let someone else from the future, who knows better perl, re-merge these functions if they know how.
2024-08-27 17:39:31 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* ```C
* if (GIMP_IS_LAYER (item))
app, libgimp, pdb: support triple-backticks unformatted desc sections. The previous PDB generation was losing pre-formatting inside triple-backticked blocks. In particular we were losing indentation (which was already ugly in C, but even syntactically wrong when displaying Python code samples). And it was also making us add double-newlines between every code lines, which was annoying. This updated code now leaves triple-backticked sections as-is. Unfortunately I was completely unable to do this by modifying the existing functions, which were modifying the input arg in-place. So I made them into functions returning the result. But then there is another part of code (niceargs()) where changing array contents doesn't work properly, and worse it seems to corrupt the array somehow (because I have generation breakage in completely-different pieces of the PDB generation code). I believe there is some passing-by reference/value concepts in perl which I don't quite get (they use `&`, `\` and other symbols and even searching for these, I don't quite understand how to use them the right way) but I've spent already too much time on this. So since I've got something working now by having duplicate functions, I'll let someone else from the future, who knows better perl, re-merge these functions if they know how.
2024-08-27 17:39:31 +08:00
* do_something ();
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* ```
app, libgimp, pdb: support triple-backticks unformatted desc sections. The previous PDB generation was losing pre-formatting inside triple-backticked blocks. In particular we were losing indentation (which was already ugly in C, but even syntactically wrong when displaying Python code samples). And it was also making us add double-newlines between every code lines, which was annoying. This updated code now leaves triple-backticked sections as-is. Unfortunately I was completely unable to do this by modifying the existing functions, which were modifying the input arg in-place. So I made them into functions returning the result. But then there is another part of code (niceargs()) where changing array contents doesn't work properly, and worse it seems to corrupt the array somehow (because I have generation breakage in completely-different pieces of the PDB generation code). I believe there is some passing-by reference/value concepts in perl which I don't quite get (they use `&`, `\` and other symbols and even searching for these, I don't quite understand how to use them the right way) but I've spent already too much time on this. So since I've got something working now by having duplicate functions, I'll let someone else from the future, who knows better perl, re-merge these functions if they know how.
2024-08-27 17:39:31 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* Or in the Python binding, you could run:
app, libgimp, pdb: support triple-backticks unformatted desc sections. The previous PDB generation was losing pre-formatting inside triple-backticked blocks. In particular we were losing indentation (which was already ugly in C, but even syntactically wrong when displaying Python code samples). And it was also making us add double-newlines between every code lines, which was annoying. This updated code now leaves triple-backticked sections as-is. Unfortunately I was completely unable to do this by modifying the existing functions, which were modifying the input arg in-place. So I made them into functions returning the result. But then there is another part of code (niceargs()) where changing array contents doesn't work properly, and worse it seems to corrupt the array somehow (because I have generation breakage in completely-different pieces of the PDB generation code). I believe there is some passing-by reference/value concepts in perl which I don't quite get (they use `&`, `\` and other symbols and even searching for these, I don't quite understand how to use them the right way) but I've spent already too much time on this. So since I've got something working now by having duplicate functions, I'll let someone else from the future, who knows better perl, re-merge these functions if they know how.
2024-08-27 17:39:31 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* ```py3
* if isinstance(item, Gimp.Layer):
app, libgimp, pdb: support triple-backticks unformatted desc sections. The previous PDB generation was losing pre-formatting inside triple-backticked blocks. In particular we were losing indentation (which was already ugly in C, but even syntactically wrong when displaying Python code samples). And it was also making us add double-newlines between every code lines, which was annoying. This updated code now leaves triple-backticked sections as-is. Unfortunately I was completely unable to do this by modifying the existing functions, which were modifying the input arg in-place. So I made them into functions returning the result. But then there is another part of code (niceargs()) where changing array contents doesn't work properly, and worse it seems to corrupt the array somehow (because I have generation breakage in completely-different pieces of the PDB generation code). I believe there is some passing-by reference/value concepts in perl which I don't quite get (they use `&`, `\` and other symbols and even searching for these, I don't quite understand how to use them the right way) but I've spent already too much time on this. So since I've got something working now by having duplicate functions, I'll let someone else from the future, who knows better perl, re-merge these functions if they know how.
2024-08-27 17:39:31 +08:00
* do_something()
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* ```
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* Returns: TRUE if the item is a layer, FALSE otherwise.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Since: 3.0
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
gboolean
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gimp_item_id_is_layer (gint item_id)
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gboolean layer = FALSE;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-id-is-layer",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
layer = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
return layer;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
}
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_id_is_text_layer:
* @item_id: The item ID.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns whether the item ID is a text layer.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a text
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* layer.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. See
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* [func@Gimp.Item.id_is_layer] for a discussion on alternatives.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* Returns: TRUE if the item is a text layer, FALSE otherwise.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Since: 3.0
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
gboolean
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gimp_item_id_is_text_layer (gint item_id)
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gboolean text_layer = FALSE;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-id-is-text-layer",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
text_layer = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
return text_layer;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
}
app, libgimp, pdb, plug-ins: new GimpGroupLayer class in libgimp. Also: - renaming gimp_layer_group_new() to gimp_group_layer_new() in order to keep the same name as in core code (i.e. GimpGroupLayer, not GimpLayerGroup). - renaming gimp_image_merge_layer_group() to gimp_group_layer_merge() - new functions: gimp_procedure_add_group_layer_argument(), gimp_procedure_add_group_layer_aux_argument() and gimp_procedure_add_group_layer_return_value(). This can be tested, e.g. in Python with these calls: ```py i = Gimp.get_images()[0] g = Gimp.GroupLayer.new(i, "hello") i.insert_layer(g, None, 1) g2 = Gimp.GroupLayer.new(i, "world") i.insert_layer(g2, g, 1) g.merge() ``` This was work started long ago, stored in an old stash which I finally finish now! :-)
2024-07-06 23:24:11 +08:00
/**
* gimp_item_id_is_group_layer:
* @item_id: The item ID.
*
* Returns whether the item ID is a group layer.
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a group
app, libgimp, pdb, plug-ins: new GimpGroupLayer class in libgimp. Also: - renaming gimp_layer_group_new() to gimp_group_layer_new() in order to keep the same name as in core code (i.e. GimpGroupLayer, not GimpLayerGroup). - renaming gimp_image_merge_layer_group() to gimp_group_layer_merge() - new functions: gimp_procedure_add_group_layer_argument(), gimp_procedure_add_group_layer_aux_argument() and gimp_procedure_add_group_layer_return_value(). This can be tested, e.g. in Python with these calls: ```py i = Gimp.get_images()[0] g = Gimp.GroupLayer.new(i, "hello") i.insert_layer(g, None, 1) g2 = Gimp.GroupLayer.new(i, "world") i.insert_layer(g2, g, 1) g.merge() ``` This was work started long ago, stored in an old stash which I finally finish now! :-)
2024-07-06 23:24:11 +08:00
* layer.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. See
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* [func@Gimp.Item.id_is_layer] for a discussion on alternatives.
app, libgimp, pdb, plug-ins: new GimpGroupLayer class in libgimp. Also: - renaming gimp_layer_group_new() to gimp_group_layer_new() in order to keep the same name as in core code (i.e. GimpGroupLayer, not GimpLayerGroup). - renaming gimp_image_merge_layer_group() to gimp_group_layer_merge() - new functions: gimp_procedure_add_group_layer_argument(), gimp_procedure_add_group_layer_aux_argument() and gimp_procedure_add_group_layer_return_value(). This can be tested, e.g. in Python with these calls: ```py i = Gimp.get_images()[0] g = Gimp.GroupLayer.new(i, "hello") i.insert_layer(g, None, 1) g2 = Gimp.GroupLayer.new(i, "world") i.insert_layer(g2, g, 1) g.merge() ``` This was work started long ago, stored in an old stash which I finally finish now! :-)
2024-07-06 23:24:11 +08:00
*
* Returns: TRUE if the item is a group layer, FALSE otherwise.
*
* Since: 3.0
**/
gboolean
gimp_item_id_is_group_layer (gint item_id)
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean group_layer = FALSE;
args = gimp_value_array_new_from_types (NULL,
G_TYPE_INT, item_id,
G_TYPE_NONE);
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-id-is-group-layer",
args);
gimp_value_array_unref (args);
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
group_layer = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
gimp_value_array_unref (return_vals);
return group_layer;
}
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_id_is_channel:
* @item_id: The item ID.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns whether the item ID is a channel.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a channel.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. See
app, libgimp, pdb: fixing broken GIR links. The 'help' field needs to be single-quoted so that @-values do not look like perl variables, hence breaking GIR annotations. Fixing: > Possible unintended interpolation of @Gimp in string at /home/jehan/dev/src/gimp/pdb/groups/item.pdb line 64.
2024-08-27 06:24:26 +08:00
* [func@Gimp.Item.id_is_layer] for a discussion on alternatives.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns: TRUE if the item ID is a channel, FALSE otherwise.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Since: 3.0
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
gboolean
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gimp_item_id_is_channel (gint item_id)
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gboolean channel = FALSE;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-id-is-channel",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
channel = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
return channel;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
}
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_id_is_layer_mask:
* @item_id: The item.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns whether the item ID is a layer mask.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a layer
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* mask.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. See
app, libgimp, pdb: fixing broken GIR links. The 'help' field needs to be single-quoted so that @-values do not look like perl variables, hence breaking GIR annotations. Fixing: > Possible unintended interpolation of @Gimp in string at /home/jehan/dev/src/gimp/pdb/groups/item.pdb line 64.
2024-08-27 06:24:26 +08:00
* [func@Gimp.Item.id_is_layer] for a discussion on alternatives.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns: TRUE if the item ID is a layer mask, FALSE otherwise.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Since: 3.0
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
gboolean
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gimp_item_id_is_layer_mask (gint item_id)
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gboolean layer_mask = FALSE;
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-id-is-layer-mask",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
layer_mask = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
return layer_mask;
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
}
/**
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
* gimp_item_id_is_path:
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* @item_id: The item ID.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
* Returns whether the item ID is a path.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a path.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. See
app, libgimp, pdb: fixing broken GIR links. The 'help' field needs to be single-quoted so that @-values do not look like perl variables, hence breaking GIR annotations. Fixing: > Possible unintended interpolation of @Gimp in string at /home/jehan/dev/src/gimp/pdb/groups/item.pdb line 64.
2024-08-27 06:24:26 +08:00
* [func@Gimp.Item.id_is_layer] for a discussion on alternatives.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
* Returns: TRUE if the item ID is a path, FALSE otherwise.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
pdb: item.pdb: '3,0' is not a version, it's '3.0'
2019-10-28 01:56:53 +08:00
* Since: 3.0
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gboolean
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
gimp_item_id_is_path (gint item_id)
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
gboolean path = FALSE;
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
"gimp-item-id-is-path",
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
path = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
return path;
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
}
/**
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
* gimp_item_id_is_selection:
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* @item_id: The item ID.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
* Returns whether the item ID is a selection.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item ID is a
* selection.
app, libgimp, pdb: prettify the previous commit. I double-checked the gi-docgen docs and realized the "Note:" were all on the same line as previous text. I had forgotten it just removed one newline. So if I want a new paragraph (double-newline in markdown), I need 3 newlines in the pdb file.
2024-08-26 21:14:48 +08:00
*
* *Note*: in most use cases, you should not use this function. See
app, libgimp, pdb: fixing broken GIR links. The 'help' field needs to be single-quoted so that @-values do not look like perl variables, hence breaking GIR annotations. Fixing: > Possible unintended interpolation of @Gimp in string at /home/jehan/dev/src/gimp/pdb/groups/item.pdb line 64.
2024-08-27 06:24:26 +08:00
* [func@Gimp.Item.id_is_layer] for a discussion on alternatives.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
* Returns: TRUE if the item ID is a selection, FALSE otherwise.
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Since: 3.0
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gboolean
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
gimp_item_id_is_selection (gint item_id)
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
gboolean selection = FALSE;
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
G_TYPE_INT, item_id,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
"gimp-item-id-is-selection",
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
selection = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: Rename libgimp GimpVectors vectors API... ...to paths Follow-up to d0bdbdfd. Changes all gimp_vectors_* () PDB to gimp_path_* () and renames relevant PDB files from vectors to path. The next step will be to rename GimpVectors in libgimp to GimpPath, removing the last (public) trace of it.
2024-07-09 07:39:51 +08:00
return selection;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_get_image:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns the item's image.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* This procedure returns the item's image.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns: (transfer none): The item's image.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GimpImage *
gimp_item_get_image (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GimpImage *image = NULL;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-image",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
image = GIMP_VALUES_GET_IMAGE (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
return image;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* gimp_item_delete:
* @item: The item to delete.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Delete a item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* This procedure deletes the specified item. This must not be done if
* the image containing this item was already deleted or if the item
* was already removed from the image. The only case in which this
* procedure is useful is if you want to get rid of a item which has
* not yet been added to an image.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
* Returns: TRUE on success.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
gboolean
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gimp_item_delete (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
gboolean success = TRUE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-delete",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
return success;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
* gimp_item_is_group:
* @item: The item.
*
* Returns whether the item is a group item.
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item is a group item
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* which can have children.
*
* Returns: TRUE if the item is a group, FALSE otherwise.
*
* Since: 2.8
**/
gboolean
gimp_item_is_group (GimpItem *item)
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean group = FALSE;
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-is-group",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
group = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return group;
}
/**
* gimp_item_get_parent:
* @item: The item.
*
* Returns the item's parent item.
*
* This procedure returns the item's parent item, if any.
*
libgimp: GimpItem now also belong to libgimp.
2019-08-15 18:12:25 +08:00
* Returns: (transfer none): The item's parent item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
GimpItem *
gimp_item_get_parent (GimpItem *item)
{
GimpValueArray *args;
GimpValueArray *return_vals;
GimpItem *parent = NULL;
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-parent",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
parent = GIMP_VALUES_GET_ITEM (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return parent;
}
/**
libgimp, pdb, plug-ins: don't skip gimp_*get_*() API from GObject Introspection anymore. The original reason to skip these was because the new _list_ API were introspected basically to a similar function signature, except with a useless return value, at least in pygobject binding where the list size was also returned. Though it seems that in fact, only the docstring was wrong. The real signature was apparently already the same. See: https://gitlab.gnome.org/GNOME/pygobject/-/issues/352 Therefore since the _get_ naming is more consistent compared to other existing function, let's re-integrate the _get_ functions for array of items or images. This basically reverts commit 15ec254148f.
2024-07-06 20:18:36 +08:00
* gimp_item_get_children:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
* @num_children: (out): The item's number of children.
*
* Returns the item's list of children.
*
* This procedure returns the list of items which are children of the
* specified item. The order is topmost to bottommost.
*
pdb, libgimp: change all generated ID array return values to object arrays and remove the manual libgimp wrappers which now have the same signature as the generated functions.
2019-09-05 18:57:43 +08:00
* Returns: (array length=num_children) (element-type GimpItem) (transfer container):
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* The item's list of children.
* The returned value must be freed with g_free().
*
* Since: 2.8
**/
pdb, libgimp: change all generated ID array return values to object arrays and remove the manual libgimp wrappers which now have the same signature as the generated functions.
2019-09-05 18:57:43 +08:00
GimpItem **
gimp_item_get_children (GimpItem *item,
gint *num_children)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: change all generated ID array return values to object arrays and remove the manual libgimp wrappers which now have the same signature as the generated functions.
2019-09-05 18:57:43 +08:00
GimpItem **children = NULL;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-children",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
*num_children = 0;
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
*num_children = GIMP_VALUES_GET_INT (return_vals, 1);
app, libgimp*, pdb, plug-ins: use g_memdup2() instead of g_memdup() Since it appeared with GLib 2.68.0, we could not change this until we bumped the dependency which has only become possible a few days ago (since Debian testing is our baseline for dependency bumps). Cf. previous commit. As this is a drop-in replacement (just a guint parameter changed to gsize to avoid integer overflow), search-and-replace with: > sed -i 's/g_memdup\>/g_memdup2/g' `grep -rIl 'g_memdup\>' *` … followed by a few manual alignment tweaks when necessary. This gets rid of the many deprecation warnings which we had lately when building with a recent GLib version.
2021-08-26 23:18:32 +08:00
{ GimpObjectArray *a = g_value_get_boxed (gimp_value_array_index (return_vals, 2)); if (a) children = g_memdup2 (a->data, a->length * sizeof (gpointer)); };
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
}
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
libgimp: add API to access item groups A layer tree can be traversed completely now. Tree manipulating functions still missing.
2010-08-29 00:49:15 +08:00
pdb, libgimp: change all generated ID array return values to object arrays and remove the manual libgimp wrappers which now have the same signature as the generated functions.
2019-09-05 18:57:43 +08:00
return children;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
* gimp_item_get_expanded:
* @item: The item.
*
* Returns whether the item is expanded.
*
Issue #10673: make clearer API docs for _id*() functions. All the functions working with object's IDs are mostly internal. They are still made public because they can be useful and are relevant in specific use cases (i.e. using IDs to reference items in specific widgets, such as drop-down lists, or when temporarily storing an item as integer, etc.). Yet it should be made clear that these usages are the exception rather than the norm.
2024-08-26 20:52:08 +08:00
* This procedure returns %TRUE if the specified item is expanded.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Returns: TRUE if the item is expanded, FALSE otherwise.
*
* Since: 2.10
**/
gboolean
gimp_item_get_expanded (GimpItem *item)
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean expanded = FALSE;
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-expanded",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
expanded = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return expanded;
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_set_expanded:
* @item: The item.
* @expanded: TRUE to expand the item, FALSE to collapse the item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Sets the expanded state of the item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure expands or collapses the item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: TRUE on success.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.10
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_set_expanded (GimpItem *item,
gboolean expanded)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean success = TRUE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_ITEM, item,
G_TYPE_BOOLEAN, expanded,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-expanded",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return success;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_get_name:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Get the name of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure returns the specified item's name.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: (transfer full): The item name.
* The returned value must be freed with g_free().
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Since: 2.8
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
**/
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gchar *
gimp_item_get_name (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gchar *name = NULL;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-name",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
name = GIMP_VALUES_DUP_STRING (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return name;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_set_name:
* @item: The item.
* @name: The new item name.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Set the name of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure sets the specified item's name.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Returns: TRUE on success.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Since: 2.8
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_set_name (GimpItem *item,
const gchar *name)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean success = TRUE;
args = gimp_value_array_new_from_types (NULL,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_ITEM, item,
G_TYPE_STRING, name,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-name",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return success;
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_get_visible:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Get the visibility of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure returns the specified item's visibility.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: The item visibility.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean
gimp_item_get_visible (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean visible = FALSE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-visible",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
visible = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return visible;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_set_visible:
* @item: The item.
* @visible: The new item visibility.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Set the visibility of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure sets the specified item's visibility.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: TRUE on success.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean
gimp_item_set_visible (GimpItem *item,
gboolean visible)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean success = TRUE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_ITEM, item,
G_TYPE_BOOLEAN, visible,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-visible",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return success;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_get_lock_content:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Get the 'lock content' state of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure returns the specified item's lock content state.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: Whether the item's contents are locked.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_get_lock_content (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean lock_content = FALSE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-lock-content",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
lock_content = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return lock_content;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_set_lock_content:
* @item: The item.
* @lock_content: The new item 'lock content' state.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Set the 'lock content' state of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure sets the specified item's lock content state.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: TRUE on success.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_set_lock_content (GimpItem *item,
gboolean lock_content)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean success = TRUE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_ITEM, item,
G_TYPE_BOOLEAN, lock_content,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-lock-content",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return success;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_get_lock_position:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Get the 'lock position' state of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure returns the specified item's lock position state.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: Whether the item's position is locked.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Since: 2.10
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_get_lock_position (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean lock_position = FALSE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-lock-position",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
lock_position = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return lock_position;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_set_lock_position:
* @item: The item.
* @lock_position: The new item 'lock position' state.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Set the 'lock position' state of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure sets the specified item's lock position state.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Returns: TRUE on success.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Since: 2.10
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_set_lock_position (GimpItem *item,
gboolean lock_position)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean success = TRUE;
args = gimp_value_array_new_from_types (NULL,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_ITEM, item,
G_TYPE_BOOLEAN, lock_position,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-lock-position",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return success;
}
app, libgimp, pdb: add visibility lock API.
2021-04-23 23:01:19 +08:00
/**
* gimp_item_get_lock_visibility:
* @item: The item.
*
* Get the 'lock visibility' state of the specified item.
*
* This procedure returns the specified item's lock visibility state.
*
* Returns: Whether the item's visibility is locked.
*
* Since: 3.0
**/
gboolean
gimp_item_get_lock_visibility (GimpItem *item)
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean lock_visibility = FALSE;
args = gimp_value_array_new_from_types (NULL,
GIMP_TYPE_ITEM, item,
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-lock-visibility",
args);
app, libgimp, pdb: add visibility lock API.
2021-04-23 23:01:19 +08:00
gimp_value_array_unref (args);
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
lock_visibility = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
gimp_value_array_unref (return_vals);
return lock_visibility;
}
/**
* gimp_item_set_lock_visibility:
* @item: The item.
* @lock_visibility: The new item 'lock visibility' state.
*
* Set the 'lock visibility' state of the specified item.
*
* This procedure sets the specified item's lock visibility state.
*
* Returns: TRUE on success.
*
* Since: 3.0
**/
gboolean
gimp_item_set_lock_visibility (GimpItem *item,
gboolean lock_visibility)
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean success = TRUE;
args = gimp_value_array_new_from_types (NULL,
GIMP_TYPE_ITEM, item,
G_TYPE_BOOLEAN, lock_visibility,
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-lock-visibility",
args);
app, libgimp, pdb: add visibility lock API.
2021-04-23 23:01:19 +08:00
gimp_value_array_unref (args);
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
gimp_value_array_unref (return_vals);
return success;
}
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_get_color_tag:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Get the color tag of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure returns the specified item's color tag.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: The item's color tag.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Since: 2.10
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
**/
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GimpColorTag
gimp_item_get_color_tag (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GimpColorTag color_tag = 0;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-color-tag",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
color_tag = GIMP_VALUES_GET_ENUM (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return color_tag;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_set_color_tag:
* @item: The item.
* @color_tag: The new item color tag.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Set the color tag of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure sets the specified item's color tag.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: TRUE on success.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Since: 2.10
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_set_color_tag (GimpItem *item,
GimpColorTag color_tag)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean success = TRUE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_ITEM, item,
GIMP_TYPE_COLOR_TAG, color_tag,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-color-tag",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return success;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_get_tattoo:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Get the tattoo of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure returns the specified item's tattoo. A tattoo is a
* unique and permanent identifier attached to a item that can be used
* to uniquely identify a item within an image even between sessions.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: The item tattoo.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
guint
gimp_item_get_tattoo (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
guint tattoo = 0;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-tattoo",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
tattoo = GIMP_VALUES_GET_UINT (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
return tattoo;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_set_tattoo:
* @item: The item.
* @tattoo: The new item tattoo.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Set the tattoo of the specified item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure sets the specified item's tattoo. A tattoo is a
* unique and permanent identifier attached to a item that can be used
* to uniquely identify a item within an image even between sessions.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Returns: TRUE on success.
*
* Since: 2.8
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_set_tattoo (GimpItem *item,
guint tattoo)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
gboolean success = TRUE;
args = gimp_value_array_new_from_types (NULL,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_ITEM, item,
G_TYPE_UINT, tattoo,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-set-tattoo",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return success;
}
/**
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* gimp_item_attach_parasite:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* @parasite: The parasite to attach to the item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Add a parasite to an item.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* This procedure attaches a parasite to an item. It has no return
* values.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
* Returns: TRUE on success.
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
*
* Since: 2.8
**/
gboolean
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gimp_item_attach_parasite (GimpItem *item,
const GimpParasite *parasite)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
gboolean success = TRUE;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
pdb, libgimp: remove double API generation from PDB. All plug-ins got ported. Let's remove support for the old API with IDs instead of objects.
2019-09-03 19:31:27 +08:00
GIMP_TYPE_PARASITE, parasite,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-attach-parasite",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
return success;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
}
/**
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* gimp_item_detach_parasite:
* @item: The item.
* @name: The name of the parasite to detach from the item.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* Removes a parasite from an item.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* This procedure detaches a parasite from an item. It has no return
* values.
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
*
* Returns: TRUE on success.
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.8
pdb: generate nicer gtk-doc comments (no doc contents changed)
2010-09-16 04:07:36 +08:00
**/
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
gboolean
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_item_detach_parasite (GimpItem *item,
const gchar *name)
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
gboolean success = TRUE;
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_STRING, name,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-detach-parasite",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
pdb: add a new PDB group "item" and move lots of functions to it The item groups has all the duplicated functionality from drawable and vectors (name, visible, linked etc). Hijack the unused GIMP_PDB_REGION and turn it into GIMP_PDB_ITEM; change all protocol aware files accordingly and bump the protocol version number. Change script-fu to handle the new type.
2010-07-09 15:34:44 +08:00
return success;
}
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
/**
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* gimp_item_get_parasite:
* @item: The item.
* @name: The name of the parasite to find.
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
*
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* Look up a parasite in an item
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
*
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* Finds and returns the parasite that is attached to an item.
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
*
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* Returns: (transfer full): The found parasite.
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.8
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
**/
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
GimpParasite *
gimp_item_get_parasite (GimpItem *item,
const gchar *name)
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
{
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
GimpValueArray *args;
GimpValueArray *return_vals;
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
GimpParasite *parasite = NULL;
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp*, pdb: gimp_value_array_new_from_types*() takes (type, value) So a value array can now we created like this: array = gimp_value_array_new_from_types (&error_msg, G_TYPE_STRING, "foo", G_TYPE_INT, 23, G_TYPE_NONE); Change PDB generation to use this, which makes for much nicer code in the libgimp wrappers, and only set arrays separately instead of all values.
2019-08-08 19:01:50 +08:00
G_TYPE_STRING, name,
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-parasite",
args);
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (args);
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
pdb, libgimp: use GIMP_VALUES_GET,DUP_FOO() in the libgimp PDB wrappers
2019-09-04 08:49:33 +08:00
parasite = GIMP_VALUES_DUP_PARASITE (return_vals, 1);
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
pdb, libgimp: port lib.pl to the new GType based libgimp API All foo_pdb.c functions in libgimp regenerated. I have reviewed this a dozen times, but please have a look, there might well be glitches and our public API is sortof important...
2019-07-30 16:51:16 +08:00
gimp_value_array_unref (return_vals);
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
return parasite;
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
}
/**
libgimp: rename the newly added item parasite functions gimp-item-find-parasite -> gimp-item-get-parasite gimp-item-list-parasites -> gimp-item-get-parasite-list Also changed the signature of gimp-item-get-parasite-list's C wrapper in libgimp to be sane.
2011-03-02 05:19:48 +08:00
* gimp_item_get_parasite_list:
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
* @item: The item.
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
*
* List all parasites.
*
* Returns a list of all parasites currently attached the an item.
*
app, libgimp: pdbgen for previous commit.
2021-12-02 05:35:25 +08:00
* Returns: (array zero-terminated=1) (transfer full):
pdb: fix generation of "Returns:" to not line-wrap annotations Also generate comments like "Must be freed with g_free()" for all return values instead of manually and inconsistently having them on some return values only.
2019-08-05 04:09:04 +08:00
* The names of currently attached parasites.
* The returned value must be freed with g_strfreev().
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.8
libgimp: move the item parasite functions to the parasites files and rename them yet again to be gimp_item_foo_parasite() instead of gimp_item_parasite_foo() because the latter is just a misnaming (they are not GimpItemParasites, they are GimpParasites attached to GimpItems, just as layers are attached to images).
2011-02-14 00:28:30 +08:00
**/
libgimp: rename the newly added item parasite functions gimp-item-find-parasite -> gimp-item-get-parasite gimp-item-list-parasites -> gimp-item-get-parasite-list Also changed the signature of gimp-item-get-parasite-list's C wrapper in libgimp to be sane.
2011-03-02 05:19:48 +08:00
gchar **
app, libgimp: pdbgen for previous commit.
2021-12-02 05:35:25 +08:00
gimp_item_get_parasite_list (GimpItem *item)
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
{
GimpValueArray *args;
GimpValueArray *return_vals;
gchar **parasites = NULL;
args = gimp_value_array_new_from_types (NULL,
app, libgimp: get rid of all ID GTypes and ID param specs Turn all ID param specs into object param specs (e.g. GimpParamImageID becomes GimpParamImage) and convert between IDs and objects in gimpgpparams.c directly above the the wire protocol, so all of app/, libgimp/ and plug-ins/ can deal directly with objects down to the lowest level and not care about IDs. Use the actual object param specs for procedure arguments and return values again instead of a plain g_param_spec_object() and bring back the none_ok parameter. This implies changing the PDB type checking functions to work on pure integers instead of IDs (one can't check whether object creation is possible if performing that check requires the object to already exist). For example gimp_foo_is_valid() becomes gimp_foo_id_is_valid() and is not involved in automatic object creation magic at the protocol level. Added wrappers which still say gimp_foo_is_valid() and take the respective objects. Adapted all code, and it all becomes nicer and less convoluted, even the generated PDB wrappers in app/ and libgimp/.
2019-08-29 17:25:35 +08:00
GIMP_TYPE_ITEM, item,
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
G_TYPE_NONE);
libgimp, pdb: make gimp_pdb_run_procedure_array() internal. Apart from all regenerated PDB files, this commit fixes the few manual usages in libgimp too.
2023-10-17 04:07:55 +08:00
return_vals = _gimp_pdb_run_procedure_array (gimp_get_pdb (),
"gimp-item-get-parasite-list",
args);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (args);
pdb, libgimp: use GIMP_VALLUES_GET_ENUM() in libgimp PDB wrappers to get the procedure's return status.
2019-09-04 07:49:35 +08:00
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
app, libgimp: pdbgen for previous commit.
2021-12-02 05:35:25 +08:00
parasites = GIMP_VALUES_DUP_STRV (return_vals, 1);
libgimp, pdb: add GimpItem > GimpDrawable > GimpLayer classes. Only class and subclasses creation and PDB generation for this first step. I'll later do other types of items.
2019-08-13 19:59:33 +08:00
gimp_value_array_unref (return_vals);
return parasites;
}