ZmSetCorrectionValue


機能

補正値を設定します。

書式

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

引数

Id [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
ZmInitで取得したデバイスIDを指定します。

ChannelNo [ VB.NET: UShort ] [ C, C++: unsigned short ] [ C#: ushort ] [ Python: ctypes.c_ushort ]
チャネル番号を指定します。

Type  [ VB.NET: UShort ] [ C, C++: unsigned short ] [ C#: ushort ] [ Python: ctypes.c_ushort ]
補正タイプを設定します。

定義


[Dec]

意味

ZM_CORRECTION_TYPE_OPEN

0

補正タイプオープン

ZM_CORRECTION_TYPE_SHORT

1

補正タイプショート

CorrectionValue1 [ VB.NET: Single ] [ C, C++: float ] [ C#: float ] [ Python: ctypes.c_float ]
補正値1を指定します。

CorrectionValue2 [ VB.NET: Single ] [ C, C++: float ] [ C#: float ] [ Python: ctypes.c_float ]
補正値2を指定します。

Format  [ VB.NET: UShort ] [ C, C++: unsigned short ] [ C#: ushort ] [ Python: ctypes.c_ushort ]
補正値フォーマットを指定します。

Type

定義


[Dec]

意味

オープンの場合

ZM_CORRECTION_FORMAT_OPEN_GB

1

G,B

ショートの場合

ZM_CORRECTION_FORMAT_SHORT_RX

1

Rs,X

戻り値

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

定義

戻り値
[Dec]

内容

ZM_ERR_SUCCESS

0

正常終了

ZM_ERR_SYS_CHANNEL_NO

20100

チャネル番号が設定可能範囲外です。

ZM_ERR_SYS_TYPE

20108

補正タイプが設定可能範囲外です

ZM_ERR_SYS_FORMAT

20113

補正値フォーマットが設定可能範囲外です

その他のエラー(参照:エラーコード詳細

初期値

補正値1(CorrectionValue1) = 0
補正値2(CorrectionValue2) = 0

説明

補正値を設定します。
補正値はチャネル毎に設定可能です。

補正値は現在の測定条件で設定されます。
測定条件を変更された際には再度補正値を設定してください。

補正値は保持していますので、一度設定した測定条件では再度設定の必要はありません。

補正についての詳細は用語集「補正」をご参照ください。

使用例

ChannelNo = 1が「0:補正タイプオープン」かつ「補正値フォーマットを1:G,B」の場合、「補正値1 = 10.0」、「補正値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 )
 

関連項目

ZmCorrection ZmGetCorrectionEnable ZmSetCorrectionEnable ZmGetCorrectionValue