画像ファイルのサイズ情報の読み込み
Namespace: FVIL.FileAssembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)
Syntax
C# |
---|
public static ImageSize CheckImageFileInfo( string strFileName, PixelMode pixelmode ) |
Visual Basic |
---|
Public Shared Function CheckImageFileInfo ( strFileName As String, pixelmode As PixelMode ) As ImageSize |
Return Value
Type: ImageSize指定された画像ファイルを画像オブジェクトに読み込む為に必要となる領域の情報を返します。
Remarks
引数 strFileName に指定されたファイル名の拡張子によって画像ファイル形式を判断し、 対応する画像ファイルアクセスクラスで読み込みます。 拡張子とクラスの対応は以下の通りです。
- .bmp : CFviImageFileBmp
- .dib : CFviImageFileBmp
- .jpg : CFviImageFileJpg
- .jpeg : CFviImageFileJpg
- .png : CFviImageFilePng
- .tif : CFviImageFileTiff
- .tiff : CFviImageFileTiff
- .raw : CFviImageFileRaw
引数 pixelmode は、画像ファイルがカラー画像の場合に有効です。 Packing が指定された場合は、 RGB24 または RGB32 として処理します。 Unpacking が指定された場合は、 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 | この例外の原因については、上記のエラーコード表をご参照ください。 |