dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/libgimpbase/gimpwire.h

153 lines
8.1 KiB
C
Raw Normal View History

After a weekend of extensive mail exchange with the signal crew, we 2000-05-14 Michael Natterer <mitch@gimp.org> After a weekend of extensive mail exchange with the signal crew, we finally found that #2742 is not a Gimp bug but a real OSF/1 bug. OSF/1 does _not_ reliably restart read() and write() calls on certain slow devices (pipes). * libgimp/gimpwire.[ch]: guard all read/write calls on the wire with loops checking for EINTR. This has to be done "manually" as glib's GIOChannels return G_IO_ERROR_UNKNOWN on the occurence of EINTR (which is a bug, too). s/int/gboolean and minor cleanups while I was on it (not changing any logic). This fix depends on the current (broken) state of the GIOChannel implementation and is scheduled for removal as soon as glib behaves nicely here. Left SA_RESTART there for the moment in app/main.c. See it as defensive programming or just my fear to change two #2742-related places at the same time. We might choose to remove SA_RESTART later. Many thanks again to Austin, Garry and Tim.
2000-05-14 20:09:43 +08:00
/* LIBGIMP - The GIMP Library
Second batch of Win32 merge.
1999-03-07 20:56:03 +08:00
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
Placed libgimp under LGPL -Yosh
1998-01-25 18:26:47 +08:00
*
Change licence to GPLv3 (and to LGPLv3 for libgimp). 2009-01-17 Michael Natterer <mitch@gimp.org> * all files with a GPL header and all COPYING files: Change licence to GPLv3 (and to LGPLv3 for libgimp). Cleaned up some copyright headers and regenerated the parsers in the ImageMap plugin. svn path=/trunk/; revision=27913
2009-01-18 06:28:01 +08:00
* This library is free software: you can redistribute it and/or
*** empty log message ***
1999-11-18 05:13:50 +08:00
* modify it under the terms of the GNU Lesser General Public
Placed libgimp under LGPL -Yosh
1998-01-25 18:26:47 +08:00
* License as published by the Free Software Foundation; either
Change licence to GPLv3 (and to LGPLv3 for libgimp). 2009-01-17 Michael Natterer <mitch@gimp.org> * all files with a GPL header and all COPYING files: Change licence to GPLv3 (and to LGPLv3 for libgimp). Cleaned up some copyright headers and regenerated the parsers in the ImageMap plugin. svn path=/trunk/; revision=27913
2009-01-18 06:28:01 +08:00
* version 3 of the License, or (at your option) any later version.
Second batch of Win32 merge.
1999-03-07 20:56:03 +08:00
*
* This library 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
added spec file to EXTRA_DIST * Makefile.am: added spec file to EXTRA_DIST * docs/Makefile.am: added undo.txt to EXTRA_DIST * app/interface.c: removed the DODGY warning, doesn't look dodgy to me * libgimp/*.h: missed an s/Library/Lesser/ * tools/pdbgen/*: lots of work on the libgimp portion -Yosh
1999-12-26 15:54:39 +08:00
* Lesser General Public License for more details.
Placed libgimp under LGPL -Yosh
1998-01-25 18:26:47 +08:00
*
*** empty log message ***
1999-11-18 05:13:50 +08:00
* You should have received a copy of the GNU Lesser General Public
Change licence to GPLv3 (and to LGPLv3 for libgimp). 2009-01-17 Michael Natterer <mitch@gimp.org> * all files with a GPL header and all COPYING files: Change licence to GPLv3 (and to LGPLv3 for libgimp). Cleaned up some copyright headers and regenerated the parsers in the ImageMap plugin. svn path=/trunk/; revision=27913
2009-01-18 06:28:01 +08:00
* License along with this library. If not, see
Change the license URL from http://www.gnu.org/licenses/ to https://
2018-07-12 05:27:07 +08:00
* <https://www.gnu.org/licenses/>.
Second batch of Win32 merge.
1999-03-07 20:56:03 +08:00
*/
Initial revision
1997-11-25 06:05:25 +08:00
#ifndef __GIMP_WIRE_H__
#define __GIMP_WIRE_H__
bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. 2001-11-23 Sven Neumann <sven@gimp.org> * configure.in: bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. Removed GDK_DISABLE_COMPAT_H and GTK_DISABLE_COMPAT_H from our default CFLAGS since they don't exist any longer. * RELEASE-TO-CVS.patch: removed since the glib/gtk+ API is supposed to be frozen now. * HACKING: removed reference to RELEASE-TO-CVS.patch * app/gui/menus.c * app/tools/gimptexttool.c: applied RELEASE-TO-CVS.patch to conform to the new GTK+/Pango API. * app/core/Makefile.am: generate marshallers with gimp_marshal prefix. * app/core/gimpmarshal.list: added all marshallers we use. * app/core/gimpmarshal.[ch]: regenerated. * app/[lots of .c files]: use gimp_marshal_* for all marshallers. * data/images/ * app/app_procs.c * app/gui/splash.c: * libgimpbase/Makefile.am * libgimpbase/gimpbase.h * libgimpbase/gimputils.[ch]: removed since they are no longer needed. * app/gimprc.c * plug-ins/common/ps.c * plug-ins/gdyntext/gdyntext.c * plug-ins/gdyntext/gdyntextcompat.c * plug-ins/gfig/gfig.c * plug-ins/gflare/gflare.c * plug-ins/script-fu/script-fu-scripts.c: use glib functions instead of gimp_strescape() and gimpstrcompress(). * cleaned up all header files: use G_BEGIN_DECLS/G_END_DECLS, declared all _get_type function as G_GNUC_CONST. * tools/pdbgen/enumcode.pl * tools/pdbgen/lib.pl: make them generate header files using G_BEGIN_DECLS/G_END_DECLS. * pixmaps/Makefile.am * pixmaps/wilber3.xpm: removed ... * data/images/tips_wilber.png: ... and added here as PNG * app/gui/tips-dialog.c: load the Wilber on demand using GdkPixbuf. * data/images/gimp_splash.ppm: removed ... * data/images/gimp_splash.png: ... and added as PNG * app/app_procs.c * app/gui/splash.[ch]: load the splash image using GdkPixbuf. * app/gui/about-dialog.c: sink the GtkPreview.
2001-11-23 07:46:13 +08:00
G_BEGIN_DECLS
Initial revision
1997-11-25 06:05:25 +08:00
app/gimpunit.c all libgimp headers are included via gimp.h or gimpui.h, so 2000-05-31 Michael Natterer <mitch@gimp.org> * app/gimpunit.c * libgimp/*: all libgimp headers are included via gimp.h or gimpui.h, so include <gtk/gtk.h> there and in the *.c files. Various cleanups.
2000-05-31 07:38:46 +08:00
/* For information look into the C source or the html documentation */
Initial revision
1997-11-25 06:05:25 +08:00
let the private wire methods live in the GIMP namespace. Declare internal 2005-12-13 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.[ch]: let the private wire methods live in the GIMP namespace. Declare internal functions as such and prefix them with an underscore. * libgimp/gimp.c * libgimp/gimptile.c * libgimpbase/gimpbase.def * libgimpbase/gimpprotocol.c * app/plug-in/plug-in-message.[ch] * app/plug-in/plug-in-run.c * app/plug-in/plug-in.c: changed accordingly.
2005-12-13 22:11:56 +08:00
typedef struct _GimpWireMessage GimpWireMessage;
typedef void (* GimpWireReadFunc) (GIOChannel *channel,
GimpWireMessage *msg,
gpointer user_data);
typedef void (* GimpWireWriteFunc) (GIOChannel *channel,
GimpWireMessage *msg,
gpointer user_data);
typedef void (* GimpWireDestroyFunc) (GimpWireMessage *msg);
typedef gboolean (* GimpWireIOFunc) (GIOChannel *channel,
added a const qualifier to the GimpWireIOFunc signature. 2006-03-11 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.h: added a const qualifier to the GimpWireIOFunc signature. * libgimp/gimp.c (gimp_write) * app/plug-in/plug-in.c (plug_in_write): changed accordingly.
2006-03-12 01:33:36 +08:00
const guint8 *buf,
let the private wire methods live in the GIMP namespace. Declare internal 2005-12-13 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.[ch]: let the private wire methods live in the GIMP namespace. Declare internal functions as such and prefix them with an underscore. * libgimp/gimp.c * libgimp/gimptile.c * libgimpbase/gimpbase.def * libgimpbase/gimpprotocol.c * app/plug-in/plug-in-message.[ch] * app/plug-in/plug-in-run.c * app/plug-in/plug-in.c: changed accordingly.
2005-12-13 22:11:56 +08:00
gulong count,
gpointer user_data);
typedef gboolean (* GimpWireFlushFunc) (GIOChannel *channel,
gpointer user_data);
struct _GimpWireMessage
Initial revision
1997-11-25 06:05:25 +08:00
{
After a weekend of extensive mail exchange with the signal crew, we 2000-05-14 Michael Natterer <mitch@gimp.org> After a weekend of extensive mail exchange with the signal crew, we finally found that #2742 is not a Gimp bug but a real OSF/1 bug. OSF/1 does _not_ reliably restart read() and write() calls on certain slow devices (pipes). * libgimp/gimpwire.[ch]: guard all read/write calls on the wire with loops checking for EINTR. This has to be done "manually" as glib's GIOChannels return G_IO_ERROR_UNKNOWN on the occurence of EINTR (which is a bug, too). s/int/gboolean and minor cleanups while I was on it (not changing any logic). This fix depends on the current (broken) state of the GIOChannel implementation and is scheduled for removal as soon as glib behaves nicely here. Left SA_RESTART there for the moment in app/main.c. See it as defensive programming or just my fear to change two #2742-related places at the same time. We might choose to remove SA_RESTART later. Many thanks again to Austin, Garry and Tim.
2000-05-14 20:09:43 +08:00
guint32 type;
Initial revision
1997-11-25 06:05:25 +08:00
gpointer data;
};
let the private wire methods live in the GIMP namespace. Declare internal 2005-12-13 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.[ch]: let the private wire methods live in the GIMP namespace. Declare internal functions as such and prefix them with an underscore. * libgimp/gimp.c * libgimp/gimptile.c * libgimpbase/gimpbase.def * libgimpbase/gimpprotocol.c * app/plug-in/plug-in-message.[ch] * app/plug-in/plug-in-run.c * app/plug-in/plug-in.c: changed accordingly.
2005-12-13 22:11:56 +08:00
void gimp_wire_register (guint32 type,
GimpWireReadFunc read_func,
GimpWireWriteFunc write_func,
GimpWireDestroyFunc destroy_func);
void gimp_wire_set_reader (GimpWireIOFunc read_func);
void gimp_wire_set_writer (GimpWireIOFunc write_func);
void gimp_wire_set_flusher (GimpWireFlushFunc flush_func);
libgimpbase: indentation in gimpwire.h
2015-06-11 00:58:32 +08:00
gboolean gimp_wire_read (GIOChannel *channel,
guint8 *buf,
gsize count,
gpointer user_data);
gboolean gimp_wire_write (GIOChannel *channel,
const guint8 *buf,
gsize count,
gpointer user_data);
gboolean gimp_wire_flush (GIOChannel *channel,
gpointer user_data);
let the private wire methods live in the GIMP namespace. Declare internal 2005-12-13 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.[ch]: let the private wire methods live in the GIMP namespace. Declare internal functions as such and prefix them with an underscore. * libgimp/gimp.c * libgimp/gimptile.c * libgimpbase/gimpbase.def * libgimpbase/gimpprotocol.c * app/plug-in/plug-in-message.[ch] * app/plug-in/plug-in-run.c * app/plug-in/plug-in.c: changed accordingly.
2005-12-13 22:11:56 +08:00
gboolean gimp_wire_error (void);
void gimp_wire_clear_error (void);
converted tabs to spaces. 2006-04-12 Sven Neumann <sven@gimp.org> * libgimp*/gimp*.[ch]: converted tabs to spaces.
2006-04-12 18:53:28 +08:00
gboolean gimp_wire_read_msg (GIOChannel *channel,
libgimpbase: indentation in gimpwire.h
2015-06-11 00:58:32 +08:00
GimpWireMessage *msg,
gpointer user_data);
converted tabs to spaces. 2006-04-12 Sven Neumann <sven@gimp.org> * libgimp*/gimp*.[ch]: converted tabs to spaces.
2006-04-12 18:53:28 +08:00
gboolean gimp_wire_write_msg (GIOChannel *channel,
libgimpbase: indentation in gimpwire.h
2015-06-11 00:58:32 +08:00
GimpWireMessage *msg,
gpointer user_data);
let the private wire methods live in the GIMP namespace. Declare internal 2005-12-13 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.[ch]: let the private wire methods live in the GIMP namespace. Declare internal functions as such and prefix them with an underscore. * libgimp/gimp.c * libgimp/gimptile.c * libgimpbase/gimpbase.def * libgimpbase/gimpprotocol.c * app/plug-in/plug-in-message.[ch] * app/plug-in/plug-in-run.c * app/plug-in/plug-in.c: changed accordingly.
2005-12-13 22:11:56 +08:00
libgimpbase: indentation in gimpwire.h
2015-06-11 00:58:32 +08:00
void gimp_wire_destroy (GimpWireMessage *msg);
let the private wire methods live in the GIMP namespace. Declare internal 2005-12-13 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.[ch]: let the private wire methods live in the GIMP namespace. Declare internal functions as such and prefix them with an underscore. * libgimp/gimp.c * libgimp/gimptile.c * libgimpbase/gimpbase.def * libgimpbase/gimpprotocol.c * app/plug-in/plug-in-message.[ch] * app/plug-in/plug-in-run.c * app/plug-in/plug-in.c: changed accordingly.
2005-12-13 22:11:56 +08:00
libgimpbase/gimpwire.h libgimpbase/gimpreloc.h 2006-08-22 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.h * libgimpbase/gimpreloc.h * libgimp/gimpdrawablepreview.h * libgimp/gimptile.h * libgimp/gimpunitcache.h * libgimpthumb/gimpthumb-utils.h * libgimpwidgets/gimpcolorarea.h * libgimpwidgets/gimphelpui.h: moved G_GNUC_INTERNAL before the return value (bug #352268). * tools/pdbgen/lib.pl : changed code generation rules to place G_GNUC_INTERNAL before the return value. * libgimp/*_pdb.h: regenerated.
2006-08-22 21:18:42 +08:00
/* for internal use in libgimpbase */
libgimpbase: add _gimp_wire_{read,write}_int64() ... for reading/writing guint64 data in the wire protocol.
2018-11-20 05:06:28 +08:00
G_GNUC_INTERNAL gboolean _gimp_wire_read_int64 (GIOChannel *channel,
guint64 *data,
gint count,
gpointer user_data);
libgimpbase/gimpwire.h libgimpbase/gimpreloc.h 2006-08-22 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.h * libgimpbase/gimpreloc.h * libgimp/gimpdrawablepreview.h * libgimp/gimptile.h * libgimp/gimpunitcache.h * libgimpthumb/gimpthumb-utils.h * libgimpwidgets/gimpcolorarea.h * libgimpwidgets/gimphelpui.h: moved G_GNUC_INTERNAL before the return value (bug #352268). * tools/pdbgen/lib.pl : changed code generation rules to place G_GNUC_INTERNAL before the return value. * libgimp/*_pdb.h: regenerated.
2006-08-22 21:18:42 +08:00
G_GNUC_INTERNAL gboolean _gimp_wire_read_int32 (GIOChannel *channel,
guint32 *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_read_int16 (GIOChannel *channel,
guint16 *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_read_int8 (GIOChannel *channel,
guint8 *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_read_double (GIOChannel *channel,
gdouble *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_read_string (GIOChannel *channel,
gchar **data,
gint count,
gpointer user_data);
app, libgimp*, plug-ins, tools: settings custom check colors now space-invaded. We pass 2 GeglColor through the wire now. Since it is passed very early (when sharing the configuration), I had some issues with initialization order of GEGL, and in particular when calling gegl_init() before gegl_config() inside _gimp_config(), I had a bunch of such criticals: > Plugin script-fu: GLib-GObject: CRITICAL: Two different plugins tried to register 'GeglOpPlugIn-transform-core' Anyway in the end, I store the passed colors as raw bytes and strings in the GPConfig object, and re-construct the GeglColor last minute in _gimp_config().
2023-11-21 04:38:11 +08:00
G_GNUC_INTERNAL gboolean
_gimp_wire_read_gegl_color (GIOChannel *channel,
GBytes **pixel_data,
GBytes **icc_data,
gchar **encoding,
gint count,
gpointer user_data);
libgimpbase: add _gimp_wire_{read,write}_int64() ... for reading/writing guint64 data in the wire protocol.
2018-11-20 05:06:28 +08:00
G_GNUC_INTERNAL gboolean _gimp_wire_write_int64 (GIOChannel *channel,
const guint64 *data,
gint count,
gpointer user_data);
libgimpbase/gimpwire.h libgimpbase/gimpreloc.h 2006-08-22 Sven Neumann <sven@gimp.org> * libgimpbase/gimpwire.h * libgimpbase/gimpreloc.h * libgimp/gimpdrawablepreview.h * libgimp/gimptile.h * libgimp/gimpunitcache.h * libgimpthumb/gimpthumb-utils.h * libgimpwidgets/gimpcolorarea.h * libgimpwidgets/gimphelpui.h: moved G_GNUC_INTERNAL before the return value (bug #352268). * tools/pdbgen/lib.pl : changed code generation rules to place G_GNUC_INTERNAL before the return value. * libgimp/*_pdb.h: regenerated.
2006-08-22 21:18:42 +08:00
G_GNUC_INTERNAL gboolean _gimp_wire_write_int32 (GIOChannel *channel,
const guint32 *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_write_int16 (GIOChannel *channel,
const guint16 *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_write_int8 (GIOChannel *channel,
const guint8 *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_write_double (GIOChannel *channel,
const gdouble *data,
gint count,
gpointer user_data);
G_GNUC_INTERNAL gboolean _gimp_wire_write_string (GIOChannel *channel,
gchar **data,
gint count,
gpointer user_data);
app, libgimp*, plug-ins, tools: settings custom check colors now space-invaded. We pass 2 GeglColor through the wire now. Since it is passed very early (when sharing the configuration), I had some issues with initialization order of GEGL, and in particular when calling gegl_init() before gegl_config() inside _gimp_config(), I had a bunch of such criticals: > Plugin script-fu: GLib-GObject: CRITICAL: Two different plugins tried to register 'GeglOpPlugIn-transform-core' Anyway in the end, I store the passed colors as raw bytes and strings in the GPConfig object, and re-construct the GeglColor last minute in _gimp_config().
2023-11-21 04:38:11 +08:00
G_GNUC_INTERNAL gboolean
_gimp_wire_write_gegl_color (GIOChannel *channel,
GBytes **pixel_data,
GBytes **icc_data,
gchar **encoding,
gint count,
gpointer user_data);
Initial revision
1997-11-25 06:05:25 +08:00
app/gimpunit.c all libgimp headers are included via gimp.h or gimpui.h, so 2000-05-31 Michael Natterer <mitch@gimp.org> * app/gimpunit.c * libgimp/*: all libgimp headers are included via gimp.h or gimpui.h, so include <gtk/gtk.h> there and in the *.c files. Various cleanups.
2000-05-31 07:38:46 +08:00
bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. 2001-11-23 Sven Neumann <sven@gimp.org> * configure.in: bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. Removed GDK_DISABLE_COMPAT_H and GTK_DISABLE_COMPAT_H from our default CFLAGS since they don't exist any longer. * RELEASE-TO-CVS.patch: removed since the glib/gtk+ API is supposed to be frozen now. * HACKING: removed reference to RELEASE-TO-CVS.patch * app/gui/menus.c * app/tools/gimptexttool.c: applied RELEASE-TO-CVS.patch to conform to the new GTK+/Pango API. * app/core/Makefile.am: generate marshallers with gimp_marshal prefix. * app/core/gimpmarshal.list: added all marshallers we use. * app/core/gimpmarshal.[ch]: regenerated. * app/[lots of .c files]: use gimp_marshal_* for all marshallers. * data/images/ * app/app_procs.c * app/gui/splash.c: * libgimpbase/Makefile.am * libgimpbase/gimpbase.h * libgimpbase/gimputils.[ch]: removed since they are no longer needed. * app/gimprc.c * plug-ins/common/ps.c * plug-ins/gdyntext/gdyntext.c * plug-ins/gdyntext/gdyntextcompat.c * plug-ins/gfig/gfig.c * plug-ins/gflare/gflare.c * plug-ins/script-fu/script-fu-scripts.c: use glib functions instead of gimp_strescape() and gimpstrcompress(). * cleaned up all header files: use G_BEGIN_DECLS/G_END_DECLS, declared all _get_type function as G_GNUC_CONST. * tools/pdbgen/enumcode.pl * tools/pdbgen/lib.pl: make them generate header files using G_BEGIN_DECLS/G_END_DECLS. * pixmaps/Makefile.am * pixmaps/wilber3.xpm: removed ... * data/images/tips_wilber.png: ... and added here as PNG * app/gui/tips-dialog.c: load the Wilber on demand using GdkPixbuf. * data/images/gimp_splash.ppm: removed ... * data/images/gimp_splash.png: ... and added as PNG * app/app_procs.c * app/gui/splash.[ch]: load the splash image using GdkPixbuf. * app/gui/about-dialog.c: sink the GtkPreview.
2001-11-23 07:46:13 +08:00
G_END_DECLS
app/gimpunit.c all libgimp headers are included via gimp.h or gimpui.h, so 2000-05-31 Michael Natterer <mitch@gimp.org> * app/gimpunit.c * libgimp/*: all libgimp headers are included via gimp.h or gimpui.h, so include <gtk/gtk.h> there and in the *.c files. Various cleanups.
2000-05-31 07:38:46 +08:00
Initial revision
1997-11-25 06:05:25 +08:00
#endif /* __GIMP_WIRE_H__ */