ZmSetCorrectionValue

Function

Set the correction value.

Format

Ret = ZmSetCorrectionValue ( Id , ChannelNo , Type , CorrectionValue1 , CorrectionValue1 , Format )

Parameters

Id [ VB.NET： Short ] [ C, C++： short ] [ C#： short ] [ Python： ctypes.c_short ]
Specify the device ID retrieved from ZmInit.

ChannelNo [ VB.NET： UShort ] [ C, C++： unsigned short ] [ C#： ushort ] [ Python： ctypes.c_ushort ]
Specify the channel number.

Type [ VB.NET： UShort ] [ C, C++： unsigned short ] [ C#： ushort ] [ Python： ctypes.c_ushort ]
Specify the correction type.

Definition	Value [Dec]	Description
ZM_CORRECTION_TYPE_OPEN	0	Correction type Open
ZM_CORRECTION_TYPE_SHORT	1	Correction type Short

CorrectionValue1 [ VB.NET： Single ] [ C, C++： float ] [ C#： float ] [ Python： ctypes.c_float ]
Specify the correction value 1.

CorrectionValue2 [ VB.NET： Single ] [ C, C++： float ] [ C#： float ] [ Python： ctypes.c_float ]
Specify the correction value 2.

Format [ VB.NET： UShort ] [ C, C++： unsigned short ] [ C#： ushort ] [ Python： ctypes.c_ushort ]
Specify the correction value format.

Type	Definition	Value [Dec]	Description
Open	ZM_CORRECTION_FORMAT_OPEN_GB	1	G,B
Short	ZM_CORRECTION_FORMAT_SHORT_RX	1	Rs,X

Return Value

Ret [ VB.NET： Integer ] [ C, C++： long ] [ C#： int ] [ Python： ctypes.c_long ]

Definition	Value [Dec]	Description
ZM_ERR_SUCCESS	0	Normality completion
ZM_ERR_SYS_CHANNEL_NO	20100	Channel No is out of the settable range.
ZM_ERR_SYS_TYPE	20108	Type is out of the settable range.
ZM_ERR_SYS_FORMAT	20113	Format is out of the settable range.

The others (See also: Details of Error Code)

Initial Value

Correction value 1 (CorrectionValue1) = 0
Correction value 2 (CorrectionValue2) = 0

Remarks

Set the correction value.
Correction value can be set for each channel.

The correction value is set based on the current conditions for the correction.
If the conditions for the correction are changed, please set the correction value again.

The correction value is retained, so once the conditions for the correction have been set, there is no need to set correction value again.

For details about correction, please refer to the glossary "Correction".

Example

When ChannelNo = 1 is "0 : Correction type Open" and correction value format is "1 : G,B", set "Correction value 1 = 10.0" and "Correction value 2 = 50.0".

VB.NET	Dim Ret As Integer Ret = ZmSetCorrectionValue ( Id , 1 , 0 , 10.0 , 50.0 , 1 )
C, C++	long Ret; Ret = ZmSetCorrectionValue ( Id , 1 , 0 , 10.0 , 50.0 , 1 );
C#	int Ret; Ret = zm.SetCorrectionValue ( Id , 1 , 0 , 10.0F , 50.0F , 1 );
Python	Ret = ctypes.c_long() Ret.value = czm.ZmSetCorrectionValue ( Id , 1 , 0 , 10.0 , 50.0 , 1 )