 |
 |
|---|---|
USB 2.0 USB 3.0 GigE |
USB 2.0 USB 3.0 GigE |
Syntax
INT is_LoadImageMem (HIDS hCam, char* File, char** ppcImgMem, int* pid)
Description
|
This function is obsolete and should not be used anymore. We recommend to use the is_ImageFile() function instead. |
is_LoadImageMem() loads an image from a file. The image must have been saved in BMP format. The image, together with its color format and color depth properties, is loaded into a newly allocated image memory.
Using the is_FreeImageMem() function, you can release the image memory again.
Input parameters
hCam |
Camera handle |
File |
File name You can either pass an absolute or a relative path. If NULL is passed, the "Open File" dialog opens. |
ppcImgMem |
Pointer to a variable containing the starting address |
pid |
Pointer to a variable containing the memory ID |
Return values
IS_CANT_ADD_TO_SEQUENCE |
The image memory is already included in the sequence and cannot be added again. |
IS_CANT_CLEANUP_MEMORY |
The driver could not release the allocated memory. |
IS_CANT_COMMUNICATE_WITH_DRIVER |
Communication with the driver failed because no driver has been loaded. |
IS_CANT_OPEN_DEVICE |
An attempt to initialize or select the camera failed (no camera connected or initialization error). |
IS_FILE_READ_INVALID_BMP_ID |
The specified file is not a valid bitmap file. |
IS_FILE_READ_INVALID_BMP_SIZE |
The bitmap size is not correct (bitmap too large). |
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_IO_REQUEST_FAILED |
An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match. |
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()
