© 2013 Thorlabs GmbH398
DCx Cameras
4.5.15 is_LoadParameters
Syntax
INT is_LoadParameters (HIDS hCam, char* pFilename)
Description
Attention
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 uc480 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 uc480 parameter file section in the appendix describes the
structure of a uc480 ini file.
Attention
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.
Input parameters
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"
"\\cam\\set2" or "/cam/set2"
Return values
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.
An attempt to initialize or select the camera failed (no
camera connected or initialization 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.
The DirectRenderer library could not be found.
File cannot be opened for writing or reading.
The camera type defined in the .ini file does not match
the current camera model.
The function can not be executed in the current camera
292
379
412
504