2006-12-10 05:33:38 +08:00
|
|
|
/* GIMP - The GNU Image Manipulation Program
|
2003-05-14 23:32:07 +08:00
|
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
|
|
|
*
|
2009-01-18 06:28:01 +08:00
|
|
|
* This program is free software: you can redistribute it and/or modify
|
2003-05-14 23:32:07 +08:00
|
|
|
* it under the terms of the GNU General Public License as published by
|
2009-01-18 06:28:01 +08:00
|
|
|
* the Free Software Foundation; either version 3 of the License, or
|
2003-05-14 23:32:07 +08:00
|
|
|
* (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
|
2018-07-12 05:27:07 +08:00
|
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
2003-05-14 23:32:07 +08:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef __APP_GIMP_UTILS_H__
|
|
|
|
|
#define __APP_GIMP_UTILS_H__
|
|
|
|
|
|
|
|
|
|
|
2022-11-29 03:59:30 +08:00
|
|
|
#ifdef GIMP_RELEASE
|
|
|
|
|
#define GIMP_TIMER_START()
|
|
|
|
|
#define GIMP_TIMER_END(message)
|
|
|
|
|
#else
|
2010-06-07 02:24:27 +08:00
|
|
|
#define GIMP_TIMER_START() \
|
|
|
|
|
{ GTimer *_timer = g_timer_new ();
|
|
|
|
|
|
|
|
|
|
#define GIMP_TIMER_END(message) \
|
2013-03-06 19:50:21 +08:00
|
|
|
g_printerr ("%s: %s took %0.4f seconds\n", \
|
2012-03-30 19:03:51 +08:00
|
|
|
G_STRFUNC, message, g_timer_elapsed (_timer, NULL)); \
|
2010-06-07 02:24:27 +08:00
|
|
|
g_timer_destroy (_timer); }
|
2022-11-29 03:59:30 +08:00
|
|
|
#endif
|
2010-06-07 02:24:27 +08:00
|
|
|
|
|
|
|
|
|
2011-06-04 23:16:21 +08:00
|
|
|
#define MIN4(a,b,c,d) MIN (MIN ((a), (b)), MIN ((c), (d)))
|
|
|
|
|
#define MAX4(a,b,c,d) MAX (MAX ((a), (b)), MAX ((c), (d)))
|
|
|
|
|
|
|
|
|
|
|
2012-04-24 03:13:57 +08:00
|
|
|
gint gimp_get_pid (void);
|
|
|
|
|
guint64 gimp_get_physical_memory_size (void);
|
2007-03-06 04:09:46 +08:00
|
|
|
gchar * gimp_get_default_language (const gchar *category);
|
Issue #8900 and #9923: reimplementing GimpUnit as a proper class.
This fixes all our GObject Introspection issues with GimpUnit which was
both an enum and an int-derived type of user-defined units *completing*
the enum values. GIR clearly didn't like this!
Now GimpUnit is a proper class and units are unique objects, allowing to
compare them with an identity test (i.e. `unit == gimp_unit_pixel ()`
tells us if unit is the pixel unit or not), which makes it easy to use,
just like with int, yet adding also methods, making for nicer
introspected API.
As an aside, this also fixes #10738, by having all the built-in units
retrievable even if libgimpbase had not been properly initialized with
gimp_base_init().
I haven't checked in details how GIR works to introspect, but it looks
like it loads the library to inspect and runs functions, hence
triggering some CRITICALS because virtual methods (supposed to be
initialized with gimp_base_init() run by libgimp) are not set. This new
code won't trigger any critical because the vtable method are now not
necessary, at least for all built-in units.
Note that GimpUnit is still in libgimpbase. It could have been moved to
libgimp in order to avoid any virtual method table (since we need to
keep core and libgimp side's units in sync, PDB is required), but too
many libgimpwidgets widgets were already using GimpUnit. And technically
most of GimpUnit logic doesn't require PDB (only the creation/sync
part). This is one of the reasons why user-created GimpUnit list is
handled and stored differently from other types of objects.
Globally this simplifies the code a lot too and we don't need separate
implementations of various utils for core and libgimp, which means less
prone to errors.
2024-07-26 02:55:21 +08:00
|
|
|
GimpUnit * gimp_get_default_unit (void);
|
2007-03-06 04:09:46 +08:00
|
|
|
|
2018-01-01 22:20:05 +08:00
|
|
|
gchar ** gimp_properties_append (GType object_type,
|
|
|
|
|
gint *n_properties,
|
|
|
|
|
gchar **names,
|
|
|
|
|
GValue **values,
|
2007-03-06 04:09:46 +08:00
|
|
|
...) G_GNUC_NULL_TERMINATED;
|
2018-01-01 22:20:05 +08:00
|
|
|
gchar ** gimp_properties_append_valist (GType object_type,
|
|
|
|
|
gint *n_properties,
|
|
|
|
|
gchar **names,
|
|
|
|
|
GValue **values,
|
2007-03-06 04:09:46 +08:00
|
|
|
va_list args);
|
2018-01-01 22:20:05 +08:00
|
|
|
void gimp_properties_free (gint n_properties,
|
|
|
|
|
gchar **names,
|
|
|
|
|
GValue *values);
|
2007-03-06 04:09:46 +08:00
|
|
|
|
2010-03-03 04:19:57 +08:00
|
|
|
gchar * gimp_markup_extract_text (const gchar *markup);
|
|
|
|
|
|
2010-10-26 19:45:17 +08:00
|
|
|
const gchar* gimp_enum_get_value_name (GType enum_type,
|
|
|
|
|
gint value);
|
2010-03-03 04:19:57 +08:00
|
|
|
|
2014-06-03 20:00:01 +08:00
|
|
|
gboolean gimp_get_fill_params (GimpContext *context,
|
|
|
|
|
GimpFillType fill_type,
|
2023-12-22 13:11:23 +08:00
|
|
|
GeglColor **color,
|
2014-06-03 20:00:01 +08:00
|
|
|
GimpPattern **pattern,
|
|
|
|
|
GError **error);
|
|
|
|
|
|
2009-04-23 03:08:42 +08:00
|
|
|
/* Common values for the n_snap_lines parameter of
|
|
|
|
|
* gimp_constrain_line.
|
|
|
|
|
*/
|
|
|
|
|
#define GIMP_CONSTRAIN_LINE_90_DEGREES 2
|
|
|
|
|
#define GIMP_CONSTRAIN_LINE_45_DEGREES 4
|
|
|
|
|
#define GIMP_CONSTRAIN_LINE_15_DEGREES 12
|
|
|
|
|
|
2019-05-31 23:26:50 +08:00
|
|
|
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);
|
|
|
|
|
|
|
|
|
|
gint gimp_file_compare (GFile *file1,
|
|
|
|
|
GFile *file2);
|
|
|
|
|
gboolean gimp_file_is_executable (GFile *file);
|
|
|
|
|
gchar * gimp_file_get_extension (GFile *file);
|
|
|
|
|
GFile * gimp_file_with_new_extension (GFile *file,
|
|
|
|
|
GFile *ext_file);
|
|
|
|
|
gboolean gimp_file_delete_recursive (GFile *file,
|
|
|
|
|
GError **error);
|
|
|
|
|
|
|
|
|
|
gchar * gimp_data_input_stream_read_line_always
|
|
|
|
|
(GDataInputStream *stream,
|
|
|
|
|
gsize *length,
|
|
|
|
|
GCancellable *cancellable,
|
|
|
|
|
GError **error);
|
|
|
|
|
|
|
|
|
|
gboolean gimp_ascii_strtoi (const gchar *nptr,
|
|
|
|
|
gchar **endptr,
|
|
|
|
|
gint base,
|
|
|
|
|
gint *result);
|
|
|
|
|
gboolean gimp_ascii_strtod (const gchar *nptr,
|
|
|
|
|
gchar **endptr,
|
|
|
|
|
gdouble *result);
|
|
|
|
|
|
2022-02-20 05:29:58 +08:00
|
|
|
gchar * gimp_appstream_to_pango_markup (const gchar *as_text);
|
2022-03-05 04:26:05 +08:00
|
|
|
void gimp_appstream_to_pango_markups (const gchar *as_text,
|
|
|
|
|
gchar **introduction,
|
|
|
|
|
GList **release_items);
|
2022-02-20 05:29:58 +08:00
|
|
|
|
2019-05-31 23:26:50 +08:00
|
|
|
gint gimp_g_list_compare (GList *list1,
|
|
|
|
|
GList *list2);
|
|
|
|
|
|
|
|
|
|
GimpTRCType gimp_suggest_trc_for_component_type (GimpComponentType component_type,
|
|
|
|
|
GimpTRCType old_trc);
|
|
|
|
|
|
2020-03-14 06:29:55 +08:00
|
|
|
GimpAsync * gimp_idle_run_async (GimpRunAsyncFunc func,
|
|
|
|
|
gpointer user_data);
|
|
|
|
|
GimpAsync * gimp_idle_run_async_full (gint priority,
|
|
|
|
|
GimpRunAsyncFunc func,
|
|
|
|
|
gpointer user_data,
|
|
|
|
|
GDestroyNotify user_data_destroy_func);
|
|
|
|
|
|
2019-05-31 23:26:50 +08:00
|
|
|
GimpImage * gimp_create_image_from_buffer (Gimp *gimp,
|
|
|
|
|
GeglBuffer *buffer,
|
|
|
|
|
const gchar *image_name);
|
2013-04-30 23:17:43 +08:00
|
|
|
|
2022-03-22 08:40:12 +08:00
|
|
|
gint gimp_view_size_get_larger (gint view_size);
|
|
|
|
|
gint gimp_view_size_get_smaller (gint view_size);
|
|
|
|
|
|
2021-06-29 22:11:03 +08:00
|
|
|
#ifdef G_OS_WIN32
|
|
|
|
|
|
|
|
|
|
gboolean gimp_win32_have_wintab (void);
|
|
|
|
|
gboolean gimp_win32_have_windows_ink (void);
|
|
|
|
|
|
|
|
|
|
#endif
|
2003-05-14 23:32:07 +08:00
|
|
|
|
|
|
|
|
#endif /* __APP_GIMP_UTILS_H__ */
|