mirror of
https://gitlab.gnome.org/GNOME/gimp.git
synced 2025-10-05 21:02:42 +02:00
This really feels like internal API which we'd want to keep private (and used by core plug-ins only). Also as Jacob noticed, it's not even included in libgimpbase/gimpbase.h so plug-ins wishing to use this API need to include this file specifically anyway (but the header is still installed and the API is introspected). Since we cannot remove these functions now that GIMP 3 was published, for API stability, I am only deprecating them both in the C API with macros and in the bindings with GObject Introspection annotations. Therefore any third-party plug-in developer trying to use these functions in a plug-in will get build-time or run-time warnings. Then when we'll move on to GIMP 4 development, we can remove the deprecation and simply make this file private-only use instead.
92 lines
2.4 KiB
C
92 lines
2.4 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpparasiteio.h
|
|
* Copyright (C) 1999 Tor Lillqvist <tml@iki.fi>
|
|
*
|
|
* 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 3 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, see
|
|
* <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __GIMP_PARASITE_IO_H__
|
|
#define __GIMP_PARASITE_IO_H__
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/* For information look into the C source or the html documentation */
|
|
|
|
|
|
/* Data structures for various standard parasites used by plug-ins and
|
|
* the GIMP core, and functions to build and parse their string
|
|
* representations.
|
|
*/
|
|
|
|
/*
|
|
* Pixmap brush pipes.
|
|
*/
|
|
|
|
#define GIMP_PIXPIPE_MAXDIM 4
|
|
|
|
typedef struct _GimpPixPipeParams GimpPixPipeParams;
|
|
|
|
/**
|
|
* GimpPixPipeParams:
|
|
* @step: Step
|
|
* @ncells: Number of cells
|
|
* @dim: Dimension
|
|
* @cols: Columns
|
|
* @rows: Rows
|
|
* @cellwidth: Cell width
|
|
* @cellheight: Cell height
|
|
* @placement: Placement
|
|
* @rank: Rank
|
|
* @selection: Selection
|
|
*
|
|
* PLease somebody help documenting this.
|
|
**/
|
|
struct _GimpPixPipeParams
|
|
{
|
|
gint step;
|
|
gint ncells;
|
|
gint dim;
|
|
gint cols;
|
|
gint rows;
|
|
gint cellwidth;
|
|
gint cellheight;
|
|
gchar *placement;
|
|
gint rank[GIMP_PIXPIPE_MAXDIM];
|
|
gchar *selection[GIMP_PIXPIPE_MAXDIM];
|
|
};
|
|
|
|
/* Initialize with dummy values */
|
|
G_DEPRECATED
|
|
void gimp_pixpipe_params_init (GimpPixPipeParams *params);
|
|
|
|
/* Parse a string into a GimpPixPipeParams */
|
|
G_DEPRECATED
|
|
void gimp_pixpipe_params_parse (const gchar *parameters,
|
|
GimpPixPipeParams *params);
|
|
|
|
/* Build a string representation of GimpPixPipeParams */
|
|
G_DEPRECATED
|
|
gchar * gimp_pixpipe_params_build (GimpPixPipeParams *params) G_GNUC_MALLOC;
|
|
|
|
/* Free the internal values. It does not free the struct itself. */
|
|
G_DEPRECATED
|
|
void gimp_pixpipe_params_free (GimpPixPipeParams *params);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GIMP_PARASITE_IO_H__ */
|