Converts a picture into another image format.
GSErrCode ACAPI_Goodies ( APIAny_ConvertPictureID, API_PictureHandle* oldPict, API_PictureHandle* newPict );
Parameters
- oldPict
- [in] Parameters of the source picture. The old format and data must be passed in the
storageFormat
andpictHdl
fields, respectively. - newPict
- [in/out] Parameters of the destination picture. The new format of the picture must be passed in the
storageFormat
field. ThepictHdl
field will be returned according to the specified format.
Return Values
NoError
- The function has completed with success.
APIERR_BADPARS
- parameters are nullptr or storage formats are invalid
APIERR_MEMFULL
- Not enough memory to create the new
pictHdl
For other common API errors see the API Errors document.
Remarks
This function is used to convert a picture from one standard image format to an other. Any picture format can be passed in both the input and output parameters.
See also APIAny_ConvertMimePictureID if you want to specify the image format using MIME types.
Requirements
- Version: API 4.1 or later
- Header: APIdefs_Goodies.h
See Also
API_PictureHandle
API_PictureFormat
APIAny_ConvertMimePictureID
ACAPI_Goodies
API Functions