画像コピー (リージョン指定)

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

Syntax

C#
public virtual void Copy(
	CFviImage src,
	Object region,
	OriginMode origin_mode
)
Visual Basic
Public Overridable Sub Copy ( 
	src As CFviImage,
	region As Object,
	origin_mode As OriginMode
)

Parameters

src
Type: FVIL.Data..::..CFviImage
複製元の画像 [BIN,UC8,S16,US16,D64,RGB32]
region
Type: System..::..Object
複製範囲を示すリージョン(CFviRegion)または２値画像(CFviImage)。
２値画像を指定する場合は以下の条件を満たしている必要が有ります。
  • 画像種別が BIN である事。
  • チャネル数が 1 でない時は、src のチャネル数と一致している事。
origin_mode
Type: FVIL..::..OriginMode
原点モード [Image,Window]
  • Image:画像の左上を原点とします。(処理ウィンドウは無視します。)
  • Window:処理ウィンドウの左上を原点とします。

Remarks

リージョンで示す範囲のみ画像をコピーします。
リージョンの始点は origin_mode で指定された原点からの相対値を示します。

処理対象画像の条件:

処理対象の画像は下記の条件を満たしている必要が有ります。

原点モード:

原点モードは、現在の画像と src と region (注:画像の時)の処理ウィンドウを使用するか否かを示します。 origin_mode が Image の時は、画像の左上を原点として画像全面を処理範囲とします。 origin_mode が Window の時は、設定されている処理ウィンドウを処理範囲とします。
各画像オブジェクトの処理範囲のサイズが一致していない場合は、内部で最小の幅、高さに正規化します。

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

エラーコード：

値ErrorCode メンバ内容
51FVIL.ErrorCode.LICENSE_ERROR ライセンスキーが見つからない為、実行できません。 または、 FVIL._SetUp.InitVisionLibrary が実行されていません。
1FVIL.ErrorCode.FAILED_TO_ALLOCATEメモリが不足しています。
11FVIL.ErrorCode.INVALID_PARAMETER引数に指定された値が不正です。
12FVIL.ErrorCode.INVALID_OBJECT 画像またはリージョンの FIE ハンドルが無効です。 または、処理対象画像の条件が満たされていません。
21FVIL.ErrorCode.NOT_SUPPORTED引数 region に指定された型はサポートしていません。
93FVIL.ErrorCode.NOMATCH_IMAGETYPE画像種別が一致していません。
99FVIL.ErrorCode.NOMATCH_CHANNEL画像のチャネル数が一致していません。

Exceptions

ExceptionCondition
System..::..NullReferenceException引数に null が指定されました。
FVIL..::..CFviExceptionこの例外の原因については、上記のエラーコード表をご参照ください。

See Also