２値化設定(CH0)

Namespace: FVIL.Video
Assembly: FVILdevice (in FVILdevice.dll) Version: 3.1.0.0 (3.1.0.5)

Syntax

C#
public virtual CFviVideoBinarize BinarizeCH0 { get; set; }
Visual Basic
Public Overridable Property BinarizeCH0 As CFviVideoBinarize
	Get
	Set

Return Value

Type: CFviVideoBinarize

FVC05が持つ２値化機能の設定を行います。 このプロパティは、チャネル 0 に対して行います。


許容値 (Mode)：
値意味
0グレイ
1２値化

許容値 (Threshold)：
値意味
0~255２値化閾値

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

エラーコード：

値ErrorCode メンバ内容
25FVIL.ErrorCode.NOT_OPENEDデバイスがオープンされていません。
11FVIL.ErrorCode.INVALID_PARAMETER引数に指定された値が不正です。
31066FVIL.Video.ErrorCode.SET_BINARIZE2値化の設定に失敗しました。

Remarks

２値化とは、1画素 8bit のグレイ画像の深度(0~255)を1画素 1bit の深度にする機能のことを言います。 深度の変換は、指定された閾値を基準に行います。 閾値を下回っていれば黒(0)、上回っていれば白(1)に変換します。

Mode の設定は、下記関数に有効です。

Mode に 0 を指定した場合、 上記関数にはグレイ(FVIL.ImageType.UC8)の画像オブジェクトを指定してください。 Mode に 1 を指定した場合、 上記関数には２値(FVIL.ImageType.BIN)の画像オブジェクトを指定してください。

Threshold の設定は、下記関数にも適用されます。

Examples

このプロパティはインスタンスの参照を返すものではありません。 従って、CFviVideoBinarize 構造体の インスタンスのメンバを個別に変更する事は出来ません。 設定を変更するには下記の何れかの方法で行ってください。

以下は、CFviVideoBinarize 構造体の 初期値指定コンストラクタで構築したインスタンスを代入する方法です。

C# Copy imageCopy
video.BinarizeCH0 = new FVIL.Video.CFviVideoBinarize( 1, 128 );

以下は、このプロパティから現在値を取得して、閾値のみを変更して再度代入する方法です。

C# Copy imageCopy
FVIL.Video.CFviVideoBinarize object = video.BinarizeCH0;   // (1) 現在値取得
object.Threshold = 128;        // (2) 閾値のみ変更
video.BinarizeCH0 = object;    // (3) 再度、代入

Exceptions

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

See Also