mirror of https://github.com/GNOME/gimp.git
321 lines
8.4 KiB
C
321 lines
8.4 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimp.h
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef __GIMP_H__
|
|
#define __GIMP_H__
|
|
|
|
#include <glib.h>
|
|
|
|
#include <libgimpcolor/gimpcolor.h>
|
|
#include <libgimpmath/gimpmath.h>
|
|
#include <libgimpbase/gimpbase.h>
|
|
|
|
#include <libgimp/gimpenums.h>
|
|
#include <libgimp/gimptypes.h>
|
|
|
|
#include <libgimp/gimpchannel.h>
|
|
#include <libgimp/gimpdrawable.h>
|
|
#include <libgimp/gimpimage.h>
|
|
#include <libgimp/gimplayer.h>
|
|
#include <libgimp/gimpmisc.h>
|
|
#include <libgimp/gimppixelrgn.h>
|
|
#include <libgimp/gimpproceduraldb.h>
|
|
#include <libgimp/gimpselection.h>
|
|
#include <libgimp/gimptile.h>
|
|
|
|
#include <libgimp/gimp_pdb.h>
|
|
|
|
#ifdef G_OS_WIN32
|
|
# include <stdlib.h> /* For __argc and __argv */
|
|
# ifdef LIBGIMP_COMPILATION
|
|
# define GIMPVAR __declspec(dllexport)
|
|
# else /* !LIBGIMP_COMPILATION */
|
|
# define GIMPVAR extern __declspec(dllimport)
|
|
# endif /* !LIBGIMP_COMPILATION */
|
|
#else /* !G_OS_WIN32 */
|
|
# define GIMPVAR extern
|
|
#endif
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
#define gimp_get_data gimp_procedural_db_get_data
|
|
#define gimp_get_data_size gimp_procedural_db_get_data_size
|
|
#define gimp_set_data gimp_procedural_db_set_data
|
|
|
|
|
|
GIMPVAR guint gimp_major_version;
|
|
GIMPVAR guint gimp_minor_version;
|
|
GIMPVAR guint gimp_micro_version;
|
|
|
|
GIMPVAR GIOChannel *_readchannel;
|
|
|
|
typedef void (* GimpInitProc) (void);
|
|
typedef void (* GimpQuitProc) (void);
|
|
typedef void (* GimpQueryProc) (void);
|
|
typedef void (* GimpRunProc) (gchar *name,
|
|
gint nparams,
|
|
GimpParam *param,
|
|
gint *nreturn_vals,
|
|
GimpParam **return_vals);
|
|
|
|
|
|
struct _GimpPlugInInfo
|
|
{
|
|
/* called when the gimp application initially starts up */
|
|
GimpInitProc init_proc;
|
|
|
|
/* called when the gimp application exits */
|
|
GimpQuitProc quit_proc;
|
|
|
|
/* called by the gimp so that the plug-in can inform the
|
|
* gimp of what it does. (ie. installing a procedure database
|
|
* procedure).
|
|
*/
|
|
GimpQueryProc query_proc;
|
|
|
|
/* called to run a procedure the plug-in installed in the
|
|
* procedure database.
|
|
*/
|
|
GimpRunProc run_proc;
|
|
};
|
|
|
|
struct _GimpParamDef
|
|
{
|
|
GimpPDBArgType type;
|
|
gchar *name;
|
|
gchar *description;
|
|
};
|
|
|
|
struct _GimpParamRegion
|
|
{
|
|
gint32 x;
|
|
gint32 y;
|
|
gint32 width;
|
|
gint32 height;
|
|
};
|
|
|
|
union _GimpParamData
|
|
{
|
|
gint32 d_int32;
|
|
gint16 d_int16;
|
|
gint8 d_int8;
|
|
gdouble d_float;
|
|
gchar *d_string;
|
|
gint32 *d_int32array;
|
|
gint16 *d_int16array;
|
|
gint8 *d_int8array;
|
|
gdouble *d_floatarray;
|
|
gchar **d_stringarray;
|
|
GimpRGB d_color;
|
|
GimpParamRegion d_region;
|
|
gint32 d_display;
|
|
gint32 d_image;
|
|
gint32 d_layer;
|
|
gint32 d_layer_mask;
|
|
gint32 d_channel;
|
|
gint32 d_drawable;
|
|
gint32 d_selection;
|
|
gint32 d_boundary;
|
|
gint32 d_path;
|
|
gint32 d_unit;
|
|
GimpParasite d_parasite;
|
|
gint32 d_tattoo;
|
|
GimpPDBStatusType d_status;
|
|
};
|
|
|
|
struct _GimpParam
|
|
{
|
|
GimpPDBArgType type;
|
|
GimpParamData data;
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
* MAIN():
|
|
*
|
|
* A macro that expands to the appropriate main() function for the
|
|
* platform being compiled for.
|
|
*
|
|
* To use this macro, simply place a line that contains just the code
|
|
* MAIN() at the toplevel of your file. No semicolon should be used.
|
|
*
|
|
*/
|
|
|
|
#ifdef G_OS_WIN32
|
|
|
|
void set_gimp_PLUG_IN_INFO_PTR(GimpPlugInInfo *);
|
|
|
|
/* Define WinMain() because plug-ins are built as GUI applications. Also
|
|
* define a main() in case some plug-in still is built as a console
|
|
* application.
|
|
*/
|
|
# ifdef __GNUC__
|
|
# ifndef _stdcall
|
|
# define _stdcall __attribute__((stdcall))
|
|
# endif
|
|
# endif
|
|
|
|
# define MAIN() \
|
|
static int \
|
|
win32_gimp_main (int argc, char **argv) \
|
|
{ \
|
|
set_gimp_PLUG_IN_INFO_PTR(&PLUG_IN_INFO); \
|
|
return gimp_main (argc, argv); \
|
|
} \
|
|
\
|
|
struct HINSTANCE__; \
|
|
int _stdcall \
|
|
WinMain (struct HINSTANCE__ *hInstance, \
|
|
struct HINSTANCE__ *hPrevInstance, \
|
|
char *lpszCmdLine, \
|
|
int nCmdShow) \
|
|
{ \
|
|
return win32_gimp_main (__argc, __argv); \
|
|
} \
|
|
\
|
|
int \
|
|
main (int argc, char *argv[]) \
|
|
{ \
|
|
return win32_gimp_main (argc, argv); \
|
|
}
|
|
#else
|
|
#ifndef __EMX__
|
|
# define MAIN() \
|
|
int \
|
|
main (int argc, char *argv[]) \
|
|
{ \
|
|
return gimp_main (argc, argv); \
|
|
}
|
|
#else
|
|
# define MAIN() \
|
|
int \
|
|
main (int argc, char *argv[]) \
|
|
{ \
|
|
set_gimp_PLUG_IN_INFO(&PLUG_IN_INFO); \
|
|
return gimp_main (argc, argv); \
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
|
|
/* The main procedure that should be called with the
|
|
* 'argc' and 'argv' that are passed to "main".
|
|
*/
|
|
gint gimp_main (gint argc,
|
|
gchar *argv[]);
|
|
|
|
/* Forcefully causes the gimp library to exit and
|
|
* close down its connection to main gimp application.
|
|
*/
|
|
void G_GNUC_NORETURN gimp_quit (void);
|
|
|
|
/* Returns the default gdisplay (given at plug-in config time).
|
|
*/
|
|
gint32 gimp_default_display (void);
|
|
|
|
|
|
/* Install a procedure in the procedure database.
|
|
*/
|
|
void gimp_install_procedure (gchar *name,
|
|
gchar *blurb,
|
|
gchar *help,
|
|
gchar *author,
|
|
gchar *copyright,
|
|
gchar *date,
|
|
gchar *menu_path,
|
|
gchar *image_types,
|
|
gint type,
|
|
gint nparams,
|
|
gint nreturn_vals,
|
|
GimpParamDef *params,
|
|
GimpParamDef *return_vals);
|
|
|
|
/* Install a temporary procedure in the procedure database.
|
|
*/
|
|
void gimp_install_temp_proc (gchar *name,
|
|
gchar *blurb,
|
|
gchar *help,
|
|
gchar *author,
|
|
gchar *copyright,
|
|
gchar *date,
|
|
gchar *menu_path,
|
|
gchar *image_types,
|
|
gint type,
|
|
gint nparams,
|
|
gint nreturn_vals,
|
|
GimpParamDef *params,
|
|
GimpParamDef *return_vals,
|
|
GimpRunProc run_proc);
|
|
|
|
/* Uninstall a temporary procedure
|
|
*/
|
|
void gimp_uninstall_temp_proc (gchar *name);
|
|
|
|
/* Run a procedure in the procedure database. The parameters are
|
|
* specified via the variable length argument list. The return
|
|
* values are returned in the 'GimpParam*' array.
|
|
*/
|
|
GimpParam * gimp_run_procedure (gchar *name,
|
|
gint *nreturn_vals,
|
|
...);
|
|
|
|
/* Run a procedure in the procedure database. The parameters are
|
|
* specified as an array of GimpParam. The return
|
|
* values are returned in the 'GimpParam*' array.
|
|
*/
|
|
GimpParam * gimp_run_procedure2 (gchar *name,
|
|
gint *nreturn_vals,
|
|
gint nparams,
|
|
GimpParam *params);
|
|
|
|
/* Destroy the an array of parameters. This is useful for
|
|
* destroying the return values returned by a call to
|
|
* 'gimp_run_procedure'.
|
|
*/
|
|
void gimp_destroy_params (GimpParam *params,
|
|
gint nparams);
|
|
|
|
/* Destroy the an array of GimpParamDef's. This is useful for
|
|
* destroying the return values returned by a call to
|
|
* 'gimp_query_procedure'.
|
|
*/
|
|
void gimp_destroy_paramdefs (GimpParamDef *paramdefs,
|
|
gint nparams);
|
|
|
|
gdouble gimp_gamma (void);
|
|
gboolean gimp_install_cmap (void);
|
|
gint gimp_min_colors (void);
|
|
gboolean gimp_show_tool_tips (void);
|
|
|
|
gchar * gimp_get_progname (void);
|
|
|
|
void gimp_attach_new_parasite (const gchar *name,
|
|
gint flags,
|
|
gint size,
|
|
const gpointer data);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GIMP_H__ */
|