Is_Saveparameters - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.5.26 is_SaveParameters

USB 2.0
Syntax
INT is_SaveParameters (HIDS hCam, const IS_CHAR* pFilename)
Description
Attention
This function is obsolete and should not be used anymore. We recommend to use the
function instead (see also
is_SaveParameters() saves the current camera parameters to an ini file or to the EEPROM of the camera. You
can load saved parameters using the
in the appendix describes the structure of a uc480 ini file.
Input parameters
hCam
pFileName
You can save two parameter sets in the non-volatile EEPROM of the camera using specific filenames:
pFileName
"\\cam\\set1" or "/cam/set1"
"\\cam\\set2" or "/cam/set2"
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_CRC_ERROR
IS_INVALID_CAMERA_TYPE
IS_INVALID_CAMERA_HANDLE
IS_INVALID_PARAMETER
IS_IO_REQUEST_FAILED
IS_NO_SUCCESS
IS_NOT_CALIBRATED
IS_NOT_SUPPORTED
IS_NULL_POINTER
IS_SUCCESS
IS_TIMED_OUT
412
USB 2.0
Obsolete functions ).
379
is_LoadParameters()
Camera handle
Pointer to a filename You can either pass an absolute or a relative path. For
internal parameter sets, these are "\\cam\\set1" or "/cam/set1", or "\
\cam\\set2" or "/cam/set2", respectively.
If NULL is passed, the "Save as" dialog will be displayed..
function. The
398
Parameter set 1
Parameter set 2
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 camera type defined in the .ini file does not match
the current camera model.
Invalid camera handle
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not
available in this mode.
An IO request from the uc480 driver failed. Possibly the
versions of the uc480_api.dll (API) and the driver file
(uc480_usb.sys) do not match.
General error message
The camera does not contain any calibration data.
The camera model used here does not support this
function or setting.
Invalid array
Function executed successfully
A timeout occurred. An image capturing process could
not be terminated within the allowable period.
is_ParameterSet()
uc480 parameter file
504
© 2013 Thorlabs GmbH
292
section