画像処理の実行 (マスク画像指定)

Namespace: FVIL.Measure
Assembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)

Syntax

C#
public virtual void Execute(
	CFviImage mask
)
Visual Basic
Public Overridable Sub Execute ( 
	mask As CFviImage
)

Parameters

mask
Type: FVIL.Data..::..CFviImage
マスク画像 [BIN,UC8,US16,S16,D64]
※チャネル数は 1 または処理対象画像と一致している必要があります。
※処理ウィンドウのサイズが処理対象画像と一致している必要があります。

Remarks

計測範囲を画素単位で示すマスク画像を用いて処理を実行します。
マスク画像の画素値が 0 の座標は計測対象から除外し、0 以外の座標を計測します。

入力画像が複数チャネルの場合はマスク画像も複数にすることでチャネル毎にマスクを指定できます。
入力画像が RGB24/RGB32 の場合は、マスク画像の 0,1,2 チャネルが R,G,B に対応します。
すべてのチャネルに共通のマスクを使用する場合は、チャネル数 1 のマスク画像を指定してください。

処理に失敗した場合は例外を発行します。
例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。

エラーコード：

値ErrorCode メンバ内容
51FVIL.ErrorCode.LICENSE_ERROR ライセンスキーが見つからない為、実行できません。 または、FVIL._SetUp.InitVisionLibrary が実行されていません。
1FVIL.ErrorCode.FAILED_TO_ALLOCATEメモリ確保に失敗しました。
12FVIL.ErrorCode.INVALID_OBJECT指定された画像オブジェクトが無効です。
81FVIL.ErrorCode.HAVE_NOT_IMAGE画像オブジェクトが設定されていません。
18FVIL.ErrorCode.INVALID_CHANNEL処理対象チャネル指標が不正です。
19FVIL.ErrorCode.INVALID_PROCAREA処理ウィンドウのサイズが不正です。
16FVIL.ErrorCode.INVALID_IMAGETYPEマスクの画像種別が不正です。
99FVIL.ErrorCode.NOMATCH_CHANNEL処理対象画像とマスク画像のチャネル数に矛盾があります。
91FVIL.ErrorCode.INVALID_SRC_IMAGETYPE入力画像の画像種別が不正です。
97FVIL.ErrorCode.INVALID_SRC_CHANNEL入力画像のチャネル数が不正です。

Exceptions

ExceptionCondition
FVIL..::..CFviExceptionこの例外の原因については、上記のエラーコード表をご参照ください。

See Also