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

73 lines
1.8 KiB
C
Raw Normal View History

pdb, libgimp: now make all ID types classes of their own. No need of is_id_arg() anymore in pdb/lib.pl. Let's reuse the {id} value. Also I had to add an additional trick for GimpDisplay which we will now generate as such in libgimp PDB files, but still need to show as GimpObject on app/pdb/. As previously, only the new classes and the PDB generation for a first step.
2019-08-14 03:36:03 +08:00
/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
*
* gimplayermask.c
* Copyright (C) Jehan
*
* 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see
* <https://www.gnu.org/licenses/>.
*/
#include "config.h"
#include "gimp.h"
libgimp: use G_DECLARE_DERIVABLE_TYPE and G_DECLARE_FINAL_TYPE for… … the public API. This was initially proposed by Niels De Graef in !101, and though I still think this is much less practical for day-to-day development, it is actually much nicer for the public part of the API. So let's use these only in public libgimp* API only, not in core. I actually already started to use these for some of the libgimpwidgets classes and am now moving libgimp main classes to these macros. * It doesn't expose the priv member (which is completely useless for plug-in developers, only to be used for core development). * It forces us to never have any variable members in the public API (which we were doing fine so far in newest API, but it's nice to be enforced with these macros). * When using G_DECLARE_FINAL_TYPE in particular, it adds flexibility as we can change the structure size and the members order as these are not exposed. And if some day, we make the class derivable with some signals to handle, only then will we expose the class with some _gimp_reserved* padding (instead of from the start when none is needed). Therefore we will allow for further extension far in the future. Moreover most of these libgimp classes were so far not using any private values, so we were declaring a `priv` member with a bogus contents just "in case we needed it in future" (as we couldn't change the struct size). So even the easiness of having a priv member was very relative for this public API so far (unlike in core code where we actually have much more complex interactions and using priv data all the time).
2021-04-06 18:39:52 +08:00
struct _GimpLayerMask
libgimp: add instance-private struct to all new objects Just in case we need it later.
2019-08-27 22:47:17 +08:00
{
libgimp: use G_DECLARE_DERIVABLE_TYPE and G_DECLARE_FINAL_TYPE for… … the public API. This was initially proposed by Niels De Graef in !101, and though I still think this is much less practical for day-to-day development, it is actually much nicer for the public part of the API. So let's use these only in public libgimp* API only, not in core. I actually already started to use these for some of the libgimpwidgets classes and am now moving libgimp main classes to these macros. * It doesn't expose the priv member (which is completely useless for plug-in developers, only to be used for core development). * It forces us to never have any variable members in the public API (which we were doing fine so far in newest API, but it's nice to be enforced with these macros). * When using G_DECLARE_FINAL_TYPE in particular, it adds flexibility as we can change the structure size and the members order as these are not exposed. And if some day, we make the class derivable with some signals to handle, only then will we expose the class with some _gimp_reserved* padding (instead of from the start when none is needed). Therefore we will allow for further extension far in the future. Moreover most of these libgimp classes were so far not using any private values, so we were declaring a `priv` member with a bogus contents just "in case we needed it in future" (as we couldn't change the struct size). So even the easiness of having a priv member was very relative for this public API so far (unlike in core code where we actually have much more complex interactions and using priv data all the time).
2021-04-06 18:39:52 +08:00
GimpChannel parent_instance;
libgimp: add instance-private struct to all new objects Just in case we need it later.
2019-08-27 22:47:17 +08:00
};
libgimp: use G_DECLARE_DERIVABLE_TYPE and G_DECLARE_FINAL_TYPE for… … the public API. This was initially proposed by Niels De Graef in !101, and though I still think this is much less practical for day-to-day development, it is actually much nicer for the public part of the API. So let's use these only in public libgimp* API only, not in core. I actually already started to use these for some of the libgimpwidgets classes and am now moving libgimp main classes to these macros. * It doesn't expose the priv member (which is completely useless for plug-in developers, only to be used for core development). * It forces us to never have any variable members in the public API (which we were doing fine so far in newest API, but it's nice to be enforced with these macros). * When using G_DECLARE_FINAL_TYPE in particular, it adds flexibility as we can change the structure size and the members order as these are not exposed. And if some day, we make the class derivable with some signals to handle, only then will we expose the class with some _gimp_reserved* padding (instead of from the start when none is needed). Therefore we will allow for further extension far in the future. Moreover most of these libgimp classes were so far not using any private values, so we were declaring a `priv` member with a bogus contents just "in case we needed it in future" (as we couldn't change the struct size). So even the easiness of having a priv member was very relative for this public API so far (unlike in core code where we actually have much more complex interactions and using priv data all the time).
2021-04-06 18:39:52 +08:00
G_DEFINE_TYPE (GimpLayerMask, gimp_layer_mask, GIMP_TYPE_CHANNEL)
pdb, libgimp: now make all ID types classes of their own. No need of is_id_arg() anymore in pdb/lib.pl. Let's reuse the {id} value. Also I had to add an additional trick for GimpDisplay which we will now generate as such in libgimp PDB files, but still need to show as GimpObject on app/pdb/. As previously, only the new classes and the PDB generation for a first step.
2019-08-14 03:36:03 +08:00
#define parent_class gimp_layer_mask_parent_class
libgimp: add instance-private struct to all new objects Just in case we need it later.
2019-08-27 22:47:17 +08:00
pdb, libgimp: now make all ID types classes of their own. No need of is_id_arg() anymore in pdb/lib.pl. Let's reuse the {id} value. Also I had to add an additional trick for GimpDisplay which we will now generate as such in libgimp PDB files, but still need to show as GimpObject on app/pdb/. As previously, only the new classes and the PDB generation for a first step.
2019-08-14 03:36:03 +08:00
static void
gimp_layer_mask_class_init (GimpLayerMaskClass *klass)
{
}
static void
gimp_layer_mask_init (GimpLayerMask *layer_mask)
{
}
libgimp: add gimp_layer,chanel,vectors,etc,_get_by_id() which call gimp_item_get_by_id() and additionally check if the returned item has the right type, and return NULL if not. This is both shorter and more readable than layer = GIMP_LAYER (gimp_item_get_by_id (id)); and additionally makes sure we don't cast e.g. a non-layer with GIMP_LAYER(), which will give criticals but shouldn't, because the wrong IDs can come from anywhere and are an input problem and not a programming error (criticals are for programming errors).
2019-09-03 16:24:24 +08:00
/**
* gimp_layer_mask_get_by_id:
* @layer_mask_id: The layer_mask id.
*
* Returns a #GimpLayerMask representing @layer_mask_id. This function
* calls gimp_item_get_by_id() and returns the item if it is
* layer_mask or %NULL otherwise.
*
* Returns: (nullable) (transfer none): a #GimpLayerMask for
* @layer_mask_id or %NULL if @layer_mask_id does not
* represent a valid layer_mask. The object belongs to
* libgimp and you must not modify or unref it.
*
* Since: 3.0
**/
GimpLayerMask *
gimp_layer_mask_get_by_id (gint32 layer_mask_id)
{
GimpItem *item = gimp_item_get_by_id (layer_mask_id);
if (GIMP_IS_LAYER_MASK (item))
return (GimpLayerMask *) item;
return NULL;
}