mirror of
https://gitlab.gnome.org/GNOME/gimp.git
synced 2025-07-03 09:23:24 +00:00

These are not usable by plug-ins anymore which should store their data between runs as arguments or aux arguments (in case of values which should be stored from one run to another but are not really usable for non-interactive scripts). These are per-plug-in (not polluting the whole process space with just random strings as identifiers which could be used by other plug-ins) and even survive restarts of GIMP. I still keep these functions, but only internally, as they are used to store settings of GimpAspectPreview, GimpDrawablePreview and GimpZoomPreview across plug-in runs. Still I changed their API to set and return a GBytes directly (mimicking the private PDB functions' API). Also I remove gimp_pdb_get_data_size() which is useless when exchanging GBytes directly. Note that the 2 functions are still exported in the library, and only not advertized through headers (so they are not really internal, just hidden), on purpose, because we need to call them in libgimpui. So it is still relatively easy for a plug-in to use them. Nevertheless I made clear in the function documentation that these must not be considered public and could end up deleted at any time. Any plug-in still trying to call these takes the risk of having their code relying on unreliable API.
55 lines
1.7 KiB
C
55 lines
1.7 KiB
C
/* GIMP - The GNU Image Manipulation Program
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
*
|
|
* gimppdb-private.h
|
|
* Copyright (C) 2019 Michael Natterer <mitch@gimp.org>
|
|
*
|
|
* 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_PDB_PRIVATE_H__
|
|
#define __GIMP_PDB_PRIVATE_H__
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
typedef enum
|
|
{
|
|
GIMP_PDB_ERROR_FAILED, /* generic error condition */
|
|
GIMP_PDB_ERROR_CANCELLED,
|
|
GIMP_PDB_ERROR_PDB_NOT_FOUND,
|
|
GIMP_PDB_ERROR_INVALID_ARGUMENT,
|
|
GIMP_PDB_ERROR_INVALID_RETURN_VALUE,
|
|
GIMP_PDB_ERROR_INTERNAL_ERROR
|
|
} GimpPdbErrorCode;
|
|
|
|
|
|
#define GIMP_PDB_ERROR (_gimp_pdb_error_quark ())
|
|
|
|
GQuark _gimp_pdb_error_quark (void) G_GNUC_CONST;
|
|
|
|
|
|
GimpPDB * _gimp_pdb_new (GimpPlugIn *plug_in);
|
|
|
|
GimpPlugIn * _gimp_pdb_get_plug_in (GimpPDB *pdb);
|
|
|
|
gboolean gimp_pdb_get_data (const gchar *identifier,
|
|
GBytes **data);
|
|
gboolean gimp_pdb_set_data (const gchar *identifier,
|
|
GBytes *data);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GIMP_PDB_PRIVATE_H__ */
|