Issue #15681: deprecate gimp_drawable_curves_explicit() and…

… gimp_drawable_curves_spline().

We can now run directly "gimp:curves" operation, both destructively or
non-destructively, but also setting the TRC, as well as individual point
types (when the curve is of type "smooth" instead of freehand).
This is much more powerful!
This commit is contained in:
Jehan 2026-03-01 21:48:13 +01:00
parent b87bab9e8c
commit 51ac9d7f2a
4 changed files with 22 additions and 2 deletions

View file

@ -987,12 +987,16 @@ register_drawable_color_procs (GimpPDB *pdb)
"gimp-drawable-curves-explicit");
gimp_procedure_set_static_help (procedure,
"Modifies the intensity curve(s) for specified drawable.",
"Modifies the intensity mapping for one channel in the specified drawable. The channel can be either an intensity component, or the value. The 'values' parameter is an array of doubles which explicitly defines how each pixel value in the drawable will be modified. Use the 'gimp-drawable-curves-spline' function to modify intensity levels with Catmull Rom splines.",
"Modifies the intensity mapping for one channel in the specified drawable. The channel can be either an intensity component, or the value. The 'values' parameter is an array of doubles which explicitly defines how each pixel value in the drawable will be modified. Use the 'gimp-drawable-curves-spline' function to modify intensity levels with Catmull Rom splines.\n"
"\n"
"Deprecated: Use filter \"gimp:curves\" instead.",
NULL);
gimp_procedure_set_static_attribution (procedure,
"Spencer Kimball & Peter Mattis",
"Spencer Kimball & Peter Mattis",
"1995-1996");
gimp_procedure_set_deprecated (procedure,
"gimp:curves");
gimp_procedure_add_argument (procedure,
gimp_param_spec_drawable ("drawable",
"drawable",
@ -1026,12 +1030,16 @@ register_drawable_color_procs (GimpPDB *pdb)
"\n"
"The @points parameter is an array of doubles in the range `[0, 1]` which define a set of control points which describe a Catmull Rom spline which yields the final intensity curve. Since every point has 2 coordinates, the size of @points (@num_coordinates) must be a multiple of 2, equal or bigger than 4 (i.e. a minimum of 2 points).\n"
"\n"
"Use [method@Gimp.Drawable.curves_explicit] to explicitly modify intensity levels.",
"Use [method@Gimp.Drawable.curves_explicit] to explicitly modify intensity levels.\n"
"\n"
"Deprecated: Use filter \"gimp:curves\" instead.",
NULL);
gimp_procedure_set_static_attribution (procedure,
"Spencer Kimball & Peter Mattis",
"Spencer Kimball & Peter Mattis",
"1995-1996");
gimp_procedure_set_deprecated (procedure,
"gimp:curves");
gimp_procedure_add_argument (procedure,
gimp_param_spec_drawable ("drawable",
"drawable",

View file

@ -206,6 +206,8 @@ gimp_drawable_colorize_hsl (GimpDrawable *drawable,
* modified. Use the gimp_drawable_curves_spline() function to modify
* intensity levels with Catmull Rom splines.
*
* Deprecated: 3.2: Use filter "gimp:curves" instead.
*
* Returns: TRUE on success.
*
* Since: 2.10
@ -264,6 +266,8 @@ gimp_drawable_curves_explicit (GimpDrawable *drawable,
* Use [method@Gimp.Drawable.curves_explicit] to explicitly modify
* intensity levels.
*
* Deprecated: 3.2: Use filter "gimp:curves" instead.
*
* Returns: TRUE on success.
*
* Since: 2.10

View file

@ -48,10 +48,12 @@ gboolean gimp_drawable_colorize_hsl (GimpDrawable *drawable,
gdouble hue,
gdouble saturation,
gdouble lightness);
GIMP_DEPRECATED_FOR(gimp:curves)
gboolean gimp_drawable_curves_explicit (GimpDrawable *drawable,
GimpHistogramChannel channel,
gsize num_values,
const gdouble *values);
GIMP_DEPRECATED_FOR(gimp:curves)
gboolean gimp_drawable_curves_spline (GimpDrawable *drawable,
GimpHistogramChannel channel,
gsize num_coordinates,

View file

@ -201,6 +201,9 @@ HELP
&std_pdb_misc;
$since = '2.10';
$deprecated = 'gimp:curves';
$deprecated_since = '3.2';
@inargs = (
{ name => 'drawable', type => 'drawable',
desc => 'The drawable' },
@ -266,6 +269,9 @@ HELP
&std_pdb_misc;
$since = '2.10';
$deprecated = 'gimp:curves';
$deprecated_since = '3.2';
@inargs = (
{ name => 'drawable', type => 'drawable',
desc => 'The drawable' },