diff options
Diffstat (limited to 'libgimp/gimpdrawablecolor_pdb.c')
| -rw-r--r-- | libgimp/gimpdrawablecolor_pdb.c | 686 |
1 files changed, 686 insertions, 0 deletions
diff --git a/libgimp/gimpdrawablecolor_pdb.c b/libgimp/gimpdrawablecolor_pdb.c new file mode 100644 index 0000000..dcc12e3 --- /dev/null +++ b/libgimp/gimpdrawablecolor_pdb.c @@ -0,0 +1,686 @@ +/* LIBGIMP - The GIMP Library + * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball + * + * gimpdrawablecolor_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 + * <https://www.gnu.org/licenses/>. + */ + +/* NOTE: This file is auto-generated by pdbgen.pl */ + +#include "config.h" + +#include "gimp.h" + + +/** + * SECTION: gimpdrawablecolor + * @title: gimpdrawablecolor + * @short_description: Functions for manipulating a drawable's color. + * + * Functions for manipulating a drawable's color, including curves and + * histograms. + **/ + + +/** + * gimp_drawable_brightness_contrast: + * @drawable_ID: The drawable. + * @brightness: Brightness adjustment. + * @contrast: Contrast adjustment. + * + * Modify brightness/contrast in the specified drawable. + * + * This procedures allows the brightness and contrast of the specified + * drawable to be modified. Both 'brightness' and 'contrast' parameters + * are defined between -0.5 and 0.5. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_brightness_contrast (gint32 drawable_ID, + gdouble brightness, + gdouble contrast) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-brightness-contrast", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, brightness, + GIMP_PDB_FLOAT, contrast, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_color_balance: + * @drawable_ID: The drawable. + * @transfer_mode: Transfer mode. + * @preserve_lum: Preserve luminosity values at each pixel. + * @cyan_red: Cyan-Red color balance. + * @magenta_green: Magenta-Green color balance. + * @yellow_blue: Yellow-Blue color balance. + * + * Modify the color balance of the specified drawable. + * + * Modify the color balance of the specified drawable. There are three + * axis which can be modified: cyan-red, magenta-green, and + * yellow-blue. Negative values increase the amount of the former, + * positive values increase the amount of the latter. Color balance can + * be controlled with the 'transfer_mode' setting, which allows + * shadows, mid-tones, and highlights in an image to be affected + * differently. The 'preserve-lum' parameter, if TRUE, ensures that the + * luminosity of each pixel remains fixed. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_color_balance (gint32 drawable_ID, + GimpTransferMode transfer_mode, + gboolean preserve_lum, + gdouble cyan_red, + gdouble magenta_green, + gdouble yellow_blue) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-color-balance", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, transfer_mode, + GIMP_PDB_INT32, preserve_lum, + GIMP_PDB_FLOAT, cyan_red, + GIMP_PDB_FLOAT, magenta_green, + GIMP_PDB_FLOAT, yellow_blue, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_colorize_hsl: + * @drawable_ID: The drawable. + * @hue: Hue in degrees. + * @saturation: Saturation in percent. + * @lightness: Lightness in percent. + * + * Render the drawable as a grayscale image seen through a colored + * glass. + * + * Desaturates the drawable, then tints it with the specified color. + * This tool is only valid on RGB color images. It will not operate on + * grayscale drawables. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_colorize_hsl (gint32 drawable_ID, + gdouble hue, + gdouble saturation, + gdouble lightness) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-colorize-hsl", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, hue, + GIMP_PDB_FLOAT, saturation, + GIMP_PDB_FLOAT, lightness, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_curves_explicit: + * @drawable_ID: The drawable. + * @channel: The channel to modify. + * @num_values: The number of values in the new curve. + * @values: The explicit curve. + * + * 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_curves_spline() function to modify intensity + * levels with Catmull Rom splines. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_curves_explicit (gint32 drawable_ID, + GimpHistogramChannel channel, + gint num_values, + const gdouble *values) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-curves-explicit", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, channel, + GIMP_PDB_INT32, num_values, + GIMP_PDB_FLOATARRAY, values, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_curves_spline: + * @drawable_ID: The drawable. + * @channel: The channel to modify. + * @num_points: The number of values in the control point array. + * @points: The spline control points: { cp1.x, cp1.y, cp2.x, cp2.y, ... }. + * + * 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 'points' parameter is an array of doubles which define a + * set of control points which describe a Catmull Rom spline which + * yields the final intensity curve. Use the gimp_curves_explicit() + * function to explicitly modify intensity levels. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_curves_spline (gint32 drawable_ID, + GimpHistogramChannel channel, + gint num_points, + const gdouble *points) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-curves-spline", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, channel, + GIMP_PDB_INT32, num_points, + GIMP_PDB_FLOATARRAY, points, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_desaturate: + * @drawable_ID: The drawable. + * @desaturate_mode: The formula to use to desaturate. + * + * Desaturate the contents of the specified drawable, with the + * specified formula. + * + * This procedure desaturates the contents of the specified drawable, + * with the specified formula. This procedure only works on drawables + * of type RGB color. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_desaturate (gint32 drawable_ID, + GimpDesaturateMode desaturate_mode) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-desaturate", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, desaturate_mode, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_equalize: + * @drawable_ID: The drawable. + * @mask_only: Equalization option. + * + * Equalize the contents of the specified drawable. + * + * This procedure equalizes the contents of the specified drawable. + * Each intensity channel is equalized independently. The equalized + * intensity is given as inten' = (255 - inten). The 'mask_only' option + * specifies whether to adjust only the area of the image within the + * selection bounds, or the entire image based on the histogram of the + * selected area. If there is no selection, the entire image is + * adjusted based on the histogram for the entire image. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_equalize (gint32 drawable_ID, + gboolean mask_only) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-equalize", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, mask_only, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_histogram: + * @drawable_ID: The drawable. + * @channel: The channel to query. + * @start_range: Start of the intensity measurement range. + * @end_range: End of the intensity measurement range. + * @mean: Mean intensity value. + * @std_dev: Standard deviation of intensity values. + * @median: Median intensity value. + * @pixels: Alpha-weighted pixel count for entire image. + * @count: Alpha-weighted pixel count for range. + * @percentile: Percentile that range falls under. + * + * Returns information on the intensity histogram for the specified + * drawable. + * + * This tool makes it possible to gather information about the + * intensity histogram of a drawable. A channel to examine is first + * specified. This can be either value, red, green, or blue, depending + * on whether the drawable is of type color or grayscale. Second, a + * range of intensities are specified. The gimp_drawable_histogram() + * function returns statistics based on the pixels in the drawable that + * fall under this range of values. Mean, standard deviation, median, + * number of pixels, and percentile are all returned. Additionally, the + * total count of pixels in the image is returned. Counts of pixels are + * weighted by any associated alpha values and by the current selection + * mask. That is, pixels that lie outside an active selection mask will + * not be counted. Similarly, pixels with transparent alpha values will + * not be counted. The returned mean, std_dev and median are in the + * range (0..255) for 8-bit images or if the plug-in is not + * precision-aware, and in the range (0.0..1.0) otherwise. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_histogram (gint32 drawable_ID, + GimpHistogramChannel channel, + gdouble start_range, + gdouble end_range, + gdouble *mean, + gdouble *std_dev, + gdouble *median, + gdouble *pixels, + gdouble *count, + gdouble *percentile) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-histogram", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, channel, + GIMP_PDB_FLOAT, start_range, + GIMP_PDB_FLOAT, end_range, + GIMP_PDB_END); + + *mean = 0.0; + *std_dev = 0.0; + *median = 0.0; + *pixels = 0.0; + *count = 0.0; + *percentile = 0.0; + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + { + *mean = return_vals[1].data.d_float; + *std_dev = return_vals[2].data.d_float; + *median = return_vals[3].data.d_float; + *pixels = return_vals[4].data.d_float; + *count = return_vals[5].data.d_float; + *percentile = return_vals[6].data.d_float; + } + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_hue_saturation: + * @drawable_ID: The drawable. + * @hue_range: Range of affected hues. + * @hue_offset: Hue offset in degrees. + * @lightness: Lightness modification. + * @saturation: Saturation modification. + * @overlap: Overlap other hue channels. + * + * Modify hue, lightness, and saturation in the specified drawable. + * + * This procedure allows the hue, lightness, and saturation in the + * specified drawable to be modified. The 'hue-range' parameter + * provides the capability to limit range of affected hues. The + * 'overlap' parameter provides blending into neighboring hue channels + * when rendering. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_hue_saturation (gint32 drawable_ID, + GimpHueRange hue_range, + gdouble hue_offset, + gdouble lightness, + gdouble saturation, + gdouble overlap) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-hue-saturation", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, hue_range, + GIMP_PDB_FLOAT, hue_offset, + GIMP_PDB_FLOAT, lightness, + GIMP_PDB_FLOAT, saturation, + GIMP_PDB_FLOAT, overlap, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_invert: + * @drawable_ID: The drawable. + * @linear: Whether to invert in linear space. + * + * Invert the contents of the specified drawable. + * + * This procedure inverts the contents of the specified drawable. Each + * intensity channel is inverted independently. The inverted intensity + * is given as inten' = (255 - inten). If 'linear' is TRUE, the + * drawable is inverted in linear space. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_invert (gint32 drawable_ID, + gboolean linear) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-invert", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, linear, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_levels: + * @drawable_ID: The drawable. + * @channel: The channel to modify. + * @low_input: Intensity of lowest input. + * @high_input: Intensity of highest input. + * @clamp_input: Clamp input values before applying output levels. + * @gamma: Gamma adjustment factor. + * @low_output: Intensity of lowest output. + * @high_output: Intensity of highest output. + * @clamp_output: Clamp final output values. + * + * Modifies intensity levels in the specified drawable. + * + * This tool allows intensity levels in the specified drawable to be + * remapped according to a set of parameters. The low/high input levels + * specify an initial mapping from the source intensities. The gamma + * value determines how intensities between the low and high input + * intensities are interpolated. A gamma value of 1.0 results in a + * linear interpolation. Higher gamma values result in more high-level + * intensities. Lower gamma values result in more low-level + * intensities. The low/high output levels constrain the final + * intensity mapping--that is, no final intensity will be lower than + * the low output level and no final intensity will be higher than the + * high output level. This tool is only valid on RGB color and + * grayscale images. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_levels (gint32 drawable_ID, + GimpHistogramChannel channel, + gdouble low_input, + gdouble high_input, + gboolean clamp_input, + gdouble gamma, + gdouble low_output, + gdouble high_output, + gboolean clamp_output) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-levels", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, channel, + GIMP_PDB_FLOAT, low_input, + GIMP_PDB_FLOAT, high_input, + GIMP_PDB_INT32, clamp_input, + GIMP_PDB_FLOAT, gamma, + GIMP_PDB_FLOAT, low_output, + GIMP_PDB_FLOAT, high_output, + GIMP_PDB_INT32, clamp_output, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_levels_stretch: + * @drawable_ID: The drawable. + * + * Automatically modifies intensity levels in the specified drawable. + * + * This procedure allows intensity levels in the specified drawable to + * be remapped according to a set of guessed parameters. It is + * equivalent to clicking the \"Auto\" button in the Levels tool. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_levels_stretch (gint32 drawable_ID) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-levels-stretch", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_posterize: + * @drawable_ID: The drawable. + * @levels: Levels of posterization. + * + * Posterize the specified drawable. + * + * This procedures reduces the number of shades allows in each + * intensity channel to the specified 'levels' parameter. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_posterize (gint32 drawable_ID, + gint levels) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-posterize", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, levels, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_drawable_threshold: + * @drawable_ID: The drawable. + * @channel: The channel to base the threshold on. + * @low_threshold: The low threshold value. + * @high_threshold: The high threshold value. + * + * Threshold the specified drawable. + * + * This procedures generates a threshold map of the specified drawable. + * All pixels between the values of 'low_threshold' and + * 'high_threshold', on the scale of 'channel' are replaced with white, + * and all other pixels with black. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_drawable_threshold (gint32 drawable_ID, + GimpHistogramChannel channel, + gdouble low_threshold, + gdouble high_threshold) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-drawable-threshold", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, channel, + GIMP_PDB_FLOAT, low_threshold, + GIMP_PDB_FLOAT, high_threshold, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} |