is_LoadParameters

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_LoadParameters (HIDS hCam, char* pFilename)

Description

Achtung

This function is obsolete and should not be used anymore. We recommend to use the is_ParameterSet() function instead (see also Obsolete functions).

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 appendix describes the structure of a uEye ini file.

Achtung

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.

Hinweis

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
"\\cam\\set1" or "/cam/set1", or
"\\cam\\set2" or "/cam/set2", respectively.

If NULL is passed, the "Open File" dialog is displayed.

You can load the parameter sets stored in the camera EEPROM using specific filenames:

"\\cam\\set1" or "/cam/set1"	Parameter set 1
"\\cam\\set2" or "/cam/set2"	Parameter set 2

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()

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > Obsolete functions >	History back Previous chapter Next chapter Print
is_LoadParameters