home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 2002 July / VPR0207A.ISO / OLS / BGA32034 / bga32034.lzh / Bga32.txt < prev    next >
Text File  |  2001-05-12  |  18KB  |  404 lines
  1. ============================================================================
  2.                 GZIP、BZIP2 で圧縮して書庫化
  3.  
  4.                     Bga32.dll version 0.34
  5.                                                               木村 利靖
  6.                                                        Toshinobu Kimura
  7. ============================================================================
  8.  
  9.  
  10. ０．はじめに
  11. ============
  12.  
  13.     このたびは「Bga32.dll」をダウンロードして頂きありがとうございます。
  14.  
  15.     Bga32.dll は、高圧縮率をほこりながら単一ファイルにしか操作を施せないという
  16.     限定性のために( ? )、いまひとつ使用されていない( らしい ? ) GZIP( .GZ )、
  17.     BZIP2( .BZ2 ) を書庫化して、複数ファイルの圧縮や解凍を便利に手軽に行える
  18.     ようにしようという安易な発想のもとに作成したＤＬＬです。
  19.  
  20.     書庫を圧縮するのではなく .GZ / .BZ2 で圧縮したファイルから
  21.     書庫( .GZA / .BZA )を作成することで、書庫の格納ファイルを主体とした操作を
  22.     可能にしました。
  23.     圧縮・解凍・格納ファイルの削除・格納ファイル名の変更などを行えます。
  24.  
  25.     32ビット版ですので、Windows 95 以降、Windows NT（i386用）でのみ動作
  26.     可能です。
  27.     単独で使用することはできません。対応したアプリケーションが必要です。
  28.  
  29.     また、Bga32.dll の API などの仕様は、現在「統合アーカイバプロジェクト」
  30.     ( http://www.csdinc.co.jp/archiver/ )を中心に進行中の
  31.     『統合アーカイバＡＰＩ仕様』（仮称）に準拠しています。
  32.     なお、「ＡＰＩ仕様」は現在進行形のプロジェクトです。したがって、この
  33.     Bga32.dll に含まれる機能も、最終決定版ではないと言うことを充分に認識
  34.     の上ご使用ください。
  35.  
  36.     それから貴方のソフトでこのＤＬＬに対応する場合、出来るだけダイナミック
  37.     リンク（LoadLibrary/GetProcAddress）で使用するようにして、Bga32.dll が
  38.     無い環境でも、( BGA 関係が使えないだけで )問題なく動作するような設計に
  39.     してください。
  40.  
  41.  
  42. １．ファイルについて
  43. ====================
  44.  
  45.     BGA32.TXT    : このドキュメントです。
  46.     BGA32.DLL    : ライブラリ本体です。
  47.     BGA32CMD.TXT : Bga32.dll でのコマンド等についての説明ファイルです。
  48.     BGA32API.TXT : Bga32.dll で使用できる API の説明書です。
  49.     BGA32API.H   : Bga32.dll を使用するためのヘッダファイルです。
  50.     BGA32.LIB    : Bga32.dll を静的リンクするためのライブラリです。
  51.                    なおこれは VC++ 用ですので、BC++ 等では使用出来ません。
  52.                    また上記にも書いたように、できればこれは使わずに
  53.                    ダイナミックにリンクする方法をお取りください。
  54.  
  55.  
  56. ２．使い方
  57. ==========
  58.  
  59.     これはライブラリのみですので、単独では使用できません。
  60.  
  61.     A. プログラムから
  62.     -----------------
  63.         API については，BGA32API.TXT をご覧ください。
  64.         Bga() API で指定するコマンドラインの詳細は BGA32CMD.TXT をご覧くださ
  65.         い。
  66.  
  67.         Bga32.dll を使用するには BGA32API.H をインクルードし、リンク時に
  68.         BGA32.LIB をリンクするか、LoadLibrary()/GetProcAddress() により
  69.         ダイナミックにリンクすることが必要です（できるだけこちらの方法を）。
  70.  
  71.     B. 一般ユーザから
  72.     -----------------
  73.         この DLL を使用するためには、対応したアプリケーションが必要です。
  74.         また、この DLL は Windows のシステムフォルダ( Windows 95/98 なら
  75.         \Windows\system\、WindowsNT/2000なら \WinNT\system32\ )にコピーして
  76.         お使いください。上記以外の場所に置くことは、今後の本 DLL のバージョン
  77.         アップなどによる仕様変更の際、重大な問題を引き起こす可能性もあります
  78.         ので、十分注意が必要です。
  79.  
  80.  
  81. ３．著作権及び転載について
  82. ==========================
  83.  
  84.     Bga32.dll は、本ライブラリを利用する権利を、必要とされる方々に無償で貸与
  85.     する、いわゆるフリーソフトウェアです。
  86.  
  87.     GZIP の圧縮・解凍エンジンは ZLIB を使用しており、著作権は
  88.     Jean-loup Gailly 氏と Mark Adler 氏が保有しています。
  89.  
  90.         'zlib' general purpose compression library version 1.1.3,
  91.         July 9th, 1998
  92.         Copyright (C) 1995-1998 Jean-loup Gailly and Mark Adler
  93.  
  94.     BZIP2 の圧縮・解凍エンジンは LIBBZIP2 を使用しており、著作権は
  95.     Julian R Seward 氏が保有しています。
  96.  
  97.         libbzip2, a library for lossless, block-sorting data compression.
  98.         bzip2-0.9.5 is distributed under a BSD-style license.
  99.         Copyright (C) 1996-1999 Julian R Seward.  All rights reserved.
  100.  
  101.     書庫( .GZA / .BZA )形式の作成、統合アーカイバ仕様に準じた DLL の作成に
  102.     ついての著作権は、木村 利靖が保有しています。
  103.  
  104.     プログラムに対して改変を加えたり、配布ファイルの内容を変更しないという
  105.     前提条件つきで使用、転載、配布は自由ですが、転載、配布時に、メディア代等
  106.     以上の手数料を徴収したり、使用に制限をつけることを禁じます。
  107.     また、転載、配布する場合には連絡をお願いします。
  108.  
  109.     またこのソフトを使用することによって生じた結果等について、作者および
  110.     原著作者は一切の責任を負わないこととさせていただきます。
  111.  
  112.  
  113. ４．公開先・サポート
  114. ====================
  115.  
  116.     ・「統合アーカイバプロジェクト」( http://www.csdinc.co.jp/archiver/ )
  117.     ・「ベクター」( http://www.vector.co.jp/ )
  118.  
  119.     で公開していただいています。
  120.  
  121.     DLL に関すること( 不具合報告や機能追加などのご要望等 )は、私あて
  122.     ( EZL02235@nifty.ne.jp )に直接メールしてください。
  123.  
  124.  
  125. ５．判明している不具合・不具合のような仕様(^^;
  126. ==============================================
  127.  
  128. ・BZA 書庫の圧縮・解凍時、状況表示ウィンドウで中止ボタンを押してもすぐに処理が
  129.   中断されない場合があります。たいていは少し待てば処理が中止されます。
  130.   ->->-> 仕様です。
  131.  
  132.  
  133. ６．バージョン履歴・覚え書き
  134. ============================
  135.  
  136.     version 0.34  2001/05/12
  137.         ・Visual Studio 6.0 SP5 での再ビルド。
  138.         ・進捗ダイアログを消去した後、ダイアログに表示していた情報の残像がオー
  139.           ナーウィンドウにまだ残ってしまう不具合を修正しました。
  140.         ・進捗ダイアログの消去後にオーナーウィンドウがアクティブにならない問題
  141.           にさらなる対策を加えてみました。前よりはいくらか良くなっている気がす
  142.           るのですが。。。(^^;
  143.         ・圧縮・解凍時に呼び出しアプリのウィンドウに対して EnableWindow() する
  144.           コードがまたも無効になっていた不具合を修正しました。
  145.  
  146.     version 0.33  2001/03/13
  147.         ・進捗ダイアログを表示するとき前面に配置する指定を止めました。
  148.         ・進捗ダイアログをデスクトップの中央に表示していましたが、オーナーウィ
  149.           ンドウの中央に表示するように変更しました。
  150.         ・進捗ダイアログを消去した後、ダイアログに表示していた情報の残像がオー
  151.           ナーウィンドウに残ってしまう不具合を修正しました。
  152.  
  153.     version 0.32  2001/01/13
  154.         ・既存のディレクトリと同名の書庫を新規に作成する際に、Bga() のコマンド
  155.           ラインで書庫名に拡張子を省略して指定すると例外が発生する不具合を修正
  156.           しました。
  157.  
  158.     version 0.31  2000/10/28
  159.         ・Visual Studio 6.0 SP4 での再ビルド。
  160.         ・自己解凍書庫を通常の書庫に変換する j コマンドを追加しました。
  161.  
  162.     version 0.30  2000/06/02
  163.         ・読み取り専用属性の付与されている、サイズが 0 バイトのファイルを圧縮
  164.           しようとすると例外が発生していた致命的な不具合を修正。
  165.         ・あわせて、書庫内のサイズが 0 バイトのファイルを解凍できなかった
  166.           不具合も修正しました。
  167.  
  168.         # .BZA の圧縮エンジンに LIBBZ2.LIB version 1.0 を試用してみたところ、
  169.           圧縮率はさほど変わらないけれど、圧縮、解凍速度は向上しているみたい。
  170.           でも、自己解凍スタブのサイズが 4KB 増大するので、保留です。
  171.  
  172.     version 0.29  2000/04/12
  173.         ・圧縮前後でサイズが増大した場合には無圧縮で格納するように変更。
  174.         ・無圧縮で格納しているファイルについては INDIVIDUALINFO 構造体の szMode
  175.           に "-store-" を設定するように変更。
  176.  
  177.         ・プログレスダイアログのファイル名の表記で '/' と '\' が混在していた
  178.           不具合を修正。
  179.           すべてを '\' で表示するようにしました。
  180.  
  181.     version 0.28  2000/03/22
  182.         ・ディレクトリ検索関係の不具合を修正。
  183.         ・迂闊にも各種パス系の処理に SHLWAPI.DLL を使用してしまっていたため、
  184.           IE の存在しない環境で動作しなかった不具合を修正。
  185.           約 20 の API を自前の関数で置き換えた。
  186.           ## 自己解凍スタブのサイズが増加しなくて良かった (^^;;
  187.           鬼束裕之さん、ご協力ありがとうございました。m(__)m
  188.         ・圧縮時に -a スイッチがまだ正常に動作しない場合があった不具合を修正。
  189.         ・新規書庫作成時に圧縮対象のファイルがひとつもないのに空の書庫を作成
  190.           していた不具合を修正。
  191.         ・マルチバイト文字のファイル名が場合によりマッチせず、解凍やファイル名
  192.           の変更が実行できなかった不具合を修正。
  193.  
  194.     version 0.27  2000/03/09
  195.         ・レスポンスファイルにマルチバイト文字を含めて記述した場合、正常に動作
  196.           しなかった不具合を修正。
  197.         ・圧縮、解凍時に BgaSetOwnerWindow API などのメッセージ系 API を呼び出
  198.           していて、かつコマンド指定で -i スイッチを指定しない場合( つまり、
  199.           Bga32.dll の進捗ダイアログとアプリケーション独自の進捗ダイアログを
  200.           同時に表示する指定の場合 )、API を呼び出すタイミングによりメッセージ
  201.           を送出できなかったり、内部のスレッドが終了しなかった不具合を修正。
  202.           この場合、BgaSetOwnerWindow 等で指定されたウィンドウへのメッセージ
  203.           送出を優先し、Bga32.dll の進捗ダイアログは表示しないようにした。
  204.         ・フォルダ作成関係の汎用クラスの再度の変更。
  205.  
  206.     version 0.26  2000/02/20
  207.         ・フォルダ作成関係の汎用クラスの変更とそれに伴う修正。
  208.         ・-i スイッチ、-n スイッチの規定値を TRUE から FALSE に変更。
  209.  
  210.         ・t コマンド時に書庫ファイルにエラーがあった場合、メッセージを表示する
  211.           のを忘れていた不具合を修正。正常時はこれまで通り何も表示しない。
  212.  
  213.     version 0.25  2000/02/16
  214.         ・解凍時に -a スイッチを有効にした。
  215.         ・あわせて、解凍時に -a スイッチが指定された場合、書庫ファイルに格納
  216.           されている空のフォルダも解凍するようにした。
  217.  
  218.         ・解凍時に属性の復元を忘れていた (^^; 不具合を修正。
  219.  
  220.     version 0.24  2000/02/01
  221.         ・リネーム時に、またまたフォルダのみのヘッダが重複して作成されてしまう
  222.           場合があった不具合を修正。
  223.         ・コマンドラインで書庫ファイルの指定にパスが含まれていない場合、圧縮
  224.           しているかのような動作だけしてみせるものの書庫ファイルがどこにも
  225.           作成されない場合がある不具合を修正。カレントのフォルダに作成するよう
  226.           にした。
  227.         ・コマンドラインで書庫ファイルと基底フォルダを相対パスで指定した場合、
  228.           正常に動作しなかった不具合を修正( したつもり )。
  229.  
  230.     version 0.23  2000/01/27
  231.         ・各種ダイアログの見た目を少しだけ変更。
  232.         ・ファイルのマッチング処理を一部修正。
  233.         ・基底フォルダが指定されなかった場合にカレントのフォルダを基準に処理
  234.           するように変更。これまではルートフォルダを基準にしていた。
  235.         ・不正なコマンド指定に対するチェックを(少しだけ)強化。
  236.  
  237.         ・リネームダイアログでのチェックで、フォルダのみのヘッダを考慮に
  238.           入れていなかった不具合を修正。
  239.         ・リネームダイアログや削除確認のメッセージボックスのオーナーウィンドウ
  240.           を設定するのを忘れていた不具合を修正。
  241.  
  242.     version 0.22  2000/01/16
  243.         ・コマンドライン中で BgaConfigDialog() で指定されたスイッチを無効にする
  244.           指定をできるようにした。
  245.  
  246.         ・解凍時に -r スイッチが働いていなかった不具合を修正。
  247.  
  248.     version 0.21  2000/01/10
  249.         ・表記文字列の半角カタカナを全角カタカナに統一した。
  250.         ・バージョンリソースの記述を少し変更。
  251.  
  252.         ・リネーム系コマンド・スイッチで、Bga32.dll 自体が扱えないファイル名
  253.           への変更も許容してしまっていた不具合を修正。実のところチェックが甘い
  254.           のはこれだけではないのだけど...
  255.         ・version 0.05 で修正したはずの、追加圧縮時の同名フォルダのヘッダ重複
  256.           格納問題が場合によりまだ発生していた不具合に対処。
  257.  
  258.     version 0.20  1999/12/14
  259.         ・GZA、BZA の自己解凍書庫作成時の設定ダイアログで「解凍後、実行または
  260.           開くファイル名(E)」に指定したファイルを、自己解凍時に開けない場合が
  261.           あった不具合を修正。
  262.  
  263.         ・GZA、BZA の自己解凍実行時の解凍開始ダイアログで、フォーカスの初期位置
  264.           を「解凍」ボタンから「解凍先フォルダの指定(E)」に変更。
  265.  
  266.         ・圧縮・解凍時に呼び出しアプリのウィンドウに対して EnableWindow() する
  267.           コードを無効にしたままだったポカミスを修正。
  268.  
  269.     version 0.19  1999/12/06
  270.         ・-a、-r スイッチが正常に機能していなかった不具合を修正。
  271.         ・また、-a、-r スイッチが未指定の場合の動作も仕様を満たしていなかった
  272.           ので、あわせて修正した。
  273.  
  274.     version 0.18  1999/12/05
  275.         ・呼び出し規約を _cdecl から _stdcall に変更。
  276.         ・Visual C++ 6.0 SP3 での再ビルド。
  277.  
  278.     version 0.17  1999/11/16
  279.         ・自己解凍形式書庫で解凍した場合に、ファイルのタイムスタンプが 9 時間
  280.           ずれる不具合を修正。version 0.16 での修正時に忘れてました (^^;;
  281.  
  282.     version 0.16  1999/11/10
  283.         ・LZH，LZS，ZIP，PAK，ARC，ZOO，ARJ, TAZ, TGZ, TBZ, GZ, BZ2, CAB, RAR
  284.           の拡張子をもつファイルは無圧縮で格納していたが、どんなファイルでも
  285.           圧縮するように変更。
  286.         ・他の圧縮ファイルに対してさらに圧縮を試みた場合、ときには小さくなるが
  287.           逆に数百バイト程度サイズが増大することもある。
  288.           これについてはもう少し検討が必要かも...
  289.           でも、例えば LZH を無圧縮で格納すると、Unlha32.dll でチェックしたとき
  290.           GZA や BZA なのに LZH だと誤認されてしまうんだよね...(^^;
  291.  
  292.         ・無圧縮で格納しているファイルについては INDIVIDUALINFO 構造体の szMode
  293.           に "-arc-" を設定するように変更( 今後のためで、現状は無意味 (^^; )。
  294.  
  295.         ・ファイルのタイムスタンプが 9 時間ずれて格納されていた不具合を修正。
  296.  
  297.         ・自己解凍書庫の作成時に「タイトル」「メッセージ」「フォルダの初期値」
  298.           「解凍後の実行ファイル」を指定可能にする。
  299.         ・SFX スタブにさらに手を加え、GZA 用が 56KB、BZA 用が 52KB に縮小。
  300.         ・SFX スタブのアイコンを変更。
  301.  
  302.         ・FPress で使用するには Arc32.dll version 0.99f 以上が必要。
  303.  
  304.     version 0.15  1999/11/05
  305.         ・GZA 用、BZA 用の SFX スタブのコンパイルオプションをいろいろと変更し、
  306.           サイズをさらに縮小化。
  307.           GZA 用が 64KB、BZA 用が 60KB となる。
  308.  
  309.     version 0.14  1999/11/03
  310.         ・自己解凍形式書庫に対して、ファイルの追加圧縮、書庫内ファイルの削除、
  311.           書庫内ファイル名の変更を可能とした。
  312.           操作的には通常形式書庫も自己解凍形式書庫も同等となっているはず。
  313.           version 0.08 で対応したつもりでいたのだけど、実は忘れていた (^^;;
  314.  
  315.     version 0.13  1999/11/02
  316.         ・bzip2 の圧縮解凍エンジンに bzip2-0.9.5d を使用するように変更した。
  317.         ・あわせて、SFX スタブ用の zlib, libbzip2 のスタティックライブラリを
  318.           シングルスレッドでビルドするようにした。Bga32.dll 用はマルチスレッド
  319.           でビルド。
  320.         ・SFX スタブのサイズが GZA 用、BZA 用ともに若干( 数 KB )小さくなった。
  321.         ・ちなみに gzip の圧縮解凍エンジンは以前と同じで zlib-1.1.3。
  322.  
  323.         ・FPress で使用するには Arc32.dll version 0.99e 以上が必要。
  324.  
  325.     version 0.12  1999/10/31
  326.         ・エラー終了時やユーザによる処理の中止時に、作成途中のファイルの残骸が
  327.           残ってしまう場合があった不具合を修正。
  328.         ・表示するダイアログボックスの動作形態を一部修正。
  329.  
  330.     version 0.11  1999/10/28
  331.         ・BgaFindFirst(), BgaFindNext() で返す INDIVIDUALINFO 構造体の szMode
  332.           と、メッセージ系 API で返す EXTRACTINGINFO 構造体の szMode に
  333.           "-gzip-" または "-bzip2-" の文字列を設定するように仕様を変更。
  334.  
  335.     version 0.10  1999/10/22
  336.         ・圧縮するファイルのサイズが 16384 のちょうど整数倍のとき、圧縮に失敗
  337.           する不具合を修正。
  338.  
  339.     version 0.09  1999/10/15
  340.         ・SFX スタブのアイコンをとりあえず作成。でもいまいち。
  341.         ・GZA 用、BZA 用の SFX スタブを GZip で圧縮して保持するように変更。
  342.           まあ version 0.08 よりは 80KB くらい小さくなったけど、まだでかい。
  343.           60KB もあるスタティックライブラリをふたつ( スタブの分を入れれば４つ )
  344.           も抱いてるから仕方ないのかな。
  345.           スタブ自体が 76KB もあるなんて...悲しい。
  346.  
  347.     version 0.08  1999/10/14
  348.         ・自己解凍書庫を作成可能にする。
  349.         ・あわせて、BgaCheckArchive()、BgaOpenArchive() で SFX も認識できる
  350.           ように修正。
  351.           処理的にはできてるのだけど、毎度のことながらスタブのアイコンが
  352.           決まらないのでとりあえず保留。
  353.           はたして気に入ったアイコンができあがるのはいつのことやら。
  354.           しかし DLL のサイズ、大きくなっちまったなあ...
  355.  
  356.         ・Arc32.dll version0.99 で .gza、.bza ともに、書庫 <-> SFX の処理を
  357.           追加。これにより FPress.exe、FPressSx.dll で SFX がらみの操作が
  358.           可能になる。
  359.  
  360.     version 0.07  1999/10/12
  361.         ・複数ファイルのリネーム時に、ファイル変更ダイアログでユーザが
  362.           キャンセルした場合、ファイル名が変更されないどころか、適当な名前に
  363.           リネームされてしまう不具合の対処。
  364.  
  365.     version 0.06  1999/10/10
  366.         ・BgaSetEnumMembersProc()、BgaClearEnumMembersProc() を実装。
  367.  
  368.         ・FPress.exe で、フォルダ単位のリネームが可能になる。
  369.  
  370.     version 0.05  1999/10/09
  371.         ・BgaSetOwnerWindow() などが呼ばれていない場合用の、自前のプログレス
  372.           ダイアログを追加( 作るのを忘れてました )。
  373.  
  374.         ・追加圧縮時にフォルダのみのヘッダを作成する際、同名のフォルダが存在
  375.           しているのに新たにヘッダを作成してしまっていた不具合の対処。
  376.  
  377.     version 0.04  1999/10/07
  378.         ・BgaSetOwnerWindow(), BgaClearOwnerWindow(), BgaSetOwnerWindowEx(),
  379.           BgaKillOwnerWindowEx() を実装。
  380.  
  381.         ・FPress.exe、FPressSx.dll で .gza、.bza 形式書庫の圧縮・解凍時に
  382.           プログレス表示が可能になる。
  383.  
  384.     version 0.03  1999/10/06
  385.         ・BgaGetFileCount(), BgaOpenArchive(), BgaCloseArchive(),
  386.           BgaFindFirst(), BgaFindNext(), BgaGetArcOriginalSize(),
  387.           BgaGetArcCompressedSize(), BgaGetArcRatio() を実装。
  388.  
  389.         ・FPress.exe で .gza、.bza 形式書庫のアイコン表示が可能になる。
  390.         ・FPress Setup 用の InstallShield スクリプトを変更し、.gza、
  391.           .bza を FPress に関連づけ指定できるようにした。
  392.  
  393.     version 0.02  1999/10/04
  394.         ・BgaGetVersion()、BgaGetRunning()、BgaCheckArchive()、
  395.           BgaConfigDialog()、BgaQueryFunctionList() を実装。
  396.  
  397.         ・FPress.exe、FPressSx.dll、Arc32.dll で圧縮・解凍が可能になる。
  398.  
  399.     version 0.01  1999/10/02
  400.         ・Bga32.dll の最初のバージョン
  401.         ・Bga() の実装。コマンドはひと通り動作する。でも、いまはまだこれだけ。
  402.  
  403. ------------------------------------------------------------------------------
  404.