From 5c1676dfe6d2f3c837a5e074117b45613fd29a72 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 20:30:19 +0200 Subject: Adding upstream version 2.10.34. Signed-off-by: Daniel Baumann --- libgimp/gimpcontext_pdb.c | 3812 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 3812 insertions(+) create mode 100644 libgimp/gimpcontext_pdb.c (limited to 'libgimp/gimpcontext_pdb.c') diff --git a/libgimp/gimpcontext_pdb.c b/libgimp/gimpcontext_pdb.c new file mode 100644 index 0000000..92f71e2 --- /dev/null +++ b/libgimp/gimpcontext_pdb.c @@ -0,0 +1,3812 @@ +/* LIBGIMP - The GIMP Library + * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball + * + * gimpcontext_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 + * . + */ + +/* NOTE: This file is auto-generated by pdbgen.pl */ + +#include "config.h" + +#include + +#include "gimp.h" + + +/** + * SECTION: gimpcontext + * @title: gimpcontext + * @short_description: Functions to manipulate a plug-in's context. + * + * Functions to manipulate a plug-in's context. + **/ + + +/** + * gimp_context_push: + * + * Pushes a context to the top of the plug-in's context stack. + * + * This procedure creates a new context by copying the current context. + * This copy becomes the new current context for the calling plug-in + * until it is popped again using gimp_context_pop(). + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_push (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-push", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_pop: + * + * Pops the topmost context from the plug-in's context stack. + * + * This procedure removes the topmost context from the plug-in's + * context stack. The context that was active before the corresponding + * call to gimp_context_push() becomes the new current context of the + * plug-in. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_pop (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-pop", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_defaults: + * + * Reset context settings to their default values. + * + * This procedure resets context settings used by various procedures to + * their default value. This procedure will usually be called after a + * context push so that a script which calls procedures affected by + * context settings will not be affected by changes in the global + * context. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_defaults (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-defaults", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_list_paint_methods: + * @num_paint_methods: The number of the available paint methods. + * @paint_methods: The names of the available paint methods. + * + * Lists the available paint methods. + * + * This procedure lists the names of the available paint methods. Any + * of the results can be used for gimp_context_set_paint_method(). + * + * Returns: TRUE on success. + * + * Since: 2.4 + **/ +gboolean +gimp_context_list_paint_methods (gint *num_paint_methods, + gchar ***paint_methods) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + gint i; + + return_vals = gimp_run_procedure ("gimp-context-list-paint-methods", + &nreturn_vals, + GIMP_PDB_END); + + *num_paint_methods = 0; + *paint_methods = NULL; + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + { + *num_paint_methods = return_vals[1].data.d_int32; + if (*num_paint_methods > 0) + { + *paint_methods = g_new0 (gchar *, *num_paint_methods + 1); + for (i = 0; i < *num_paint_methods; i++) + (*paint_methods)[i] = g_strdup (return_vals[2].data.d_stringarray[i]); + } + } + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_paint_method: + * + * Retrieve the currently active paint method. + * + * This procedure returns the name of the currently active paint + * method. + * + * Returns: The name of the active paint method. + * + * Since: 2.4 + **/ +gchar * +gimp_context_get_paint_method (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-paint-method", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_paint_method: + * @name: The name of the paint method. + * + * Set the specified paint method as the active paint method. + * + * This procedure allows the active paint method to be set by + * specifying its name. The name is simply a string which corresponds + * to one of the names of the available paint methods. If there is no + * matching method found, this procedure will return an error. + * Otherwise, the specified method becomes active and will be used in + * all subsequent paint operations. + * + * Returns: TRUE on success. + * + * Since: 2.4 + **/ +gboolean +gimp_context_set_paint_method (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-paint-method", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_stroke_method: + * + * Retrieve the currently active stroke method. + * + * This procedure returns the currently active stroke method. + * + * Returns: The active stroke method. + * + * Since: 2.10 + **/ +GimpStrokeMethod +gimp_context_get_stroke_method (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpStrokeMethod stroke_method = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-stroke-method", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + stroke_method = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return stroke_method; +} + +/** + * gimp_context_set_stroke_method: + * @stroke_method: The new stroke method. + * + * Set the specified stroke method as the active stroke method. + * + * This procedure set the specified stroke method as the active stroke + * method. The new method will be used in all subsequent stroke + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_stroke_method (GimpStrokeMethod stroke_method) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-stroke-method", + &nreturn_vals, + GIMP_PDB_INT32, stroke_method, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_foreground: + * @foreground: The foreground color. + * + * Get the current GIMP foreground color. + * + * This procedure returns the current GIMP foreground color. The + * foreground color is used in a variety of tools such as paint tools, + * blending, and bucket fill. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_get_foreground (GimpRGB *foreground) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-get-foreground", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + *foreground = return_vals[1].data.d_color; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_foreground: + * @foreground: The foreground color. + * + * Set the current GIMP foreground color. + * + * This procedure sets the current GIMP foreground color. After this is + * set, operations which use foreground such as paint tools, blending, + * and bucket fill will use the new value. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_foreground (const GimpRGB *foreground) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-foreground", + &nreturn_vals, + GIMP_PDB_COLOR, foreground, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_background: + * @background: The background color. + * + * Get the current GIMP background color. + * + * This procedure returns the current GIMP background color. The + * background color is used in a variety of tools such as blending, + * erasing (with non-alpha images), and image filling. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_get_background (GimpRGB *background) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-get-background", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + *background = return_vals[1].data.d_color; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_background: + * @background: The background color. + * + * Set the current GIMP background color. + * + * This procedure sets the current GIMP background color. After this is + * set, operations which use background such as blending, filling + * images, clearing, and erasing (in non-alpha images) will use the new + * value. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_background (const GimpRGB *background) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-background", + &nreturn_vals, + GIMP_PDB_COLOR, background, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_default_colors: + * + * Set the current GIMP foreground and background colors to black and + * white. + * + * This procedure sets the current GIMP foreground and background + * colors to their initial default values, black and white. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_default_colors (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-default-colors", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_swap_colors: + * + * Swap the current GIMP foreground and background colors. + * + * This procedure swaps the current GIMP foreground and background + * colors, so that the new foreground color becomes the old background + * color and vice versa. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_swap_colors (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-swap-colors", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_opacity: + * + * Get the opacity. + * + * This procedure returns the opacity setting. The return value is a + * floating point number between 0 and 100. + * + * Returns: The opacity. + * + * Since: 2.2 + **/ +gdouble +gimp_context_get_opacity (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble opacity = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-opacity", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + opacity = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return opacity; +} + +/** + * gimp_context_set_opacity: + * @opacity: The opacity. + * + * Set the opacity. + * + * This procedure modifies the opacity setting. The value should be a + * floating point number between 0 and 100. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_opacity (gdouble opacity) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-opacity", + &nreturn_vals, + GIMP_PDB_FLOAT, opacity, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_paint_mode: + * + * Get the paint mode. + * + * This procedure returns the paint-mode setting. The return value is + * an integer which corresponds to the values listed in the argument + * description. + * + * Returns: The paint mode. + * + * Since: 2.2 + **/ +GimpLayerMode +gimp_context_get_paint_mode (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpLayerMode paint_mode = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-paint-mode", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + paint_mode = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return paint_mode; +} + +/** + * gimp_context_set_paint_mode: + * @paint_mode: The paint mode. + * + * Set the paint mode. + * + * This procedure modifies the paint_mode setting. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_paint_mode (GimpLayerMode paint_mode) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-paint-mode", + &nreturn_vals, + GIMP_PDB_INT32, paint_mode, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_line_width: + * + * Get the line width setting. + * + * This procedure returns the line width setting. + * + * Returns: The line width setting. + * + * Since: 2.10 + **/ +gdouble +gimp_context_get_line_width (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble line_width = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-line-width", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + line_width = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return line_width; +} + +/** + * gimp_context_set_line_width: + * @line_width: The line width setting. + * + * Set the line width setting. + * + * This procedure modifies the line width setting for stroking lines. + * + * This setting affects the following procedures: + * gimp_drawable_edit_stroke_selection(), + * gimp_drawable_edit_stroke_item(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_line_width (gdouble line_width) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-line-width", + &nreturn_vals, + GIMP_PDB_FLOAT, line_width, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_line_width_unit: + * + * Get the line width unit setting. + * + * This procedure returns the line width unit setting. + * + * Returns: The line width unit setting. + * + * Since: 2.10 + **/ +GimpUnit +gimp_context_get_line_width_unit (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpUnit line_width_unit = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-line-width-unit", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + line_width_unit = return_vals[1].data.d_unit; + + gimp_destroy_params (return_vals, nreturn_vals); + + return line_width_unit; +} + +/** + * gimp_context_set_line_width_unit: + * @line_width_unit: The line width setting unit. + * + * Set the line width unit setting. + * + * This procedure modifies the line width unit setting for stroking + * lines. + * + * This setting affects the following procedures: + * gimp_drawable_edit_stroke_selection(), + * gimp_drawable_edit_stroke_item(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_line_width_unit (GimpUnit line_width_unit) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-line-width-unit", + &nreturn_vals, + GIMP_PDB_INT32, line_width_unit, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_line_cap_style: + * + * Get the line cap style setting. + * + * This procedure returns the line cap style setting. + * + * Returns: The line cap style setting. + * + * Since: 2.10 + **/ +GimpCapStyle +gimp_context_get_line_cap_style (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpCapStyle cap_style = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-line-cap-style", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + cap_style = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return cap_style; +} + +/** + * gimp_context_set_line_cap_style: + * @cap_style: The line cap style setting. + * + * Set the line cap style setting. + * + * This procedure modifies the line cap style setting for stroking + * lines. + * + * This setting affects the following procedures: + * gimp_drawable_edit_stroke_selection(), + * gimp_drawable_edit_stroke_item(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_line_cap_style (GimpCapStyle cap_style) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-line-cap-style", + &nreturn_vals, + GIMP_PDB_INT32, cap_style, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_line_join_style: + * + * Get the line join style setting. + * + * This procedure returns the line join style setting. + * + * Returns: The line join style setting. + * + * Since: 2.10 + **/ +GimpJoinStyle +gimp_context_get_line_join_style (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpJoinStyle join_style = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-line-join-style", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + join_style = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return join_style; +} + +/** + * gimp_context_set_line_join_style: + * @join_style: The line join style setting. + * + * Set the line join style setting. + * + * This procedure modifies the line join style setting for stroking + * lines. + * + * This setting affects the following procedures: + * gimp_drawable_edit_stroke_selection(), + * gimp_drawable_edit_stroke_item(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_line_join_style (GimpJoinStyle join_style) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-line-join-style", + &nreturn_vals, + GIMP_PDB_INT32, join_style, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_line_miter_limit: + * + * Get the line miter limit setting. + * + * This procedure returns the line miter limit setting. + * + * Returns: The line miter limit setting. + * + * Since: 2.10 + **/ +gdouble +gimp_context_get_line_miter_limit (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble miter_limit = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-line-miter-limit", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + miter_limit = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return miter_limit; +} + +/** + * gimp_context_set_line_miter_limit: + * @miter_limit: The line miter limit setting. + * + * Set the line miter limit setting. + * + * This procedure modifies the line miter limit setting for stroking + * lines. + * A mitered join is converted to a bevelled join if the miter would + * extend to a distance of more than (miter-limit * line-width) from + * the actual join point. + * + * This setting affects the following procedures: + * gimp_drawable_edit_stroke_selection(), + * gimp_drawable_edit_stroke_item(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_line_miter_limit (gdouble miter_limit) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-line-miter-limit", + &nreturn_vals, + GIMP_PDB_FLOAT, miter_limit, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_line_dash_offset: + * + * Get the line dash offset setting. + * + * This procedure returns the line dash offset setting. + * + * Returns: The line dash offset setting. + * + * Since: 2.10 + **/ +gdouble +gimp_context_get_line_dash_offset (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble dash_offset = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-line-dash-offset", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + dash_offset = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return dash_offset; +} + +/** + * gimp_context_set_line_dash_offset: + * @dash_offset: The line dash offset setting. + * + * Set the line dash offset setting. + * + * This procedure modifies the line dash offset setting for stroking + * lines. + * + * This setting affects the following procedures: + * gimp_drawable_edit_stroke_selection(), + * gimp_drawable_edit_stroke_item(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_line_dash_offset (gdouble dash_offset) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-line-dash-offset", + &nreturn_vals, + GIMP_PDB_FLOAT, dash_offset, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_line_dash_pattern: + * @num_dashes: The number of dashes in the dash_pattern array. + * @dashes: The line dash pattern setting. + * + * Get the line dash pattern setting. + * + * This procedure returns the line dash pattern setting. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_get_line_dash_pattern (gint *num_dashes, + gdouble **dashes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-get-line-dash-pattern", + &nreturn_vals, + GIMP_PDB_END); + + *num_dashes = 0; + *dashes = NULL; + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + { + *num_dashes = return_vals[1].data.d_int32; + *dashes = g_new (gdouble, *num_dashes); + memcpy (*dashes, + return_vals[2].data.d_floatarray, + *num_dashes * sizeof (gdouble)); + } + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_line_dash_pattern: + * @num_dashes: The number of dashes in the dash_pattern array. + * @dashes: The line dash pattern setting. + * + * Set the line dash pattern setting. + * + * This procedure modifies the line dash pattern setting for stroking + * lines. + * + * The unit of the dash pattern segments is the actual line width used + * for the stroke operation, in other words a segment length of 1.0 + * results in a square segment shape (or gap shape). + * + * This setting affects the following procedures: + * gimp_drawable_edit_stroke_selection_(), + * gimp_drawable_edit_stroke_item(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_line_dash_pattern (gint num_dashes, + const gdouble *dashes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-line-dash-pattern", + &nreturn_vals, + GIMP_PDB_INT32, num_dashes, + GIMP_PDB_FLOATARRAY, dashes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_brush: + * + * Retrieve the currently active brush. + * + * This procedure returns the name of the currently active brush. All + * paint operations and stroke operations use this brush to control the + * application of paint to the image. + * + * Returns: The name of the active brush. + * + * Since: 2.2 + **/ +gchar * +gimp_context_get_brush (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-brush", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_brush: + * @name: The name of the brush. + * + * Set the specified brush as the active brush. + * + * This procedure allows the active brush to be set by specifying its + * name. The name is simply a string which corresponds to one of the + * names of the installed brushes. If there is no matching brush found, + * this procedure will return an error. Otherwise, the specified brush + * becomes active and will be used in all subsequent paint operations. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_brush (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_brush_size: + * + * Get brush size in pixels. + * + * Get the brush size in pixels for brush based paint tools. + * + * Returns: Brush size in pixels. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_brush_size (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble size = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-brush-size", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + size = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return size; +} + +/** + * gimp_context_set_brush_size: + * @size: Brush size in pixels. + * + * Set brush size in pixels. + * + * Set the brush size in pixels for brush based paint tools. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_brush_size (gdouble size) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-size", + &nreturn_vals, + GIMP_PDB_FLOAT, size, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_brush_default_size: + * + * Set brush size to its default. + * + * Set the brush size to the default (max of width and height) for + * paintbrush, airbrush, or pencil tools. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_brush_default_size (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-default-size", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_brush_aspect_ratio: + * + * Get brush aspect ratio. + * + * Set the aspect ratio for brush based paint tools. + * + * Returns: Aspect ratio. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_brush_aspect_ratio (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble aspect = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-brush-aspect-ratio", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + aspect = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return aspect; +} + +/** + * gimp_context_set_brush_aspect_ratio: + * @aspect: Aspect ratio. + * + * Set brush aspect ratio. + * + * Set the aspect ratio for brush based paint tools. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_brush_aspect_ratio (gdouble aspect) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-aspect-ratio", + &nreturn_vals, + GIMP_PDB_FLOAT, aspect, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_brush_angle: + * + * Get brush angle in degrees. + * + * Set the angle in degrees for brush based paint tools. + * + * Returns: Angle in degrees. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_brush_angle (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble angle = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-brush-angle", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + angle = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return angle; +} + +/** + * gimp_context_set_brush_angle: + * @angle: Angle in degrees. + * + * Set brush angle in degrees. + * + * Set the angle in degrees for brush based paint tools. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_brush_angle (gdouble angle) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-angle", + &nreturn_vals, + GIMP_PDB_FLOAT, angle, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_brush_spacing: + * + * Get brush spacing as percent of size. + * + * Get the brush spacing as percent of size for brush based paint + * tools. + * + * Returns: Brush spacing as fraction of size. + * + * Since: 2.10 + **/ +gdouble +gimp_context_get_brush_spacing (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble spacing = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-brush-spacing", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + spacing = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return spacing; +} + +/** + * gimp_context_set_brush_spacing: + * @spacing: Brush spacing as fraction of size. + * + * Set brush spacing as percent of size. + * + * Set the brush spacing as percent of size for brush based paint + * tools. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_brush_spacing (gdouble spacing) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-spacing", + &nreturn_vals, + GIMP_PDB_FLOAT, spacing, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_brush_default_spacing: + * + * Set brush spacing to its default. + * + * Set the brush spacing to the default for paintbrush, airbrush, or + * pencil tools. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_brush_default_spacing (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-default-spacing", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_brush_hardness: + * + * Get brush hardness in paint options. + * + * Get the brush hardness for brush based paint tools. + * + * Returns: Brush hardness. + * + * Since: 2.10 + **/ +gdouble +gimp_context_get_brush_hardness (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble hardness = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-brush-hardness", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + hardness = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return hardness; +} + +/** + * gimp_context_set_brush_hardness: + * @hardness: Brush hardness. + * + * Set brush hardness. + * + * Set the brush hardness for brush based paint tools. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_brush_hardness (gdouble hardness) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-hardness", + &nreturn_vals, + GIMP_PDB_FLOAT, hardness, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_brush_default_hardness: + * + * Set brush spacing to its default. + * + * Set the brush spacing to the default for paintbrush, airbrush, or + * pencil tools. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_brush_default_hardness (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-default-hardness", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_brush_force: + * + * Get brush force in paint options. + * + * Get the brush application force for brush based paint tools. + * + * Returns: Brush application force. + * + * Since: 2.10 + **/ +gdouble +gimp_context_get_brush_force (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble force = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-brush-force", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + force = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return force; +} + +/** + * gimp_context_set_brush_force: + * @force: Brush application force. + * + * Set brush application force. + * + * Set the brush application force for brush based paint tools. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_brush_force (gdouble force) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-brush-force", + &nreturn_vals, + GIMP_PDB_FLOAT, force, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_dynamics: + * + * Retrieve the currently active paint dynamics. + * + * This procedure returns the name of the currently active paint + * dynamics. All paint operations and stroke operations use this paint + * dynamics to control the application of paint to the image. + * + * Returns: The name of the active paint dynamics. + * + * Since: 2.8 + **/ +gchar * +gimp_context_get_dynamics (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-dynamics", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_dynamics: + * @name: The name of the paint dynamics. + * + * Set the specified paint dynamics as the active paint dynamics. + * + * This procedure allows the active paint dynamics to be set by + * specifying its name. The name is simply a string which corresponds + * to one of the names of the installed paint dynamics. If there is no + * matching paint dynamics found, this procedure will return an error. + * Otherwise, the specified paint dynamics becomes active and will be + * used in all subsequent paint operations. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_dynamics (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-dynamics", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_mypaint_brush: + * + * Retrieve the currently active MyPaint brush. + * + * This procedure returns the name of the currently active MyPaint + * brush. + * + * Returns: The name of the active MyPaint brush. + * + * Since: 2.10 + **/ +gchar * +gimp_context_get_mypaint_brush (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-mypaint-brush", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_mypaint_brush: + * @name: The name of the MyPaint brush. + * + * Set the specified MyPaint brush as the active MyPaint brush. + * + * This procedure allows the active MyPaint brush to be set by + * specifying its name. The name is simply a string which corresponds + * to one of the names of the installed MyPaint brushes. If there is no + * matching MyPaint brush found, this procedure will return an error. + * Otherwise, the specified MyPaint brush becomes active and will be + * used in all subsequent MyPaint paint operations. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_mypaint_brush (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-mypaint-brush", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_pattern: + * + * Retrieve the currently active pattern. + * + * This procedure returns name of the the currently active pattern. All + * clone and bucket-fill operations with patterns will use this pattern + * to control the application of paint to the image. + * + * Returns: The name of the active pattern. + * + * Since: 2.2 + **/ +gchar * +gimp_context_get_pattern (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-pattern", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_pattern: + * @name: The name of the pattern. + * + * Set the specified pattern as the active pattern. + * + * This procedure allows the active pattern to be set by specifying its + * name. The name is simply a string which corresponds to one of the + * names of the installed patterns. If there is no matching pattern + * found, this procedure will return an error. Otherwise, the specified + * pattern becomes active and will be used in all subsequent paint + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_pattern (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-pattern", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_gradient: + * + * Retrieve the currently active gradient. + * + * This procedure returns the name of the currently active gradient. + * + * Returns: The name of the active gradient. + * + * Since: 2.2 + **/ +gchar * +gimp_context_get_gradient (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-gradient", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_gradient: + * @name: The name of the gradient. + * + * Sets the specified gradient as the active gradient. + * + * This procedure lets you set the specified gradient as the active or + * \"current\" one. The name is simply a string which corresponds to + * one of the loaded gradients. If no matching gradient is found, this + * procedure will return an error. Otherwise, the specified gradient + * will become active and will be used for subsequent custom gradient + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_gradient (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_gradient_fg_bg_rgb: + * + * Sets the built-in FG-BG RGB gradient as the active gradient. + * + * This procedure sets the built-in FG-BG RGB gradient as the active + * gradient. The gradient will be used for subsequent gradient + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_gradient_fg_bg_rgb (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient-fg-bg-rgb", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_gradient_fg_bg_hsv_cw: + * + * Sets the built-in FG-BG HSV (cw) gradient as the active gradient. + * + * This procedure sets the built-in FG-BG HSV (cw) gradient as the + * active gradient. The gradient will be used for subsequent gradient + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_gradient_fg_bg_hsv_cw (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient-fg-bg-hsv-cw", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_gradient_fg_bg_hsv_ccw: + * + * Sets the built-in FG-BG HSV (ccw) gradient as the active gradient. + * + * This procedure sets the built-in FG-BG HSV (ccw) gradient as the + * active gradient. The gradient will be used for subsequent gradient + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_gradient_fg_bg_hsv_ccw (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient-fg-bg-hsv-ccw", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_gradient_fg_transparent: + * + * Sets the built-in FG-Transparent gradient as the active gradient. + * + * This procedure sets the built-in FG-Transparent gradient as the + * active gradient. The gradient will be used for subsequent gradient + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_gradient_fg_transparent (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient-fg-transparent", + &nreturn_vals, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_gradient_blend_color_space: + * + * Get the gradient blend color space. + * + * Get the gradient blend color space for paint tools and the gradient + * tool. + * + * Returns: Color blend space. + * + * Since: 2.10 + **/ +GimpGradientBlendColorSpace +gimp_context_get_gradient_blend_color_space (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpGradientBlendColorSpace blend_color_space = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-gradient-blend-color-space", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + blend_color_space = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return blend_color_space; +} + +/** + * gimp_context_set_gradient_blend_color_space: + * @blend_color_space: Blend color space. + * + * Set the gradient blend color space. + * + * Set the gradient blend color space for paint tools and the gradient + * tool. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_gradient_blend_color_space (GimpGradientBlendColorSpace blend_color_space) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient-blend-color-space", + &nreturn_vals, + GIMP_PDB_INT32, blend_color_space, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_gradient_repeat_mode: + * + * Get the gradient repeat mode. + * + * Get the gradient repeat mode for paint tools and the gradient tool. + * + * Returns: Repeat mode. + * + * Since: 2.10 + **/ +GimpRepeatMode +gimp_context_get_gradient_repeat_mode (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpRepeatMode repeat_mode = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-gradient-repeat-mode", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + repeat_mode = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return repeat_mode; +} + +/** + * gimp_context_set_gradient_repeat_mode: + * @repeat_mode: Repeat mode. + * + * Set the gradient repeat mode. + * + * Set the gradient repeat mode for paint tools and the gradient tool. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_gradient_repeat_mode (GimpRepeatMode repeat_mode) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient-repeat-mode", + &nreturn_vals, + GIMP_PDB_INT32, repeat_mode, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_gradient_reverse: + * + * Get the gradient reverse setting. + * + * Get the gradient reverse setting for paint tools and the gradient + * tool. + * + * Returns: Reverse. + * + * Since: 2.10 + **/ +gboolean +gimp_context_get_gradient_reverse (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean reverse = FALSE; + + return_vals = gimp_run_procedure ("gimp-context-get-gradient-reverse", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + reverse = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return reverse; +} + +/** + * gimp_context_set_gradient_reverse: + * @reverse: Reverse. + * + * Set the gradient reverse setting. + * + * Set the gradient reverse setting for paint tools and the gradient + * tool. + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_gradient_reverse (gboolean reverse) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-gradient-reverse", + &nreturn_vals, + GIMP_PDB_INT32, reverse, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_palette: + * + * Retrieve the currently active palette. + * + * This procedure returns the name of the the currently active palette. + * + * Returns: The name of the active palette. + * + * Since: 2.2 + **/ +gchar * +gimp_context_get_palette (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-palette", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_palette: + * @name: The name of the palette. + * + * Set the specified palette as the active palette. + * + * This procedure allows the active palette to be set by specifying its + * name. The name is simply a string which corresponds to one of the + * names of the installed palettes. If no matching palette is found, + * this procedure will return an error. Otherwise, the specified + * palette becomes active and will be used in all subsequent palette + * operations. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_palette (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-palette", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_font: + * + * Retrieve the currently active font. + * + * This procedure returns the name of the currently active font. + * + * Returns: The name of the active font. + * + * Since: 2.2 + **/ +gchar * +gimp_context_get_font (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *name = NULL; + + return_vals = gimp_run_procedure ("gimp-context-get-font", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + name = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return name; +} + +/** + * gimp_context_set_font: + * @name: The name of the font. + * + * Set the specified font as the active font. + * + * This procedure allows the active font to be set by specifying its + * name. The name is simply a string which corresponds to one of the + * names of the installed fonts. If no matching font is found, this + * procedure will return an error. Otherwise, the specified font + * becomes active and will be used in all subsequent font operations. + * + * Returns: TRUE on success. + * + * Since: 2.2 + **/ +gboolean +gimp_context_set_font (const gchar *name) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-font", + &nreturn_vals, + GIMP_PDB_STRING, name, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_antialias: + * + * Get the antialias setting. + * + * This procedure returns the antialias setting. + * + * Returns: The antialias setting. + * + * Since: 2.8 + **/ +gboolean +gimp_context_get_antialias (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean antialias = FALSE; + + return_vals = gimp_run_procedure ("gimp-context-get-antialias", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + antialias = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return antialias; +} + +/** + * gimp_context_set_antialias: + * @antialias: The antialias setting. + * + * Set the antialias setting. + * + * This procedure modifies the antialias setting. If antialiasing is + * turned on, the edges of selected region will contain intermediate + * values which give the appearance of a sharper, less pixelized edge. + * This should be set as TRUE most of the time unless a binary-only + * selection is wanted. + * + * This setting affects the following procedures: + * gimp_image_select_color(), gimp_image_select_contiguous_color(), + * gimp_image_select_round_rectangle(), gimp_image_select_ellipse(), + * gimp_image_select_polygon(), gimp_image_select_item(), + * gimp_drawable_edit_bucket_fill(), gimp_drawable_edit_stroke_item(), + * gimp_drawable_edit_stroke_selection(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_antialias (gboolean antialias) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-antialias", + &nreturn_vals, + GIMP_PDB_INT32, antialias, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_feather: + * + * Get the feather setting. + * + * This procedure returns the feather setting. + * + * Returns: The feather setting. + * + * Since: 2.8 + **/ +gboolean +gimp_context_get_feather (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean feather = FALSE; + + return_vals = gimp_run_procedure ("gimp-context-get-feather", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + feather = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return feather; +} + +/** + * gimp_context_set_feather: + * @feather: The feather setting. + * + * Set the feather setting. + * + * This procedure modifies the feather setting. If the feather option + * is enabled, selections will be blurred before combining. The blur is + * a gaussian blur; its radii can be controlled using + * gimp_context_set_feather_radius(). + * + * This setting affects the following procedures: + * gimp_image_select_color(), gimp_image_select_contiguous_color(), + * gimp_image_select_rectangle(), gimp_image_select_round_rectangle(), + * gimp_image_select_ellipse(), gimp_image_select_polygon(), + * gimp_image_select_item(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_feather (gboolean feather) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-feather", + &nreturn_vals, + GIMP_PDB_INT32, feather, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_feather_radius: + * @feather_radius_x: The horizontal feather radius. + * @feather_radius_y: The vertical feather radius. + * + * Get the feather radius setting. + * + * This procedure returns the feather radius setting. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_get_feather_radius (gdouble *feather_radius_x, + gdouble *feather_radius_y) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-get-feather-radius", + &nreturn_vals, + GIMP_PDB_END); + + *feather_radius_x = 0.0; + *feather_radius_y = 0.0; + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + { + *feather_radius_x = return_vals[1].data.d_float; + *feather_radius_y = return_vals[2].data.d_float; + } + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_set_feather_radius: + * @feather_radius_x: The horizontal feather radius. + * @feather_radius_y: The vertical feather radius. + * + * Set the feather radius setting. + * + * This procedure modifies the feather radius setting. + * + * This setting affects all procedures that are affected by + * gimp_context_set_feather(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_feather_radius (gdouble feather_radius_x, + gdouble feather_radius_y) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-feather-radius", + &nreturn_vals, + GIMP_PDB_FLOAT, feather_radius_x, + GIMP_PDB_FLOAT, feather_radius_y, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_sample_merged: + * + * Get the sample merged setting. + * + * This procedure returns the sample merged setting. + * + * Returns: The sample merged setting. + * + * Since: 2.8 + **/ +gboolean +gimp_context_get_sample_merged (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean sample_merged = FALSE; + + return_vals = gimp_run_procedure ("gimp-context-get-sample-merged", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + sample_merged = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return sample_merged; +} + +/** + * gimp_context_set_sample_merged: + * @sample_merged: The sample merged setting. + * + * Set the sample merged setting. + * + * This procedure modifies the sample merged setting. If an operation + * depends on the colors of the pixels present in a drawable, like when + * doing a seed fill, this setting controls whether the pixel data from + * the specified drawable is used ('sample-merged' is FALSE), or the + * pixel data from the composite image ('sample-merged' is TRUE. This + * is equivalent to sampling for colors after merging all visible + * layers). + * + * This setting affects the following procedures: + * gimp_image_select_color(), gimp_image_select_contiguous_color(), + * gimp_drawable_edit_bucket_fill(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_sample_merged (gboolean sample_merged) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-sample-merged", + &nreturn_vals, + GIMP_PDB_INT32, sample_merged, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_sample_criterion: + * + * Get the sample criterion setting. + * + * This procedure returns the sample criterion setting. + * + * Returns: The sample criterion setting. + * + * Since: 2.8 + **/ +GimpSelectCriterion +gimp_context_get_sample_criterion (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpSelectCriterion sample_criterion = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-sample-criterion", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + sample_criterion = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return sample_criterion; +} + +/** + * gimp_context_set_sample_criterion: + * @sample_criterion: The sample criterion setting. + * + * Set the sample criterion setting. + * + * This procedure modifies the sample criterion setting. If an + * operation depends on the colors of the pixels present in a drawable, + * like when doing a seed fill, this setting controls how color + * similarity is determined. SELECT_CRITERION_COMPOSITE is the default + * value. + * + * This setting affects the following procedures: + * gimp_image_select_color(), gimp_image_select_contiguous_color(), + * gimp_drawable_edit_bucket_fill(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_sample_criterion (GimpSelectCriterion sample_criterion) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-sample-criterion", + &nreturn_vals, + GIMP_PDB_INT32, sample_criterion, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_sample_threshold: + * + * Get the sample threshold setting. + * + * This procedure returns the sample threshold setting. + * + * Returns: The sample threshold setting. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_sample_threshold (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble sample_threshold = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-sample-threshold", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + sample_threshold = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return sample_threshold; +} + +/** + * gimp_context_set_sample_threshold: + * @sample_threshold: The sample threshold setting. + * + * Set the sample threshold setting. + * + * This procedure modifies the sample threshold setting. If an + * operation depends on the colors of the pixels present in a drawable, + * like when doing a seed fill, this setting controls what is + * \"sufficiently close\" to be considered a similar color. If the + * sample threshold has not been set explicitly, the default threshold + * set in gimprc will be used. + * + * This setting affects the following procedures: + * gimp_image_select_color(), gimp_image_select_contiguous_color(), + * gimp_drawable_edit_bucket_fill(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_sample_threshold (gdouble sample_threshold) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-sample-threshold", + &nreturn_vals, + GIMP_PDB_FLOAT, sample_threshold, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_sample_threshold_int: + * + * Get the sample threshold setting as an integer value. + * + * This procedure returns the sample threshold setting as an integer + * value. See gimp_context_get_sample_threshold(). + * + * Returns: The sample threshold setting. + * + * Since: 2.8 + **/ +gint +gimp_context_get_sample_threshold_int (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gint sample_threshold = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-sample-threshold-int", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + sample_threshold = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return sample_threshold; +} + +/** + * gimp_context_set_sample_threshold_int: + * @sample_threshold: The sample threshold setting. + * + * Set the sample threshold setting as an integer value. + * + * This procedure modifies the sample threshold setting as an integer + * value. See gimp_context_set_sample_threshold(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_sample_threshold_int (gint sample_threshold) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-sample-threshold-int", + &nreturn_vals, + GIMP_PDB_INT32, sample_threshold, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_sample_transparent: + * + * Get the sample transparent setting. + * + * This procedure returns the sample transparent setting. + * + * Returns: The sample transparent setting. + * + * Since: 2.8 + **/ +gboolean +gimp_context_get_sample_transparent (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean sample_transparent = FALSE; + + return_vals = gimp_run_procedure ("gimp-context-get-sample-transparent", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + sample_transparent = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return sample_transparent; +} + +/** + * gimp_context_set_sample_transparent: + * @sample_transparent: The sample transparent setting. + * + * Set the sample transparent setting. + * + * This procedure modifies the sample transparent setting. If an + * operation depends on the colors of the pixels present in a drawable, + * like when doing a seed fill, this setting controls whether + * transparency is considered to be a unique selectable color. When + * this setting is TRUE, transparent areas can be selected or filled. + * + * This setting affects the following procedures: + * gimp_image_select_color(), gimp_image_select_contiguous_color(), + * gimp_drawable_edit_bucket_fill(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_sample_transparent (gboolean sample_transparent) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-sample-transparent", + &nreturn_vals, + GIMP_PDB_INT32, sample_transparent, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_diagonal_neighbors: + * + * Get the diagonal neighbors setting. + * + * This procedure returns the diagonal neighbors setting. + * + * Returns: The diagonal neighbors setting. + * + * Since: 2.10 + **/ +gboolean +gimp_context_get_diagonal_neighbors (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean diagonal_neighbors = FALSE; + + return_vals = gimp_run_procedure ("gimp-context-get-diagonal-neighbors", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + diagonal_neighbors = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return diagonal_neighbors; +} + +/** + * gimp_context_set_diagonal_neighbors: + * @diagonal_neighbors: The diagonal neighbors setting. + * + * Set the diagonal neighbors setting. + * + * This procedure modifies the diagonal neighbors setting. If the + * affected region of an operation is based on a seed point, like when + * doing a seed fill, then, when this setting is TRUE, all eight + * neighbors of each pixel are considered when calculating the affected + * region; in contrast, when this setting is FALSE, only the four + * orthogonal neighbors of each pixel are considered. + * + * This setting affects the following procedures: + * gimp_image_select_contiguous_color(), + * gimp_drawable_edit_bucket_fill(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_diagonal_neighbors (gboolean diagonal_neighbors) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-diagonal-neighbors", + &nreturn_vals, + GIMP_PDB_INT32, diagonal_neighbors, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_distance_metric: + * + * Get the distance metric used in some computations. + * + * This procedure returns the distance metric in the current context. + * See gimp_context_set_distance_metric() to know more about its usage. + * + * Returns: The distance metric. + * + * Since: 2.10 + **/ +GeglDistanceMetric +gimp_context_get_distance_metric (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GeglDistanceMetric metric = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-distance-metric", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + metric = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return metric; +} + +/** + * gimp_context_set_distance_metric: + * @metric: The distance metric. + * + * Set the distance metric used in some computations. + * + * This procedure modifies the distance metric used in some + * computations, such as gimp_drawable_edit_gradient_fill(). In + * particular, it does not change the metric used in generic distance + * computation on canvas, as in the Measure tool. + * + * This setting affects the following procedures: + * gimp_drawable_edit_gradient_fill(). + * + * Returns: TRUE on success. + * + * Since: 2.10 + **/ +gboolean +gimp_context_set_distance_metric (GeglDistanceMetric metric) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-distance-metric", + &nreturn_vals, + GIMP_PDB_INT32, metric, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_interpolation: + * + * Get the interpolation type. + * + * This procedure returns the interpolation setting. The return value + * is an integer which corresponds to the values listed in the argument + * description. If the interpolation has not been set explicitly by + * gimp_context_set_interpolation(), the default interpolation set in + * gimprc will be used. + * + * Returns: The interpolation type. + * + * Since: 2.8 + **/ +GimpInterpolationType +gimp_context_get_interpolation (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpInterpolationType interpolation = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-interpolation", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + interpolation = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return interpolation; +} + +/** + * gimp_context_set_interpolation: + * @interpolation: The interpolation type. + * + * Set the interpolation type. + * + * This procedure modifies the interpolation setting. + * + * This setting affects affects the following procedures: + * gimp_item_transform_flip(), gimp_item_transform_perspective(), + * gimp_item_transform_rotate(), gimp_item_transform_scale(), + * gimp_item_transform_shear(), gimp_item_transform_2d(), + * gimp_item_transform_matrix(), gimp_image_scale(), + * gimp_layer_scale(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_interpolation (GimpInterpolationType interpolation) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-interpolation", + &nreturn_vals, + GIMP_PDB_INT32, interpolation, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_transform_direction: + * + * Get the transform direction. + * + * This procedure returns the transform direction. The return value is + * an integer which corresponds to the values listed in the argument + * description. + * + * Returns: The transform direction. + * + * Since: 2.8 + **/ +GimpTransformDirection +gimp_context_get_transform_direction (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpTransformDirection transform_direction = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-transform-direction", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + transform_direction = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return transform_direction; +} + +/** + * gimp_context_set_transform_direction: + * @transform_direction: The transform direction. + * + * Set the transform direction. + * + * This procedure modifies the transform direction setting. + * + * This setting affects affects the following procedures: + * gimp_item_transform_flip(), gimp_item_transform_perspective(), + * gimp_item_transform_rotate(), gimp_item_transform_scale(), + * gimp_item_transform_shear(), gimp_item_transform_2d(), + * gimp_item_transform_matrix(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_transform_direction (GimpTransformDirection transform_direction) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-transform-direction", + &nreturn_vals, + GIMP_PDB_INT32, transform_direction, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_transform_resize: + * + * Get the transform resize type. + * + * This procedure returns the transform resize setting. The return + * value is an integer which corresponds to the values listed in the + * argument description. + * + * Returns: The transform resize type. + * + * Since: 2.8 + **/ +GimpTransformResize +gimp_context_get_transform_resize (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpTransformResize transform_resize = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-transform-resize", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + transform_resize = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return transform_resize; +} + +/** + * gimp_context_set_transform_resize: + * @transform_resize: The transform resize type. + * + * Set the transform resize type. + * + * This procedure modifies the transform resize setting. When + * transforming pixels, if the result of a transform operation has a + * different size than the original area, this setting determines how + * the resulting area is sized. + * + * This setting affects affects the following procedures: + * gimp_item_transform_flip(), gimp_item_transform_flip_simple(), + * gimp_item_transform_perspective(), gimp_item_transform_rotate(), + * gimp_item_transform_rotate_simple(), gimp_item_transform_scale(), + * gimp_item_transform_shear(), gimp_item_transform_2d(), + * gimp_item_transform_matrix(). + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_transform_resize (GimpTransformResize transform_resize) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-transform-resize", + &nreturn_vals, + GIMP_PDB_INT32, transform_resize, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_transform_recursion: + * + * Deprecated: There is no replacement for this procedure. + * + * Returns: This returns always 3 and is meaningless. + **/ +gint +gimp_context_get_transform_recursion (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gint transform_recursion = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-transform-recursion", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + transform_recursion = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return transform_recursion; +} + +/** + * gimp_context_set_transform_recursion: + * @transform_recursion: This parameter is ignored. + * + * Deprecated: There is no replacement for this procedure. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_context_set_transform_recursion (gint transform_recursion) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-transform-recursion", + &nreturn_vals, + GIMP_PDB_INT32, transform_recursion, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_size: + * + * Get ink blob size in pixels. + * + * Get the ink blob size in pixels for ink tool. + * + * Returns: ink blob size in pixels. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_ink_size (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble size = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-size", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + size = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return size; +} + +/** + * gimp_context_set_ink_size: + * @size: ink blob size in pixels. + * + * Set ink blob size in pixels. + * + * Set the ink blob size in pixels for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_size (gdouble size) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-size", + &nreturn_vals, + GIMP_PDB_FLOAT, size, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_angle: + * + * Get ink angle in degrees. + * + * Get the ink angle in degrees for ink tool. + * + * Returns: ink angle in degrees. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_ink_angle (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble angle = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-angle", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + angle = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return angle; +} + +/** + * gimp_context_set_ink_angle: + * @angle: ink angle in degrees. + * + * Set ink angle in degrees. + * + * Set the ink angle in degrees for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_angle (gdouble angle) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-angle", + &nreturn_vals, + GIMP_PDB_FLOAT, angle, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_size_sensitivity: + * + * Get ink size sensitivity. + * + * Get the ink size sensitivity for ink tool. + * + * Returns: ink size sensitivity. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_ink_size_sensitivity (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble size = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-size-sensitivity", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + size = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return size; +} + +/** + * gimp_context_set_ink_size_sensitivity: + * @size: ink size sensitivity. + * + * Set ink size sensitivity. + * + * Set the ink size sensitivity for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_size_sensitivity (gdouble size) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-size-sensitivity", + &nreturn_vals, + GIMP_PDB_FLOAT, size, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_tilt_sensitivity: + * + * Get ink tilt sensitivity. + * + * Get the ink tilt sensitivity for ink tool. + * + * Returns: ink tilt sensitivity. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_ink_tilt_sensitivity (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble tilt = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-tilt-sensitivity", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + tilt = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return tilt; +} + +/** + * gimp_context_set_ink_tilt_sensitivity: + * @tilt: ink tilt sensitivity. + * + * Set ink tilt sensitivity. + * + * Set the ink tilt sensitivity for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_tilt_sensitivity (gdouble tilt) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-tilt-sensitivity", + &nreturn_vals, + GIMP_PDB_FLOAT, tilt, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_speed_sensitivity: + * + * Get ink speed sensitivity. + * + * Get the ink speed sensitivity for ink tool. + * + * Returns: ink speed sensitivity. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_ink_speed_sensitivity (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble speed = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-speed-sensitivity", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + speed = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return speed; +} + +/** + * gimp_context_set_ink_speed_sensitivity: + * @speed: ink speed sensitivity. + * + * Set ink speed sensitivity. + * + * Set the ink speed sensitivity for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_speed_sensitivity (gdouble speed) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-speed-sensitivity", + &nreturn_vals, + GIMP_PDB_FLOAT, speed, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_blob_type: + * + * Get ink blob type. + * + * Get the ink blob type for ink tool. + * + * Returns: Ink blob type. + * + * Since: 2.8 + **/ +GimpInkBlobType +gimp_context_get_ink_blob_type (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpInkBlobType type = 0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-blob-type", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + type = return_vals[1].data.d_int32; + + gimp_destroy_params (return_vals, nreturn_vals); + + return type; +} + +/** + * gimp_context_set_ink_blob_type: + * @type: Ink blob type. + * + * Set ink blob type. + * + * Set the ink blob type for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_blob_type (GimpInkBlobType type) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-blob-type", + &nreturn_vals, + GIMP_PDB_INT32, type, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_blob_aspect_ratio: + * + * Get ink blob aspect ratio. + * + * Get the ink blob aspect ratio for ink tool. + * + * Returns: ink blob aspect ratio. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_ink_blob_aspect_ratio (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble aspect = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-blob-aspect-ratio", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + aspect = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return aspect; +} + +/** + * gimp_context_set_ink_blob_aspect_ratio: + * @aspect: ink blob aspect ratio. + * + * Set ink blob aspect ratio. + * + * Set the ink blob aspect ratio for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_blob_aspect_ratio (gdouble aspect) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-blob-aspect-ratio", + &nreturn_vals, + GIMP_PDB_FLOAT, aspect, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_context_get_ink_blob_angle: + * + * Get ink blob angle in degrees. + * + * Get the ink blob angle in degrees for ink tool. + * + * Returns: ink blob angle in degrees. + * + * Since: 2.8 + **/ +gdouble +gimp_context_get_ink_blob_angle (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gdouble angle = 0.0; + + return_vals = gimp_run_procedure ("gimp-context-get-ink-blob-angle", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + angle = return_vals[1].data.d_float; + + gimp_destroy_params (return_vals, nreturn_vals); + + return angle; +} + +/** + * gimp_context_set_ink_blob_angle: + * @angle: ink blob angle in degrees. + * + * Set ink blob angle in degrees. + * + * Set the ink blob angle in degrees for ink tool. + * + * Returns: TRUE on success. + * + * Since: 2.8 + **/ +gboolean +gimp_context_set_ink_blob_angle (gdouble angle) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-context-set-ink-blob-angle", + &nreturn_vals, + GIMP_PDB_FLOAT, angle, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} -- cgit v1.2.3