[gimp] libgimp: reorder functions and members of GimpProcedure



commit 550ec68cffdb4dcd05342598828a5508cef2aa36
Author: Michael Natterer <mitch gimp org>
Date:   Mon Aug 5 23:01:25 2019 +0200

    libgimp: reorder functions and members of GimpProcedure
    
    to make more sense, as long as the file has little git history.

 libgimp/gimpprocedure.c         | 225 ++++++++++++++++++++--------------------
 libgimp/gimpprocedure.h         |  16 +--
 plug-ins/common/goat-exercise.c |   8 +-
 3 files changed, 126 insertions(+), 123 deletions(-)
---
diff --git a/libgimp/gimpprocedure.c b/libgimp/gimpprocedure.c
index 9cb8b03bbd..315b3acef2 100644
--- a/libgimp/gimpprocedure.c
+++ b/libgimp/gimpprocedure.c
@@ -55,30 +55,33 @@ gimp_pdb_error_quark (void)
 
 struct _GimpProcedurePrivate
 {
-  GimpPlugIn       *plug_in;        /* the procedure's plug-in        */
-  GimpPDBProcType   proc_type;      /* procedure type                 */
+  GimpPlugIn       *plug_in;
+
+  gchar            *name;
+  GimpPDBProcType   proc_type;
+
+  gchar            *image_types;
 
-  gchar            *name;           /* procedure name                 */
   gchar            *menu_label;
-  gchar            *blurb;          /* Short procedure description    */
-  gchar            *help;           /* Detailed help instructions     */
+  GList            *menu_paths;
+
+  gchar            *blurb;
+  gchar            *help;
   gchar            *help_id;
-  gchar            *authors;        /* Authors field                  */
-  gchar            *copyright;      /* Copyright field                */
-  gchar            *date;           /* Date field                     */
-  gchar            *image_types;
+
+  gchar            *authors;
+  gchar            *copyright;
+  gchar            *date;
 
   GimpIconType      icon_type;
   guint8           *icon_data;
   gint              icon_data_length;
 
-  GList            *menu_paths;
-
-  gint32            n_args;         /* Number of procedure arguments  */
-  GParamSpec      **args;           /* Array of procedure arguments   */
+  gint32            n_args;
+  GParamSpec      **args;
 
-  gint32            n_values;       /* Number of return values        */
-  GParamSpec      **values;         /* Array of return values         */
+  gint32            n_values;
+  GParamSpec      **values;
 
   GimpRunFunc       run_func;
   gpointer          run_data;
@@ -127,6 +130,7 @@ gimp_procedure_finalize (GObject *object)
   g_clear_object  (&procedure->priv->plug_in);
 
   g_clear_pointer (&procedure->priv->name,        g_free);
+  g_clear_pointer (&procedure->priv->image_types, g_free);
   g_clear_pointer (&procedure->priv->menu_label,  g_free);
   g_clear_pointer (&procedure->priv->blurb,       g_free);
   g_clear_pointer (&procedure->priv->help,        g_free);
@@ -134,14 +138,13 @@ gimp_procedure_finalize (GObject *object)
   g_clear_pointer (&procedure->priv->authors,     g_free);
   g_clear_pointer (&procedure->priv->copyright,   g_free);
   g_clear_pointer (&procedure->priv->date,        g_free);
-  g_clear_pointer (&procedure->priv->image_types, g_free);
-
-  g_clear_pointer (&procedure->priv->icon_data, g_free);
-  procedure->priv->icon_data_length = 0;
 
   g_list_free_full (procedure->priv->menu_paths, g_free);
   procedure->priv->menu_paths = NULL;
 
+  g_clear_pointer (&procedure->priv->icon_data, g_free);
+  procedure->priv->icon_data_length = 0;
+
   if (procedure->priv->args)
     {
       for (i = 0; i < procedure->priv->n_args; i++)
@@ -283,6 +286,48 @@ gimp_procedure_get_proc_type (GimpProcedure *procedure)
   return procedure->priv->proc_type;
 }
 
+/**
+ * gimp_procedure_set_image_types:
+ * @image_types the image types this procedure can operate on.
+ *
+ * This is a comma separated list of image types, or actually drawable
+ * types, that this procedure can deal with. Wildcards are possible
+ * here, so you could say "RGB*" instead of "RGB, RGBA" or "*" for all
+ * image types.
+ *
+ * Supported types are "RGB", "GRAY", "INDEXED" and their variants
+ * with alpha.
+ *
+ * Since: 3.0
+ **/
+void
+gimp_procedure_set_image_types (GimpProcedure *procedure,
+                                const gchar   *image_types)
+{
+  g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
+
+  g_free (procedure->priv->image_types);
+  procedure->priv->image_types = g_strdup (image_types);
+}
+
+/**
+ * gimp_procedure_get_image_types:
+ *
+ * This procedure retrieves the list of image types the procedure can
+ * operate on. See gimp_procedure_set_image_types().
+ *
+ * Returns: The image types.
+ *
+ * Since: 3.0
+ **/
+const gchar *
+gimp_procedure_get_image_types (GimpProcedure *procedure)
+{
+  g_return_val_if_fail (GIMP_IS_PROCEDURE (procedure), NULL);
+
+  return procedure->priv->image_types;
+}
+
 /**
  * gimp_procedure_set_menu_label:
  * @procedure:  A #GimpProcedure.
@@ -326,6 +371,56 @@ gimp_procedure_get_menu_label (GimpProcedure *procedure)
   return procedure->priv->menu_label;
 }
 
+/**
+ * gimp_procedure_add_menu_path:
+ * @procedure: A #GimpProcedure.
+ * @menu_path: The @procedure's additional menu path.
+ *
+ * Adds a menu path to te procedure. Only procedures which have a menu
+ * label can add a menu path.
+ *
+ * Menu paths are untranslated paths to menus and submenus with the
+ * syntax:
+ *
+ * &lt;Prefix&gt;/Path/To/Submenu
+ *
+ * for instance:
+ *
+ * &lt;Image&gt;/Layer/Transform
+ *
+ * See also: gimp_plug_in_add_menu_branch().
+ *
+ * Since: 3.0
+ **/
+void
+gimp_procedure_add_menu_path (GimpProcedure *procedure,
+                              const gchar   *menu_path)
+{
+  g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
+  g_return_if_fail (menu_path != NULL);
+  g_return_if_fail (procedure->priv->menu_label != NULL);
+
+  procedure->priv->menu_paths = g_list_append (procedure->priv->menu_paths,
+                                               g_strdup (menu_path));
+}
+
+/**
+ * gimp_procedure_get_menu_paths:
+ * @procedure: A #GimpProcedure.
+ *
+ * Returns: (transfer none) (element-type gchar*): the @procedure's
+ *          menu paths as added with gimp_procedure_add_menu_path().
+ *
+ * Since: 3.0
+ **/
+GList *
+gimp_procedure_get_menu_paths (GimpProcedure *procedure)
+{
+  g_return_val_if_fail (GIMP_IS_PROCEDURE (procedure), NULL);
+
+  return procedure->priv->menu_paths;
+}
+
 /**
  * gimp_procedure_set_documentation:
  * @procedure: A #GimpProcedure.
@@ -495,48 +590,6 @@ gimp_procedure_get_date (GimpProcedure *procedure)
   return procedure->priv->date;
 }
 
-/**
- * gimp_procedure_set_image_types:
- * @image_types the image types this procedure can operate on.
- *
- * This is a comma separated list of image types, or actually drawable
- * types, that this procedure can deal with. Wildcards are possible
- * here, so you could say "RGB*" instead of "RGB, RGBA" or "*" for all
- * image types.
- *
- * Supported types are "RGB", "GRAY", "INDEXED" and their variants
- * with alpha.
- *
- * Since: 3.0
- **/
-void
-gimp_procedure_set_image_types (GimpProcedure *procedure,
-                                const gchar   *image_types)
-{
-  g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
-
-  g_free (procedure->priv->image_types);
-  procedure->priv->image_types = g_strdup (image_types);
-}
-
-/**
- * gimp_procedure_get_image_types:
- *
- * This procedure retrieves the list of image types the procedure can
- * operate on. See gimp_procedure_set_image_types().
- *
- * Returns: The image types.
- *
- * Since: 3.0
- **/
-const gchar *
-gimp_procedure_get_image_types (GimpProcedure *procedure)
-{
-  g_return_val_if_fail (GIMP_IS_PROCEDURE (procedure), NULL);
-
-  return procedure->priv->image_types;
-}
-
 void
 gimp_procedure_set_icon (GimpProcedure *procedure,
                          GimpIconType   icon_type,
@@ -592,56 +645,6 @@ gimp_procedure_get_icon (GimpProcedure  *procedure,
   return procedure->priv->icon_type;
 }
 
-/**
- * gimp_procedure_add_menu_path:
- * @procedure: A #GimpProcedure.
- * @menu_path: The @procedure's additional menu path.
- *
- * Adds a menu path to te procedure. Only procedures which have a menu
- * label can add a menu path.
- *
- * Menu paths are untranslated paths to menus and submenus with the
- * syntax:
- *
- * &lt;Prefix&gt;/Path/To/Submenu
- *
- * for instance:
- *
- * &lt;Image&gt;/Layer/Transform
- *
- * See also: gimp_plug_in_add_menu_branch().
- *
- * Since: 3.0
- **/
-void
-gimp_procedure_add_menu_path (GimpProcedure *procedure,
-                              const gchar   *menu_path)
-{
-  g_return_if_fail (GIMP_IS_PROCEDURE (procedure));
-  g_return_if_fail (menu_path != NULL);
-  g_return_if_fail (procedure->priv->menu_label != NULL);
-
-  procedure->priv->menu_paths = g_list_append (procedure->priv->menu_paths,
-                                               g_strdup (menu_path));
-}
-
-/**
- * gimp_procedure_get_menu_paths:
- * @procedure: A #GimpProcedure.
- *
- * Returns: (transfer none) (element-type gchar*): the @procedure's
- *          menu paths as added with gimp_procedure_add_menu_path().
- *
- * Since: 3.0
- **/
-GList *
-gimp_procedure_get_menu_paths (GimpProcedure *procedure)
-{
-  g_return_val_if_fail (GIMP_IS_PROCEDURE (procedure), NULL);
-
-  return procedure->priv->menu_paths;
-}
-
 /**
  * gimp_procedure_add_argument:
  * @procedure: the #GimpProcedure.
diff --git a/libgimp/gimpprocedure.h b/libgimp/gimpprocedure.h
index c1143c4a81..610f35f8ac 100644
--- a/libgimp/gimpprocedure.h
+++ b/libgimp/gimpprocedure.h
@@ -86,10 +86,18 @@ GimpPlugIn     * gimp_procedure_get_plug_in        (GimpProcedure     *procedure
 const gchar    * gimp_procedure_get_name           (GimpProcedure     *procedure);
 GimpPDBProcType  gimp_procedure_get_proc_type      (GimpProcedure     *procedure);
 
+void             gimp_procedure_set_image_types    (GimpProcedure     *procedure,
+                                                    const gchar       *image_types);
+const gchar    * gimp_procedure_get_image_types    (GimpProcedure     *procedure);
+
 void             gimp_procedure_set_menu_label     (GimpProcedure     *procedure,
                                                     const gchar       *menu_label);
 const gchar    * gimp_procedure_get_menu_label     (GimpProcedure     *procedure);
 
+void             gimp_procedure_add_menu_path      (GimpProcedure     *procedure,
+                                                    const gchar       *menu_path);
+GList          * gimp_procedure_get_menu_paths     (GimpProcedure     *procedure);
+
 void             gimp_procedure_set_documentation  (GimpProcedure     *procedure,
                                                     const gchar       *blurb,
                                                     const gchar       *help,
@@ -106,10 +114,6 @@ const gchar    * gimp_procedure_get_authors        (GimpProcedure     *procedure
 const gchar    * gimp_procedure_get_copyright      (GimpProcedure     *procedure);
 const gchar    * gimp_procedure_get_date           (GimpProcedure     *procedure);
 
-void             gimp_procedure_set_image_types    (GimpProcedure     *procedure,
-                                                    const gchar       *image_types);
-const gchar    * gimp_procedure_get_image_types    (GimpProcedure     *procedure);
-
 void             gimp_procedure_set_icon           (GimpProcedure     *procedure,
                                                     GimpIconType       icon_type,
                                                     const guint8      *icon_data);
@@ -117,10 +121,6 @@ GimpIconType     gimp_procedure_get_icon           (GimpProcedure     *procedure
                                                     const guint8     **icon_data,
                                                     gint              *icon_data_length);
 
-void             gimp_procedure_add_menu_path      (GimpProcedure     *procedure,
-                                                    const gchar       *menu_path);
-GList          * gimp_procedure_get_menu_paths     (GimpProcedure     *procedure);
-
 void             gimp_procedure_add_argument       (GimpProcedure     *procedure,
                                                     GParamSpec        *pspec);
 void             gimp_procedure_add_argument_from_property
diff --git a/plug-ins/common/goat-exercise.c b/plug-ins/common/goat-exercise.c
index 6e26a9e1cd..e04e4c9d30 100644
--- a/plug-ins/common/goat-exercise.c
+++ b/plug-ins/common/goat-exercise.c
@@ -97,7 +97,11 @@ goat_create_procedure (GimpPlugIn  *plug_in,
       procedure = gimp_procedure_new (plug_in, name, GIMP_PLUGIN,
                                       goat_run, NULL, NULL);
 
+      gimp_procedure_set_image_types (procedure,
+                                      "RGB*, INDEXED*, GRAY*");
+
       gimp_procedure_set_menu_label (procedure, N_("Goat-e_xercise"));
+      gimp_procedure_add_menu_path (procedure, "<Image>/Filters");
 
       gimp_procedure_set_documentation (procedure,
                                         N_("Exercise a goat"),
@@ -109,10 +113,6 @@ goat_create_procedure (GimpPlugIn  *plug_in,
                                       "Øyvind Kolås <pippin gimp org>",
                                       "21march 2012");
 
-      gimp_procedure_set_image_types (procedure,
-                                      "RGB*, INDEXED*, GRAY*");
-
-      gimp_procedure_add_menu_path (procedure, "<Image>/Filters");
       gimp_procedure_set_icon (procedure, GIMP_ICON_TYPE_ICON_NAME,
                                (const guint8 *) GIMP_ICON_GEGL);
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]