データ複製
Namespace: FVIL.GDIAssembly: 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) は、複製の可否を判定できます。
src が RGB32 で このオブジェクトが 32 bpp の時、 option に 1 を指定するとアルファ値もコピーしますが、 本ライブラリの画像処理機能はアルファ値を考慮していない為、 0 にリセットされているか不定値の場合がありますのでご注意ください。 通常は、 option に 0 を指定してコピーしてから、 ClearAlpha(Color, Int32, Boolean) などでアルファ値を初期化することを推奨します。
複製に失敗した場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。
エラーコード:
値 | ErrorCode メンバ | 内容 |
---|---|---|
11 | FVIL.ErrorCode.INVALID_PARAMETER | 引数が無効です。 src が null か、 option に 0, 1 以外が指定されています。 |
21 | FVIL.ErrorCode.NOT_SUPPORTED | サポートしていない画像種別です。 |
23 | FVIL.ErrorCode.NOT_ALLOCATED | 画像領域が確保されていません。 |
96 | FVIL.ErrorCode.NOMATCH_IMAGESIZE | 画像サイズと処理範囲サイズが一致していません。 |
Exceptions
Exception | Condition |
---|---|
FVIL..::..CFviException | この例外の原因については、上記のエラーコード表をご参照ください。 |