MiracleMage  - WonderWitch emulator on Win32 -

version 0.33 Readme.htm
Last update 4/18/2001



動作環境

  DirectX がセットアップされた Win32 環境(Windows95/98/NT/2000)で動作するものと思われます。Windows2000で開発を行い、Windows98/NT(SP5) 環境での動作は確認されています。DirectX は 5.0 以上であれば大丈夫だと思いますが、それ以前のバージョンでも動作するかもしれません。ただし、画面モードは 16-bit Color 以上にしておいてください(256色では動作しません、ごめんなさい)。
  2bytes 文字を表示するには恵梨沙フォントも必要です(詳しくは使用方法の節参照)。
  また、version0.33 からのバイナリリリースは MingW でコンパイルしたもので、実行には MSVCRT.DLL が必要となります(OS のバージョンがWindows98 以降であれば MSVCRT.DLL は標準でインストールされているはずです)。MSVCRT.DLL がない場合はこちら等からダウンロードしてください。

使用方法

  MiracleMage は WonderWitch の動作環境を Windows 系 OS の稼動する PC 上で再現させるためのエミュレータです。使用するためには、まず WonderWitch 上で動作するアプリケーション(.fxファイル)が必要です。また、2bytes 文字を表示させるためには恵梨沙フォントが別途必要です。フォントのセットアップ方法は、
  1. 恵梨沙フォントホームページからオリジナル版恵梨沙フォント(elisa100.lzh)をダウンロード
  2. ダウンロードしたファイルを展開し、その中の ELISA100.FNT というファイルを MMage.exe と同じフォルダにコピー
で OK です。

  まず、MMage.exe を実行してください。タイトル画面が表示されます。

ここでファイルメニューから開くを選び、動作させたい WonderWitch アプリケーションを選ぶか、ファイルをこのウィンドウにドラックアンドドロップしてください。ファイル読み込み完了後、次のようなウィンドウが表示されるので、WonderWitch アプリケーションに引数を渡したい場合はここで入力します。必要ない場合はそのままOKを押すかリターンキーを押してください(なお、設定によりこのステップをパスすることもできます)。

入力が終わると、直ちに実行が開始されます。例えば、WonderWitch 付属の SAM&PLE (WWitch\contrib\games\xmas_lcc.fx) を選択すると以下のような画面が表示されます。

WonderWitch のキー入力は PC のキーボードより行います。WonderWitchキーと PC キーの対応は以下の通りです。
 

WonderWitch キー
対応する PC キー
KEY_UP1
カーソルキー上
KEY_RIGHT1
カーソルキー右
KEY_DOWN1
カーソルキー下
KEY_LEFT1
カーソルキー左
KEY_UP2
'I' キー
KEY_RIGHT2
'L' キー
KEY_DOWN2
'K' キー
KEY_LEFT2
 'J' キー
KEY_A
スペースキー or 'Z' キー
KEY_B
'X' キー
KEY_START
TAB キー

例えば、SAM&PLE のタイトル画面で TAB キーを押すと、

このような画面になり、キャラクターをカーソルキーでキャラクターを動かしてスペースキーでジャンプさせることができます。
 

ファイルシステムのエミュレーションについて

  MiracleMage version0.20 からファイルシステムのエミュレーションが実装されています。WonderWitch の /rom0 と /ram0 はデフォルトでそれぞれ "カレントディレクトリ\rom0"、"カレントディレクトリ\ram0" にマッピングされます。マッピングされるディレクトリは任意に設定することが出来ます。WonderWitch アプリケーションでのファイル操作はこれらのディレクトリに置かれた Windows ファイルへの操作として実現されます。

  ファイルシステムエミュレーションはまだ完全ではなく、テストも十分ではありません。mmap() は実装されていません。

  MiracleMage 上で扱うファイル名は Windows のファイル名がそのまま利用されます。WonderWitch ではファイル名は 16bytes までとなっているので、Windows ファイル名の先頭 16bytes が MiracleMage で認識されるファイル名となります。

  マッピングされる Windows ファイルには WonderWitch 転送形式(.fx)ファイルのヘッダをつける必要はありません(mkfent しなくてよい)。また、mkfent したファイルがあっても、先頭 128bytes をヘッダとみなしません。将来のリリースでは、fx 拡張子を持つファイルはヘッダ付きとみなす仕様にする予定です。

MiracleMage の設定について

  ファイルメニューの設定から MiracleMage の設定を行うことができます。設定情報はカレントディレクトリの mmage.ini というファイルに保存されます。

その他

  MiracleMage はフリーソフトです。また、いかなる保証もありません。本ソフトウェアによって生じた損害等に関して、作者は一切責任を負いません。
  ライセンスは GNU General Public License です。自由に再配布/改変が可能です。詳しくは COPYING を参照してください。
  MiracleMage の情報、アップデートについては、以下のページを参照してください。

http://www04.u-page.so-net.ne.jp/td5/zry/WonderWitch/

また、よりよいツールを目指すために、利用された皆様からのご意見、ご要望、動作/バグ報告こちらまでお寄せいただけたらと思います。


Copyright 2001 Tomoyuki 'ZRY' Nakano.
feedback:zry@td5.so-net.ne.jp