scImageHandler.dll
 全て クラス 名前空間 関数 変数 列挙値
名前空間 | 関数
scImageHandler 名前空間

画像ファイルを簡単に読み書きするための関数群 [詳解]

名前空間

 FORMAT
 対応画像フォーマット
 

関数

const char *__stdcall scImageHandler_LastErrorMessage ()
 
int __stdcall scImageHandler_SetQuality (int qality)
 
int __stdcall scImageHandler_Save (const char *img_filename, const scMetaImg *p_meta_img, int img_format_id)
 
void *__stdcall scImageHandler_Create (const char *img_filename)
 
int __stdcall scImageHandler_Delete (scMetaImg *p_meta_img)
 

詳解

画像ファイルを簡単に読み書きするための関数群

この関数群は、画像ファイルを簡単に読み書きするための関数、定数をまとめたものである。 この関数群は、scImageHandler.dll によって提供される。

関数詳解

void* __stdcall scImageHandler::scImageHandler_Create ( const char *  img_filename)

この関数は、画像ファイルを読み込み、scMetaImg を構築する。

引数
[in]img_filename画像ファイルのパス
戻り値
成功した場合、ヒープ上に構築した scMetaImg のアドレスを void * 形式で帰す。失敗した場合、NULL を帰す。
int __stdcall scImageHandler::scImageHandler_Delete ( scMetaImg p_meta_img)

この関数は、scMetaImg * を破棄する。

引数
[in]p_meta_img破棄される画像データ
戻り値
無し
const char* __stdcall scImageHandler::scImageHandler_LastErrorMessage ( )

この関数は、最後に発生したエラーメッセージを帰す。

戻り値
最後に発生したエラーメッセージを帰す。最後に実行した関数が正常終了した場合、正常終了を示すメッセージを帰す。
int __stdcall scImageHandler::scImageHandler_Save ( const char *  img_filename,
const scMetaImg p_meta_img,
int  img_format_id 
)

この関数は、画像フォーマットを指定して、画像ファイルを保存する。 現時点で、この関数は以下の組み合わせに対応している。

(channel,bit) = ( 1, 1 ), ( 1, 8 ), ( 3, 8 )

typedef int ( __stdcall *P_SAVE_IMAGE )( const char *, const scMetaImg *, int );
P_SAVE_IMAGE p_save_img;
p_save_img = reinterpret_cast< P_SAVE_IMAGE >( ::GetProcAddress( hDLL, "scImageHandler_Save" ) );
if( p_save_img != NULL )
{
// scMetaImg test_img は初期化済み
( *p_save_img )( filename_img, &test_img, scImageHandler::FORMAT::JPEG );
}
引数
[in]img_filename画像ファイルのパス
[in]p_meta_img保存される画像データ
[in]img_format_id画像フォーマット
参照
FORMAT::JPEG
FORMAT::PNG
FORMAT::GIF
FORMAT::TIFF
FORMAT::BMP
戻り値
成功した場合、0 を帰す。失敗した場合、0以外 を帰す。
int __stdcall scImageHandler::scImageHandler_SetQuality ( int  qality)

この関数は、JPEG形式で保存される画像の画質指定パラメータ0(最低)〜100(最高)の整数値を指定する。初期値は75。

戻り値
変更前の画質指定パラメータを帰す。