home *** CD-ROM | disk | FTP | other *** search
/ Phoenix Heaven Sunny 2 / APPARE2.BIN / oh_towns / gwav / src / gwav.doc < prev    next >
Text File  |  1995-06-20  |  11KB  |  210 lines
  1. --------------------------------------------------------------------------
  2.                          PCM Player 'GWAV' V1.1 L32
  3.  
  4.                                『GWAV.EXG』
  5.  
  6.                   Copyright(C) 1994,1995 by メルキュール
  7. --------------------------------------------------------------------------
  8.  
  9. 【概要】
  10. 　　名前のとおりで、どこにでもある PCMサウンドを再生するだけのプログラム
  11. 　です。
  12. 　　拡張子が.SNDと.WAVの PCM音声ファイルを、オンメモリで再生することがで
  13. 　きます。ファイルの選択には、TOWNS標準ファイルセレクタを使用します。
  14. 　　再生中は、シェルを終了しなければ他の処理ができますから、テキストエデ
  15. 　ィタで文書を打ちながらPCMサウンドを聞くことも可能です。ちなみにEINラン
  16. 　チャーやGL.EXGで.EXPのオーバーレイ実行を行う場合はシェル終了と同じ扱い
  17. 　になるので、再生を停止します。
  18. 　　パラメータにサウンドファイル名をフルパスでセットすると、起動直後にフ
  19. 　ァイルを読み込んで再生しますので、.IF2に設定したり、GSTART.CNFに記述す
  20. 　るなど遊び方もいろいろあることでしょう。
  21.  
  22.  
  23. 【対応機種＆ＯＳ】
  24. 　+--------------------------------------------------------------------+
  25. 　| 　機種　：FMＴＯＷＮＳシリーズ全機種（Martyを除く）                |
  26. 　| 　メモリ：要４MB以上（OSのバージョンや環境によって異なる）         |
  27. 　| 　ＯＳ　：TownsOS V2.1 L31以降                                     |
  28. 　+--------------------------------------------------------------------+
  29. 　　シェルが動作する環境なら動作しますが、なるべく最新のOSと４MB以上のメ
  30. 　モリを搭載した環境で使用してください。私は L31～50A で確認しています。
  31. 　サウンドデータをオンメモリで再生するため、シェルやGWAV.EXGやサウンドデ
  32. 　ータなどが載せられるだけの空きメモリが必要です。
  33. 　　また、.WAVデータを再生するためには、システム設定で「マイクロソフトウ
  34. 　ェーブフォームデータ」を「使用する」に設定にしてください。これを設定し
  35. 　なければ.SNDしか再生できません。
  36.  
  37.  
  38. 【準備】
  39. 　　以下のファイルが収録されています。
  40.  
  41.        ↓サブディレクトリの部分ね
  42.       ____
  43. 　　・GUR\IGWAV   .GUR   ：┐リソースファイル
  44. 　　・GUR\IGWAV   .GUS   ：│
  45. 　　・SRC\IGWAV   .C     ：┘
  46. 　　・SRC\GWAV    .C     ：GWAVメインプログラム(呼び出し関数も含む)
  47. 　　・SRC\GWAV    .LNK   ：リンクファイル
  48. 　　・SRC\GWAV    .      ：メイクファイル
  49. 　　・SRC\GWAV    .DOC   ：PCMプレイヤー'GWAV'解説書
  50. 　　・EXP\GWAV    .EXG   ：PCMプレイヤー'GWAV'本体
  51.  
  52. 　　使用するにはGWAV.EXGをどこか適当なディレクトリにコピーしてください。
  53. 　それから、アイテム登録してください。まぁ、ファイルメニューから実行して
  54. 　も構いませんが、登録した方が便利かと。
  55. 　　それから.WAVも再生するのでしたら、システム設定で「マイクロソフトウェ
  56. 　ーブフォームデータ」を「使用する」に設定し、リセットしてください。.SND
  57. 　だけでいいやって人は、この設定は必要ありません。
  58. 　　なお、添付のソースを使って再コンパイルする場合には、解凍時に生成する
  59. 　 'SRC'と'GUR'と'EXP'ディレクトリに加えて、 'OBJ'ディレクトリが必要です
  60. 　（といってもリンクファイルとメイクファイルは環境によって書き換える必要
  61. 　があるのですが…どうすればいいのかおわかりですね？）。
  62. 　　それと、リンクする際にEINライブラリ（EINTM.LIB）を必要としますので、
  63. 　別途用意してください。 EIN関係のライブラリの中にサンプルプログラムとも
  64. 　ども入っています。作者はＮａｍさんです。
  65.  
  66.  
  67. 【使用法】
  68. 　　なにはともあれ、GWAV.EXGを起動します。そうすると、アイコンが３個＋１
  69. 　の小さなウィンドウが画面中央に表示されます。
  70.  
  71.                      +---終了ボタン
  72.                      |
  73.                   +--+-------------------------------+
  74.                   | +++ +--------------------------+ |
  75.                   | | | | サウンドファイル名       | |
  76.                   | +-+ +--------------------------+ |
  77.                   | +--------+ +--------+ +--------+ |
  78.                   | | ﾌｧｲﾙ   | | 再生   | | 停止   | |
  79.                   | |  選択  | |  ﾎﾞﾀﾝ  | |   ﾎﾞﾀﾝ | |
  80.                   | |   ﾎﾞﾀﾝ | |        | |        | |
  81.                   | +--------+ +--------+ +--------+ |
  82.                   +----------------------------------+
  83.  
  84. 　　ファイル選択ボタンをクリックするとファイルセレクタが開き、サウンドフ
  85. 　ァイルを選択することができます。拡張子は.SNDと.WAVのみが表示されるよう
  86. 　になっています。ファイルを選択すると、メモリ上に読み込み、即座に再生が
  87. 　始まります。再生されない場合は、大抵メモリ不足です。不要なアプリケーシ
  88. 　ョンを終了するなどしてメモリを空けてください。たまに、サウンドファイル
  89. 　が壊れている、なんてこともあるみたいですが。
  90. 　　再生を開始すると、他のタスクに切り換えることができます。サウンメッセ
  91. 　ージさえ鳴らさなければ、ちゃんと最後まで再生してくれます（サウンドメッ
  92. 　セージはサウンド機能を強制的に使うので、再生が止まってしまう）。また、
  93. 　Recoder/Liteのようにサウンド機能を使うアプリを起動しても止まる場合があ
  94. 　ります。同じサウンド機能を使うのだから、仕方ないですね。
  95.  
  96. 　　再生ボタンをクリックすると、すでにメモリ上に読み込んでいるサウンドフ
  97. 　ァイルを再生します。メモリ不足などで一時的にメモリ上から追い出されてい
  98. 　る場合もありますが、そのときには再びメモリに読み込んでから再生します。
  99. 　なお、ファイル名はサウンドファイル名の項に表示されます。
  100.  
  101. 　　停止ボタンをクリックすると、再生しているサウンドを停止します。また、
  102. 　同時にサウンド機能の初期化なども行います（読み込み済のファイルは消去し
  103. 　ない）。アイコンはリセットになってますが、TOWNS リセットボタンではあり
  104. 　ません。
  105. 　　サウンドメッセージが正しく鳴らない場合は、停止ボタンを押せば正常に戻
  106. 　ります。アイコンにリセットとなっているくらいで、サウンド機能のリセット
  107. 　の意味も持っています（ほんとかよ）。
  108.  
  109. 　　また、パラメータにサウンドファイル名をフルパスで入れると、サウンドフ
  110. 　ァイルを読み込んで再生します。すでにGWAVが起動していた場合は、起動して
  111. 　いるGWAVに読み込まれていたサウンドの代わりに、あとから指定されたサウン
  112. 　ドを再生します。とりあえずGWAVを起動しておき、.IF2で登録しておいて、フ
  113. 　ァイルウィンドウから次々とサウンドファイルをダブルクリックして再生する、
  114. 　なんてことも可能です。
  115.  
  116. 　　終了ボタンを押すと、再生中なら止めてからプログラムを終了します。タス
  117. 　クリストから強制終了とやっても同様です。シェルが終了するような処理（.E
  118. 　XPや.EXEなどの実行）であっても終了ボタンを押したのと同じ動作をします。
  119. 　　なお、拙作のGL.EXGによる.EXP実行では、終了することはありませんが、再
  120. 　生中ならサウンドの再生が停止します。
  121.  
  122.  
  123. 　　GSTART.CNFに記述したり、拙作のGSTARTUP.EXGを使うことで、TOWNS 起動時
  124. 　にサウンドを再生させることができます（といっても、シェルが起動する度に
  125. 　毎回鳴ることになるんですけど）。GSTART.CNFならば、
  126.  
  127. 　　LOAD = D:\EXG\GWAV.EXG D:\SND\OHAYO.SND
  128.  
  129. 　のように、また、GSTARTUP.EXGを使うなら、GSTARTUP.CNFに
  130.  
  131. 　　GWAV.EXG D:\SND\OHAYO.SND
  132.  
  133. 　のように記述します（当然\STARTUPディレクトリにGWAV.EXGを置くことを忘れ
  134. 　ないように）。
  135.  
  136.  
  137. 【キーボードで使う】
  138. 　　V1.1L30からキーボードだけでも使えるようになりました。
  139. 　　・ファイル選択ボタン：PF1 キー
  140. 　　・再生ボタン　　　　：PF2 キー
  141. 　　・停止ボタン　　　　：PF3 キー
  142. 　　・終了ボタン　　　　：PF12キー
  143. 　ファイルセレクターは、マニュアルにあるとおりのキー操作ができますから、
  144. 　キーボードだけでファイルを選んで鳴らして終了、ってなこともできます。あ
  145. 　～、しかしPFキーだけなんてずいぶん安直なキーアサインだよなぁ。
  146.  
  147.  
  148. 【！注意点！】
  149. 　　本来は、サウンドを再生したまま他のタスクにスイッチできるのは許される
  150. 　ことではないのですが、あえてそれを行っています（こうした方が便利でしょ
  151. 　？）。その影響からか、たまにおかしな動作をすることがあるかもしれません
  152. 　が、「ああ、保証外の使い方してるから仕方ないよな」と笑って許してくださ
  153. 　い(^^;。
  154. 　　それから、再生中にサウンドメッセージが鳴ると、サウンド再生が止まるこ
  155. 　とがあるなんてのは、バグではなくて仕様です。どっちもサウンド機能使うん
  156. 　だから仕方ないってば。
  157. 　　エラーチェックはあまりしっかりやっていません。ヘンなことをすると落ち
  158. 　るかもしれません。いちおう私も毎日過酷な条件で使っているので、致命的な
  159. 　ものはそんなにないと思うのですが。拡張子をだます、なんて非常識な使い方
  160. 　などを決してしないように（たぶん死にます）。
  161. 　　V1.1 L31から、WAVE-BIOS がサポートしていない周波数のデータであっても
  162. 　なるべく近い周波数に設定して無理やり鳴らすようになっています。この場合、
  163. 　本来とは微妙に音が変化しています。きちんと聞きたいならば、なんらかのソ
  164. 　フトを使ってサポート範囲内の周波数に変換してください。
  165.  
  166.  
  167. 【著作権】
  168. 　・著作権はGWAV.EXGの作者であるメルキュール（染川　淳）に帰属しますが、
  169. 　　転載・配布は自由です。配布時にはこのドキュメントと関連ファイル全て（
  170. 　　アーカイブ内全ファイル）を必ずセットにしてください。単独での配付を禁
  171. 　　止します。
  172. 　・このプログラムはフリーソフトウェアです。
  173. 　・無断で内容を書き換えることは許可しません。が、別のプログラムを作る際
  174. 　　に一部を使用することについては構いません。要は、作者名や名前や機能を
  175. 　　ほんのちょっと変えただけで再配付するのはダメよってこと。
  176. 　・商利用に関して、制限はありません。ただし、作者の権利を侵害するような
  177. 　　ことはしないでください。
  178. 　・このプログラムを使用して生じたいかなる損害に対しても作者は一切の責任
  179. 　　を負いません。すべて自分の責任において使用してください。それが承知で
  180. 　　きないような場合は、このプログラムを使用しないほうが幸せです。
  181.  
  182.  
  183. 【プログラムに歴史あり】
  184.  
  185. 　　V1.1 L10：初登場。もともとは私の師匠が作った.SNDプレイヤーがアイディ
  186. 　　　　　　　アのベースになっている。ただし諸般の事情により、FGALAV以外
  187. 　　　　　　　のフォーラムでの公開を取り消した（FGALAVが一番登録早かった
  188. 　　　　　　　から、消せなかっただけ）。
  189. 　　V1.1 L20：EIN(TM) のリジュームマネージャ組み込みにより、終了時の位置
  190. 　　　　　　　を記憶するようになった。また、『実践HighCプログラミングGUI
  191. 　　　　　　　入門編』へサンプル提供するため、ソースを改善。
  192. 　　V1.1 L30：エラー発生時にダイアログを表示するようにした。また、ショー
  193. 　　　　　　　トカットキーにも対応。現実逃避の産物（眠いよ～）。
  194. 　　V1.1 L31：WAVE-BIOS の仕様で、規定外の周波数のデータを放り込むとエラ
  195. 　　　　　　　ーではじかれることがあることが発覚し、その対策を施す。サポ
  196. 　　　　　　　ートしている周波数のうちもっとも近いもので再生するので、少
  197. 　　　　　　　し音が変になるが、こればかりはどうしようもない。正しく変換
  198. 　　　　　　　でもかけますか？遅くなるけど。
  199. 　　V1.1 L32：拡張子がなかった場合、ファイルを選ばずに再生ボタンを押すと
  200. 　　　　　　　NULLポインタを参照するという大間抜けなバグを修正。
  201.  
  202. 　　　　　　　　　　　　　　　　　　　　　　　　　　　１９９５年６月２日
  203.  
  204.                                      written by メルキュール（染川　淳）
  205.                                                 NIFTY-Serve ID:MHH00266
  206.                                                 PC-VAN      ID:TWM78095
  207.  
  208. --------------------------------------------------------------------------
  209. ※このプログラムは HighC Compiler V1.7にてコンパイルされました。
  210.