ファイルの読み込み

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

Syntax

C#
public override void Load(
	string filename
)
Visual Basic
Public Overrides Sub Load ( 
	filename As String
)

Parameters

filename
Type: System..::..String
ファイル名称 (※ディレクトリと拡張子も含めて指定してください。)

Implements

IFviFileAccess..::..Load(String)

Remarks

パタンファイルを読み込みます。 引数には、.pat の拡張子が付いたファイル名を指定してください。 それ以外の場合は Load(String) を実行し、画像データ部分のみを復元します。 その他のプロパティは初期値のままになります。

既定のピクセルモード(DefaultPixelMode)の初期値は Unpacking に設定されていますので、 これらのクラスのメソッドはカラー画像を UC8x3ch の画像オブジェクトとして読み込みます。 既定のピクセルモードを Packing に設定すると RGB24 または RGB32 として読み込みます。

『MyPattern』と言うファイルをカレントディレクトリから読み込みたい場合は、 拡張子 .pat も含めて『.\\MyPattern.pat』と言う文字列を指定します。 この場合、以下の３つのファイルが読み込まれます。

  • MyPattern.pat ... パタン画像
  • MyPattern.pat_MSK ... マスク画像
  • MyPattern.pat_INF ... 登録座標と基準点の情報

『MyPattern.pat』のように、ディレクトリを指定しなかった場合は、 MyPattern.pat_INF ファイルのみを Windows ディレクトリから読み込もうと試みます。 その他の２つは、カレントディレクトリから読み込みます。
パタン画像が UC8x1ch の時は .pat はビットマップ形式で保管されています。 その他の場合は Raw 形式で保管されており、上記の他に .pat.conf が付加されています。
クラスの説明に示すサンプルコードを参考にしてください。

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

エラーコード：

値ErrorCode メンバ内容
11FVIL.ErrorCode.INVALID_PARAMETER引数に null 又は長さ 0 の文字列が指定されました。
6FVIL.ErrorCode.FAILED_TO_LOADパタンファイル(.pat)又はマスクファイル(.pat_MSK)が見つからないか、不正です。
13FVIL.ErrorCode.INVALID_DATAパタンとマスクのサイズが一致しないか、座標に異常があります。

Exceptions

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

See Also