![]() |
![]() |
---|---|
USB 2.0 USB 3.0 GigE |
USB 2.0 USB 3.0 GigE |
Syntax
INT is_SaveImageMem (HIDS hCam, const IS_CHAR* File, char* pcMem, int nID)
Description
This function is obsolete and should not be used anymore. We recommend to use the is_ImageFile() function instead. |
is_SaveImageMem() saves an image in bitmap (*.BMP) format to a file. The images are read out from the specified image memory. The bitmap is stored with the color depth that was used when allocating the image memory (in DIB mode) or that was set for the current color mode (in Direct3D mode).
In Direct3D mode, overlay data is not saved. |
Input parameters
hCam |
Camera handle |
File |
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" dialog will be displayed. |
pcMem |
Pointer to the image memory |
nID |
Image memory ID |
Return values
IS_FILE_WRITE_OPEN_ERROR |
File cannot be opened for writing or reading. |
IS_INVALID_CAMERA_HANDLE |
Invalid camera handle |
IS_INVALID_MEMORY_POINTER |
Invalid pointer or invalid memory ID |
IS_INVALID_PARAMETER |
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode. |
IS_NO_SUCCESS |
General error message |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_OUT_OF_MEMORY |
No memory could be allocated. |
IS_SEQUENCE_BUF_ALREADY_LOCKED |
The memory could not be locked. The pointer to the buffer is invalid. |
IS_SUCCESS |
Function executed successfully |
Related functions
•is_ImageFile()
•is_GetImageMem()
•is_SetImageMem()