Is_Loadparameters - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.5.15 is_LoadParameters

USB 2.0
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
function instead (see also
is_LoadParameters() loads the parameters for a camera from a uc480 ini file or from the camera EEPROM.
Using the
is_SaveParameters()
Only camera-specific ini files can be loaded. 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
hCam
pFilename
You can load the parameter sets stored in the camera EEPROM using specific filenames:
pFilename
"\\cam\\set1" or "/cam/set1"
"\\cam\\set2" or "/cam/set2"
Return values
IS_CANT_ADD_TO_SEQUENCE
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_CRC_ERROR
IS_DR_CANNOT_CREATE_SURFACE
IS_DR_CANNOT_CREATE_TEXTURE
IS_DR_CANNOT_CREATE_VERTEX_BUFFER
IS_DR_DEVICE_OUT_OF_MEMORY
IS_DR_LIBRARY_NOT_FOUND
IS_FILE_WRITE_OPEN_ERROR
IS_INVALID_CAMERA_TYPE
IS_INVALID_CAPTURE_MODE
398
USB 2.0
Obsolete functions ).
379
function, you can save camera parameters in an ini file or in the camera.
412
Camera handle
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.
uc480 parameter file
504
Parameter set 1
Parameter set 2
The image memory is already included in the sequence
and cannot be added again.
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.
The image surface or overlay surface could not be
created.
The texture could not be created.
The vertex buffer could not be created.
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
is_ParameterSet()
section in the appendix describes the
© 2013 Thorlabs GmbH
292