漫画压缩文件及漫画文件夹阅读器

Susie 32bit Plug-in 仕様 rev5 １．はじめに Susie 32bit Plug-in は Windows の DLL であり、後述の API により Susie 以外の ソフトウェアからも簡単に使う事が出来ます。 また、この仕様通りにPlug-inを作れば Susie を新しい画像フォーマットに 対応させる事が可能です。 ２．Plug-in APIのバージョン 今後の拡張性を持たせるため、Plug-inにAPIのバージョン番号がつきます。 このバージョン番号はすべてのバージョンに共通である関数'GETPLUGININFO'によって 取得出来ます。 バージョン番号は基本的に4byteのコードで以下の意味を持ちます。 00 I N ~T T T | | +-- N : Normal, M : Multi-picture | +---- I : Import filter, X : Export filter, A : Archive extractor +------ Virsion No. ３．共通関数 ・GetPluginInfo - Plug-inに関する情報を得る Prototype: extern "C" int _export PASCAL GetPluginInfo(int infono, LPSTR buf,int buflen); Parameter: int infono : 取得する情報番号 0 : Plug-in APIバージョン 1 : Plug-in名、バージョン及び copyright (SusieのAbout..に表示されます) 2n+2: 代表的な拡張子 ("*.JPG" "*.RGB;*.Q0" など) 2n+3: ファイル形式名 (ファイルタイプ名として使われます) LPSTR buf : 情報を納めるバッファ int buflen : バッファ長(byte) Return: バッファに書き込んだ文字数を返します。 情報番号が無効の場合、0を返します。 解説: 情報番号0と1はすべてのバージョンで共通とします。 2以降は二つづつ組みでSusieのOPENダイアログで用いる情報です。 一つのplug-inで複数の画像フォーマットに対応している場合は その数だけ拡張子とファイル形式名を用意します。 ４．'00IN'の関数 ・IsSupported - 展開可能な(対応している)ファイル形式か調べる。 Prototype: extern "C" int _export PASCAL IsSupported(LPSTR filename,DWORD dw); Parameter: LPSTR filename : ファイルネーム DWORD dw : 上位ワードが 0 のとき: ファイルハンドル 上位ワードが 非0 のとき: ファイル先頭部(2Kbyte以上)を読み込んだバッファへの ポインタ ファイルサイズが2Kbyte以下の場合もバッファは2Kbyte 確保し、余分は 0 で埋めること Return: 対応している画像フォーマットであれば非0を返す 解説: 各Plug-inは基本的に渡されたファイルのヘッダを調べ、自分の対応したファイル フォーマットであるかどうかを調べる。 まれにファイル名(拡張子)を判断材料として必要としたり、複数のファイルで 構成されている場合があるので、ファイル名(フルパス)も引数に加えた。 今回配布のPlug-inではfilenameは使われていない。 ・GetPictureInfo - 画像ファイルに関する情報を得る Prototype: extern "C" int _export PASCAL GetPictureInfo( LPSTR buf,long len,unsigned int flag,struct PictureInfo *lpInfo); Parameter: LPSTR buf : 入力がファイルの場合 ファイル名 メモリーの場合 ファイルイメージへのポインタ long len : 入力がファイルの場合 読込み開始オフセット(MacBin対応のため) メモリーの場合 データサイズ unsigned int flag : 追加情報 xxxx xxxx xxxx xSSS SSS : 入力形式 000 : ディスクファイル 001 : メモリ上のイメージ struct PictureInfo *lpInfo : struct PictureInfo { long left,top; 画像を展開する位置 long width; 画像の幅(pixel) long height; 画像の高さ(pixel) WORD x_density; 画素の水平方向密度 WORD y_density; 画素の垂直方向密度 short colorDepth; １画素当たりのbit数 HLOCAL hInfo; 画像内のテキスト情報 }; hInfoには必要に応じてPlug-inが確保したGlobalメモリーの ハンドルが格納される。 Return: エラーコード。0なら正常終了。 ・GetPicture - 画像を展開する Prototype: extern "C" int _export PASCAL GetPicture( LPSTR buf,long len,unsigned int flag, HANDLE *pHBInfo,HANDLE *pHBm, FARPROC lpPrgressCallback,long lData); Parameter: LPSTR buf : 入力がファイルの場合 ファイル名 メモリーの場合 ファイルイメージへのポインタ long len : 入力がファイルの場合 読込み開始オフセット(MacBin対応のため) メモリーの場合 データサイズ unsigned int flag : 追加情報 xxxx xxxx xxxx xSSS SSS : 入力形式 000 : ディスクファイル 001 : メモリ上のイメージ HLOCAL *pHBInfo : BITMAPINFO 構造体が納められたメモリハンドルが 返される。 HLOCAL *pHBm : ビットマップデータ本体のメモリハンドルが返される FARPROC lpPrgressCallback : 途中経過を表示するコールバック関数へのポインタ。 NULLの場合、plug-inは処理が終了するまでプロセスを占有し、 中断も出来ません。 コールバック関数のprototype: int PASCAL ProgressCallback( int nNum,int nDenom,long lData); まず nNum==0 でコールされ、nNum==nDenom になるまで 定期的に呼ばれる。 戻値が 非0 の時、Plug-inは処理を中断する。 long lData : コールバック関数に渡すlongデータ。 ポインタ等を必要に応じて受け渡せる。 Return: エラーコード。0なら正常終了。 解説: プラグインはLocalAllocによって必要なメモリーを確保し、そのハンドルを 返す。 アプリケーションはLocalFreeによってメモリーを開放する必要がある。 ・GetPreview - プレビュー・カタログ表示用画像縮小展開ルーティン Prototype: extern "C" int _export PASCAL GetPreview( LPSTR buf,long len,unsigned int flag, HANDLE *pHBInfo,HANDLE *pHBm, FARPROC lpPrgressCallback,long lData); Parameter: GETPICTURE参照。 Return: エラーコード。0なら正常終了。 この関数はオプションであり、未対応の場合は -1 を返す。 解説: プレビュー等で用いる縮小された画像をファイルから作成する。 JPEGの様に、アルゴリズムの関係で縮小されたサイズでは高速に展開出来る ときにこの関数をインプリメントする。 今回配布のPlug-inでは IFJPEG.PLG のみ対応(1/4サイズで展開)している。 未対応の場合、Susieは通常の展開ルーティンを用いて展開した後 縮小処理を行う。 （対応していても縮小ロードされた画像を更にサイズ調整している） プラグインはLocalAllocによって必要なメモリーを確保し、そのハンドルを 返す。 アプリケーションはLocalFreeによってメモリーを開放する必要がある。 ・エラーコード 0 : 正常終了 -1 : その機能はインプリメントされていない 1 : コールバック関数が非0を返したので展開を中止した 2 : 未知のフォーマット 3 : データが壊れている 4 : メモリーが確保出来ない 5 : メモリーエラー（Lock出来ない、等） 6 : ファイルリードエラー 7 : （予約） 8 : 内部エラー ５．'00AM'の関数 (暫定) ・IsSupported - 展開可能な(対応している)ファイル形式か調べる。 Prototype: extern "C" int _export PASCAL IsSupported(LPSTR filename,DWORD dw); Parameter: LPSTR filename : ファイルネーム DWORD dw : 上位ワードが 0 のとき: ファイルハンドル 上位ワードが 非0 のとき: ファイル先頭部(2Kbyte以上)を読み込んだバッファへの ポインタ ファイルサイズが2Kbyte以下の場合もバッファは2Kbyte 確保し、余分は 0 で埋めること Return: 対応