描画イメージの保存 (任意座標)

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

Syntax

C#
public void SaveImage(
	CFviImage image,
	Rectangle region,
	double mag
)
Visual Basic
Public Sub SaveImage ( 
	image As CFviImage,
	region As Rectangle,
	mag As Double
)

Parameters

image
Type: FVIL.Data..::..CFviImage
保存先
region
Type: System.Drawing..::..Rectangle
保存範囲 (画像上の座標)
mag
Type: System..::..Double
倍率 (0.0より大きい値)

Remarks

画像上の指定された範囲をオーバレイ処理して画像オブジェクトに保存します。 引数 region には、画像の保存したい部分を始点(X,Y)とサイズ(Width,Height)で指定してください。 単位はピクセルです。 保存先の画像オブジェクト(image)の領域サイズは、 region に指定されたサイズと mag に指定された倍率で決定します。

注意: オーバレイ処理に関して
この関数は、オーバレイの 伸縮属性 が true のものを保存する事を目的としています。 false の場合は考慮していない為、正常に描画できない場合があります。 現在の描画イメージを正確に保存したい場合は、 SaveImage(CFviImage) を使用してください。

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

エラーコード：

値ErrorCode メンバ内容
11FVIL.ErrorCode.INVALID_PARAMETER 引数が不正です。以下の何れかが原因です。
  • image が null -
  • region の始点が 0 未満 -
  • region のサイズが 0 以下 -
  • mag が 0.0 以下 -
16064FVIL.GDI.ErrorCode.FAILED_TO_CREATE_GDIOBJECT デバイスコンテキストの生成に失敗しました。
1FVIL.ErrorCode.FAILED_TO_ALLOCATE 保存先の画像オブジェクト(image)の再確保に失敗した場合に 画像オブジェクトが、この例外を発行します。
- その他 描画処理に失敗した場合は、 Draw(IntPtr) 関数が例外を発行します。

Exceptions

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

See Also