//======================================================================//
//									//
//		SoundTools Ver3.0 用 NuSystemについて			//
//				NINTENDO Co,Ltd.			//
//									//
//			1998/10/21	K.Ohki				//
//======================================================================//

【１】インストール
  まず、MUS ライブラリVer.3 の lib ディレクトリのライブラリとヘッダーが、
　所定の場所にコピーされているのを確認してください。

  その後、nualstl3ディレクトリに移り、以下のコマンドを入力し、NuSystemの
　ライブラリをインストールしてください。

  　　make -f makefile.dos install

  これで、makefile.dosのN64KITDIR（デフォルトではc:\nintendo\n64kit）で指定した
  位置にlibmus3.0用のNuSystemがインストールされます。


【２】コンパイル方法
　nualstl3 ライブラリを再構築する場合は、以下のようにして下さい。

  通常では、NuSystemのソースは、

  X:\nintendo\n64kit\nusys\src
  (X: NuSystemをインストールしたドライブ)

  にnusys-120.lzhとして圧縮してインストールされていますので、
  これをその場で展開し、
  展開してできたディレクトリ"nusys-1.20"のしたに
  nualstl3をディレクトリごとコピーしてください。
  そしてnualstl3のしたで

  >make -f makfile.dos

  とすればコンパイルできます。

　（参考）
  N64 Soundtools 付属のライブラリ（libgmus.a libn_gaudio_sc.a など）は、
  OS2.0I Patch5以降に対応した物です。
　OS2.0I Patch4以前のバージョンで動作させる場合、これらも再構築する必要が
　あります。
　それぞれのソースの makefile の以下の行のコメントを外してコンパイルして
  下さい。

    OLD_AUDIO_DEF = -D_OLD_AUDIO_LIBRARY


【３】NuSystemの変更点

  libmus3.0は、それ以前とはかなり関数やその動作が変更されています。
  しかし、できるだけその差をNuSystem側で吸収し、変更点が少なくなるように
  しています。
  また、audioマイクロコードとn_audioマイクロコード用は同じソースから
  ライブラリを生成できるようにしました。


  ●変更概要

  これまで、NuSystem用のmusライブラリが必要でしたが、libmus3.0から
  スケジューラの変更ができるようになりました。
  そのため、libmusをそのまま用いるように変更しています。
  ただ、これまではmusライブラリを変更してsound effects bankやbinary song等
  の領域をオーディオヒープ領域から確保できるようにしていましたが、
  そのままlibmusを用いた場合そういったことができません。
  これを解決するため、libmusの内部関数のうち__MusInitMemMalloc()を用いています。

  libmus3.0から効果音は、エフェクトバンクファイルとして扱うようになり、
  関数も変更されていますので、NuSystem側も変更しています。

  以下に変更した関数と新たに追加した関数をあげておきます。


  ●変更した関数

  nuAuStlinit()
    これまで、引数のmusConfigのメンバをほとんどを使わなかったものを、
    すべて使うようになりました。そのため、全てのメンバの初期設定を
    おこなってください。
    ただしNULLを指定した場合は、デフォルト値（auConfig)を用います。

  nuAuStlMgrInit()
    これまでDMAコールバック用の初期化部分とシンセサイザの初期化を削除し、
    スケジューラの登録とmusの初期化をおこなうように変更しました。
    また引数は、musConfig構造体のポインタに変更しています。


  ●追加した関数

  nuAuStlSeqPlayerInit()
    シーケンスと効果音の扱いが変わったので、追加しました。
    オーディオヒープ領域から、シーケンス（binary song)の領域を
    確保します。そのため、サイズには、ゲームでつかうシーケンスファイルの
    最大値をしてしてください。

  nuAuStlSndPlayerInit()
    効果音が別ファイルになったので追加しました。
    オーディオヒープ領域から、効果音（binary song effects bank）の
    領域を確保します。そのため、サイズにはゲームで使う効果音のファイルの
    最大値を指定してください。



  ●削除した関数

  nuAuStlPlayerInit()
    nuAuStlPlayerInit()は、nuAuStlSeqPlayerInit()に変更しました。
    また、この関数でMusIntialize()を呼んでいましたが、
    nuAuStlMgrInit()で呼ぶように変更しています。
    マクロでnuAuStlPlayerInit()は、nuAuStlSeqPlayerInit()に定義して
    あります。

  ●その他
    ボリュームやパン、テンポの指定はマクロで定義してありますが、
    libmus3.0に無い関数は使えません。また新規に作成していませんので
    注意してつかってください。