mirror of
https://gitlab.gnome.org/GNOME/gimp
synced 2024-10-21 03:52:33 +00:00
17d4af0080
2007-07-18 Sven Neumann <sven@gimp.org> * app/pdb/gimpprocedure.[ch] (gimp_procedure_set_strings): added const qualifiers. svn path=/trunk/; revision=22956
647 lines
22 KiB
C
647 lines
22 KiB
C
/* GIMP - The GNU Image Manipulation Program
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include <stdarg.h>
|
|
#include <string.h>
|
|
#include <sys/types.h>
|
|
|
|
#include <glib-object.h>
|
|
|
|
#include "libgimpbase/gimpbase.h"
|
|
#include "libgimpcolor/gimpcolor.h"
|
|
|
|
#include "pdb-types.h"
|
|
|
|
#include "core/gimp.h"
|
|
#include "core/gimp-utils.h"
|
|
#include "core/gimpcontext.h"
|
|
#include "core/gimpchannel.h"
|
|
#include "core/gimplayer.h"
|
|
#include "core/gimpparamspecs.h"
|
|
#include "core/gimpprogress.h"
|
|
|
|
#include "vectors/gimpvectors.h"
|
|
|
|
#include "gimpprocedure.h"
|
|
|
|
#include "gimp-intl.h"
|
|
|
|
|
|
static void gimp_procedure_finalize (GObject *object);
|
|
|
|
static gint64 gimp_procedure_get_memsize (GimpObject *object,
|
|
gint64 *gui_size);
|
|
|
|
static GValueArray * gimp_procedure_real_execute (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpContext *context,
|
|
GimpProgress *progress,
|
|
GValueArray *args);
|
|
static void gimp_procedure_real_execute_async (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpContext *context,
|
|
GimpProgress *progress,
|
|
GValueArray *args,
|
|
GimpObject *display);
|
|
|
|
static void gimp_procedure_free_strings (GimpProcedure *procedure);
|
|
static gboolean gimp_procedure_validate_args (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpProgress *progress,
|
|
GParamSpec **param_specs,
|
|
gint n_param_specs,
|
|
GValueArray *args,
|
|
gboolean return_vals);
|
|
|
|
|
|
G_DEFINE_TYPE (GimpProcedure, gimp_procedure, GIMP_TYPE_OBJECT)
|
|
|
|
#define parent_class gimp_procedure_parent_class
|
|
|
|
|
|
static void
|
|
gimp_procedure_class_init (GimpProcedureClass *klass)
|
|
{
|
|
GObjectClass *object_class = G_OBJECT_CLASS (klass);
|
|
GimpObjectClass *gimp_object_class = GIMP_OBJECT_CLASS (klass);
|
|
|
|
object_class->finalize = gimp_procedure_finalize;
|
|
|
|
gimp_object_class->get_memsize = gimp_procedure_get_memsize;
|
|
|
|
klass->execute = gimp_procedure_real_execute;
|
|
klass->execute_async = gimp_procedure_real_execute_async;
|
|
}
|
|
|
|
static void
|
|
gimp_procedure_init (GimpProcedure *procedure)
|
|
{
|
|
procedure->proc_type = GIMP_INTERNAL;
|
|
}
|
|
|
|
static void
|
|
gimp_procedure_finalize (GObject *object)
|
|
{
|
|
GimpProcedure *procedure = GIMP_PROCEDURE (object);
|
|
gint i;
|
|
|
|
gimp_procedure_free_strings (procedure);
|
|
|
|
if (procedure->args)
|
|
{
|
|
for (i = 0; i < procedure->num_args; i++)
|
|
g_param_spec_unref (procedure->args[i]);
|
|
|
|
g_free (procedure->args);
|
|
procedure->args = NULL;
|
|
}
|
|
|
|
if (procedure->values)
|
|
{
|
|
for (i = 0; i < procedure->num_values; i++)
|
|
g_param_spec_unref (procedure->values[i]);
|
|
|
|
g_free (procedure->values);
|
|
procedure->values = NULL;
|
|
}
|
|
|
|
G_OBJECT_CLASS (parent_class)->finalize (object);
|
|
}
|
|
|
|
static gint64
|
|
gimp_procedure_get_memsize (GimpObject *object,
|
|
gint64 *gui_size)
|
|
{
|
|
GimpProcedure *procedure = GIMP_PROCEDURE (object);
|
|
gint64 memsize = 0;
|
|
gint i;
|
|
|
|
if (! procedure->static_strings)
|
|
{
|
|
if (procedure->original_name)
|
|
memsize += strlen (procedure->original_name) + 1;
|
|
|
|
if (procedure->blurb)
|
|
memsize += strlen (procedure->blurb) + 1;
|
|
|
|
if (procedure->help)
|
|
memsize += strlen (procedure->help) + 1;
|
|
|
|
if (procedure->author)
|
|
memsize += strlen (procedure->author) + 1;
|
|
|
|
if (procedure->copyright)
|
|
memsize += strlen (procedure->copyright) + 1;
|
|
|
|
if (procedure->date)
|
|
memsize += strlen (procedure->date) + 1;
|
|
|
|
if (procedure->deprecated)
|
|
memsize += strlen (procedure->deprecated) + 1;
|
|
}
|
|
|
|
memsize += procedure->num_args * sizeof (GParamSpec *);
|
|
|
|
for (i = 0; i < procedure->num_args; i++)
|
|
memsize += gimp_g_param_spec_get_memsize (procedure->args[i]);
|
|
|
|
memsize += procedure->num_values * sizeof (GParamSpec *);
|
|
|
|
for (i = 0; i < procedure->num_values; i++)
|
|
memsize += gimp_g_param_spec_get_memsize (procedure->values[i]);
|
|
|
|
return memsize + GIMP_OBJECT_CLASS (parent_class)->get_memsize (object,
|
|
gui_size);
|
|
}
|
|
|
|
static GValueArray *
|
|
gimp_procedure_real_execute (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpContext *context,
|
|
GimpProgress *progress,
|
|
GValueArray *args)
|
|
{
|
|
g_return_val_if_fail (args->n_values >= procedure->num_args, NULL);
|
|
|
|
return procedure->marshal_func (procedure, gimp,
|
|
context, progress,
|
|
args);
|
|
}
|
|
|
|
static void
|
|
gimp_procedure_real_execute_async (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpContext *context,
|
|
GimpProgress *progress,
|
|
GValueArray *args,
|
|
GimpObject *display)
|
|
{
|
|
GValueArray *return_vals;
|
|
|
|
g_return_if_fail (args->n_values >= procedure->num_args);
|
|
|
|
return_vals = GIMP_PROCEDURE_GET_CLASS (procedure)->execute (procedure,
|
|
gimp,
|
|
context,
|
|
progress,
|
|
args);
|
|
|
|
g_value_array_free (return_vals);
|
|
}
|
|
|
|
|
|
/* public functions */
|
|
|
|
GimpProcedure *
|
|
gimp_procedure_new (GimpMarshalFunc marshal_func)
|
|
{
|
|
GimpProcedure *procedure;
|
|
|
|
g_return_val_if_fail (marshal_func != NULL, NULL);
|
|
|
|
procedure = g_object_new (GIMP_TYPE_PROCEDURE, NULL);
|
|
|
|
procedure->marshal_func = marshal_func;
|
|
|
|
return procedure;
|
|
}
|
|
|
|
void
|
|
gimp_procedure_set_strings (GimpProcedure *procedure,
|
|
const gchar *original_name,
|
|
const gchar *blurb,
|
|
const gchar *help,
|
|
const gchar *author,
|
|
const gchar *copyright,
|
|
const gchar *date,
|
|
const gchar *deprecated)
|
|
{
|
|
g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
|
|
|
|
gimp_procedure_free_strings (procedure);
|
|
|
|
procedure->original_name = g_strdup (original_name);
|
|
procedure->blurb = g_strdup (blurb);
|
|
procedure->help = g_strdup (help);
|
|
procedure->author = g_strdup (author);
|
|
procedure->copyright = g_strdup (copyright);
|
|
procedure->date = g_strdup (date);
|
|
procedure->deprecated = g_strdup (deprecated);
|
|
|
|
procedure->static_strings = FALSE;
|
|
}
|
|
|
|
void
|
|
gimp_procedure_set_static_strings (GimpProcedure *procedure,
|
|
gchar *original_name,
|
|
gchar *blurb,
|
|
gchar *help,
|
|
gchar *author,
|
|
gchar *copyright,
|
|
gchar *date,
|
|
gchar *deprecated)
|
|
{
|
|
g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
|
|
|
|
gimp_procedure_free_strings (procedure);
|
|
|
|
procedure->original_name = original_name;
|
|
procedure->blurb = blurb;
|
|
procedure->help = help;
|
|
procedure->author = author;
|
|
procedure->copyright = copyright;
|
|
procedure->date = date;
|
|
procedure->deprecated = deprecated;
|
|
|
|
procedure->static_strings = TRUE;
|
|
}
|
|
|
|
void
|
|
gimp_procedure_take_strings (GimpProcedure *procedure,
|
|
gchar *original_name,
|
|
gchar *blurb,
|
|
gchar *help,
|
|
gchar *author,
|
|
gchar *copyright,
|
|
gchar *date,
|
|
gchar *deprecated)
|
|
{
|
|
g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
|
|
|
|
gimp_procedure_free_strings (procedure);
|
|
|
|
procedure->original_name = original_name;
|
|
procedure->blurb = blurb;
|
|
procedure->help = help;
|
|
procedure->author = author;
|
|
procedure->copyright = copyright;
|
|
procedure->date = date;
|
|
procedure->deprecated = deprecated;
|
|
|
|
procedure->static_strings = FALSE;
|
|
}
|
|
|
|
GValueArray *
|
|
gimp_procedure_execute (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpContext *context,
|
|
GimpProgress *progress,
|
|
GValueArray *args)
|
|
{
|
|
GValueArray *return_vals = NULL;
|
|
|
|
g_return_val_if_fail (GIMP_IS_PROCEDURE (procedure), NULL);
|
|
g_return_val_if_fail (GIMP_IS_GIMP (gimp), NULL);
|
|
g_return_val_if_fail (GIMP_IS_CONTEXT (context), NULL);
|
|
g_return_val_if_fail (progress == NULL || GIMP_IS_PROGRESS (progress), NULL);
|
|
g_return_val_if_fail (args != NULL, NULL);
|
|
|
|
if (! gimp_procedure_validate_args (procedure, gimp, progress,
|
|
procedure->args, procedure->num_args,
|
|
args, FALSE))
|
|
{
|
|
return_vals = gimp_procedure_get_return_values (procedure, FALSE);
|
|
g_value_set_enum (return_vals->values, GIMP_PDB_CALLING_ERROR);
|
|
|
|
return return_vals;
|
|
}
|
|
|
|
/* call the procedure */
|
|
return_vals = GIMP_PROCEDURE_GET_CLASS (procedure)->execute (procedure,
|
|
gimp,
|
|
context,
|
|
progress,
|
|
args);
|
|
|
|
/* If there are no return arguments, assume an execution error */
|
|
if (! return_vals)
|
|
{
|
|
return_vals = gimp_procedure_get_return_values (procedure, FALSE);
|
|
g_value_set_enum (return_vals->values, GIMP_PDB_EXECUTION_ERROR);
|
|
|
|
return return_vals;
|
|
}
|
|
|
|
return return_vals;
|
|
}
|
|
|
|
void
|
|
gimp_procedure_execute_async (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpContext *context,
|
|
GimpProgress *progress,
|
|
GValueArray *args,
|
|
GimpObject *display)
|
|
{
|
|
g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
|
|
g_return_if_fail (GIMP_IS_GIMP (gimp));
|
|
g_return_if_fail (GIMP_IS_CONTEXT (context));
|
|
g_return_if_fail (progress == NULL || GIMP_IS_PROGRESS (progress));
|
|
g_return_if_fail (args != NULL);
|
|
g_return_if_fail (display == NULL || GIMP_IS_OBJECT (display));
|
|
|
|
if (gimp_procedure_validate_args (procedure, gimp, progress,
|
|
procedure->args, procedure->num_args,
|
|
args, FALSE))
|
|
{
|
|
GIMP_PROCEDURE_GET_CLASS (procedure)->execute_async (procedure, gimp,
|
|
context, progress,
|
|
args, display);
|
|
}
|
|
}
|
|
|
|
GValueArray *
|
|
gimp_procedure_get_arguments (GimpProcedure *procedure)
|
|
{
|
|
GValueArray *args;
|
|
GValue value = { 0, };
|
|
gint i;
|
|
|
|
g_return_val_if_fail (GIMP_IS_PROCEDURE (procedure), NULL);
|
|
|
|
args = g_value_array_new (procedure->num_args);
|
|
|
|
for (i = 0; i < procedure->num_args; i++)
|
|
{
|
|
g_value_init (&value, G_PARAM_SPEC_VALUE_TYPE (procedure->args[i]));
|
|
g_value_array_append (args, &value);
|
|
g_value_unset (&value);
|
|
}
|
|
|
|
return args;
|
|
}
|
|
|
|
GValueArray *
|
|
gimp_procedure_get_return_values (GimpProcedure *procedure,
|
|
gboolean success)
|
|
{
|
|
GValueArray *args;
|
|
GValue value = { 0, };
|
|
gint n_args;
|
|
gint i;
|
|
|
|
g_return_val_if_fail (GIMP_IS_PROCEDURE (procedure) ||
|
|
success == FALSE, NULL);
|
|
|
|
if (procedure)
|
|
n_args = procedure->num_values + 1;
|
|
else
|
|
n_args = 1;
|
|
|
|
args = g_value_array_new (n_args);
|
|
|
|
g_value_init (&value, GIMP_TYPE_PDB_STATUS_TYPE);
|
|
g_value_set_enum (&value,
|
|
success ? GIMP_PDB_SUCCESS : GIMP_PDB_EXECUTION_ERROR);
|
|
g_value_array_append (args, &value);
|
|
g_value_unset (&value);
|
|
|
|
if (procedure)
|
|
for (i = 0; i < procedure->num_values; i++)
|
|
{
|
|
g_value_init (&value, G_PARAM_SPEC_VALUE_TYPE (procedure->values[i]));
|
|
g_value_array_append (args, &value);
|
|
g_value_unset (&value);
|
|
}
|
|
|
|
return args;
|
|
}
|
|
|
|
void
|
|
gimp_procedure_add_argument (GimpProcedure *procedure,
|
|
GParamSpec *pspec)
|
|
{
|
|
g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
|
|
g_return_if_fail (G_IS_PARAM_SPEC (pspec));
|
|
|
|
procedure->args = g_renew (GParamSpec *, procedure->args,
|
|
procedure->num_args + 1);
|
|
|
|
procedure->args[procedure->num_args] = pspec;
|
|
|
|
g_param_spec_ref (pspec);
|
|
g_param_spec_sink (pspec);
|
|
|
|
procedure->num_args++;
|
|
}
|
|
|
|
void
|
|
gimp_procedure_add_return_value (GimpProcedure *procedure,
|
|
GParamSpec *pspec)
|
|
{
|
|
g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
|
|
g_return_if_fail (G_IS_PARAM_SPEC (pspec));
|
|
|
|
procedure->values = g_renew (GParamSpec *, procedure->values,
|
|
procedure->num_values + 1);
|
|
|
|
procedure->values[procedure->num_values] = pspec;
|
|
|
|
g_param_spec_ref (pspec);
|
|
g_param_spec_sink (pspec);
|
|
|
|
procedure->num_values++;
|
|
}
|
|
|
|
|
|
/* private functions */
|
|
|
|
static void
|
|
gimp_procedure_free_strings (GimpProcedure *procedure)
|
|
{
|
|
if (! procedure->static_strings)
|
|
{
|
|
g_free (procedure->original_name);
|
|
g_free (procedure->blurb);
|
|
g_free (procedure->help);
|
|
g_free (procedure->author);
|
|
g_free (procedure->copyright);
|
|
g_free (procedure->date);
|
|
g_free (procedure->deprecated);
|
|
}
|
|
|
|
procedure->original_name = NULL;
|
|
procedure->blurb = NULL;
|
|
procedure->help = NULL;
|
|
procedure->author = NULL;
|
|
procedure->copyright = NULL;
|
|
procedure->date = NULL;
|
|
procedure->deprecated = NULL;
|
|
|
|
procedure->static_strings = FALSE;
|
|
}
|
|
|
|
static gboolean
|
|
gimp_procedure_validate_args (GimpProcedure *procedure,
|
|
Gimp *gimp,
|
|
GimpProgress *progress,
|
|
GParamSpec **param_specs,
|
|
gint n_param_specs,
|
|
GValueArray *args,
|
|
gboolean return_vals)
|
|
{
|
|
gint i;
|
|
|
|
for (i = 0; i < MIN (args->n_values, n_param_specs); i++)
|
|
{
|
|
GValue *arg = &args->values[i];
|
|
GParamSpec *pspec = param_specs[i];
|
|
GType arg_type = G_VALUE_TYPE (arg);
|
|
GType spec_type = G_PARAM_SPEC_VALUE_TYPE (pspec);
|
|
|
|
if (arg_type != spec_type)
|
|
{
|
|
if (return_vals)
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' returned a wrong value type "
|
|
"for return value '%s' (#%d). "
|
|
"Expected %s, got %s."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_param_spec_get_name (pspec),
|
|
i + 1, g_type_name (spec_type),
|
|
g_type_name (arg_type));
|
|
}
|
|
else
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' has been called with a "
|
|
"wrong value type for argument '%s' (#%d). "
|
|
"Expected %s, got %s."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_param_spec_get_name (pspec),
|
|
i + 1, g_type_name (spec_type),
|
|
g_type_name (arg_type));
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
else if (! (pspec->flags & GIMP_PARAM_NO_VALIDATE))
|
|
{
|
|
GValue string_value = { 0, };
|
|
|
|
g_value_init (&string_value, G_TYPE_STRING);
|
|
|
|
if (g_value_type_transformable (arg_type, G_TYPE_STRING))
|
|
g_value_transform (arg, &string_value);
|
|
else
|
|
g_value_set_static_string (&string_value,
|
|
"<not transformable to string>");
|
|
|
|
if (g_param_value_validate (pspec, arg))
|
|
{
|
|
if (GIMP_IS_PARAM_SPEC_DRAWABLE_ID (pspec) &&
|
|
g_value_get_int (arg) == -1)
|
|
{
|
|
if (return_vals)
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' returned an "
|
|
"invalid ID for argument '%s'. "
|
|
"Most likely a plug-in is trying "
|
|
"to work on a layer that doesn't "
|
|
"exist any longer."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_param_spec_get_name (pspec));
|
|
}
|
|
else
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' has been called with an "
|
|
"invalid ID for argument '%s'. "
|
|
"Most likely a plug-in is trying "
|
|
"to work on a layer that doesn't "
|
|
"exist any longer."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_param_spec_get_name (pspec));
|
|
}
|
|
}
|
|
else if (GIMP_IS_PARAM_SPEC_IMAGE_ID (pspec) &&
|
|
g_value_get_int (arg) == -1)
|
|
{
|
|
if (return_vals)
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' returned an "
|
|
"invalid ID for argument '%s'. "
|
|
"Most likely a plug-in is trying "
|
|
"to work on an image that doesn't "
|
|
"exist any longer."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_param_spec_get_name (pspec));
|
|
}
|
|
else
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' has been called with an "
|
|
"invalid ID for argument '%s'. "
|
|
"Most likely a plug-in is trying "
|
|
"to work on an image that doesn't "
|
|
"exist any longer."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_param_spec_get_name (pspec));
|
|
}
|
|
}
|
|
else
|
|
{
|
|
if (return_vals)
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' returned "
|
|
"'%s' as return value '%s' "
|
|
"(#%d, type %s). "
|
|
"This value is out of range."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_value_get_string (&string_value),
|
|
g_param_spec_get_name (pspec),
|
|
i + 1, g_type_name (spec_type));
|
|
}
|
|
else
|
|
{
|
|
gimp_message (gimp, G_OBJECT (progress),
|
|
GIMP_MESSAGE_ERROR,
|
|
_("Procedure '%s' has been called with "
|
|
"value '%s' for argument '%s' "
|
|
"(#%d, type %s). "
|
|
"This value is out of range."),
|
|
gimp_object_get_name (GIMP_OBJECT (procedure)),
|
|
g_value_get_string (&string_value),
|
|
g_param_spec_get_name (pspec),
|
|
i + 1, g_type_name (spec_type));
|
|
}
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
g_value_unset (&string_value);
|
|
}
|
|
}
|
|
|
|
return TRUE;
|
|
}
|