This function is used to convert an IMAGE type variable containing an image in DIB format or in a recognised file format into another image format.
Note:
In Java/Web and Cloud version, the available file formats are restricted to BMP, PNG, JPG, TIFF and GIF formats.
TIFF format support requires Java 9 or later, or the installation of a third-party ImageIO plugin. Integrated support for TIFF and PNM formats is no longer available as the image library used (jai) is not compatible with Java 9.
If the image format is recognised by the system and matches the requested output format, the function does not perform any operation and returns code 1 (Operation completed successfully).
Context
Windows client
Windows server
Java client
Java server
Adelia Web client
Adelia Cloud client
Event Adelia client
Parameters
IMAGE |
ImageVar |
IMAGE type variable. |
NUM_BIN_4 |
FileFormat |
Image format used to save the file: 0 BMP format 1 PCX format 2 PNG format 3 PPM format 4 PGM format 5 PBM format 6 JPEG format 7 TGA format 8 GIF format 9 TIFF format 13 MNG format 18 JP2 format |
NUM_BIN_2 |
ReturnCode |
Return code for the operation: -3 The input image format is not supported. -2 The IMAGE variable is empty. -1 Error while opening or writing file. 0 Internal error. 1 Operation completed successfully. |
Example
FileFormat = 6
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxConvertBitmap' ImageVar FileName FileFormat ReturnCode
List of the VaToolBx functions by topic