 |
 |
|---|---|
USB 2.0 GigE |
USB 2.0 GigE |
Syntax
INT is_LoadParameters (HIDS hCam, char* pFilename)
Description
|
This function is obsolete and should not be used anymore. We recommend to use the is_ParameterSet() function instead. |
is_LoadParameters() loads the parameters for a camera from a uEye ini file or from the camera EEPROM. Using the is_SaveParameters() function, you can save camera parameters in an ini file or in the camera.
Only camera-specific ini files can be loaded. The "uEye parameter file" section in the uEye manual describes the structure of a uEye ini file.
|
When loading an ini file, make sure that the image size (AOI) and color depth parameters in the ini file match those in the allocated memory. Otherwise, display errors may occur. |
|
As the USB uEye XS has only one image size you cannot set a separate resolution for trigger mode. |
Input parameters
hCam |
Camera handle |
pFilename |
Pointer to a filename. You can either pass an absolute or a relative path. For the internal camera parameter sets, these would be If NULL is passed, the "Open File" dialog is displayed. |
You can load the parameter sets stored in the camera EEPROM using specific filenames:
Return values
IS_CANT_ADD_TO_SEQUENCE |
The image memory is already included in the sequence and cannot be added again. |
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_CRC_ERROR |
A CRC error-correction problem occurred while reading the settings. |
IS_DR_CANNOT_CREATE_SURFACE |
The image surface or overlay surface could not be created. |
IS_DR_CANNOT_CREATE_TEXTURE |
The texture could not be created. |
IS_DR_CANNOT_CREATE_VERTEX_BUFFER |
The vertex buffer could not be created. |
IS_DR_DEVICE_OUT_OF_MEMORY |
Not enough graphics memory available. |
IS_DR_LIBRARY_NOT_FOUND |
The DirectRenderer library could not be found. |
IS_FILE_WRITE_OPEN_ERROR |
File cannot be opened for writing or reading. |
IS_INVALID_CAMERA_TYPE |
The camera type defined in the .ini file does not match the current camera model. |
IS_INVALID_CAPTURE_MODE |
The function can not be executed in the current camera operating mode (free run, trigger or standby). |
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_CALIBRATED |
The camera does not contain any calibration data. |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_NULL_POINTER |
Invalid array |
IS_OUT_OF_MEMORY |
No memory could be allocated. |
IS_PARAMETER_SET_NOT_PRESENT |
Parameter set is not present. |
IS_SEQUENCE_BUF_ALREADY_LOCKED |
The memory could not be locked. The pointer to the buffer is invalid. |
IS_SUCCESS |
Function executed successfully |
IS_TIMED_OUT |
A timeout occurred. An image capturing process could not be terminated within the allowable period. |
Related functions
•is_ParameterSet()
