summaryrefslogtreecommitdiffstats
path: root/app/core/gimpparamspecs-desc.c
diff options
context:
space:
mode:
Diffstat (limited to 'app/core/gimpparamspecs-desc.c')
-rw-r--r--app/core/gimpparamspecs-desc.c193
1 files changed, 193 insertions, 0 deletions
diff --git a/app/core/gimpparamspecs-desc.c b/app/core/gimpparamspecs-desc.c
new file mode 100644
index 0000000..a59f14f
--- /dev/null
+++ b/app/core/gimpparamspecs-desc.c
@@ -0,0 +1,193 @@
+/* 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 3 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, see <https://www.gnu.org/licenses/>.
+ */
+
+#include "config.h"
+
+#include <string.h>
+
+#include <gio/gio.h>
+
+#include "libgimpbase/gimpbase.h"
+
+#include "core-types.h"
+
+#include "gimpparamspecs.h"
+#include "gimpparamspecs-desc.h"
+
+
+static inline const gchar *
+gimp_param_spec_get_blurb (GParamSpec *pspec)
+{
+ const gchar *blurb = g_param_spec_get_blurb (pspec);
+
+ return blurb ? blurb : "";
+}
+
+static gchar *
+gimp_param_spec_boolean_desc (GParamSpec *pspec)
+{
+ const gchar *blurb = gimp_param_spec_get_blurb (pspec);
+
+ return g_strconcat (blurb, " (TRUE or FALSE)", NULL);
+}
+
+static gchar *
+gimp_param_spec_int32_desc (GParamSpec *pspec)
+{
+ GParamSpecInt *ispec = G_PARAM_SPEC_INT (pspec);
+ const gchar *blurb = gimp_param_spec_get_blurb (pspec);
+
+ if (ispec->minimum == G_MININT32 && ispec->maximum == G_MAXINT32)
+ return g_strdup (blurb);
+
+ if (ispec->minimum == G_MININT32)
+ return g_strdup_printf ("%s (%s <= %d)", blurb,
+ g_param_spec_get_name (pspec),
+ ispec->maximum);
+
+ if (ispec->maximum == G_MAXINT32)
+ return g_strdup_printf ("%s (%s >= %d)", blurb,
+ g_param_spec_get_name (pspec),
+ ispec->minimum);
+
+ return g_strdup_printf ("%s (%d <= %s <= %d)", blurb,
+ ispec->minimum,
+ g_param_spec_get_name (pspec),
+ ispec->maximum);
+}
+
+static gchar *
+gimp_param_spec_double_desc (GParamSpec *pspec)
+{
+ GParamSpecDouble *dspec = G_PARAM_SPEC_DOUBLE (pspec);
+ const gchar *blurb = gimp_param_spec_get_blurb (pspec);
+
+ if (dspec->minimum == - G_MAXDOUBLE && dspec->maximum == G_MAXDOUBLE)
+ return g_strdup (blurb);
+
+ if (dspec->minimum == - G_MAXDOUBLE)
+ return g_strdup_printf ("%s (%s <= %g)", blurb,
+ g_param_spec_get_name (pspec),
+ dspec->maximum);
+
+ if (dspec->maximum == G_MAXDOUBLE)
+ return g_strdup_printf ("%s (%s >= %g)", blurb,
+ g_param_spec_get_name (pspec),
+ dspec->minimum);
+
+ return g_strdup_printf ("%s (%g <= %s <= %g)", blurb,
+ dspec->minimum,
+ g_param_spec_get_name (pspec),
+ dspec->maximum);
+}
+
+static gchar *
+gimp_param_spec_enum_desc (GParamSpec *pspec)
+{
+ const gchar *blurb = gimp_param_spec_get_blurb (pspec);
+ GString *str = g_string_new (blurb);
+ GEnumClass *enum_class = g_type_class_peek (pspec->value_type);
+ GEnumValue *enum_value;
+ GSList *excluded;
+ gint i, n;
+
+ if (GIMP_IS_PARAM_SPEC_ENUM (pspec))
+ excluded = GIMP_PARAM_SPEC_ENUM (pspec)->excluded_values;
+ else
+ excluded = NULL;
+
+ g_string_append (str, " { ");
+
+ for (i = 0, n = 0, enum_value = enum_class->values;
+ i < enum_class->n_values;
+ i++, enum_value++)
+ {
+ GSList *list;
+ gchar *name;
+
+ for (list = excluded; list; list = list->next)
+ {
+ gint value = GPOINTER_TO_INT (list->data);
+
+ if (value == enum_value->value)
+ break;
+ }
+
+ if (list)
+ continue;
+
+ if (n > 0)
+ g_string_append (str, ", ");
+
+ if (G_LIKELY (g_str_has_prefix (enum_value->value_name, "GIMP_")))
+ name = gimp_canonicalize_identifier (enum_value->value_name + 5);
+ else
+ name = gimp_canonicalize_identifier (enum_value->value_name);
+
+ g_string_append (str, name);
+ g_free (name);
+
+ g_string_append_printf (str, " (%d)", enum_value->value);
+
+ n++;
+ }
+
+ g_string_append (str, " }");
+
+ return g_string_free (str, FALSE);
+}
+
+/**
+ * gimp_param_spec_get_desc:
+ * @pspec: a #GParamSpec
+ *
+ * This function creates a description of the passed @pspec, which is
+ * suitable for use in the PDB. Actually, it currently only deals with
+ * parameter types used in the PDB and should not be used for anything
+ * else.
+ *
+ * Return value: A newly allocated string describing the parameter.
+ */
+gchar *
+gimp_param_spec_get_desc (GParamSpec *pspec)
+{
+ g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), NULL);
+
+ if (GIMP_IS_PARAM_SPEC_UNIT (pspec))
+ {
+ }
+ else if (GIMP_IS_PARAM_SPEC_INT32 (pspec))
+ {
+ return gimp_param_spec_int32_desc (pspec);
+ }
+ else
+ {
+ switch (G_TYPE_FUNDAMENTAL (pspec->value_type))
+ {
+ case G_TYPE_BOOLEAN:
+ return gimp_param_spec_boolean_desc (pspec);
+
+ case G_TYPE_DOUBLE:
+ return gimp_param_spec_double_desc (pspec);
+
+ case G_TYPE_ENUM:
+ return gimp_param_spec_enum_desc (pspec);
+ }
+ }
+
+ return g_strdup (g_param_spec_get_blurb (pspec));
+}