画像ファイルの読み込み
Namespace: FVIL.FileAssembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)
Syntax
C# |
---|
public static void LoadImageFile( string strFileName, CFviImage image, PixelMode pixelmode ) |
Visual Basic |
---|
Public Shared Sub LoadImageFile ( strFileName As String, image As CFviImage, pixelmode As PixelMode ) |
Parameters
- strFileName
- Type: System..::..String
画像ファイルへのパス
- image
- Type: FVIL.Data..::..CFviImage
画像データの読み込み先
- pixelmode
- Type: FVIL..::..PixelMode
ピクセルモード。(カラー画像の場合に使用します。Packing を指定すると RGB24 または RGB32 として読み込みます。Unacking を指定すると UC8 または US16 の 3 チャネルとして読み込みます。)
Remarks
画像ファイルの内容を画像オブジェクトに読み込みます。
この関数は、簡易的に画像ファイルを読み込む為のものです。
この関数で指定できないパラメータを指定する必要があれば、
各画像ファイルアクセスクラスを直接使用してください。
引数 strFileName に指定されたファイル名の拡張子によって画像ファイル形式を判断し、 対応する画像ファイルアクセスクラスで読み込みます。 拡張子とクラスの対応は以下の通りです。
- .bmp : CFviImageFileBmp
- .dib : CFviImageFileBmp
- .jpg : CFviImageFileJpg
- .jpeg : CFviImageFileJpg
- .png : CFviImageFilePng
- .tif : CFviImageFileTiff
- .tiff : CFviImageFileTiff
- .raw : CFviImageFileRaw
引数 pixelmode は、画像ファイルがカラー画像の場合に有効です。 Packing が指定された場合は、 image を RGB24 または RGB32 で確保して読み込みます。 Unpacking が指定された場合は、 image を UC8 または US16 の 3 チャネルで確保して読み込みます。 本ライブラリの画像処理はチャネル分割された画像データを処理対象とするものが多いので、 Unpacking で読み込むことを推奨します。 但し、Raw フォーマットの場合は、 pixelmode は無視されます。
留意事項:
JPEG,PNG,TIFF 画像を読み込む場合は、fvalg_oss_mt が必要です。
これらの DLL は InitVisionLibrary()()()() を実行した際に自動的にロードされます。
InitVisionLibrary()()()() が実行されていない場合、
または、これらの DLL をインストールしていない場合は FVIL.ErrorCode.LICENSE_ERROR (51) を返します。
正常に実行できなかった場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。
エラーコード:
値 | ErrorCode メンバ | 内容 |
---|---|---|
11 | FVIL.ErrorCode.INVALID_PARAMETER | 引数に誤りがあります。 |
21 | FVIL.ErrorCode.NOT_SUPPORTED | 指定された画像ファイル形式はサポートしていません。 |
- | その他 | 読み込み中に異常が発生した場合は、 各画像ファイルアクセスクラスのエラーコードが返ります。 |
Exceptions
Exception | Condition |
---|---|
FVIL..::..CFviException | この例外の原因については、上記のエラーコード表をご参照ください。 |