Graphisoft®

GX ModuleVersion: 16

Convert

Convert an image to another image format.

    GSErrCode Convert (
        GSHandle       sourceImage,

        const char*    sourceTypeMime,
        GSHandle*      targetImage,

        const char*    targetTypeMime,
        short          quality
);

Parameters

sourceImage
The image to be converted.
sourceTypeMime
The suggested format of the image.
targetImage
The address of the destination image.
targetTypeMime
The desired format type of the destination image.
quality
The desired pixel size in bits in the target.

Return Values

If the function succeeds, the return value is NoError. If the function fails, the return value is the error code.

Remarks

The destination GSHandle should be NULL-initialized.

This function also works if you do not supply the format of the image, but might be considerably slower.

There are some image formats which has no identifier sign (eg. TGA) in the image data. For these you are have to supply the format information.

Requirements

Version:
GX
Header:
GXImageBase.hpp
Import Library:
GXImageBase.lib
Module:
GXImageBase.dll [WIN], GXImageBase.framework [MAC]

See Also

GXImageBase