THORLABS DCU22 Series User Manual

© 2013 Thorlabs GmbH
4 Programming (SDK)
409
4.5.24 is_SaveImageMem
USB 2.0
USB 3.0
USB 2.0
USB 3.0
Syntax
INT is_SaveImageMem (HIDS hCam, const IS_CHAR* File, char* pcMem, int nID)
Description
Attention
This function is obsolete and should not be used anymore. We recommend to use the is_ImageFile()
function instead (see also Obsolete functions ).
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).
Note
In Direct3D mode, overlay data are 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()
264
379
264
247
337

THORLABS DCU22 Series Specifications

General

Brand	THORLABS
Model	DCU22 Series
Category	Security Camera
Language	English