データ複製

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

Syntax

C#
public virtual CFviGdiImage Copy(
	CFviImage src,
	int option
)
Visual Basic
Public Overridable Function Copy ( 
	src As CFviImage,
	option As Integer
) As CFviGdiImage

Parameters

src
Type: FVIL.Data..::..CFviImage
複製元
option
Type: System..::..Int32
オプション
  • 0: 通常のコピー処理を行います。
  • 1: 複製元と複製先の何れも 32 bpp (RGB32) の時、アルファ値もコピーします。

Return Value

Type: CFviGdiImage

複製後の自身のインスタンスを返します。

Remarks

引数 src に指定された画像オブジェクトの処理範囲の部分を このオブジェクトの画像領域へ複製します。 このオブジェクトの画像領域は、複製元の処理範囲以上のサイズが必要です。 複製処理の挙動については CheckCopyable(CFviImage) の説明をご参照ください。 CheckCopyable(CFviImage) は、複製の可否を判定できます。

srcRGB32 で このオブジェクトが 32 bpp の時、 option に 1 を指定するとアルファ値もコピーしますが、 本ライブラリの画像処理機能はアルファ値を考慮していない為、 0 にリセットされているか不定値の場合がありますのでご注意ください。 通常は、 option に 0 を指定してコピーしてから、 ClearAlpha(Color, Int32, Boolean) などでアルファ値を初期化することを推奨します。

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

エラーコード:

ErrorCode メンバ内容
11FVIL.ErrorCode.INVALID_PARAMETER 引数が無効です。 srcnull か、 option に 0, 1 以外が指定されています。
21FVIL.ErrorCode.NOT_SUPPORTEDサポートしていない画像種別です。
23FVIL.ErrorCode.NOT_ALLOCATED画像領域が確保されていません。
96FVIL.ErrorCode.NOMATCH_IMAGESIZE画像サイズと処理範囲サイズが一致していません。

Exceptions

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

See Also