マスク領域から画像オブジェクトへの複写

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

Syntax

C#
public virtual void MaskCopyTo(
	CFviImage image
)
Visual Basic
Public Overridable Sub MaskCopyTo ( 
	image As CFviImage
)

Parameters

image
Type: FVIL.Data..::..CFviImage
複写先画像

Remarks

マスク領域のビット(マスク情報)を複写先の画像オブジェクトへそのまま複写します。

処理範囲を考慮しますので、予め Window プロパティにより処理範囲の設定を行ってください。
複写先に指定できる画像オブジェクトの条件は以下の通りです。

  • 複写先の処理範囲サイズと一致している事
    ※但し、複写先の処理範囲の縦と横のサイズがいずれも大きい場合は許容されます。
  • チャネル数が 1 である事
  • 画像種別が UC8 である事

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

エラーコード：

値ErrorCode メンバ内容
23FVIL.ErrorCode.NOT_ALLOCATEDマスク領域が確保されていません。
11FVIL.ErrorCode.INVALID_PARAMETER引数 image に null が指定されました。
12FVIL.ErrorCode.INVALID_OBJECT引数に指定された画像オブジェクトの領域が確保されていません。
16FVIL.ErrorCode.INVALID_IMAGETYPE引数に指定された画像オブジェクトの画像種別が処理対象外です。
18FVIL.ErrorCode.NOMATCH_CHANNEL引数に指定された画像オブジェクトのチャネル数が処理対象外です。
19FVIL.ErrorCode.INVALID_PROCAREA処理範囲のサイズが一致していません。

Exceptions

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

See Also