summaryrefslogtreecommitdiffstats
path: root/app/core/gimp-utils.c
diff options
context:
space:
mode:
Diffstat (limited to 'app/core/gimp-utils.c')
-rw-r--r--app/core/gimp-utils.c1098
1 files changed, 1098 insertions, 0 deletions
diff --git a/app/core/gimp-utils.c b/app/core/gimp-utils.c
new file mode 100644
index 0000000..d3df098
--- /dev/null
+++ b/app/core/gimp-utils.c
@@ -0,0 +1,1098 @@
+/* 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 <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <locale.h>
+
+#ifdef HAVE__NL_MEASUREMENT_MEASUREMENT
+#include <langinfo.h>
+#endif
+
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+
+#include <glib.h>
+
+#ifdef G_OS_WIN32
+#define _WIN32_WINNT 0x0500
+#include <windows.h>
+#include <process.h>
+#endif
+
+#if defined(G_OS_UNIX) && defined(HAVE_EXECINFO_H)
+/* For get_backtrace() */
+#include <stdlib.h>
+#include <string.h>
+#include <execinfo.h>
+#endif
+
+#include <cairo.h>
+#include <gegl.h>
+#include <gobject/gvaluecollector.h>
+#include <gdk-pixbuf/gdk-pixbuf.h>
+
+#include "libgimpbase/gimpbase.h"
+#include "libgimpmath/gimpmath.h"
+#include "libgimpcolor/gimpcolor.h"
+
+#include "core-types.h"
+
+#include "gimp.h"
+#include "gimp-utils.h"
+#include "gimpasync.h"
+#include "gimpcontext.h"
+#include "gimperror.h"
+
+#include "gimp-intl.h"
+
+
+#define MAX_FUNC 100
+
+
+gint
+gimp_get_pid (void)
+{
+ return (gint) getpid ();
+}
+
+guint64
+gimp_get_physical_memory_size (void)
+{
+#ifdef G_OS_UNIX
+#if defined(HAVE_UNISTD_H) && defined(_SC_PHYS_PAGES) && defined (_SC_PAGE_SIZE)
+ return (guint64) sysconf (_SC_PHYS_PAGES) * sysconf (_SC_PAGE_SIZE);
+#endif
+#endif
+
+#ifdef G_OS_WIN32
+# if defined(_MSC_VER) && (_MSC_VER <= 1200)
+ MEMORYSTATUS memory_status;
+ memory_status.dwLength = sizeof (memory_status);
+
+ GlobalMemoryStatus (&memory_status);
+ return memory_status.dwTotalPhys;
+# else
+ /* requires w2k and newer SDK than provided with msvc6 */
+ MEMORYSTATUSEX memory_status;
+
+ memory_status.dwLength = sizeof (memory_status);
+
+ if (GlobalMemoryStatusEx (&memory_status))
+ return memory_status.ullTotalPhys;
+# endif
+#endif
+
+ return 0;
+}
+
+/*
+ * basically copied from gtk_get_default_language()
+ */
+gchar *
+gimp_get_default_language (const gchar *category)
+{
+ gchar *lang;
+ gchar *p;
+ gint cat = LC_CTYPE;
+
+ if (! category)
+ category = "LC_CTYPE";
+
+#ifdef G_OS_WIN32
+
+ p = getenv ("LC_ALL");
+ if (p != NULL)
+ lang = g_strdup (p);
+ else
+ {
+ p = getenv ("LANG");
+ if (p != NULL)
+ lang = g_strdup (p);
+ else
+ {
+ p = getenv (category);
+ if (p != NULL)
+ lang = g_strdup (p);
+ else
+ lang = g_win32_getlocale ();
+ }
+ }
+
+#else
+
+ if (strcmp (category, "LC_CTYPE") == 0)
+ cat = LC_CTYPE;
+ else if (strcmp (category, "LC_MESSAGES") == 0)
+ cat = LC_MESSAGES;
+ else
+ g_warning ("unsupported category used with gimp_get_default_language()");
+
+ lang = g_strdup (setlocale (cat, NULL));
+
+#endif
+
+ p = strchr (lang, '.');
+ if (p)
+ *p = '\0';
+ p = strchr (lang, '@');
+ if (p)
+ *p = '\0';
+
+ return lang;
+}
+
+GimpUnit
+gimp_get_default_unit (void)
+{
+#if defined (HAVE__NL_MEASUREMENT_MEASUREMENT)
+ const gchar *measurement = nl_langinfo (_NL_MEASUREMENT_MEASUREMENT);
+
+ switch (*((guchar *) measurement))
+ {
+ case 1: /* metric */
+ return GIMP_UNIT_MM;
+
+ case 2: /* imperial */
+ return GIMP_UNIT_INCH;
+ }
+
+#elif defined (G_OS_WIN32)
+ DWORD measurement;
+ int ret;
+
+ ret = GetLocaleInfo(LOCALE_USER_DEFAULT,
+ LOCALE_IMEASURE | LOCALE_RETURN_NUMBER,
+ (LPTSTR)&measurement,
+ sizeof(measurement) / sizeof(TCHAR) );
+
+ if (ret != 0) /* GetLocaleInfo succeeded */
+ {
+ switch ((guint) measurement)
+ {
+ case 0: /* metric */
+ return GIMP_UNIT_MM;
+
+ case 1: /* imperial */
+ return GIMP_UNIT_INCH;
+ }
+ }
+#endif
+
+ return GIMP_UNIT_MM;
+}
+
+gchar **
+gimp_properties_append (GType object_type,
+ gint *n_properties,
+ gchar **names,
+ GValue **values,
+ ...)
+{
+ va_list args;
+
+ g_return_val_if_fail (g_type_is_a (object_type, G_TYPE_OBJECT), NULL);
+ g_return_val_if_fail (n_properties != NULL, NULL);
+ g_return_val_if_fail (names != NULL || *n_properties == 0, NULL);
+ g_return_val_if_fail (values != NULL || *n_properties == 0, NULL);
+
+ va_start (args, values);
+ names = gimp_properties_append_valist (object_type, n_properties,
+ names, values, args);
+ va_end (args);
+
+ return names;
+}
+
+gchar **
+gimp_properties_append_valist (GType object_type,
+ gint *n_properties,
+ gchar **names,
+ GValue **values,
+ va_list args)
+{
+ GObjectClass *object_class;
+ gchar *param_name;
+
+ g_return_val_if_fail (g_type_is_a (object_type, G_TYPE_OBJECT), NULL);
+ g_return_val_if_fail (n_properties != NULL, NULL);
+ g_return_val_if_fail (names != NULL || *n_properties == 0, NULL);
+ g_return_val_if_fail (values != NULL || *n_properties == 0, NULL);
+
+ object_class = g_type_class_ref (object_type);
+
+ param_name = va_arg (args, gchar *);
+
+ while (param_name)
+ {
+ GValue *value;
+ gchar *error = NULL;
+ GParamSpec *pspec = g_object_class_find_property (object_class,
+ param_name);
+
+ if (! pspec)
+ {
+ g_warning ("%s: object class `%s' has no property named `%s'",
+ G_STRFUNC, g_type_name (object_type), param_name);
+ break;
+ }
+
+ names = g_renew (gchar *, names, *n_properties + 1);
+ *values = g_renew (GValue, *values, *n_properties + 1);
+
+ value = &((*values)[*n_properties]);
+
+ names[*n_properties] = g_strdup (param_name);
+ value->g_type = 0;
+
+ g_value_init (value, G_PARAM_SPEC_VALUE_TYPE (pspec));
+
+ G_VALUE_COLLECT (value, args, 0, &error);
+
+ if (error)
+ {
+ g_warning ("%s: %s", G_STRFUNC, error);
+ g_free (error);
+ g_free (names[*n_properties]);
+ g_value_unset (value);
+ break;
+ }
+
+ *n_properties = *n_properties + 1;
+
+ param_name = va_arg (args, gchar *);
+ }
+
+ g_type_class_unref (object_class);
+
+ return names;
+}
+
+void
+gimp_properties_free (gint n_properties,
+ gchar **names,
+ GValue *values)
+{
+ g_return_if_fail (names != NULL || n_properties == 0);
+ g_return_if_fail (values != NULL || n_properties == 0);
+
+ if (names && values)
+ {
+ gint i;
+
+ for (i = 0; i < n_properties; i++)
+ {
+ g_free (names[i]);
+ g_value_unset (&values[i]);
+ }
+
+ g_free (names);
+ g_free (values);
+ }
+}
+
+/* markup unescape code stolen and adapted from gmarkup.c
+ */
+static gchar *
+char_str (gunichar c,
+ gchar *buf)
+{
+ memset (buf, 0, 8);
+ g_unichar_to_utf8 (c, buf);
+ return buf;
+}
+
+static gboolean
+unescape_gstring (GString *string)
+{
+ const gchar *from;
+ gchar *to;
+
+ /*
+ * Meeks' theorum: unescaping can only shrink text.
+ * for &lt; etc. this is obvious, for &#xffff; more
+ * thought is required, but this is patently so.
+ */
+ for (from = to = string->str; *from != '\0'; from++, to++)
+ {
+ *to = *from;
+
+ if (*to == '\r')
+ {
+ *to = '\n';
+ if (from[1] == '\n')
+ from++;
+ }
+ if (*from == '&')
+ {
+ from++;
+ if (*from == '#')
+ {
+ gboolean is_hex = FALSE;
+ gulong l;
+ gchar *end = NULL;
+
+ from++;
+
+ if (*from == 'x')
+ {
+ is_hex = TRUE;
+ from++;
+ }
+
+ /* digit is between start and p */
+ errno = 0;
+ if (is_hex)
+ l = strtoul (from, &end, 16);
+ else
+ l = strtoul (from, &end, 10);
+
+ if (end == from || errno != 0)
+ {
+ return FALSE;
+ }
+ else if (*end != ';')
+ {
+ return FALSE;
+ }
+ else
+ {
+ /* characters XML 1.1 permits */
+ if ((0 < l && l <= 0xD7FF) ||
+ (0xE000 <= l && l <= 0xFFFD) ||
+ (0x10000 <= l && l <= 0x10FFFF))
+ {
+ gchar buf[8];
+ char_str (l, buf);
+ strcpy (to, buf);
+ to += strlen (buf) - 1;
+ from = end;
+ }
+ else
+ {
+ return FALSE;
+ }
+ }
+ }
+
+ else if (strncmp (from, "lt;", 3) == 0)
+ {
+ *to = '<';
+ from += 2;
+ }
+ else if (strncmp (from, "gt;", 3) == 0)
+ {
+ *to = '>';
+ from += 2;
+ }
+ else if (strncmp (from, "amp;", 4) == 0)
+ {
+ *to = '&';
+ from += 3;
+ }
+ else if (strncmp (from, "quot;", 5) == 0)
+ {
+ *to = '"';
+ from += 4;
+ }
+ else if (strncmp (from, "apos;", 5) == 0)
+ {
+ *to = '\'';
+ from += 4;
+ }
+ else
+ {
+ return FALSE;
+ }
+ }
+ }
+
+ gimp_assert (to - string->str <= string->len);
+ if (to - string->str != string->len)
+ g_string_truncate (string, to - string->str);
+
+ return TRUE;
+}
+
+gchar *
+gimp_markup_extract_text (const gchar *markup)
+{
+ GString *string;
+ const gchar *p;
+ gboolean in_tag = FALSE;
+
+ if (! markup)
+ return NULL;
+
+ string = g_string_new (NULL);
+
+ for (p = markup; *p; p++)
+ {
+ if (in_tag)
+ {
+ if (*p == '>')
+ in_tag = FALSE;
+ }
+ else
+ {
+ if (*p == '<')
+ in_tag = TRUE;
+ else
+ g_string_append_c (string, *p);
+ }
+ }
+
+ unescape_gstring (string);
+
+ return g_string_free (string, FALSE);
+}
+
+/**
+ * gimp_enum_get_value_name:
+ * @enum_type: Enum type
+ * @value: Enum value
+ *
+ * Returns the value name for a given value of a given enum
+ * type. Useful to have inline in GIMP_LOG() messages for example.
+ *
+ * Returns: The value name.
+ **/
+const gchar *
+gimp_enum_get_value_name (GType enum_type,
+ gint value)
+{
+ const gchar *value_name = NULL;
+
+ gimp_enum_get_value (enum_type,
+ value,
+ &value_name,
+ NULL /*value_nick*/,
+ NULL /*value_desc*/,
+ NULL /*value_help*/);
+
+ return value_name;
+}
+
+gboolean
+gimp_get_fill_params (GimpContext *context,
+ GimpFillType fill_type,
+ GimpRGB *color,
+ GimpPattern **pattern,
+ GError **error)
+
+{
+ g_return_val_if_fail (GIMP_IS_CONTEXT (context), FALSE);
+ g_return_val_if_fail (color != NULL, FALSE);
+ g_return_val_if_fail (pattern != NULL, FALSE);
+ g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
+
+ *pattern = NULL;
+
+ switch (fill_type)
+ {
+ case GIMP_FILL_FOREGROUND:
+ gimp_context_get_foreground (context, color);
+ break;
+
+ case GIMP_FILL_BACKGROUND:
+ gimp_context_get_background (context, color);
+ break;
+
+ case GIMP_FILL_WHITE:
+ gimp_rgba_set (color, 1.0, 1.0, 1.0, GIMP_OPACITY_OPAQUE);
+ break;
+
+ case GIMP_FILL_TRANSPARENT:
+ gimp_rgba_set (color, 0.0, 0.0, 0.0, GIMP_OPACITY_TRANSPARENT);
+ break;
+
+ case GIMP_FILL_PATTERN:
+ *pattern = gimp_context_get_pattern (context);
+
+ if (! *pattern)
+ {
+ g_set_error_literal (error, GIMP_ERROR, GIMP_FAILED,
+ _("No patterns available for this operation."));
+
+ /* fall back to BG fill */
+ gimp_context_get_background (context, color);
+
+ return FALSE;
+ }
+ break;
+
+ default:
+ g_warning ("%s: invalid fill_type %d", G_STRFUNC, fill_type);
+ return FALSE;
+ }
+
+ return TRUE;
+}
+
+/**
+ * gimp_constrain_line:
+ * @start_x:
+ * @start_y:
+ * @end_x:
+ * @end_y:
+ * @n_snap_lines: Number evenly disributed lines to snap to.
+ * @offset_angle: The angle by which to offset the lines, in degrees.
+ * @xres: The horizontal resolution.
+ * @yres: The vertical resolution.
+ *
+ * Projects a line onto the specified subset of evenly radially
+ * distributed lines. @n_lines of 2 makes the line snap horizontally
+ * or vertically. @n_lines of 4 snaps on 45 degree steps. @n_lines of
+ * 12 on 15 degree steps. etc.
+ **/
+void
+gimp_constrain_line (gdouble start_x,
+ gdouble start_y,
+ gdouble *end_x,
+ gdouble *end_y,
+ gint n_snap_lines,
+ gdouble offset_angle,
+ gdouble xres,
+ gdouble yres)
+{
+ GimpVector2 diff;
+ GimpVector2 dir;
+ gdouble angle;
+
+ offset_angle *= G_PI / 180.0;
+
+ diff.x = (*end_x - start_x) / xres;
+ diff.y = (*end_y - start_y) / yres;
+
+ angle = (atan2 (diff.y, diff.x) - offset_angle) * n_snap_lines / G_PI;
+ angle = RINT (angle) * G_PI / n_snap_lines + offset_angle;
+
+ dir.x = cos (angle);
+ dir.y = sin (angle);
+
+ gimp_vector2_mul (&dir, gimp_vector2_inner_product (&dir, &diff));
+
+ *end_x = start_x + dir.x * xres;
+ *end_y = start_y + dir.y * yres;
+}
+
+gint
+gimp_file_compare (GFile *file1,
+ GFile *file2)
+{
+ if (g_file_equal (file1, file2))
+ {
+ return 0;
+ }
+ else
+ {
+ gchar *uri1 = g_file_get_uri (file1);
+ gchar *uri2 = g_file_get_uri (file2);
+ gint result = strcmp (uri1, uri2);
+
+ g_free (uri1);
+ g_free (uri2);
+
+ return result;
+ }
+}
+
+static inline gboolean
+is_script (const gchar *filename)
+{
+#ifdef G_OS_WIN32
+ /* On Windows there is no concept like the Unix executable flag.
+ * There is a weak emulation provided by the MS C Runtime using file
+ * extensions (com, exe, cmd, bat). This needs to be extended to
+ * treat scripts (Python, Perl, ...) as executables, too. We use the
+ * PATHEXT variable, which is also used by cmd.exe.
+ */
+ static gchar **exts = NULL;
+
+ const gchar *ext = strrchr (filename, '.');
+ const gchar *pathext;
+ gint i;
+
+ if (exts == NULL)
+ {
+ pathext = g_getenv ("PATHEXT");
+ if (pathext != NULL)
+ {
+ exts = g_strsplit (pathext, G_SEARCHPATH_SEPARATOR_S, 100);
+ }
+ else
+ {
+ exts = g_new (gchar *, 1);
+ exts[0] = NULL;
+ }
+ }
+
+ for (i = 0; exts[i]; i++)
+ {
+ if (g_ascii_strcasecmp (ext, exts[i]) == 0)
+ return TRUE;
+ }
+#endif /* G_OS_WIN32 */
+
+ return FALSE;
+}
+
+gboolean
+gimp_file_is_executable (GFile *file)
+{
+ GFileInfo *info;
+ gboolean executable = FALSE;
+
+ g_return_val_if_fail (G_IS_FILE (file), FALSE);
+
+ info = g_file_query_info (file,
+ G_FILE_ATTRIBUTE_STANDARD_NAME ","
+ G_FILE_ATTRIBUTE_STANDARD_TYPE ","
+ G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE ",",
+ G_FILE_QUERY_INFO_NONE,
+ NULL, NULL);
+
+ if (info)
+ {
+ GFileType file_type = g_file_info_get_file_type (info);
+ const gchar *filename = g_file_info_get_name (info);
+
+ if (file_type == G_FILE_TYPE_REGULAR &&
+ (g_file_info_get_attribute_boolean (info,
+ G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE) ||
+ is_script (filename)))
+ {
+ executable = TRUE;
+ }
+
+ g_object_unref (info);
+ }
+
+ return executable;
+}
+
+/**
+ * gimp_file_get_extension:
+ * @file: A #GFile
+ *
+ * Returns @file's extension (including the .), or NULL if there is no
+ * extension. Note that this function handles compressed files too,
+ * e.g. for "file.png.gz" it will return ".png.gz".
+ *
+ * Returns: The @file's extension. Free with g_free() when no longer needed.
+ **/
+gchar *
+gimp_file_get_extension (GFile *file)
+{
+ gchar *uri;
+ gint uri_len;
+ gchar *ext = NULL;
+ gint search_len;
+
+ g_return_val_if_fail (G_IS_FILE (file), NULL);
+
+ uri = g_file_get_uri (file);
+ uri_len = strlen (uri);
+
+ if (g_str_has_suffix (uri, ".gz"))
+ search_len = uri_len - 3;
+ else if (g_str_has_suffix (uri, ".bz2"))
+ search_len = uri_len - 4;
+ else if (g_str_has_suffix (uri, ".xz"))
+ search_len = uri_len - 3;
+ else
+ search_len = uri_len;
+
+ ext = g_strrstr_len (uri, search_len, ".");
+
+ if (ext)
+ ext = g_strdup (ext);
+
+ g_free (uri);
+
+ return ext;
+}
+
+GFile *
+gimp_file_with_new_extension (GFile *file,
+ GFile *ext_file)
+{
+ gchar *uri;
+ gchar *file_ext;
+ gint file_ext_len = 0;
+ gchar *ext_file_ext = NULL;
+ gchar *uri_without_ext;
+ gchar *new_uri;
+ GFile *ret;
+
+ g_return_val_if_fail (G_IS_FILE (file), NULL);
+ g_return_val_if_fail (ext_file == NULL || G_IS_FILE (ext_file), NULL);
+
+ uri = g_file_get_uri (file);
+ file_ext = gimp_file_get_extension (file);
+
+ if (file_ext)
+ {
+ file_ext_len = strlen (file_ext);
+ g_free (file_ext);
+ }
+
+ if (ext_file)
+ ext_file_ext = gimp_file_get_extension (ext_file);
+
+ uri_without_ext = g_strndup (uri, strlen (uri) - file_ext_len);
+
+ g_free (uri);
+
+ new_uri = g_strconcat (uri_without_ext, ext_file_ext, NULL);
+
+ ret = g_file_new_for_uri (new_uri);
+
+ g_free (ext_file_ext);
+ g_free (uri_without_ext);
+ g_free (new_uri);
+
+ return ret;
+}
+
+gchar *
+gimp_data_input_stream_read_line_always (GDataInputStream *stream,
+ gsize *length,
+ GCancellable *cancellable,
+ GError **error)
+{
+ GError *temp_error = NULL;
+ gchar *result;
+
+ g_return_val_if_fail (G_IS_DATA_INPUT_STREAM (stream), NULL);
+ g_return_val_if_fail (error == NULL || *error == NULL, NULL);
+
+ if (! error)
+ error = &temp_error;
+
+ result = g_data_input_stream_read_line (stream, length, cancellable, error);
+
+ if (! result && ! *error)
+ {
+ result = g_strdup ("");
+
+ if (length) *length = 0;
+ }
+
+ g_clear_error (&temp_error);
+
+ return result;
+}
+
+gboolean
+gimp_ascii_strtoi (const gchar *nptr,
+ gchar **endptr,
+ gint base,
+ gint *result)
+{
+ gchar *temp_endptr;
+ gint64 temp_result;
+
+ g_return_val_if_fail (nptr != NULL, FALSE);
+ g_return_val_if_fail (base == 0 || (base >= 2 && base <= 36), FALSE);
+
+ if (! endptr)
+ endptr = &temp_endptr;
+
+ temp_result = g_ascii_strtoll (nptr, endptr, base);
+
+ if (*endptr == nptr || errno == ERANGE ||
+ temp_result < G_MININT || temp_result > G_MAXINT)
+ {
+ errno = 0;
+
+ return FALSE;
+ }
+
+ if (result) *result = temp_result;
+
+ return TRUE;
+}
+
+gboolean
+gimp_ascii_strtod (const gchar *nptr,
+ gchar **endptr,
+ gdouble *result)
+{
+ gchar *temp_endptr;
+ gdouble temp_result;
+
+ g_return_val_if_fail (nptr != NULL, FALSE);
+
+ if (! endptr)
+ endptr = &temp_endptr;
+
+ temp_result = g_ascii_strtod (nptr, endptr);
+
+ if (*endptr == nptr || errno == ERANGE)
+ {
+ errno = 0;
+
+ return FALSE;
+ }
+
+ if (result) *result = temp_result;
+
+ return TRUE;
+}
+
+gint
+gimp_g_list_compare (GList *list1,
+ GList *list2)
+{
+ while (list1 && list2)
+ {
+ if (list1->data < list2->data)
+ return -1;
+ else if (list1->data > list2->data)
+ return +1;
+
+ list1 = g_list_next (list1);
+ list2 = g_list_next (list2);
+ }
+
+ if (! list1)
+ return -1;
+ else if (! list2)
+ return +1;
+
+ return 0;
+}
+
+typedef struct
+{
+ gint ref_count;
+
+ GimpAsync *async;
+ gint idle_id;
+
+ GimpRunAsyncFunc func;
+ gpointer user_data;
+ GDestroyNotify user_data_destroy_func;
+} GimpIdleRunAsyncData;
+
+static GimpIdleRunAsyncData *
+gimp_idle_run_async_data_new (void)
+{
+ GimpIdleRunAsyncData *data;
+
+ data = g_slice_new0 (GimpIdleRunAsyncData);
+
+ data->ref_count = 1;
+
+ return data;
+}
+
+static void
+gimp_idle_run_async_data_inc_ref (GimpIdleRunAsyncData *data)
+{
+ data->ref_count++;
+}
+
+static void
+gimp_idle_run_async_data_dec_ref (GimpIdleRunAsyncData *data)
+{
+ data->ref_count--;
+
+ if (data->ref_count == 0)
+ {
+ g_signal_handlers_disconnect_by_data (data->async, data);
+
+ if (! gimp_async_is_stopped (data->async))
+ gimp_async_abort (data->async);
+
+ g_object_unref (data->async);
+
+ if (data->user_data && data->user_data_destroy_func)
+ data->user_data_destroy_func (data->user_data);
+
+ g_slice_free (GimpIdleRunAsyncData, data);
+ }
+}
+
+static void
+gimp_idle_run_async_cancel (GimpAsync *async,
+ GimpIdleRunAsyncData *data)
+{
+ gimp_idle_run_async_data_inc_ref (data);
+
+ if (data->idle_id)
+ {
+ g_source_remove (data->idle_id);
+
+ data->idle_id = 0;
+ }
+
+ gimp_idle_run_async_data_dec_ref (data);
+}
+
+static void
+gimp_idle_run_async_waiting (GimpAsync *async,
+ GimpIdleRunAsyncData *data)
+{
+ gimp_idle_run_async_data_inc_ref (data);
+
+ if (data->idle_id)
+ {
+ g_source_remove (data->idle_id);
+
+ data->idle_id = 0;
+ }
+
+ g_signal_handlers_block_by_func (data->async,
+ gimp_idle_run_async_cancel,
+ data);
+
+ while (! gimp_async_is_stopped (data->async))
+ data->func (data->async, data->user_data);
+
+ g_signal_handlers_unblock_by_func (data->async,
+ gimp_idle_run_async_cancel,
+ data);
+
+ data->user_data = NULL;
+
+ gimp_idle_run_async_data_dec_ref (data);
+}
+
+static gboolean
+gimp_idle_run_async_idle (GimpIdleRunAsyncData *data)
+{
+ gimp_idle_run_async_data_inc_ref (data);
+
+ g_signal_handlers_block_by_func (data->async,
+ gimp_idle_run_async_cancel,
+ data);
+
+ data->func (data->async, data->user_data);
+
+ g_signal_handlers_unblock_by_func (data->async,
+ gimp_idle_run_async_cancel,
+ data);
+
+ if (gimp_async_is_stopped (data->async))
+ {
+ data->user_data = NULL;
+
+ gimp_idle_run_async_data_dec_ref (data);
+
+ return G_SOURCE_REMOVE;
+ }
+
+ gimp_idle_run_async_data_dec_ref (data);
+
+ return G_SOURCE_CONTINUE;
+}
+
+GimpAsync *
+gimp_idle_run_async (GimpRunAsyncFunc func,
+ gpointer user_data)
+{
+ return gimp_idle_run_async_full (G_PRIORITY_DEFAULT_IDLE, func,
+ user_data, NULL);
+}
+
+GimpAsync *
+gimp_idle_run_async_full (gint priority,
+ GimpRunAsyncFunc func,
+ gpointer user_data,
+ GDestroyNotify user_data_destroy_func)
+{
+ GimpIdleRunAsyncData *data;
+
+ g_return_val_if_fail (func != NULL, NULL);
+
+ data = gimp_idle_run_async_data_new ();
+
+ data->func = func;
+ data->user_data = user_data;
+ data->user_data_destroy_func = user_data_destroy_func;
+
+ data->async = gimp_async_new ();
+
+ g_signal_connect (data->async, "cancel",
+ G_CALLBACK (gimp_idle_run_async_cancel),
+ data);
+ g_signal_connect (data->async, "waiting",
+ G_CALLBACK (gimp_idle_run_async_waiting),
+ data);
+
+ data->idle_id = g_idle_add_full (
+ priority,
+ (GSourceFunc) gimp_idle_run_async_idle,
+ data,
+ (GDestroyNotify) gimp_idle_run_async_data_dec_ref);
+
+ return g_object_ref (data->async);
+}
+
+
+/* debug stuff */
+
+#include "gegl/gimp-babl.h"
+#include "gimpimage.h"
+#include "gimplayer.h"
+#include "gimplayer-new.h"
+
+GimpImage *
+gimp_create_image_from_buffer (Gimp *gimp,
+ GeglBuffer *buffer,
+ const gchar *image_name)
+{
+ GimpImage *image;
+ GimpLayer *layer;
+ const Babl *format;
+
+ g_return_val_if_fail (GIMP_IS_GIMP (gimp), NULL);
+ g_return_val_if_fail (GEGL_IS_BUFFER (buffer), NULL);
+
+ if (! image_name)
+ image_name = "Debug Image";
+
+ format = gegl_buffer_get_format (buffer);
+
+ image = gimp_create_image (gimp,
+ gegl_buffer_get_width (buffer),
+ gegl_buffer_get_height (buffer),
+ gimp_babl_format_get_base_type (format),
+ gimp_babl_format_get_precision (format),
+ FALSE);
+
+ layer = gimp_layer_new_from_gegl_buffer (buffer, image, format,
+ image_name,
+ GIMP_OPACITY_OPAQUE,
+ GIMP_LAYER_MODE_NORMAL,
+ NULL /* same image */);
+ gimp_image_add_layer (image, layer, NULL, -1, FALSE);
+
+ gimp_create_display (gimp, image, GIMP_UNIT_PIXEL, 1.0, NULL, 0);
+
+ /* unref the image unconditionally, even when no display was created */
+ g_object_add_weak_pointer (G_OBJECT (image), (gpointer) &image);
+ g_object_unref (image);
+
+ return image;
+}