214 DCx camera
© 2010 Thorlabs
7.3.66
is_SaveImageMemEx
Syntax
INT is_SaveImageMemEx (HIDS hCam, const IS_CHAR* File,
char* pcMem, int nID,
INT fileFormat, INT Param)
Description
is_SaveImageMemEx() saves an image in bitmap (*.BMP) or Jpeg (*.JPG) format to a file. The
images are read out from the specified image memory. The bitmap is stored with the colour depth
that was used when allocating the image memory (in DIB mode) or that was set for the current
colour mode (in Direct3D mode). JPEG files are always saved with a colour depth of 8 or 24 bits.
In Direct3D mode, overlay data is not saved.
Input Parameters
Pointer to a string containing the BMP filename. You can either pass an absolute
or a relative path.
If NULL is passed, the "Save as" dialogue will be displayed.
Pointer to the image memory
Specifies the output format of the file.
When you use IS_IMG_JPG to specify the file format, you can set the quality by
specifying a value between 1 and 100 for Param.
If Param=0, the system uses the default quality (75).
If you use IS_IMG_BMP, Param does not take effect.
Return Values
Function executed successfully
Invalid file format or invalid JPEG quality value