home *** CD-ROM | disk | FTP | other *** search
/ Phoenix Heaven Sunny 2 / APPARE2.BIN / oh_towns / taropyon / he386 / doc / he386.doc < prev    next >
Text File  |  1995-06-20  |  14KB  |  315 lines
  1. **************************************************************************
  2.  
  3.                     ＨＥ３８６ ver.3.01 取扱説明書
  4.  
  5. **************************************************************************
  6.  
  7.  
  8. 　HE386 は，テキストファイル中に書かれているMML （Music Macro Language）を
  9. 元にスタンダードMIDIファイル形式の音楽演奏データを作る出すツールです。
  10.  
  11.  
  12. **************************************************************************
  13. ☆  HE386 の特徴
  14. **************************************************************************
  15.  
  16. ・スタンダードMIDIファイルを作成
  17.  
  18. 　HE386 はテキストファイルして作成されたデータファイルから，スタンダード
  19. MIDIファイル形式の演奏データファイルを作成します。
  20. 　MIDIがサポートするほとんどすべての演奏情報をきめ細かく指定することができ
  21. ，４分音符の分解能は 48～9600 まで対応しています。
  22.  
  23. ・MML の常識を打ち破る超強力スペック
  24.  
  25. 　トラックやパート，マクロ等，ほとんどの設定はメモリの許すかぎり無制限に使
  26. 用できます。
  27. 　通常の設定を行う「セッタ」，設定値にオフセットを加える「オフセッタ」，局
  28. 所的に設定を変更する「ピンセッタ」の３系統の設定コマンドにより，複雑な設定
  29. を簡単に管理しまとめることができます。
  30. 　数値指定には，相対値／パーセンテージ／ランダムといった様々な指定ができま
  31. す。
  32.  
  33. ・Ｃ言語ライクなインタプリタCCI を搭載
  34.  
  35. 　HE386 にはＣ言語ライクなインタプリタCCI が搭載されています。
  36. 　CCI を使えばユーザーがMML に命令を追加することができます。
  37. 　標準でGS音源を制御する命令を組み込んでいます。
  38.  
  39.  
  40. **************************************************************************
  41. ☆  使用，転載，再配付について
  42. **************************************************************************
  43.  
  44. 　このプログラムの著作権は作者が保持しています。
  45. 　以下の条件に従って自由に使用してください。
  46.  
  47.     1.　著作権表示を変更しないこと。
  48.     2.　このプログラムを使用したことによって生じた損害はまったく保証し
  49.       ない。
  50.     3.　作者はこのプログラムに不備があっても，それを訂正する義務を負わ
  51.       ない。
  52.     4.　収録されているすべてのファイルを一括して配付すること。
  53.  
  54. 　感想・障害報告等，作者への連絡は，
  55.         NIFTY-Serve           ID:PAH01170
  56. まで，願いします。
  57. 　電子メールでのお問い合わせは返事が遅れたり，あるいは返信のメールが行かな
  58. いこともありますので，予めご了承ください。
  59.  
  60. 　転載，再配付については作者の許諾を得る必要はありません。
  61.  
  62.  
  63. **************************************************************************
  64. ☆  HE386 の起動と使い方
  65. **************************************************************************
  66.  
  67. 　HE386 はコマンドモードまたは，HEwin （ver.1.01b 以降）やEDIAから使うこと
  68. ができます。
  69. 　ここではコマンドモードからは，RUN386.EXEを使い，
  70.  
  71.   RUN386 HE386P <MMLファイル名>
  72.  
  73. とします。
  74. 　MML ファイル名は，拡張子.MMLを持つテキストファイルとします（パラメータ指
  75. 定時には拡張子.MMLは省略できます）。
  76.  
  77. 　たとえば，MUSIC.MML をコンパイルする場合は，
  78.  
  79.   RUN386 HE386P MUSIC
  80.  
  81. とします。コンパイルが成功すれば演奏データファイルMUSIC.MID ができているは
  82. ずです。
  83.  
  84.  
  85. **************************************************************************
  86. ☆  HEwin ／EDIAからHE386 を使う
  87. **************************************************************************
  88.  
  89. 　HE386 はHEwin またはEDIAのテキストエディタから呼び出して使うこともできま
  90. す。
  91. 　本バージョンのHE386 を呼び出すことができるのは，
  92.  
  93.     HEwin   …  ver.1.02b edition #01
  94.     EDIA    …  ver.1.01b edition #02
  95.  
  96. のものに限られます。
  97. 　これら以外のバージョンのHEwin/EDIAからHE386 を使っても，正常に動作しない
  98. 可能性があります。
  99.  
  100.  
  101. ●  HEwin ver.1.02b edition #01                       （天晴CD Vol.1収録）
  102.  
  103. 　天晴CD Vol.1に用意されているインストーラを使ってHEwin とHE386 をインスト
  104. ールすると，自動的にHEwin からHE386 を使う環境が整います。
  105. 　手動で環境を整える場合は，HE386P.EXPが格納されているディレクトリを，HEwi
  106. n のDOS コンソール，[SETUP] メニュー配下の「EXP search path 」（項目／ボタ
  107. ン）で指定してください。HE386P.EXPがHEWIN.EXP と同じディレクトリに格納され
  108. ている場合は，[SETUP] メニュー配下の「EXP search path 」（項目／ボタン）は
  109. 使う必要ありません。
  110.  
  111. 　HEwin からコンパイルするときは，MML が書かれているテキストファイルを編集
  112. 状態にして，HEwin のテキストエディタ[MENU4]メニュー配下の「MML Compile」（
  113. 項目／ボタン）を実行し，そこから「Compile 」（項目／ボタン）を選択してくだ
  114. さい。
  115. 　HE386 には編集中のファイル名が渡されるだけですので，コンパイルしたいテキ
  116. ストファイルはあらかじめファイルに保存されている必要があります。
  117. 　HE386 でのコンパイルが終了し，編集中のテキストファイルのファイル名の拡張
  118. 子を.MIDに変更したファイル名と同名のファイルが存在すれば，それを演奏データ
  119. ファイルとみなして演奏します。
  120. 　演奏は，コンパイルに失敗してもファイルが存在すれば行われます。
  121.  
  122.  
  123. ●  EDIA ver.1.01b edition #02                        （天晴CD Vol.1収録）
  124.  
  125. 　天晴CD Vol.1に用意されているインストーラを使ってEDIAとHE386 をインストー
  126. ルすると，自動的にEDIAからHE386 を使う環境が整います。
  127. 　手動で環境を整える場合は，HE386P.EXPが格納されているディレクトリを，EDIA
  128. の[MENU4] メニュー配下の「EXP search path 」（項目／ボタン）で指定してくだ
  129. さい。HE386P.EXPがEDIA.EXPと同じディレクトリに格納されている場合は，[MENU4]
  130. メニュー配下の「EXP search path 」（項目／ボタン）で指定する必要はありませ
  131. ん。
  132.  
  133. 　EDIAからコンパイルするときは，MML が書かれているテキストファイルを編集状
  134. 態にして，[MENU4]配下の「MML Compile」（項目／ボタン）を実行し，そこから「
  135. Compile 」（項目／ボタン）を選択してください。
  136. 　HE386 には編集中のファイル名が渡されるだけですので，コンパイルしたいテキ
  137. ストファイルはあらかじめファイルに保存されている必要があります。
  138. 　HE386 でのコンパイルが終了し，編集中のテキストファイルのファイル名の拡張
  139. 子を.MIDに変更したファイル名と同名のファイルが存在すれば，それを演奏データ
  140. ファイルとみなして演奏します。
  141. 　演奏は，コンパイルに失敗してもファイルが存在すれば行われます。
  142.  
  143.  
  144. **************************************************************************
  145. ☆  MML について，
  146. **************************************************************************
  147.  
  148. 　HE386 はテキストファイルとして作成されたMML ソースファイルを元に，スタン
  149. ダードMIDIファイル形式の演奏データを作成するツールです。
  150. 　スタンダードMIDIファイルは，基本的にはMIDIメッセージ（MIDI規格の演奏情報
  151. ）に時間情報が追加された構成になっています。
  152. 　HE386 を使いこなすためには，MIDIメッセージについてある程度知っておいたほ
  153. うがいいでしょう。
  154.  
  155.  
  156. ●コンパイル動作概要
  157.  
  158. 　HE386 は次のような処理を経て演奏データファイルを作成します。
  159.  
  160.     (1) ソースファイルのオープン
  161.     (2) ソースファイルの読み込み
  162.     (3) プリプロセッサ処理
  163.     (4) 演奏データの作成
  164.     (5) 最適化
  165.     (6) 演奏データをファイルに出力
  166.  
  167. 　(2) から(4) は，ソースファイルの１行単位に処理が行われ，入力行がなくな
  168. るまで繰り返し実行されます。
  169. 　演奏データはいったんメモリ上に作成され，演奏データの作成が終わると無駄
  170. な演奏データを取り除くため (5)の最適化が行われます。
  171. 　最後に演奏データをファイルに書き出します。
  172.  
  173. 　(3) のプリプロセッサ処理というのは，マクロ展開や別ファイルの取り込みを
  174. 行う，入力行に対する一種の文字列変換操作です。
  175. 　HE386 のプリプロセッサは，マクロ展開，#ifdef～#else～#endif による条件
  176. 付き範囲指定，#includeによる別ファイルの取り込み等が行えます。
  177. 　特殊なプリプロセッサ処理として，正弦波や２次関数に従って数値が連続的に変
  178. 化するようなコマンドパラメータを作りだすことができます。
  179. 　CCI による命令の拡張はプリプロセッサ処理の段階で行われます。
  180.  
  181.  
  182. ●トラックとパートに関して，
  183.  
  184. 　HE386 には，パート単位に設定を行うパート系コマンド，トラック単位に設定を
  185. 行うトラック系コマンドの２系統のコマンドが用意されています。
  186. 　トラックは演奏データ，つまりスタンダードMIDIファイルを構成する単位です。
  187. トラックには（基本的には）楽器一台分の演奏情報が格納され，演奏データは複数
  188. のトラックによって構成されます。
  189. 　パートはトラックを構成するMML データの構成単位です。複数のパートを組み合
  190. わせてトラックが構成されます。
  191. 　図で表すと以下のような構成となります。
  192.  
  193.   －－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
  194.     パート            トラック              演奏データ
  195.   －－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
  196.     制御パート  ------+
  197.                       制御トラック  --------+
  198.                                             |
  199.     ピアノ・パート1 --+                     |
  200.     ピアノ・パート2 --+                     |
  201.     ピアノ・パート3 --+                     |
  202.     ピアノ・パート4 --+                     |
  203.                       ピアノ・トラック  ----+
  204.                                             |
  205.     ギター・パート1 --+                     |
  206.     ギター・パート2 --+                     |
  207.     ギター・パート3 --+                     |
  208.                       ギター・トラック  ----+
  209.                                             |
  210.     リズム・パート1 --+                     |
  211.     リズム・パート2 --+                     |
  212.     リズム・パート3 --+                     |
  213.                       リズム・トラック  ----+
  214.                                             シーケンスデータ
  215.   －－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
  216.  
  217. 　ここでの「ピアノ・トラック」というのはピアノの演奏情報を格納するトラック
  218. という意味です。
  219. 　パート系コマンドとトラック系コマンドはうまく使い分けて演奏データを作成し
  220. てください。
  221. 　たとえば，トラック系コマンドはトラック内の演奏データすべてに影響を及ぼす
  222. 設定を行うために使い，パート系コマンドは局所的（ある小節の中だけとか）な設
  223. 定に用いるといった使い分け方があります。
  224.  
  225.  
  226. ●期待通りに演奏データが作れない場合は，
  227.  
  228. 　入力したMML の通りに演奏されない場合は，演奏データをダンプ表示して確認し
  229. てください。ダンプ表示ではトラック毎のMIDI情報をすべて確認することができま
  230. す。
  231.  
  232. 　HE386 起動時のオプションパラメータに，-dumpMsgを指定すると出力される演奏
  233. データを確認することができます。
  234. 　このダンプ表示をファイルに保存したい場合は，以下のオプションパラメータを
  235. 付け加えてください。
  236.  
  237.         -dumpMsg -msgOut <ファイル名>
  238.  
  239. 　画面にダンプ表示を行う必要ないという場合は，以下のオプションパラメータを
  240. 付け加えてください。
  241.  
  242.         -cnsMsgIgn -dumpMsg -msgOut <ファイル名>
  243.  
  244. 　ダンプ表示は曲が長いと膨大な大きさになるので（ダンプ表示のファイルサイズ
  245. は数Ｍを越えるときがあります），確認したい箇所だけをコンパイルして表示する
  246. ようにしたほうがいいでしょう。
  247.  
  248.  
  249. **************************************************************************
  250. ☆  High-EUP Compiler 系譜
  251. **************************************************************************
  252.  
  253.   ┌───────────┬─────┬─────┬──────────┐
  254.   │名称                  │ﾊﾞｰｼﾞｮﾝ   │実行ﾌｧｲﾙ名│その他              │
  255.   ├───────────┼─────┼─────┼──────────┤
  256.   │High-EUP Compiler     │ver.1.01  │HE.EXE    │MS-DOS汎用          │
  257.   ├───────────┼─────┼─────┼──────────┤
  258.   │386|High-EUP Compiler │ver.1.02  │HE386.EXP │DOS-Extender汎用    │
  259.   │386|High-EUP Compiler │ver.1.03  │HE386.EXP │DOS-Extender汎用    │
  260.   ├───────────┼─────┼─────┼──────────┤
  261.   │386|High-EUP Compiler │ver.2.01  │HEAT.EXP  │HEat内蔵タイプ      │
  262.   ├───────────┼─────┼─────┼──────────┤
  263.   │386|High-EUP Compiler │ver.3.01  │HE386P.EXP│TownsOS用ｽﾀﾝﾄﾞｱﾛｰﾝ  │
  264.   └───────────┴─────┴─────┴──────────┘
  265.  
  266. 　High-EUP Compiler(HE.EXE)及び386|High-EUP Compiler(HE386.EXP) ver.1.02
  267. ～2.01までは，EUPHONY 形式の演奏データを作成します。また，MML はHGPLAY／
  268. EDPLAY 系の拡張で，F-BASIC386 やMUSIC PRO TOWNS が出力するMML と上位互換
  269. 性があります。
  270. 　ver.3.01は，スタンダードMIDIファイルを作成します。ver.3.01は従来のMML 
  271. との互換性はまったくありません。
  272.  
  273.  
  274. **************************************************************************
  275. ☆  最後に，
  276. **************************************************************************
  277.  
  278. 　HE386 ver.3.01のMML 仕様はHEatやそれ以前のHE／HE386 のものとはまったく異
  279. なっており，互換性はまったくありません。
  280. 　同じMML とはいっても，共通部分は音程を表すのに「Ａ～Ｇ」を使うといったと
  281. ころぐらいです。
  282.  
  283. 　HEatが音楽データの制作活動において（それなりに）使ってもらえたは，F-BASI
  284. C386のMML やとMUSIC PRO TOWNS でMML セーブしたMML と互換性があったからです
  285. が，これがMML 仕様上の最大の欠点でもありました。
  286. 　従来のMML と互換性を維持するために，MML 仕様に統一性がなく，かなり面倒な
  287. 設定も必要でした。
  288. 　内蔵音源や比較的小規模のMIDI用の演奏データを作る場合には，それでも問題な
  289. かったのですが，GS音源の機能をフルに活用するMIDI用の演奏データを作成する場
  290. 合には従来のMML 仕様では限界に達してしまいました。
  291.  
  292. 　そうした背景から，HE386 ver.3 はHEatのMML との互換性は思い切って捨てて，
  293. まったく新しいMML コンパイラとして設計しました。
  294. 　HE386 ver.3 はGS音源を含めていかなるMIDI音源の機能も十二分に引き出せる性
  295. 能を持っています。
  296.  
  297. 　HE386 ver.3 のMML は一見複雑そうに見えますが，命令体系が整備されています
  298. ので命令数はHEatのMML よりも少なくなっています。
  299.  
  300. 　HE386 ver.3 はプログラマブルという点を生かすように設計されています。
  301. 　これは，いいほうに解釈すれば「柔軟性があり自由度が高い」となりますが，問
  302. 題があるとすれば「決まった書きかた，書式がない」ということになってしまいま
  303. す。
  304. 　つまり，同じことを実現するのも何通りもの指定方法があるので，自分にあった
  305. MML の書きかたを見つけるまでが大変だと思います。
  306.  
  307. 　HE386 は既存のいかなる音楽ツールともコンセプトの異なる特殊な演奏データ作
  308. 成ツールです。
  309. 　面倒臭い部分もありますが，既存のツールでは表現できない演奏データもらくら
  310. くとこなしてしまう点もたくさんあります。
  311. 　是非ともHE386 を使って演奏データを作ってみてください。
  312.  
  313.                                                        1993. 6.29 TaroPYON
  314.  
  315.