画像ファイル保存

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

Syntax

C#
public override void Save(
	string strFileName,
	CFviImage image
)
Visual Basic
Public Overrides Sub Save ( 
	strFileName As String,
	image As CFviImage
)

Parameters

strFileName
Type: System..::..String
保存先の画像ファイルパス
image
Type: FVIL.Data..::..CFviImage
保存対象の画像オブジェクト

Remarks

画像オブジェクトの内容を画像ファイルに書き込みます。
画像ファイル名称は、ディレクトリと拡張子も含めて指定してください。

引数 image に指定された画像オブジェクト(CFviImage)の 画像データ(.raw 拡張子)と情報ファイル(.raw.conf)を保管します。
拡張子は、引数 strFileName に従いますので .raw でなくても構いません。 例えば、 testimage.dat と指定された場合は、 testimage.dat.conf が付加されます。 但し、ディレクトリは必ず指定するようにしてください。 『testimage.raw』のように、ディレクトリを指定しなかった場合は、 testimage.raw.conf ファイルのみを Windows ディレクトリに保存します。

画像データと情報ファイル:

画像データは、 CFviImage の画像領域部分のみをバイナリデータとして保管されます。 情報ファイルは、 CFviImage の画像メモリのサイズや種別などが保管されます。 Version セクションは、将来 機能向上を行う場合にデータ互換を保つ為に予約しているもので、現在は WIL 1.2.0.0 が常に記載されます。 Image セクションは、 CFviImage の画像領域の情報です。 処理範囲の情報は保管されません。 

[Version]
Product=WIL
Major=1
Minor=2
Build=0
Revision=0

[Image]
HorzSize=1600
VertSize=1200
ImageType=2
Channel=3
Depth=8
ImageInfo=0
HorzByte=1600

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

エラーコード：

値ErrorCode メンバ内容
11FVIL.ErrorCode.INVALID_PARAMETER引数に誤りがあります。
2FVIL.ErrorCode.FAILED_TO_OPEN画像ファイルのオープンに失敗しました。
4FVIL.ErrorCode.FAILED_TO_WRITE画像ファイルの書き込みに失敗しました。
23FVIL.ErrorCode.NOT_ALLOCATEDメモリが確保されていません。
54FVIL.ErrorCode.INTERRUPTEDユーザの要求により処理を中断しました。

Exceptions

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

See Also