Function
GimpRunSaveFunc
unstable since: 3.0
Declaration
GimpValueArray*
(* GimpRunSaveFunc) (
GimpProcedure* procedure,
GimpRunMode run_mode,
GimpImage* image,
gint n_drawables,
GimpDrawable** drawables,
GFile* file,
GimpMetadata* metadata,
GimpProcedureConfig* config,
gpointer run_data
)
Description [src]
The save function is run during the lifetime of the GIMP session, each time a plug-in save procedure is called.
If a MimeType was passed in gimp_save_procedure_new(), then metadata will be
non-NULL and can be tweaked by the run() function if needed. Otherwise you
can let it as-is and it will be stored back into the exported file according
to rules on metadata export shared across formats.
Available since: 3.0
Parameters
procedure-
Type:
GimpProcedureThe
GimpProcedurethat runs.The data is owned by the caller of the function. run_mode-
Type:
GimpRunModeThe
GimpRunMode. image-
Type:
GimpImageThe image to save.
The data is owned by the caller of the function. n_drawables-
Type:
gintThe number of drawables to save.
drawables-
Type: An array of
GimpDrawable*The drawables to save.
The length of the array is specified in the n_drawablesargument.The data is owned by the caller of the function. file-
Type:
GFileThe
GFileto save to.The data is owned by the caller of the function. metadata-
Type:
GimpMetadataMetadata object prepared for the mimetype passed in
gimp_file_procedure_set_mime_types()if export_metadata argument was set in gimp_save_procedure_new().The data is owned by the caller of the function. config-
Type:
GimpProcedureConfigThe
procedure‘s remaining arguments.The data is owned by the caller of the function. run_data-
Type:
gpointerThe run_data given in gimp_save_procedure_new().
The argument can be NULL.The data is owned by the caller of the function.
Return value
Type: GimpValueArray
The procedure‘s return values.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |