diff options
Diffstat (limited to 'libgimp/gimpgimprc_pdb.c')
-rw-r--r-- | libgimp/gimpgimprc_pdb.c | 330 |
1 files changed, 330 insertions, 0 deletions
diff --git a/libgimp/gimpgimprc_pdb.c b/libgimp/gimpgimprc_pdb.c new file mode 100644 index 0000000..499b8fc --- /dev/null +++ b/libgimp/gimpgimprc_pdb.c @@ -0,0 +1,330 @@ +/* LIBGIMP - The GIMP Library + * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball + * + * gimpgimprc_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: gimpgimprc + * @title: gimpgimprc + * @short_description: Interactions with settings from gimprc. + * + * Interactions with settings from gimprc. + **/ + + +/** + * gimp_gimprc_query: + * @token: The token to query for. + * + * Queries the gimprc file parser for information on a specified token. + * + * This procedure is used to locate additional information contained in + * the gimprc file considered extraneous to the operation of GIMP. + * Plug-ins that need configuration information can expect it will be + * stored in the user gimprc file and can use this procedure to + * retrieve it. This query procedure will return the value associated + * with the specified token. This corresponds _only_ to entries with + * the format: (<token> <value>). The value must be a + * string. Entries not corresponding to this format will cause warnings + * to be issued on gimprc parsing and will not be queryable. + * + * Returns: The value associated with the queried token. + **/ +gchar * +gimp_gimprc_query (const gchar *token) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *value = NULL; + + return_vals = gimp_run_procedure ("gimp-gimprc-query", + &nreturn_vals, + GIMP_PDB_STRING, token, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + value = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return value; +} + +/** + * gimp_gimprc_set: + * @token: The token to add or modify. + * @value: The value to set the token to. + * + * Sets a gimprc token to a value and saves it in the gimprc. + * + * This procedure is used to add or change additional information in + * the gimprc file that is considered extraneous to the operation of + * GIMP. Plug-ins that need configuration information can use this + * function to store it, and gimp_gimprc_query() to retrieve it. This + * will accept _only_ string values in UTF-8 encoding. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_gimprc_set (const gchar *token, + const gchar *value) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-gimprc-set", + &nreturn_vals, + GIMP_PDB_STRING, token, + GIMP_PDB_STRING, value, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_get_default_comment: + * + * Get the default image comment as specified in the Preferences. + * + * Returns a copy of the default image comment. + * + * Returns: Default image comment. + **/ +gchar * +gimp_get_default_comment (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *comment = NULL; + + return_vals = gimp_run_procedure ("gimp-get-default-comment", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + comment = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return comment; +} + +/** + * gimp_get_default_unit: + * + * Get the default unit (taken from the user's locale). + * + * Returns the default unit's integer ID. + * + * Returns: Default unit. + * + * Since: 2.4 + **/ +GimpUnit +gimp_get_default_unit (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + GimpUnit unit_id = 0; + + return_vals = gimp_run_procedure ("gimp-get-default-unit", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + unit_id = return_vals[1].data.d_unit; + + gimp_destroy_params (return_vals, nreturn_vals); + + return unit_id; +} + +/** + * gimp_get_monitor_resolution: + * @xres: X resolution. + * @yres: Y resolution. + * + * Get the monitor resolution as specified in the Preferences. + * + * Returns the resolution of the monitor in pixels/inch. This value is + * taken from the Preferences (or the windowing system if this is set + * in the Preferences) and there's no guarantee for the value to be + * reasonable. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_get_monitor_resolution (gdouble *xres, + gdouble *yres) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-get-monitor-resolution", + &nreturn_vals, + GIMP_PDB_END); + + *xres = 0.0; + *yres = 0.0; + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + { + *xres = return_vals[1].data.d_float; + *yres = return_vals[2].data.d_float; + } + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_get_theme_dir: + * + * Get the directory of the current GUI theme. + * + * Returns a copy of the current GUI theme dir. + * + * Deprecated: There is no replacement for this procedure. + * + * Returns: The GUI theme dir. + **/ +gchar * +gimp_get_theme_dir (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *theme_dir = NULL; + + return_vals = gimp_run_procedure ("gimp-get-theme-dir", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + theme_dir = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return theme_dir; +} + +/** + * gimp_get_icon_theme_dir: + * + * Get the directory of the current icon theme. + * + * Returns a copy of the current icon theme dir. + * + * Deprecated: There is no replacement for this procedure. + * + * Returns: The icon theme dir. + * + * Since: 2.10 + **/ +gchar * +gimp_get_icon_theme_dir (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *icon_theme_dir = NULL; + + return_vals = gimp_run_procedure ("gimp-get-icon-theme-dir", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + icon_theme_dir = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return icon_theme_dir; +} + +/** + * _gimp_get_color_configuration: + * + * Get a serialized version of the color management configuration. + * + * Returns a string that can be deserialized into a GimpColorConfig + * object representing the current color management configuration. + * + * Returns: Serialized color management configuration. + * + * Since: 2.4 + **/ +gchar * +_gimp_get_color_configuration (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *config = NULL; + + return_vals = gimp_run_procedure ("gimp-get-color-configuration", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + config = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return config; +} + +/** + * gimp_get_module_load_inhibit: + * + * Get the list of modules which should not be loaded. + * + * Returns a copy of the list of modules which should not be loaded. + * + * Returns: The list of modules. + **/ +gchar * +gimp_get_module_load_inhibit (void) +{ + GimpParam *return_vals; + gint nreturn_vals; + gchar *load_inhibit = NULL; + + return_vals = gimp_run_procedure ("gimp-get-module-load-inhibit", + &nreturn_vals, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + load_inhibit = g_strdup (return_vals[1].data.d_string); + + gimp_destroy_params (return_vals, nreturn_vals); + + return load_inhibit; +} |