Method
GimpExportOptionsget_image
since: 3.0
Declaration [src]
GimpExportReturn
gimp_export_options_get_image (
GimpExportOptions* options,
GimpImage** image
)
Description [src]
Takes an image to be exported, possibly creating a temporary copy
modified according to export settings in options
(such as the
capabilities of the export format).
If necessary, a copy is created, converted and modified, image
changed to point to the new image and the procedure returns
GimpExportReturn
.
In this case, you must take care of deleting the created image using
gimp_image_delete()
once the image has been exported, unless you
were planning to display it with gimp_display_new()
, or you will leak memory.
If GimpExportReturn
is returned, then image
is still the
original image. You should neither modify it, nor should you delete
it in the end. If you wish to temporarily modify the image before
export anyway, call gimp_image_duplicate()
when
GimpExportReturn
was returned.
Available since: 3.0
Parameters
image
-
Type:
GimpImage
The image.
The argument will be modified by the function. The data is owned by the caller of the function.
Return value
Type: GimpExportReturn
An enum of GimpExportReturn
.