2000-05-31 21:24:14 +08:00
|
|
|
/* LIBGIMP - The GIMP Library
|
2003-07-03 08:47:26 +08:00
|
|
|
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
|
2000-05-31 21:24:14 +08:00
|
|
|
*
|
2019-08-06 18:50:08 +08:00
|
|
|
* gimppdb_pdb.c
|
2000-05-31 21:24:14 +08:00
|
|
|
*
|
2009-01-18 06:28:01 +08:00
|
|
|
* This library is free software: you can redistribute it and/or
|
2000-05-31 21:24:14 +08:00
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
2009-01-18 06:28:01 +08:00
|
|
|
* version 3 of the License, or (at your option) any later version.
|
2000-05-31 21:24:14 +08:00
|
|
|
*
|
|
|
|
* 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
|
2000-06-02 01:34:56 +08:00
|
|
|
* Lesser General Public License for more details.
|
2000-05-31 21:24:14 +08:00
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2009-01-18 06:28:01 +08:00
|
|
|
* License along with this library. If not, see
|
2018-07-12 05:27:07 +08:00
|
|
|
* <https://www.gnu.org/licenses/>.
|
2000-05-31 21:24:14 +08:00
|
|
|
*/
|
|
|
|
|
2007-01-09 18:52:47 +08:00
|
|
|
/* NOTE: This file is auto-generated by pdbgen.pl */
|
2000-06-01 05:16:11 +08:00
|
|
|
|
2002-05-14 07:30:23 +08:00
|
|
|
#include "config.h"
|
|
|
|
|
2000-05-31 21:24:14 +08:00
|
|
|
#include "gimp.h"
|
2019-08-09 03:52:36 +08:00
|
|
|
#include "gimppdb_pdb.h"
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2003-12-19 08:00:49 +08:00
|
|
|
/**
|
2019-08-07 06:19:38 +08:00
|
|
|
* _gimp_pdb_temp_name:
|
2003-12-19 08:00:49 +08:00
|
|
|
*
|
|
|
|
* Generates a unique temporary PDB name.
|
|
|
|
*
|
|
|
|
* This procedure generates a temporary PDB entry name that is
|
2007-01-09 18:52:47 +08:00
|
|
|
* guaranteed to be unique.
|
2003-12-19 08:00:49 +08:00
|
|
|
*
|
2019-08-05 04:09:04 +08:00
|
|
|
* Returns: (transfer full): A unique temporary name for a temporary PDB entry.
|
|
|
|
* The returned value must be freed with g_free().
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2003-12-19 08:00:49 +08:00
|
|
|
gchar *
|
2019-08-07 06:19:38 +08:00
|
|
|
_gimp_pdb_temp_name (void)
|
2003-12-19 08:00:49 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2003-12-19 08:00:49 +08:00
|
|
|
gchar *temp_name = NULL;
|
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_NONE);
|
2019-07-30 16:51:16 +08:00
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-temp-name",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2003-12-19 08:00:49 +08:00
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
2019-09-04 08:49:33 +08:00
|
|
|
temp_name = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
2003-12-19 08:00:49 +08:00
|
|
|
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (return_vals);
|
2003-12-19 08:00:49 +08:00
|
|
|
|
|
|
|
return temp_name;
|
|
|
|
}
|
|
|
|
|
2000-08-25 07:06:53 +08:00
|
|
|
/**
|
2019-08-08 07:14:35 +08:00
|
|
|
* _gimp_pdb_dump:
|
2000-08-25 07:06:53 +08:00
|
|
|
* @filename: The dump filename.
|
|
|
|
*
|
|
|
|
* Dumps the current contents of the procedural database
|
|
|
|
*
|
|
|
|
* This procedure dumps the contents of the procedural database to the
|
|
|
|
* specified file. The file will contain all of the information
|
2007-11-23 22:38:37 +08:00
|
|
|
* provided for each registered procedure.
|
2000-08-25 07:06:53 +08:00
|
|
|
*
|
|
|
|
* Returns: TRUE on success.
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean
|
2019-08-08 07:14:35 +08:00
|
|
|
_gimp_pdb_dump (const gchar *filename)
|
2000-05-31 21:24:14 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean success = TRUE;
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, filename,
|
2019-07-30 16:51:16 +08:00
|
|
|
G_TYPE_NONE);
|
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-dump",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
2000-08-23 09:44:59 +08:00
|
|
|
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (return_vals);
|
2000-08-23 09:44:59 +08:00
|
|
|
|
|
|
|
return success;
|
2000-05-31 21:24:14 +08:00
|
|
|
}
|
|
|
|
|
2000-08-25 07:06:53 +08:00
|
|
|
/**
|
2019-08-08 07:14:35 +08:00
|
|
|
* _gimp_pdb_query:
|
2000-08-25 07:06:53 +08:00
|
|
|
* @name: The regex for procedure name.
|
|
|
|
* @blurb: The regex for procedure blurb.
|
|
|
|
* @help: The regex for procedure help.
|
2019-08-11 23:03:03 +08:00
|
|
|
* @authors: The regex for procedure authors.
|
2000-08-25 07:06:53 +08:00
|
|
|
* @copyright: The regex for procedure copyright.
|
|
|
|
* @date: The regex for procedure date.
|
2017-03-22 00:45:50 +08:00
|
|
|
* @proc_type: The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-in', 'GIMP Extension', 'Temporary Procedure' }.
|
2019-08-01 04:51:35 +08:00
|
|
|
* @num_matches: (out): The number of matching procedures.
|
|
|
|
* @procedure_names: (out) (array length=num_matches) (element-type gchar*) (transfer full): The list of procedure names.
|
2000-08-25 07:06:53 +08:00
|
|
|
*
|
|
|
|
* Queries the procedural database for its contents using regular
|
|
|
|
* expression matching.
|
|
|
|
*
|
|
|
|
* This procedure queries the contents of the procedural database. It
|
|
|
|
* is supplied with seven arguments matching procedures on { name,
|
2019-08-11 23:03:03 +08:00
|
|
|
* blurb, help, authors, copyright, date, procedure type}. This is
|
2000-08-25 07:06:53 +08:00
|
|
|
* accomplished using regular expression matching. For instance, to
|
|
|
|
* find all procedures with \"jpeg\" listed in the blurb, all seven
|
|
|
|
* arguments can be supplied as \".*\", except for the second, which
|
|
|
|
* can be supplied as \".*jpeg.*\". There are two return arguments for
|
|
|
|
* this procedure. The first is the number of procedures matching the
|
|
|
|
* query. The second is a concatenated list of procedure names
|
|
|
|
* corresponding to those matching the query. If no matching entries
|
|
|
|
* are found, then the returned string is NULL and the number of
|
|
|
|
* entries is 0.
|
|
|
|
*
|
|
|
|
* Returns: TRUE on success.
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean
|
2019-08-08 07:14:35 +08:00
|
|
|
_gimp_pdb_query (const gchar *name,
|
|
|
|
const gchar *blurb,
|
|
|
|
const gchar *help,
|
2019-08-11 23:03:03 +08:00
|
|
|
const gchar *authors,
|
2019-08-08 07:14:35 +08:00
|
|
|
const gchar *copyright,
|
|
|
|
const gchar *date,
|
|
|
|
const gchar *proc_type,
|
|
|
|
gint *num_matches,
|
|
|
|
gchar ***procedure_names)
|
2000-05-31 21:24:14 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean success = TRUE;
|
2019-07-30 16:51:16 +08:00
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, name,
|
|
|
|
G_TYPE_STRING, blurb,
|
|
|
|
G_TYPE_STRING, help,
|
2019-08-11 23:03:03 +08:00
|
|
|
G_TYPE_STRING, authors,
|
2019-08-08 19:01:50 +08:00
|
|
|
G_TYPE_STRING, copyright,
|
|
|
|
G_TYPE_STRING, date,
|
|
|
|
G_TYPE_STRING, proc_type,
|
2019-07-30 16:51:16 +08:00
|
|
|
G_TYPE_NONE);
|
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-query",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2000-06-02 01:34:56 +08:00
|
|
|
*num_matches = 0;
|
2000-08-22 05:23:31 +08:00
|
|
|
*procedure_names = NULL;
|
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
2000-08-23 09:44:59 +08:00
|
|
|
|
|
|
|
if (success)
|
2000-05-31 21:24:14 +08:00
|
|
|
{
|
2019-09-04 08:49:33 +08:00
|
|
|
*num_matches = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
|
|
*procedure_names = GIMP_VALUES_DUP_STRING_ARRAY (return_vals, 2);
|
2000-05-31 21:24:14 +08:00
|
|
|
}
|
|
|
|
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (return_vals);
|
2000-08-23 09:44:59 +08:00
|
|
|
|
|
|
|
return success;
|
2000-05-31 21:24:14 +08:00
|
|
|
}
|
|
|
|
|
2008-04-07 04:30:59 +08:00
|
|
|
/**
|
2019-08-07 00:29:55 +08:00
|
|
|
* _gimp_pdb_proc_exists:
|
2008-04-07 04:30:59 +08:00
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
*
|
|
|
|
* Checks if the specified procedure exists in the procedural database
|
|
|
|
*
|
|
|
|
* This procedure checks if the specified procedure is registered in
|
|
|
|
* the procedural database.
|
|
|
|
*
|
|
|
|
* Returns: Whether a procedure of that name is registered.
|
|
|
|
*
|
2015-06-01 03:18:09 +08:00
|
|
|
* Since: 2.6
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2008-04-07 04:30:59 +08:00
|
|
|
gboolean
|
2019-08-07 00:29:55 +08:00
|
|
|
_gimp_pdb_proc_exists (const gchar *procedure_name)
|
2008-04-07 04:30:59 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2008-04-07 04:30:59 +08:00
|
|
|
gboolean exists = FALSE;
|
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
2019-07-30 16:51:16 +08:00
|
|
|
G_TYPE_NONE);
|
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-exists",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2008-04-07 04:30:59 +08:00
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
2019-09-04 08:49:33 +08:00
|
|
|
exists = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
2008-04-07 04:30:59 +08:00
|
|
|
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (return_vals);
|
2008-04-07 04:30:59 +08:00
|
|
|
|
|
|
|
return exists;
|
|
|
|
}
|
|
|
|
|
2000-08-25 07:06:53 +08:00
|
|
|
/**
|
2019-08-06 18:50:08 +08:00
|
|
|
* _gimp_pdb_proc_info:
|
2006-04-01 01:42:13 +08:00
|
|
|
* @procedure_name: The procedure name.
|
2019-08-01 04:51:35 +08:00
|
|
|
* @proc_type: (out): The procedure type.
|
|
|
|
* @num_args: (out): The number of input arguments.
|
|
|
|
* @num_values: (out): The number of return values.
|
2000-08-25 07:06:53 +08:00
|
|
|
*
|
|
|
|
* Queries the procedural database for information on the specified
|
|
|
|
* procedure.
|
|
|
|
*
|
2019-09-04 07:38:31 +08:00
|
|
|
* This procedure returns information on the specified procedure. The
|
2000-08-25 07:06:53 +08:00
|
|
|
* procedure type, number of input, and number of return values are
|
|
|
|
* returned. For specific information on each input argument and return
|
2019-08-12 04:31:15 +08:00
|
|
|
* value, use the gimp_pdb_db_proc_argument() and
|
|
|
|
* gimp_pdb_db_proc_return_value() procedures.
|
2000-08-25 07:06:53 +08:00
|
|
|
*
|
|
|
|
* Returns: TRUE on success.
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean
|
2019-09-04 07:38:31 +08:00
|
|
|
_gimp_pdb_proc_info (const gchar *procedure_name,
|
|
|
|
GimpPDBProcType *proc_type,
|
|
|
|
gint *num_args,
|
|
|
|
gint *num_values)
|
2000-05-31 21:24:14 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean success = TRUE;
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
2019-07-30 16:51:16 +08:00
|
|
|
G_TYPE_NONE);
|
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-info",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2000-08-22 05:23:31 +08:00
|
|
|
*proc_type = 0;
|
|
|
|
*num_args = 0;
|
|
|
|
*num_values = 0;
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
2000-08-23 09:44:59 +08:00
|
|
|
|
2019-09-04 07:38:31 +08:00
|
|
|
if (success)
|
|
|
|
{
|
2019-09-04 08:49:33 +08:00
|
|
|
*proc_type = GIMP_VALUES_GET_ENUM (return_vals, 1);
|
|
|
|
*num_args = GIMP_VALUES_GET_INT (return_vals, 2);
|
|
|
|
*num_values = GIMP_VALUES_GET_INT (return_vals, 3);
|
2019-09-04 07:38:31 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
|
|
|
|
return success;
|
|
|
|
}
|
|
|
|
|
2019-09-08 03:08:13 +08:00
|
|
|
/**
|
|
|
|
* _gimp_pdb_proc_image_types:
|
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
*
|
|
|
|
* Queries the procedural database for the image types supported by the
|
|
|
|
* specified procedure.
|
|
|
|
*
|
|
|
|
* This procedure returns the image types supported by the specified
|
|
|
|
* procedure.
|
|
|
|
*
|
|
|
|
* Returns: (transfer full): The image types.
|
|
|
|
* The returned value must be freed with g_free().
|
|
|
|
*
|
|
|
|
* Since: 3.0
|
|
|
|
**/
|
|
|
|
gchar *
|
|
|
|
_gimp_pdb_proc_image_types (const gchar *procedure_name)
|
|
|
|
{
|
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
|
|
|
gchar *image_types = NULL;
|
|
|
|
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
|
|
|
G_TYPE_NONE);
|
|
|
|
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-image-types",
|
|
|
|
args);
|
|
|
|
gimp_value_array_unref (args);
|
|
|
|
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
|
|
image_types = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
|
|
|
|
return image_types;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* _gimp_pdb_proc_menu_label:
|
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
*
|
|
|
|
* Queries the procedural database for the procedure's menu label.
|
|
|
|
*
|
|
|
|
* This procedure returns the menu label of the specified procedure.
|
|
|
|
*
|
|
|
|
* Returns: (transfer full): The menu_label.
|
|
|
|
* The returned value must be freed with g_free().
|
|
|
|
*
|
|
|
|
* Since: 3.0
|
|
|
|
**/
|
|
|
|
gchar *
|
|
|
|
_gimp_pdb_proc_menu_label (const gchar *procedure_name)
|
|
|
|
{
|
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
|
|
|
gchar *menu_label = NULL;
|
|
|
|
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
|
|
|
G_TYPE_NONE);
|
|
|
|
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-menu-label",
|
|
|
|
args);
|
|
|
|
gimp_value_array_unref (args);
|
|
|
|
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
|
|
menu_label = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
|
|
|
|
return menu_label;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* _gimp_pdb_proc_menu_paths:
|
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
* @num_menu_paths: (out): The number of menu paths.
|
|
|
|
*
|
|
|
|
* Queries the procedural database for the procedure's menu paths.
|
|
|
|
*
|
|
|
|
* This procedure returns the menu paths of the specified procedure.
|
|
|
|
*
|
|
|
|
* Returns: (array length=num_menu_paths) (element-type gchar*) (transfer full):
|
|
|
|
* The menu paths of the plug-in.
|
|
|
|
* The returned value must be freed with g_strfreev().
|
|
|
|
*
|
|
|
|
* Since: 3.0
|
|
|
|
**/
|
|
|
|
gchar **
|
|
|
|
_gimp_pdb_proc_menu_paths (const gchar *procedure_name,
|
|
|
|
gint *num_menu_paths)
|
|
|
|
{
|
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
|
|
|
gchar **menu_paths = NULL;
|
|
|
|
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
|
|
|
G_TYPE_NONE);
|
|
|
|
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-menu-paths",
|
|
|
|
args);
|
|
|
|
gimp_value_array_unref (args);
|
|
|
|
|
|
|
|
*num_menu_paths = 0;
|
|
|
|
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
|
|
{
|
|
|
|
*num_menu_paths = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
|
|
menu_paths = GIMP_VALUES_DUP_STRING_ARRAY (return_vals, 2);
|
|
|
|
}
|
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
|
|
|
|
return menu_paths;
|
|
|
|
}
|
|
|
|
|
2019-09-04 07:38:31 +08:00
|
|
|
/**
|
|
|
|
* _gimp_pdb_proc_documentation:
|
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
* @blurb: (out) (transfer full): A short blurb.
|
|
|
|
* @help: (out) (transfer full): Detailed procedure help.
|
|
|
|
* @help_id: (out) (transfer full): The procedure help_id.
|
|
|
|
*
|
|
|
|
* Queries the procedural database for documentation on the specified
|
|
|
|
* procedure.
|
|
|
|
*
|
|
|
|
* This procedure returns documentation on the specified procedure. A
|
|
|
|
* short blurb, detailed help and help_id.
|
|
|
|
*
|
|
|
|
* Returns: TRUE on success.
|
|
|
|
*
|
|
|
|
* Since: 3.0
|
|
|
|
**/
|
|
|
|
gboolean
|
|
|
|
_gimp_pdb_proc_documentation (const gchar *procedure_name,
|
|
|
|
gchar **blurb,
|
|
|
|
gchar **help,
|
|
|
|
gchar **help_id)
|
|
|
|
{
|
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
|
|
|
gboolean success = TRUE;
|
|
|
|
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
|
|
|
G_TYPE_NONE);
|
|
|
|
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-documentation",
|
|
|
|
args);
|
|
|
|
gimp_value_array_unref (args);
|
|
|
|
|
|
|
|
*blurb = NULL;
|
|
|
|
*help = NULL;
|
|
|
|
*help_id = NULL;
|
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
2019-09-04 07:38:31 +08:00
|
|
|
|
2000-08-23 09:44:59 +08:00
|
|
|
if (success)
|
2000-05-31 21:24:14 +08:00
|
|
|
{
|
2019-09-04 08:49:33 +08:00
|
|
|
*blurb = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
*help = GIMP_VALUES_DUP_STRING (return_vals, 2);
|
|
|
|
*help_id = GIMP_VALUES_DUP_STRING (return_vals, 3);
|
2019-09-04 07:38:31 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
|
|
|
|
return success;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* _gimp_pdb_proc_attribution:
|
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
* @authors: (out) (transfer full): Authors of the procedure.
|
|
|
|
* @copyright: (out) (transfer full): The copyright.
|
|
|
|
* @date: (out) (transfer full): Copyright date.
|
|
|
|
*
|
|
|
|
* Queries the procedural database for attribution information on the
|
|
|
|
* specified procedure.
|
|
|
|
*
|
|
|
|
* This procedure returns attribution information on the specified
|
|
|
|
* procedure. The authors, copyright information and date are returned.
|
|
|
|
*
|
|
|
|
* Returns: TRUE on success.
|
|
|
|
*
|
|
|
|
* Since: 3.0
|
|
|
|
**/
|
|
|
|
gboolean
|
|
|
|
_gimp_pdb_proc_attribution (const gchar *procedure_name,
|
|
|
|
gchar **authors,
|
|
|
|
gchar **copyright,
|
|
|
|
gchar **date)
|
|
|
|
{
|
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
|
|
|
gboolean success = TRUE;
|
|
|
|
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
|
|
|
G_TYPE_NONE);
|
|
|
|
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-attribution",
|
|
|
|
args);
|
|
|
|
gimp_value_array_unref (args);
|
|
|
|
|
|
|
|
*authors = NULL;
|
|
|
|
*copyright = NULL;
|
|
|
|
*date = NULL;
|
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
2019-09-04 07:38:31 +08:00
|
|
|
|
|
|
|
if (success)
|
|
|
|
{
|
2019-09-04 08:49:33 +08:00
|
|
|
*authors = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
*copyright = GIMP_VALUES_DUP_STRING (return_vals, 2);
|
|
|
|
*date = GIMP_VALUES_DUP_STRING (return_vals, 3);
|
2000-05-31 21:24:14 +08:00
|
|
|
}
|
|
|
|
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (return_vals);
|
2000-08-23 09:44:59 +08:00
|
|
|
|
|
|
|
return success;
|
2000-05-31 21:24:14 +08:00
|
|
|
}
|
|
|
|
|
2019-08-05 16:46:55 +08:00
|
|
|
/**
|
2019-08-09 03:52:36 +08:00
|
|
|
* _gimp_pdb_proc_argument:
|
2019-08-05 16:46:55 +08:00
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
* @arg_num: The argument number.
|
|
|
|
*
|
|
|
|
* Queries the procedural database for information on the specified
|
|
|
|
* procedure's argument.
|
|
|
|
*
|
|
|
|
* This procedure returns the #GParamSpec of procedure_name's argument.
|
|
|
|
*
|
|
|
|
* Returns: (transfer full): The GParamSpec of the argument.
|
|
|
|
* The returned value must be freed with g_param_spec_unref().
|
|
|
|
*
|
|
|
|
* Since: 3.0
|
|
|
|
**/
|
|
|
|
GParamSpec *
|
2019-08-09 03:52:36 +08:00
|
|
|
_gimp_pdb_proc_argument (const gchar *procedure_name,
|
|
|
|
gint arg_num)
|
2019-08-05 16:46:55 +08:00
|
|
|
{
|
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
|
|
|
GParamSpec *param_spec = NULL;
|
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
2019-08-15 20:04:56 +08:00
|
|
|
G_TYPE_INT, arg_num,
|
2019-08-05 16:46:55 +08:00
|
|
|
G_TYPE_NONE);
|
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-argument",
|
|
|
|
args);
|
2019-08-05 16:46:55 +08:00
|
|
|
gimp_value_array_unref (args);
|
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
2019-09-04 08:49:33 +08:00
|
|
|
param_spec = GIMP_VALUES_DUP_PARAM (return_vals, 1);
|
2019-08-05 16:46:55 +08:00
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
|
|
|
|
return param_spec;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2019-08-09 03:52:36 +08:00
|
|
|
* _gimp_pdb_proc_return_value:
|
2019-08-05 16:46:55 +08:00
|
|
|
* @procedure_name: The procedure name.
|
|
|
|
* @val_num: The return value number.
|
|
|
|
*
|
|
|
|
* Queries the procedural database for information on the specified
|
|
|
|
* procedure's return value.
|
|
|
|
*
|
|
|
|
* This procedure returns the #GParamSpec of procedure_name's return
|
|
|
|
* value.
|
|
|
|
*
|
|
|
|
* Returns: (transfer full): The GParamSpec of the return value.
|
|
|
|
* The returned value must be freed with g_param_spec_unref().
|
|
|
|
*
|
|
|
|
* Since: 3.0
|
|
|
|
**/
|
|
|
|
GParamSpec *
|
2019-08-09 03:52:36 +08:00
|
|
|
_gimp_pdb_proc_return_value (const gchar *procedure_name,
|
|
|
|
gint val_num)
|
2019-08-05 16:46:55 +08:00
|
|
|
{
|
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
|
|
|
GParamSpec *param_spec = NULL;
|
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, procedure_name,
|
2019-08-15 20:04:56 +08:00
|
|
|
G_TYPE_INT, val_num,
|
2019-08-05 16:46:55 +08:00
|
|
|
G_TYPE_NONE);
|
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-proc-return-value",
|
|
|
|
args);
|
2019-08-05 16:46:55 +08:00
|
|
|
gimp_value_array_unref (args);
|
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
2019-09-04 08:49:33 +08:00
|
|
|
param_spec = GIMP_VALUES_DUP_PARAM (return_vals, 1);
|
2019-08-05 16:46:55 +08:00
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
|
|
|
|
return param_spec;
|
|
|
|
}
|
|
|
|
|
2000-08-25 07:06:53 +08:00
|
|
|
/**
|
2019-08-06 18:50:08 +08:00
|
|
|
* _gimp_pdb_get_data:
|
2000-08-25 07:06:53 +08:00
|
|
|
* @identifier: The identifier associated with data.
|
2019-08-01 04:51:35 +08:00
|
|
|
* @bytes: (out): The number of bytes in the data.
|
|
|
|
* @data: (out) (array length=bytes) (element-type guint8) (transfer full): A byte array containing data.
|
2000-08-25 07:06:53 +08:00
|
|
|
*
|
|
|
|
* Returns data associated with the specified identifier.
|
|
|
|
*
|
|
|
|
* This procedure returns any data which may have been associated with
|
|
|
|
* the specified identifier. The data is a variable length array of
|
|
|
|
* bytes. If no data has been associated with the identifier, an error
|
|
|
|
* is returned.
|
|
|
|
*
|
|
|
|
* Returns: TRUE on success.
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean
|
2019-08-06 18:50:08 +08:00
|
|
|
_gimp_pdb_get_data (const gchar *identifier,
|
|
|
|
gint *bytes,
|
|
|
|
guint8 **data)
|
2000-05-31 21:24:14 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean success = TRUE;
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, identifier,
|
2019-07-30 16:51:16 +08:00
|
|
|
G_TYPE_NONE);
|
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-get-data",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2000-06-02 01:34:56 +08:00
|
|
|
*bytes = 0;
|
|
|
|
*data = NULL;
|
2000-08-22 05:23:31 +08:00
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
2000-08-23 09:44:59 +08:00
|
|
|
|
|
|
|
if (success)
|
2000-05-31 21:24:14 +08:00
|
|
|
{
|
2019-09-04 08:49:33 +08:00
|
|
|
*bytes = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
|
|
*data = GIMP_VALUES_DUP_UINT8_ARRAY (return_vals, 2);
|
2000-05-31 21:24:14 +08:00
|
|
|
}
|
|
|
|
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (return_vals);
|
2000-08-23 09:44:59 +08:00
|
|
|
|
|
|
|
return success;
|
2000-06-02 01:34:56 +08:00
|
|
|
}
|
2000-05-31 21:24:14 +08:00
|
|
|
|
2000-08-25 07:06:53 +08:00
|
|
|
/**
|
2019-08-07 00:29:55 +08:00
|
|
|
* _gimp_pdb_get_data_size:
|
2000-08-25 07:06:53 +08:00
|
|
|
* @identifier: The identifier associated with data.
|
|
|
|
*
|
|
|
|
* Returns size of data associated with the specified identifier.
|
|
|
|
*
|
|
|
|
* This procedure returns the size of any data which may have been
|
|
|
|
* associated with the specified identifier. If no data has been
|
|
|
|
* associated with the identifier, an error is returned.
|
|
|
|
*
|
|
|
|
* Returns: The number of bytes in the data.
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2000-06-02 01:34:56 +08:00
|
|
|
gint
|
2019-08-07 00:29:55 +08:00
|
|
|
_gimp_pdb_get_data_size (const gchar *identifier)
|
2000-06-02 01:34:56 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2000-06-02 01:34:56 +08:00
|
|
|
gint bytes = 0;
|
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, identifier,
|
2019-07-30 16:51:16 +08:00
|
|
|
G_TYPE_NONE);
|
2000-06-02 01:34:56 +08:00
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-get-data-size",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2000-06-02 01:34:56 +08:00
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
2019-09-04 08:49:33 +08:00
|
|
|
bytes = GIMP_VALUES_GET_INT (return_vals, 1);
|
2019-07-30 16:51:16 +08:00
|
|
|
|
|
|
|
gimp_value_array_unref (return_vals);
|
2000-06-02 01:34:56 +08:00
|
|
|
|
|
|
|
return bytes;
|
|
|
|
}
|
|
|
|
|
2000-08-25 07:06:53 +08:00
|
|
|
/**
|
2019-08-06 18:50:08 +08:00
|
|
|
* _gimp_pdb_set_data:
|
2000-08-25 07:06:53 +08:00
|
|
|
* @identifier: The identifier associated with data.
|
|
|
|
* @bytes: The number of bytes in the data.
|
2019-08-01 04:51:35 +08:00
|
|
|
* @data: (array length=bytes) (element-type guint8): A byte array containing data.
|
2000-08-25 07:06:53 +08:00
|
|
|
*
|
|
|
|
* Associates the specified identifier with the supplied data.
|
|
|
|
*
|
|
|
|
* This procedure associates the supplied data with the provided
|
|
|
|
* identifier. The data may be subsequently retrieved by a call to
|
|
|
|
* 'procedural-db-get-data'.
|
|
|
|
*
|
|
|
|
* Returns: TRUE on success.
|
2010-09-16 04:07:36 +08:00
|
|
|
**/
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean
|
2019-08-06 18:50:08 +08:00
|
|
|
_gimp_pdb_set_data (const gchar *identifier,
|
|
|
|
gint bytes,
|
|
|
|
const guint8 *data)
|
2000-06-02 01:34:56 +08:00
|
|
|
{
|
2019-07-30 16:51:16 +08:00
|
|
|
GimpValueArray *args;
|
|
|
|
GimpValueArray *return_vals;
|
2000-08-23 09:44:59 +08:00
|
|
|
gboolean success = TRUE;
|
2000-06-02 01:34:56 +08:00
|
|
|
|
2019-08-08 19:01:50 +08:00
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
|
|
G_TYPE_STRING, identifier,
|
2019-08-15 20:04:56 +08:00
|
|
|
G_TYPE_INT, bytes,
|
2019-08-15 21:04:34 +08:00
|
|
|
GIMP_TYPE_UINT8_ARRAY, NULL,
|
2019-07-30 16:51:16 +08:00
|
|
|
G_TYPE_NONE);
|
2019-08-15 21:04:34 +08:00
|
|
|
gimp_value_set_uint8_array (gimp_value_array_index (args, 2), data, bytes);
|
2019-07-30 16:51:16 +08:00
|
|
|
|
2019-09-04 05:55:49 +08:00
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
|
|
"gimp-pdb-set-data",
|
|
|
|
args);
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (args);
|
2000-06-02 01:34:56 +08:00
|
|
|
|
2019-09-04 07:49:35 +08:00
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
2000-08-23 09:44:59 +08:00
|
|
|
|
2019-07-30 16:51:16 +08:00
|
|
|
gimp_value_array_unref (return_vals);
|
2000-08-23 09:44:59 +08:00
|
|
|
|
|
|
|
return success;
|
2000-05-31 21:24:14 +08:00
|
|
|
}
|