{ -- ZM0.MAN ------------------------------------------------ ZMUSIC SYSTEM MANUAL ('93/10/04) まえがき 初版発売後、読者の皆さんから寄せられたご意見・要望の数々。 それらを可能な限り取り入れて再構成されたのが今回のバージョンです。 ずいぶんと新機能が追加されましたので、前バージョン以上に マニアックなものになりました。最初から全部の機能を使いこなそうとは思わず、 人の演奏データを聴いたり、打ち込んだり、既存データのアレンジなどを したりしつつ、徐々にＺＭＵＳＩＣに慣れていって下さい。 では、ＺＭＵＳＩＣがあなたの発想のペンに、 Ｘ６８ｋがキャンバスになりえますように。 西川善司 マニュアルデバッグ協力(敬称略):NOVA,ぽぜ,M.ODAKI,LastTear,ゆきごん,あほみ他 { -- ZM1.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ １ イントロダクション ここではＺＭＵＳＩＣシステムの概要を簡単に説明します。 １．１． はじめに コンピュータミュージックを楽しむには幾つかの方法があります。 １． 実際に弾いたものをコンピュータ、シーケンサのメモリに記憶しておくもの ２． コンピュータ、シーケンサのメモリに直接演奏データを書き込んでいくもの ３． １． と２． の複合的な方法 などです。２．はコンピュータのキーボードを叩くことから「打ち込み」と 呼ばれます。３．はつまり、人間が弾いたものを後でコンピュータを用いて 修正するといったものです。 ちょっと昔までは３．の方法が圧倒的にメジャーでしたが、音源の進歩と ミュージック・ツールの進化により最近は２．の方法もメジャー化してきています。 最近は譜面も起こさずに直接「打ち込み」を始める作曲者も少なくないようですし、 スタジオのマニピュレータ(平たくいえば打ち込み人)の中には実際に弾いた ものよりも人間臭さを表現する人もいるとききます。 さて、本書でお話しするのは２．の方法です。２．の方法の魅力といえば、 自分が楽器の演奏が出来なくてもイメージ通りの演奏が可能という点でしょう。 さらに、一度仕上げた曲は、ディスクなどの記憶装置に保存しておけばいつでも 再現可能というのもこの方法の魅力です。 打ち込みの方法にも実は色々な方法があります。一番原始的なものとしては 完全な数値入力です。音階、発音時間、など全てをこまごまと入力していくものです。 最近は「ステップ入力」と呼ばれます。数年前にＭＺやＰＣ８００１用に出ていた ローランドＣＭＵ８００シリーズはこの方法でした。これを進化させものが 譜面入力による「打ち込み」です。要するに五線譜に音符を置いていくタイプの ものですね。楽器の演奏はおろか譜面を読むことが出来ない人にでも簡単に音楽を 作ることが出来るため初心者層には圧倒的な人気を誇ります。また印刷機能が 充実していれば美しい譜面を得ることが出来ますので、プロでもこのタイプを 使っている人が多くいます。 さて、「ＺＭＵＳＩＣ」では現在（注）ＭＭＬという「打ち込み」方式を 採用しています。これはいわば「音楽記述言語」というもので 「音楽をプログラム」するというイメージが正しいでしょう。完全な数値入力よりは ずっとドキュメント性が高い上、入力する量も少ないのでパソコンを基盤として 音楽を楽しむ人にはピッタリのものといえます。欠点としては、小中学校程度の 音楽知識が必要なこと、ある程度コンピュータを扱える人（ＤＩＲやＣＯＰＹが 分かればＯＫ！）でないと駄目なこと、ドキュメント性が譜面入力よりは低いこと、 などです。まあ、ドレミが読めて、ディスクをフォーマットしたことが あれば素質十分です。 ＭＭＬの利点としては、慣れればあらゆる方式よりも高速に一曲を仕上げることが 出来ること、細かいニュアンスなどに凝ることが出来るなどが挙げられます。 また、移植性が高い点も見逃せません。殆ど方言のような感覚で他の機種の 演奏データや他の音楽ドライバ用のデータを、自分の使っているＭＭＬに 修正利用することが出来るのです。 さあ、「ＺＭＵＳＩＣ」を懸け橋にしてあなたもコンピュータ・ミュージックの 世界に浸りませんか。 （注）今後、違った入力方式に対応した支援プログラムが発表されれば、 別の入力方式（例えば譜面入力方式）も可能です。 １．２． ＺＭＵＳＩＣ．Ｘとは ＺＭＵＳＩＣ．ＸとはＸ６８ｋ本体付属のＯＰＭＤＲＶ．Ｘを改造したりするもの ではなく、全く新しくゼロから開発されたミュージックプログラム開発言語です。 Ｘ６８ｋの内蔵音源であるＦＭ音源８声とＡＤＰＣＭ１声（PCM8.X (C) H.ETOHを 使用すれば８声まで）、ＭＩＤＩインターフェースが接続されていれば ＭＩＤＩ楽器も同時にコントロールする事が出来ます。 一般の他のドライバでは１つのＭＩＤＩ楽器をＸ６８ｋの外部音源という感じで 扱っていましたが「ＺＭＵＳＩＣ．Ｘ」ではＸ６８ｋをホストに複数の ＭＩＤＩ楽器をコントロールする事が出来るように設計されているのでどんどん 自分のＭＩＤＩシステムを広げていくことが可能です。 ここでＺＭＵＳＩＣ．Ｘの特長を列挙してみます。 １． ＯＰＭＤＲＶ．Ｘに上位コンパチ ２． ＦＭ音源，ＡＤＰＣＭ，ＭＩＤＩ楽器を同時に演奏可能 ３． もちろんＭＩＤＩ楽器を持っていない人でも多彩なコマンドを内蔵音源に 対して使用可能 ４． 汎用トラックを80本持ち、その内最大32トラックを同時に演奏可能 ５． ＡＤＰＣＭを音階ＭＭＬでコントロール可能。独自のＡＤＰＣＭドライバ搭載 ６． ポルタメントやオートベンド、和音やＬＦＯなどの特殊コマンド系が ＦＭ／ＭＩＤＩの両方で使用可能 ７． ＡＤＰＣＭコンフィギュレーションファイルで、ＡＤＰＣＭデータの音程と ボリュームが変更可能。合成、エンベロープの変更も可能 ８． 任意の時間に演奏中の任意のトラックに任意の演奏データを割り込ませて 演奏することが可能（効果音モード） ９． 演奏処理がＯＰＭＤＲＶ．Ｘの平均３倍以上高速。さらにテンポずれが 起こりにくい設計 １０．ＭＴ３２の他にＵ２２０／Ｍ１／ＳＣ５５等に対応した楽器個別の コマンドを装備 １１．ＭＩＤＩ楽器側の音色や設定をファイルに吸い出す機能を装備 １２，オブジェクトレベルの演奏データを得ることが可能（コンパイル機能） １３．あらゆる命令が機械語レベルで操作可能。ゲーム等のＢＧＭドライバとして 威力を発揮 １４．専用Ａ／Ｄコンバータによってサンプリングされた高音質のＡＤＰＣＭデータ ライブラリの標準装備 １５．全情報公開。ライセンスフリー １６．ＰＣＭ８．Ｘ (C)江藤 啓に完全対応。ＡＤＰＣＭ音を最大同時に８声まで シーケンス可能 １７．複数のX68000による同期演奏 とまあ、大袈裟なところもありますがこんな感じてす。 同人ソフトなどの製作者やグループにとっては8, 9, 12, 13, 15辺りが 魅力でしょうか。 １．３． 著作権について 法律上、日本では著作権の放棄ができませんので、著作権は作者西川善司に 保留されます。しかし、プログラムの性質上、「ＺＭＵＳＩＣ．Ｘ」のオリジナルを 開発した私西川善司は「ＺＭＵＳＩＣ．Ｘ」及びこれらを支援するプログラム (サブルーチンを含む)全ての使用権に関するライセンス権を放棄します。 よってとくに断らずに商的利用が出来ます。つまり市販だろうが同人だろうが勝手に 「ＺＭＵＳＩＣ．Ｘ」を組み込んだソフトを売ってもいいということです。 ただし、一つだけ守って欲しいことがあります。それは「ＺＭＵＳＩＣ．Ｘ」の 改造についてです。改造は勿論各自に自由で行って構わないのですが、 データの完全な互換性が保持されないような改造を施した際には バージョンＩＤ番号を＄Ｆ０以上にして欲しいのです（オリジナルは＄２０です。 ソースリストZMSC.HAS参照）。また、オリジナルのＺＭＵＳＩＣ．Ｘで演奏できない データフォーマットにした場合はファイルの拡張子も変更しておいて下さい。 これは混乱を防止するためです。今後のバージョンアップ版との兼ね合いも ありますし、とにかく改造を施したものではオリジナルバージョン用のデータを 頭っからはじいて欲しいのです。是非ご協力下さい。 移植に関しても自由に行って構いません（ただし、完全にコンパチでない場合は バージョン番号をやはり＄Ｆ０以上にして下さい）。移植版をＯｈ！Ｘ編集部へ 送ってくれればＵＳＥＲ’Ｓ ＷＯＲＫ等のコーナーで紹介したいと思います。 １．４． ＺＭＵＳＩＣ．Ｘの概要(ＺＭＤ,ＺＭＳとは) ＺＭＵＳＩＣ．Ｘ上で演奏するデータを作るためには２通りの開発方法が あります。 １つは「ＭＵＳＩＣＺ．ＦＮＣ」を組み込んだＸ−ＢＡＳＩＣ上で 開発する方法です(MEASURE3参照)。基本的には「ＭＵＳＩＣＺ．ＦＮＣ」に 設けられたＺＭＵＳＩＣ．Ｘ制御命令を記述していくことにより演奏プログラムを 作成していきます。同じ処理を繰り返したい時は「for〜next｣、条件分岐を させたいなら「if 〜 then 〜」…‥というようにＸ−ＢＡＳＩＣに用意された 多彩な命令を折り混ぜて開発を行うことができます。また、文字変数などを うまく使えば少ない手間で長い曲も作れそうです。さらに、曲データ以外の 音楽関係のツール、たとえば音色エディタ等も作ることができるでしょう。 ２番目の方法はCOMMAND.X上からエディタを使ってＭＭＬファイルを作成する 方式です(MEASURE4参照)。ＺＭＵＳＩＣシステムではこのＭＭＬファイルを、 拡張子'.ZMS'を付けることを前提に特にＺＭＳファイルと呼ぶことにします。 この形式ではＺＭＳコマンド(MEASURE4参照)と呼ばれるＺＭＵＳＩＣ．Ｘ制御命令を 一行一行に記述していくことで演奏プログラムを作成していきます。 Ｘ−ＢＡＳＩＣのような制御文はないので一見開発が不便そうですが、 エディタに備えられたマクロ機能や複写機能を駆使すればＢＡＳＩＣ以上の 開発環境になりえます。また、Ｘ−ＢＡＳＩＣで作られた演奏プログラムも このＺＭＳファイルに変換することができます。これには'm_switch()'命令を 使用します(MEASURE3参照)。 実はＸ−ＢＡＳＩＣで記述された演奏プログラム、エディタによって記述された ＺＭＳファイルがＺＭＵＳＩＣ．Ｘへ受け渡されるとＺＭＵＳＩＣ．Ｘは内部で $47,$30,$30…のような16進数のデータ列で構成されたオブジェクトに変換しています。 演奏しながらいちいち命令語を認識していたのでは処理が追い付きませんから、演奏直前に 必要な計算を全て済ませてしまうわけです。Ｘ−ＢＡＳＩＣで記述された 演奏プログラム、エディタによって記述されたＺＭＳファイルを演奏する時、 ほんの一瞬ですが待たされますが、この時そのオブジェクト・データへ変換して いるのです。ＺＭＵＳＩＣシステムではこのオブジェクト・データを特に ＺＭＤデータと呼ぶことにします。 通常はＺＭＤデータを意識する必要はないのですが、あえてこのＺＭＤデータを 取り出す方法があります。ＺＭＵＳＩＣ．Ｘに備わっているコンパイル機能がそれです。 具体的には A>zmusic -c ＺＭＳファイル名 のようにします(ＺＭＵＳＩＣ．ＸはアセンブラやＣコンパイラのようにも機能します)。 するとＺＭＳファイルの主ファイル名に拡張子'.ZMD'を添付したファイルが 生成されます。これをＺＭＵＳＩＣシステムでは特にＺＭＤファイルと呼びます。 このＺＭＤファイルも演奏可能で、その際は当然ＺＭＤデータに変換する作業が ありませんので全く待たされずに演奏が開始されます。高速応答が要求される場合 (たとえば自作ゲームに曲を入れる場合など)は演奏データをＺＭＤデータで 管理した方がよいでしょう。ただし、データや環境の変更が困難ですので、 音楽データの配布を目的とした場合はＺＭＤデータ形式は避けるべきです。 { -- ZM2.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ ２ ＺＭＵＳＩＣ．Ｘのオプション・スイッチ解説 ここではＺＭＵＳＩＣ．Ｘのコマンドオプションについて解説します。 ２．１． はじめに ＺＭＵＳＩＣ．Ｘというプログラムには大きく分けて２つの機能が ある。１つはシステムに常駐して音楽演奏をする機能、もう１つは前章で 述べたＺＭＤファイルの生成機能である。よってＺＭＵＳＩＣ．Ｘの コマンドオプション／コマンドスイッチも大きく２つの機能に分けられる。 １つは常駐する際のパラメータとしての機能、もう１つは演奏データを コンパイルする際にこれを支援するものである。 各スイッチは「／」「−」の後ろにこれから解説するコマンドスイッチの アルファベットを記述し、さらに必要であればその直後に数値等のパラメータを 記述することによって指定する。具体的には A>zmusic −または／[各スイッチの英数字][パラメータ] のようになる。スイッチは(例外を除いて)順不同でいくつでも記述することが できる。また、 A>zmusic -h または -? でコマンドスイッチの簡単な説明を見ることができる。 それではそれぞれのスイッチを解説することにする。 ２．２． ドライバ組み込み時のスイッチ −Ａ 割り込みにタイマＡを使用する。デフォルトではタイマＢを使用する。 タイマＡはテンポ77から300までを有効範囲とし、かなり正確なテンポを キープ出来る。外部シーケンサ／リズムマシンとの同期演奏にはこちらの モードを勧める。 よく分からない人は特に設定する必要はない。 −Ｂファイルネーム ＡＤＰＣＭブロックデータ（ＺＰＤデータ）をドライバ起動時に読み込む。 後述の'−Ｐ'スイッチでＡＤＰＣＭバッファのサイズを指定していない場合は自動的に そのブロックデータのサイズがバッファサイズになる。ファイルネームの 拡張子を省略すると自動的に'.ZPD'が添付される（MEASURE6参照）。 −Ｅ 外部シーケンサ／リズムマシンとの同期演奏を行う。Ｘ６８ｋをホストにした ＭＵＳＩＣシステムならばこのスイッチは設定する必要はない。複数のＸ６８ｋを 　同期させて演奏させるにはこのスイッチを設定すること。 具体的には、演奏開始時にスタートメッセージ$FA、演奏再開時にコンティニュー メッセージ$FB、演奏停止時にストップメッセージ$FCを送信するようになる。 また、演奏データ中で指定したテンポに合わせてタイミングクロック$F8を 送信する。 −Ｇ ＺＭＵＳＩＣ．Ｘ起動時にロゴや常駐を報告するメッセージを表示しない。 −Ｍ ＭＦＰの多重割り込み対応モードにする。ラスタースクロール等の処理を ジャマしない。高度な割り込みを駆使したアプリケーションと併用する場合には このスイッチを指定すると良いだろう。通常やよく意味の分からない人は 設定する必要は全くない。 −Ｎ 初期化なしモードにする。このスイッチを指定してＺＭＵＳＩＣ．Ｘを 常駐させると以後、演奏データの変り目等で楽器等やワークの初期化を 行わない。これはゲーム等のＢＧＭを機械語レベルで演奏する時に 曲の変り目の処理を軽くするためのものである。通常は設定する必要は ない。 −Ｏn ＰＣＭ８．Ｘが先に組み込んであることが前提のスイッチ。従来の ＡＤＰＣＭ１声の曲データをＰＣＭ８．Ｘを用いてむりやりポリフォニックで 鳴らしてしまおうというものである。ただし、本来のＰＣＭ８モードとは 違うものなので注意すること(２．５．参照)。パラメータのnは音楽演奏に８声ある ＡＤＰＣＭチャンネルを何声音楽用に確保するかを設定するものである。 nは1≦n≦8でn省略時は自動的にn＝8が採択される。余ったチャンネル数は 効果音専用とみなして音楽演奏には使用しない。例えば A>zmusic -o6 とした場合、ＢＧＭ演奏用にチャンネル1〜6をＢＧＭ専用にし チャンネル７，８を効果音専用とする。 −Ｐn ＡＤＰＣＭデータバッファとしてnキロバイト確保する。'−Ｐ'スイッチを 設定しないとＡＤＰＣＭバッファサイズは256となる。0と設定した場合は、 ＡＤＰＣＭに関係するコマンドは無効になる（MEASURE6参照)。 −Ｒ 常駐しているＺＭＵＳＩＣ．Ｘをシステムから削除する。コマンドラインから 常駐させた場合のみ有効で'CONFIG.SYS'から'DEVICE＝'で組み込んだ場合は 常駐解除はできない。 −Ｓファイルネーム ＭＩＤＩのダンプデータ、ＡＤＰＣＭデータのコンフィギュレーションファイル などのセットアップファイルを読み込みドライバ起動時に実行する。 ＡＤＰＣＭコンフィギュレーションファイル中、データの加工を行うように 設定してある場合には必要分のワークを確保しないといけない(MEASURE6参照)。 ファイルネームは拡張子等の省略は認められず、さらにＭＩＤＩダンプデータは 拡張子'.MDD'の時のみ有効である。 さて、ここに演奏データのファイル名を書けばドライバ起動時に曲を演奏させる ことも可能。もちろんその際、ＡＤＰＣＭを使用していたりするならば それらに関係するバッファも確保しなければならない。 例 A>zmusic -bdrum.zpd -w30 -p100 -s music.zmd −Ｔn ＃n トラックバッファをnキロバイト確保する。デフォルトでは128キロバイト確保する。 サイズの大きいデータを演奏する際には状況に応じて設定すべきである。 −Ｗn ワークエリアとしてnキロバイト確保する。ワークエリアはＡＤＰＣＭデータの加工や コンフィギュレーションファイルのバッファ、ＭＩＤＩ楽器の設定の取り込み用 バッファ、波形メモリバッファと多目的に使用されるため、作業内容に応じて 設定すべきである。ＡＤＰＣＭのデータ加工用のワークとして設定する場合の目安は、 加工するデータのうち最長のものの長さを４倍した大きさである。 −Ｘn ＥＯＸ（エンド・オブ・エクスクルーシブ）メッセージを送った後、 ｎ ── 60 秒 のウェイトを与える。デフォルトは3で通常は設定する必要はないが、 極端に応答の遅いＭＩＤＩ楽器に対しては設定するとよい(U110/220,D70…など)。 ２．３． ＣＯＮＦＩＧ．ＳＹＳからの組み込み ＺＭＵＳＩＣ．Ｘはデバイスドライバでもあるので、もちろん ＣＯＮＦＩＧ．ＳＹＳから組み込むことが出来る。書式は他のデバイスドライバ 同様に DEVICE＝ZMUSIC.X オプションスイッチ… のようにする。 また DEVICE＝ZMUSIC.X -s曲ファイル名 のようにすればデバイスドライバ組み込み時から曲を流すことが出来る。 もちろん演奏に必要なバッファは取る必要がある。 ２．４． コンパイル支援系 −Ｃ ファイルネーム１ ファイルネーム２ ファイルネーム１をコンパイルし生成されるオブシェクトをファイルネーム２で セーブする。ファイルネーム２は省略可能で省略時はファイルネーム１に 拡張子'.ZMD'を付けたファイルネームでセーブされる。 例 A>zmusic -c music.opm → music.ZMD この’−Ｃ’スイッチは必ずコマンドラインの最後に書かなければならない。 '−Ｃ'スイッチの後ろに書かれたスイッチは無視される。 例 A>zmusic -c music.opm -w100 ←'-w100'は無視される。 また、大文字の’Ｃ’でこのスイッチを設定した場合は最適化処理 (空トラックの削除処理)を行なわずに動作を行なう。 −Ｑ ファイルネーム１ ファイルネーム２ コンパイル後その演奏データのトータルステップカウントを計算する。 ＭＭＬ命令[do]〜[loop]以外(例えば[coda]〜[tocoda]など)を用いて無限ループを 構成していると半永久的に計算を繰り返してしまうので注意。チェックサム的な 役割を果たすためＯｈ！Ｘなどの雑誌メディアに投稿する際はこのトータルステップ カウントを原稿等に添えること。 −Ｔn ＃n トラックバッファを確保する。デフォルトで128キロバイト確保するが コンパイル中'out of memory'が出た時設定すると良いだろう。常駐時と 同じイメージでコンパイルが行えるよう敢えてこういう仕様にした。 −Ｗn コンパイルされたデータを整理する際にこのエリアを使用する。デフォルトで 128キロバイト確保しているので殆どの場合は設定する必要はない。 極端に長い曲をコンパイルする際には設定の必要がある。 ２．５． ＰＣＭ８．Ｘモードについて ＰＣＭ８．Ｘとは江藤 啓氏により作成されたＸ６８ｋ本体の改造をせずに ＡＤＰＣＭ音を８和音までリアルタイムに発音できるアプリケーションである。 このＰＣＭ８．Ｘを事前に組み込んでからＺＭＵＳＩＣ．Ｘを組み込むと ＺＭＵＳＩＣ．Ｘは自動的にＰＣＭ８．Ｘモードで動作する。 ＺＭＵＳＩＣ．Ｘを組み込んだ後にＰＣＭ８．Ｘを組み込むことはできない( エラーが発生する)。 さて、ＺＭＵＳＩＣ．ＸのＰＣＭ８モードには２通りある。 １つはＡＤＰＣＭ音源を８つのほぼ独立したチャンネルとして使用する モードである。このモードにするにはＺＭＵＳＩＣ．Ｘを組み込む時に特別な スイッチ等を設定する必要はない。このモードを特にＰＣＭ８独立チャンネル モードと呼ぶことにする。 もう１つはＰＣＭ８．Ｘを組み込んだあと'−Ｏ'スイッチをつけて ＺＭＵＳＩＣ．Ｘを組み込むと設定されるモードである。これは ＰＣＭ８．Ｘ用ではない曲、つまりＡＤＰＣＭ１声用の曲データのＡＤＰＣＭ音を むりやりポリフォニックに演奏するモードである。例えばシンバルを 叩いた後このシンバルが鳴り終らないうちにスネアを叩いたとすると、 ＡＤＰＣＭ１声の従来の曲ではシンバルの音がブツリと切れてスネアの音に 切り替わっていた。ここをブツ切りにしないで（ＰＣＭ８．Ｘを用いて） ちゃんと前後の音を重ねて演奏してしまおうというのがこのモードである。 このモードはＰＣＭ８ポリモードと呼ぶことする。 ＰＣＭ８独立チャンネルモード時の具体的な操作方法に関しては後述する。 ２．６． ３タイプのＺＭＵＳＩＣ．Ｘ 　ＺＭＵＳＩＣには ●シャープ純正(または互換)のＭＩＤＩインターフェースに対応した標準的な ＵＮＩＶＥＲＳＡＬバージョン ●ＲＳ２３２Ｃポートを使ってＭＩＤＩ出力を行うＲＳ２３２Ｃバージョン ●ネオ・コンピュータ・システム(ＮＣＳ)製のサブボード、ポリフォンを使用して ＭＩＤＩ出力を行うＰＯＬＹＰＨＯＮバージョン の３つのタイプが存在する。 ３タイプとも内蔵音源(ＦＭ音源、ＡＤＰＣＭ音源)の制御部分は、全く同じ プログラムで構成されており、違うのはＭＩＤＩ出力に関する点のみである。 ３タイプともＸ６８０００／Ｘ６８０３０の両方に対応している。 ●ＲＳ２３２Ｃバージョン ＲＳ２３２ＣバージョンはＸ６８本体後面パネルのＲＳ２３２Ｃ端子に市販の ＲＳ２３２Ｃ−ＭＩＤＩアダプタ(例：COME ON MUSIC製 MA01 ￥10,000)を装着し、 これを使用してＭＩＤＩ制御を行うＺＭＵＳＩＣである。標準のＵＮＩＶＥＲＳＡＬ バージョンとは以下の相違点がある。 ・ＭＩＤＩ出力の処理速度がＵＮＩＶＥＲＳＡＬバージョンと比べて少し遅い。 ・純正ＭＩＤＩインターフェース・ボードを装着していてもＲＳ２３２Ｃ−ＭＩＤＩを 強制的に選択する。 ・外部同期モード(オプション'-E')がない。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ＲＳ２３２Ｃ版の注意 ┃ ┃ ┃ ┃ ＲＳ２３２Ｃ版はＲＳ２３２Ｃ関連の割り込みベクタ等を占有する ┃ ┃ ┃ ┃アプリケーションとは共存できません。(RSDRV.SYSなど) ┃ ┃ ┃ ┃ ベクタが占有されている時は ┃ ┃ ┃ ┃The interrupt-vector has already been occupied by some other applications. ┃ ┃ ┃ ┃というエラーメッセージが表示され、ＺＭＵＳＩＣは起動されません。 ┃ ┃ ┃ ┃ベクタを占有しているアプリケーションを一度解除してからもう一度 ┃ ┃ ┃ ┃ＺＭＵＳＩＣを起動してください。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ●ＰＯＬＹＰＨＯＮバージョン ＰＯＬＹＰＨＯＮバージョンはサブボード「ポリフォン」をポリフォンに同梱の プログラム「PCM8SB.X」で制御し、ＭＩＤＩ出力を行うＺＭＵＳＩＣである。 ＺＭＵＳＩＣの組み込みよりも先にポリフォンに同梱のプログラム「PCM8SB.X」を 組み込まなくてはＭＩＤＩ制御が行えない。PCM8SB.Xを組み込まずにＺＭＵＳＩＣ のみを組み込んだ場合は内蔵音源の制御のみ可能となる。標準のＵＮＩＶＥＲＳＡＬ バージョンとは以下の相違点がある。 ・ＭＩＤＩ出力の処理速度がＵＮＩＶＥＲＳＡＬバージョンと比べて少し遅い。 ・ＭＩＤＩインターフェース・ボードを装着していてもＰＯＬＹＰＨＯＮ−ＭＩＤＩを 強制的に選択する。 ・ポリフォン−ＭＩＤＩによるＭＩＤＩ−ＩＮはサポートされない。 ・外部同期モード(オプション'-E')がない。 ２．７．　機能縮小版ＺＭＳＣ．Ｘ ＭＭＬコンパイル処理部分などを省いたＺＭＤ再生専用のＺＭＵＳＩＣが、 ＺＭＳＣ．Ｘである。ＺＭＳを扱う機能は全く持っていないため、ＺＭＳファイルを 演奏したりすることはできない。しかし、常駐サイズはＺＭＵＳＩＣ．Ｘの半分程度で 済むため、ゲームやその他のアプリケーションから使用する場合には適している。 ＺＭＵＳＩＣ．Ｘ同様にＵＮＩＶＥＲＳＡＬバージョン、ＲＳ２３２Ｃバージョン、 ＰＯＬＹＰＨＯＮバージョンの３タイプがある。 　以下にＺＭＵＳＩＣ．ＸとＺＭＳＣ．Ｘとの相違点を述べる。 ・ファンクション$01 m_alloc ファンクション$02 m_assign ファンクション$03 m_vget ファンクション$06 m_trk ファンクション$07 m_free ファンクション$3e set_fm_master_vol はなんの機能も実行しない(削除されている)。 ファンクション$3c get_play_workは、戻り値のd0.lが意味をなさなくなる (a0.lにはZMUSIC.X同様の正しい戻り値を返す)。 ・ファイル名'OPM'への出力による制御も行なえるが、ＺＭＤまたはＺＰＤ以外を 出力した場合は何の機能も実行しない(ＺＭＳコマンドの使用もできない)。 ・ファイル名'MIDI'によるＭＩＤＩ楽器のデータ吸い取り機能はそのまま使用できる。 ＭＤＤの転送も行なえる。 ・IOCS _OPMDRVによるコントロールはできない。TRAP #3でのみファンクション コールを実行できる。 ・ＺＭＤの演奏やＺＰＤの変更登録はＺＭＵＳＩＣ．Ｘ同様にZP.Rで行なえる。 ただし、ＺＭＳの再生は行なえない。 ・ＭＵＳＩＣＺ．ＦＮＣは使用できるが 'm_alloc' 'm_assign' 'm_vget' 'm_trk' 'm_trk2' 'm_free' 'fm_master' 'm_debug' は、なんの機能も実行しない(削除されている)。 ・デフォルトでトラックバッファを３２キロバイト、ワークエリアを０キロバイト、 ＡＤＰＣＭバッファを２５６キロバイト確保して常駐する。ＺＭＵＳＩＣ．Ｘとは デフォルトが違うので注意すること。 { -- ZM3.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ ３ Ｘ−ＢＡＳＩＣ用外部関数ＭＵＳＩＣＺ．ＦＮＣ Ｘ６８ｋ本体付属のＢＡＳＩＣ「Ｘ−ＢＡＳＩＣ」からＺＭＵＳＩＣを 使う方法について述べます。 ３．１． はじめに ＢＡＳＩＣからＺＭＵＳＩＣを使うには外部関数「ＭＵＳＩＣＺ．ＦＮＣ」を 組み込んだＸ−ＢＡＳＩＣを起動しなければならない。具体的には、 ＢＡＳＩＣディレクトリ中のBASIC.CNFの内容のうち FUNC＝MUSIC の部分を FUNC＝MUSICZ のように変更し、さらにこのディレクトリにMUSICZ.FNCをコピーする。そして A>basic でＸ−ＢＡＳＩＣを起動すればよい。しかし、各自のシステムの環境によっては 多少の食い違いもあるのでよく分からない人は「ＢＡＳＩＣマニュアル」を参照すること。 また、1990年10月号のＯｈ！Ｘに発表された「ＺＭＵＳＩＣ．ＦＮＣ」とは 全く無関係である。このＺＭＵＳＩＣシステムは「ＺＭＵＳＩＣ．ＦＮＣ」とは 全く関係ない。互換性もない。 MEASURE1で述べたようにＺＭＵＳＩＣ．Ｘは一部を除いて Ｘ６８ｋ本体付属の「ＯＰＭＤＲＶ．Ｘ」と「ＭＵＳＩＣ．ＦＮＣ」との互換性を 保っている。このことからＭＵＳＩＣＺ．ＦＮＣのコマンドの一部は ＭＵＳＩＣ．ＦＮＣのものと仕様が同じである。そのため、ここでは 「Ｘ−ＢＡＳＩＣマニュアル」にあるコマンドも重複して説明がなされている。 しかし、ＭＵＳＩＣＺ．ＦＮＣでは仕様が拡張変更されたものもあるので 注意すること。 また、従来のＭＵＳＩＣ．ＦＮＣでもＺＭＵＳＩＣは操作可能である。 その場合もちろんＺＭＵＳＩＣ．Ｘの100％の性能を発揮することは出来ない。 逆にＭＵＳＩＣＺ．ＦＮＣでＯＰＭＤＲＶ．Ｘは操作出来ないので注意すること。 ３．２． コマンドの使用にあたっての注意 ＭＩＤＩ楽器専用のコマンドは場合によっては楽器のメモリを書き換える。 よく楽器側のマニュアルを読んでから実行すること。楽器側に大切なデータが 存在する場合は、楽器のメモリをファイルに保存しておくとよい(MEASURE9参照)。 ３．３． ＭＵＳＩＣＺ．ＦＮＣ命令一覧 ●初期化 -------------------------------------------------------------------------------- 関数名 m_init() 機能 音源の初期化、ドライバのワークの初期化 引数 なし 戻り値 なし 備考 ＭＩＤＩボード装着時ＭＩＤＩ楽器に対して以下のコマンドメッセージを送出する。 システムリセット($FF) リセットオールコントローラーズ($Bn,$79,$00) オムニモードオン($Bn,7D,$00) モノモードオフ($Bn,$7F,$00) ローカルオン($Bn,$7A,$7F) マスターチューン・微調整＝中央($Bn,$65,$00,$Bn,$64,$01,$Bn,$06,$40,$Bn,$26,$00) マスターチューン・コース＝中央($Bn,$65,$00,$Bn,$64,$02,$BN,$06,$40) -------------------------------------------------------------------------------- 関数名 m_count(n) 機能 全音符の絶対音長指定 引数 n＝全音符の絶対音長(char:1≦n≦254) 戻り値 なし 備考 'm_init()'でデフォルト値である192が設定される。 通常は設定する必要無し。 ゲーム用のＢＧＭ等を作成する時など、割り込み回数を減らす目的で使うとよい。 192, 144, 128, 96といった数値が一般的。 -------------------------------------------------------------------------------- ●トラック確保／チャンネルアサイン -------------------------------------------------------------------------------- 関数名 m_alloc(tr,size) 機能 トラックバッファの確保 引数 tr:トラック番号(char:1〜80) size:バッファサイズ(int:100〜65535) 戻り値 なし -------------------------------------------------------------------------------- 関数名 m_assign(ch,tr) 機能 チャンネル番号chをトラック番号trに割り当てる 引数 ch:チャンネル番号(char:1〜32) tr:トラック番号(char:1〜80) 戻り値 なし 備考 複数のトラックを１つのチャンネルに割り当てることも出来る。 チャンネル番号は後述の'm_ch()'コマンドによって対象デバイスが変化する ただし、ＰＣＭ８．Ｘ組み込み時は'm_ch()'によらずチャンネル番号26〜32が ＡＤＰＣＭ2〜8になる。 -------------------------------------------------------------------------------- 関数名 m_assign2(ch,tr) 機能 チャンネル番号chをトラック番号trに割り当てる 引数 ch:チャンネル番号(str:"FM1〜8","MIDI1〜16","ADPCM","ADPCM1〜8") tr:トラック番号(char:1〜80) 戻り値 なし 備考 １つのチャンネルを複数のトラックに割り当てることが出来る。 例 m_assign2(1,"fm1") m_assign2(1,"midi10") "adpcm2〜8"が実用できるのはＰＣＭ８モード時のみである。 -------------------------------------------------------------------------------- 関数名 m_ch(dv) 機能 ベースチャンネルを変更する 引数 dv:デバイス名(str:"FM" or "MIDI") 戻り値 なし 備考 "FM"を設定するとチャンネル番号1〜8がＦＭ音源, 9がＡＤＰＣＭチャンネル１ 10〜25がＭＩＤＩになる。 "MIDI"を設定するとチャンネル番号1〜16がＭＩＤＩ17〜24がＦＭ音源, 25がＡＤＰＣＭチャンネル１になる また、ＰＣＭ８．Ｘ組み込み時は'm_ch()'によらずチャンネル番号26〜32が ＡＤＰＣＭ2〜8になる。 例 m_ch("midi") m_ch("fm") -------------------------------------------------------------------------------- 関数名 m_free(tr) 機能 トラックバッファのフリーエリアを得る 引数 tr＝トラック番号(char:1〜80) 戻り値 ｉｎｔ -------------------------------------------------------------------------------- ●演奏制御 -------------------------------------------------------------------------------- 関数名 m_play(tr1,tr2,…,tr10) 機能 演奏の開始 引数 tr1〜10:トラック番号(char:1〜80) 全て省略すると全トラックを演奏する 戻り値 なし -------------------------------------------------------------------------------- 関数名 m_stop(tr1,tr2,…,tr10) 機能 演奏の停止 引数 tr1〜10:トラック番号(char:1〜80) 全て省略すると全トラックの演奏を停止する 戻り値 なし -------------------------------------------------------------------------------- 関数名 m_cont(tr1,tr2,…,tr10) 機能 演奏の再開 引数 tr1〜10:トラック番号(char:1〜80) 全て省略すると全トラックの演奏を再開する 戻り値 なし -------------------------------------------------------------------------------- 関数名 m_solo(ch1,ch2,…ch10) 機能 演奏チャンネルのマスク（その１） 引数 ch1〜10＝チャンネル番号（char) 戻り値 なし 備考 指定したチャンネルのみを演奏しそれ以外のチャンネル演奏を一時停止する。 演奏中に実行可能。またパラメータを省略し m_solo() とすると通常演奏に戻る。 m_ch("FM")の時はチャンネル番号1〜8がＦＭ音源,9がＡＤＰＣＭチャンネル１ 10〜25がＭＩＤＩに対応する。 m_ch("MIDI")の時はチャンネル番号1〜16がＭＩＤＩ,17〜24がＦＭ音源, 25がＡＤＰＣＭチャンネル１に対応する。 また、ＰＣＭ８．Ｘ組み込み時は'm_ch()'によらずチャンネル番号26〜32が ＡＤＰＣＭ2〜8に対応する。 演奏が停止したトラックも内部処理は続行するため、マスクを解除した時は 他のトラックに遅れを取らずに何事も無かったように演奏が再開される。 ただし、このコマンド実行時は効果音モードが正常に動作しない。 ------------------------------------------------------------------------------ 関数名 m_mute(ch1,ch2,…ch10) 機能 演奏チャンネルのマスク（その２） 引数 ch1〜10＝チャンネル番号（char) 戻り値 なし 備考 指定したチャンネルの演奏を一時停止し、それ以外のチャンネルは通常に 演奏を行う。演奏中に実行可能。またパラメータを省略し m_mute() とすると通常演奏に戻る。 m_ch("FM")の時はチャンネル番号1〜8がＦＭ音源,9がＡＤＰＣＭチャンネル１ 10〜25がＭＩＤＩに対応する。 m_ch("MIDI")の時はチャンネル番号1〜16がＭＩＤＩ,17〜24がＦＭ音源, 25がＡＤＰＣＭチャンネル１に対応する また、ＰＣＭ８．Ｘ組み込み時は'm_ch()'によらずチャンネル番号26〜32が ＡＤＰＣＭ2〜8に対応する。 演奏が停止したトラックも内部処理は続行するため、マスクを解除した時は 他のトラックに遅れを取らずに何事も無かったように演奏が再開される。 ただし、このコマンド実行時は効果音モードが正常に動作しない。 -------------------------------------------------------------------------------- 関数名 m_fadeout(spd) 機能 演奏中のデータをフェードアウト／インする 引数 spd＝フェードアウト／イン・スピード(int:−85〜85) 戻り値 なし 備考 spdを省略するとデフォルト値16が設定される。 spdは正値がフェードアウト、負値がフェードインの指定となる。 絶対値が大きいほど音量の増減スピードは速くなる。 -------------------------------------------------------------------------------- 関数名 m_stat(ch) 機能 演奏状態のチェック 引数 チャンネル番号(char:1〜25) （注１） 全て省略すると全チャンネルの演奏状態をチェック出来る 戻り値 ｉｎｔ チャンネル番号を指定した場合、そのチャンネルが演奏中ならば1、 演奏中でないなら0。チャンネル番号を省略した場合は演奏中の チャンネル番号に対応したビットが1に、演奏していないチャンネル番号に 対応したビットが０になる。 m_ch("FM")の場合はビット0〜7がＦＭチャンネル1〜8に、ビット8が ＡＤＰＣＭチャンネル１に、ビット9〜24がＭＩＤＩチャンネル1〜16に 対応する。 m_ch("MIDI")の場合はビット0〜15がＭＩＤＩチャンネル1〜16に ビット16〜23がＦＭチャンネル1〜8に、ビット24が ＡＤＰＣＭチャンネル１に対応する。 また、ＰＣＭ８．Ｘを組み込み時には'm_ch()'によらずビット25〜31が ＡＤＰＣＭ2〜8チャンネルに対応する。 -------------------------------------------------------------------------------- ●開発補助 -------------------------------------------------------------------------------- 関数名 m_debug(sw) 機能 ＭＭＬの'[@]','[!]','[end]'コマンドの有効／無効化 引数 sw＝数値(char:0＝off,nz＝on) 戻り値 なし -------------------------------------------------------------------------------- 関数名 m_total() 機能 各トラックにセットされたＭＭＬの総ステップタイム数を計算し 結果を画面に出力する 引数 なし 戻り値 なし 備考 トラック番号：ループ外の総カウント数 ループ内の総カウント数 というフォーマットで出力される。 Ｘ−ＢＡＳＩＣは独自の仮想画面で画面を管理しているのに対して 本命令はむりやり表示を行っているため画面下部で本命令を実行すると 表示の一部がずれることがある。 -------------------------------------------------------------------------------- ●テンポ -------------------------------------------------------------------------------- 関数名 m_tempo(tm) 機能 テンポの設定 引数 tm＝トラック番号(int:20〜300) 戻り値 tmを省略すると現在のテンポ値を返す 備考 タイマＡモード(MEASURE2参照)で動作中時はテンポ77以下は強制的に77になる。 -------------------------------------------------------------------------------- ●ＭＭＬの書き込み -------------------------------------------------------------------------------- 関数名 m_trk(tr,str) 機能 ＭＭＬをトラックへ書き込む 引数 tr:トラック番号(char:1〜80) str:ＭＭＬデータ(str) 戻り値 なし 備考 ＭＭＬに関してはMEASURE5を参照のこと。 -------------------------------------------------------------------------------- 関数名 m_trk2(str,tr1,tr2,tr3,tr4,tr5,tr6,tr7,tr8) 機能 ＭＭＬを複数のトラックへ書き込む 引数 str:ＭＭＬデータ(str) tr1〜8:トラック番号(char:1〜80) 戻り値 なし 備考 tr2〜tr8は省略可能。 ＭＭＬに関してはMEASURE5を参照のこと。 -------------------------------------------------------------------------------- ●ＦＭ音源の音色設定 -------------------------------------------------------------------------------- 関数名 m_vset(vn,ary) 機能 ＦＭ音源の音色登録 引数 vn:音色番号(char:1〜200) ary:音色データ(dim char ary(4,10)) 戻り値 なし 備考 　 10 /*設定例 20 dim char v(4,10) 30 /* AF OM WF SYC SPD PMD AMD PMS AMS PAN 40 v={59, 15, 2, 1,200,127, 0, 0, 0, 3, 0, 　　 50 /* AR DR SR RR SL OL KS ML DT1 DT2 AME 60 31, 8, 1, 8, 7, 20, 2, 1, 5, 3, 0, 70 31, 8, 8, 7, 5, 24, 1, 2, 1, 1, 0, 80 31, 3, 7, 8, 1, 21, 1, 1, 3, 0, 0, 90 31, 0, 0, 9, 0, 0, 2, 8, 5, 2, 0} 100 m_vset(1,v) パラメータ概説 ０ １〜４(オペレータ) ０ AF(ﾌｨｰﾄﾞﾊﾞｯｸ/ｱﾙｺﾞﾘｽﾞﾑ) (0〜63) | AR(ｱﾀｯｸﾚｰﾄ) (0〜31) １ OM(ｽﾛｯﾄﾏｽｸ) (0〜15) | 1DR(1stﾃﾞｨｹｲﾚｰﾄ) (0〜31) ２ WF(ｳｪｰｳﾞﾌｫｰﾑ) (0〜3) | 2DR(2ndﾃﾞｨｹｲﾚｰﾄ) (0〜31) ３ SYC(ｼﾝｸﾛ) (0,1) | RR(ﾘﾘｰｽﾚｰﾄ) (0〜15) ４ SPD(ｽﾋﾟｰﾄﾞ) (0〜255) | 1DL(1stﾃﾞｨｹｲﾚﾍﾞﾙ) (0〜15) ５ PMD (0〜127) | TL(ﾄｰﾀﾙﾚﾍﾞﾙ) (0〜127) ６ AMD (0〜127) | KS(ｷｰｽｹｰﾘﾝｸﾞ) (0〜3) ７ PMS (0〜7) | MUL(ﾌｪｰｽﾞﾏﾙﾁﾌﾟﾗｲ) (0〜15) ８ AMS (0〜3) | DT1(ﾃﾞｨﾁｭｰﾝ1) (0〜7) ９ PAN (0〜3) | DT2(ﾃﾞｨﾁｭｰﾝ2) (0〜3) 10 DUMMY | AME(AMSｲﾈｰﾌﾞﾙ) (0,1) パラメータの機能や詳しい解説は専門書や「ＢＡＳＩＣマニュアル」の M_VSET()やM_VGET()の項を参照。 -------------------------------------------------------------------------------- 関数名 m_vget(vn,ary) 機能 ＦＭ音源の音色データの取り出し 引数 vn:音色番号(char:1〜200) ary:音色バッファ(dim char ary(4,10)) 戻り値 ary(4,10)に音色データが格納される -------------------------------------------------------------------------------- 関数名 m_fmvset(vn,ary) 機能 ＦＭ音源の音色登録(AL/FB分離形式) 引数 vn:音色番号(char:1〜200) ary:音色データ(dim char ary(4,10)) 戻り値 なし 例 10 dim char v(4,10) 20 /* AR 1DR 2DR RR 1DL TL RS MUL DT1 DT2 AME 30 v={ 31, 0, 2, 0, 0, 21, 0, 1, 0, 0, 0, 40 31, 0, 0, 8, 0, 3, 0, 3, 0, 0, 0, 50 31, 0, 0, 8, 0, 3, 0, 1, 0, 0, 0, 60 31, 0, 0, 8, 0, 3, 0, 1, 0, 0, 0, 70 /* CON FBL OM PAN WF SYC SPD PMD AMD PMS AMS 80 5, 7,15, 3 0, 0, 0, 0, 0, 0, 0} 90 m_fmvset(1,v) 備考 AL/FB(CON/FB)分離形式とはＦＭ音源のパラメータである アルゴリズム（またはコネクション）とフィードバックレベルを 従来の書式では１つにまとめていたのを分かりやすく分割して 指定できるようにしたもの。 -------------------------------------------------------------------------------- ●ＡＤＰＣＭコンフィギュレーション -------------------------------------------------------------------------------- 関数名 m_pcmset(nt,fn,pt,vl,mx,dl,ct,rv,fd) 機能 ノート番号ntにファイルネームfnのＡＤＰＣＭ音をセットする 引数 nt＝ノート番号(int:0〜511) fn＝ファイルネーム(str) pt＝ピッチシフトパラメータ(int:0〜11＝ﾋﾟｯﾁﾀﾞｳﾝ,12＝ﾆｭｰﾄﾗﾙ,13〜24＝ﾋﾟｯﾁｱｯﾌﾟ) vl＝ボリュームパラメータ(int:1%〜300%) mx＝ミックス対象ノート番号(int:0〜511) dl＝ミックスディレイパラメータ（int:0〜65535) ct＝カットパラメータ(int:0〜$ffffffff) rv＝リバーススイッチ(char:0＝normal/1＝reverse) fd＝フェード イン／アウトパラメータ(int:0〜$ffffffff) 戻り値 なし 備考 カットパラメータ＝オフセット(0〜65535)×65536＋カットサイズ(0〜65535) フェードイン／アウト・パラメータ＝オフセット(0〜65535)×65536 ＋モード(−1＝フェードイン,＋1＝フェードアウト)×256 ＋フェードイン／アウト・レベル(0〜127) fnがカレントより見つからない場合は環境変数'zmusic'のパスを参照する。 pt,vl,mx,dl,ct,rv,fdはそれぞれ省略可能。 pt,vl,mx,dl,ct,rv,fdのいずれかを設定した場合はＡＤＰＣＭデータの加工を 行うので多少の時間を要する。 また、加工には相当量のメモリを必要とするためドライバ起動時の'−Ｗ'スイッチ でワークエリアを十分に確保していないとエラーとなる。 パラメータの具体的な説明はMEASURE6を参照のこと。 例 m_pcmset(10,"snare.pcm",13,120,8,1000,&h10001000,1,&h1000ff01) -------------------------------------------------------------------------------- 関数名 m_pcmcnf(fn) 機能 ＡＤＰＣＭコンフィギュレーションファイルで ＡＤＰＣＭ音をドライバに登録する 引数 fn＝ファイルネーム(str) 戻り値 なし 備考 fnがカレントより見つからない場合は環境変数'zmusic'のパスを参照する。 -------------------------------------------------------------------------------- 関数名 m_adpcm_block(fn) 機能 ＡＤＰＣＭブロックデータを読み込む 引数 fn＝ファイルネーム(str) 戻り値 なし 備考 fnがカレントより見つからない場合は環境変数'zmusic'のパスを参照する。 ＡＤＰＣＭバッファがブロックデータの大きさより小さい場合はエラーとなる。 -------------------------------------------------------------------------------- ●ＭＩＤＩデータ出力 -------------------------------------------------------------------------------- 関数名 m_out(data1,data2,…,data10) 機能 ＭＩＤＩデータを送信する 引数 data1〜10＝ＭＩＤＩデータ(char) 戻り値 なし 備考 data2以降は省略可,Ｘ−ＢＡＳＩＣの制約からデータは10個まで。 例 m_out(&HC0,10) -------------------------------------------------------------------------------- 関数名 m_dirout(ary,size) 機能 １次元配列に格納されたデータを送信する 引数 ary＝１次元配列(dim char ary(n)) size＝送信データ数(int:1〜65536) 戻り値 なし 備考 sizeを省略した場合は配列内全てのデータを送信する。 -------------------------------------------------------------------------------- 関数名 m_exc(ary,size) 機能 １次元配列に格納されたデータをエクスクルーシブデータとして送信する 引数 ary＝１次元配列(dim char ary(n)) size＝送信データ数(int:1〜65536) 戻り値 なし 備考 sizeを省略した場合は配列内全てのデータを送信する。 頭に$f0、後尾に$f7を自動的に付けて送信するだけで機能的には ほとんど'm_dirout()'と同じ。 -------------------------------------------------------------------------------- 関数名 m_roland(dev,mdl,ary,size) 機能 １次元配列に格納されたデータを ローランドエクスクルーシブデータと見なし送信する 引数 dev＝転送先の楽器のデバイスＩＤ(char) mdl＝転送先の楽器のモデルＩＤ(char) ary＝１次元配列(dim char ary(n)) size＝送信データ数(int:1〜65536) 戻り値 なし 備考 sizeを省略した場合は配列内全てのデータを送信する。 エクスクルーシブヘッダやチェックサムのデータは自動発信する。 -------------------------------------------------------------------------------- 関数名 m_trans(fn) 機能 ＭＩＤＩダンプデータファイルをＭＩＤＩ楽器へ送信する 引数 fn＝ファイルネーム(str) 戻り値 なし 備考 fnがカレントより見つからない場合は環境変数'zmusic'のパスを参照する。 MEASURE9参照。 -------------------------------------------------------------------------------- ●ＭＩＤＩデータ入力 -------------------------------------------------------------------------------- 関数名 m_inp(mode) 機能 ＭＩＤＩデータを送信する 引数 mode＝入力モード(char:0,1〜255) mode＝0 入力データがない場合はエラーコードを持って帰還 mode＝1〜255 データが受信されるまでmode×(1/60)秒間待つ 戻り値 0〜255:入力されたデータ -1:エラー -------------------------------------------------------------------------------- 関数名 m_rec() 機能 ＭＩＤＩ楽器よりデータを受信するモードにする 引数 なし 戻り値 なし 備考 MEASURE9参照。 -------------------------------------------------------------------------------- 関数名 m_rstop() 機能 ＭＩＤＩ楽器からのデータを受信するモードを解除する 引数 なし 戻り値 なし 備考 MEASURE9参照。 -------------------------------------------------------------------------------- 関数名 m_save(fn) 機能 m_rec()で受信したＭＩＤＩデータをセーブする 引数 fn＝ファイルネーム(str) 戻り値 なし 備考 MEASURE9参照。 -------------------------------------------------------------------------------- ●ＳＣ５５／ＳＣ１５５／ＣＭ３００／ＣＭ５００のＧＳパート専用命令 パラメータの意味などは楽器のマニュアルを参照のこと -------------------------------------------------------------------------------- 関数名 sc55_init(id) 機能 ＳＣ５５の初期化を行なう 引数 id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 -------------------------------------------------------------------------------- 関数名 sc55_v_reserve(ary,id) 機能 ＳＣ５５のボイスリザーブ 引数 ary＝各パートのボイスリザーブ値(dim char ary(15)＝{vr1,…,vr16}) id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は15でリザーブ値は16パート分書かなければならない。 また、合計が楽器の最大同時発生数である24以下にならなければならない。 ary(0)＝パート1,ary(1)＝パート2…,ary(15)＝パート16というふうに対応する。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 -------------------------------------------------------------------------------- 関数名 sc55_reverb(ary,id) 機能 ＳＣ５５のリバーブパラメータ設定 引数 ary＝リバーブパラメータ(dim char ary(6)＝{rv1,…,rv7}) id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は6以内で配列の内容全部がＳＣ５５へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される ary(0):REVERB MACRO 00:Room1,01:Room2,02:Room3,03:Hall1,04:Hall2 05:Plate,06:Delay,07:Panning Delay(FB) ary(1):REVERB CHARACTER ($00〜$07) ary(2):REVERB PRE-LPF ($00〜$07) ary(3):REVERB LEVEL ($00〜$7F) ary(4):REVERB TIME ($00〜$7F) ary(5):REVERB DELAY FEEDBACK ($00〜$7F) ary(6):REVERB SEND LEVEL TO CHORUS ($00〜$7F) (SC55マニュアルp79参照) -------------------------------------------------------------------------------- 関数名 sc55_chorus(ary,id) 機能 ＳＣ５５のコーラスパラメータ設定 引数 ary＝コーラスパラメータ(dim char ary(7)＝{co1,…,co8}) id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は7以内で配列の内容全部がＳＣ５５へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):CHORUS MACRO 00:Chorus1,01:Chorus2,02:Chorus3,03:Chorus4 04:Feedback Chorus,05:Flanger,06:Short Delay 07:Short Delay(FB) ary(1):CHORUS PRE-LPF ($00〜$07) ary(2):CHORUS LEVEL ($00〜$7F) ary(3):CHORUS FEEDBACK ($00〜$7F) ary(4):CHORUS DELAY ($00〜$7F) ary(5):CHORUS RATE ($00〜$7F) ary(6):CHORUS DEPTH ($00〜$7F) ary(7):CHORUS SEND LEVEL TO REVERB ($00〜$7F) (SC55マニュアルp79参照) -------------------------------------------------------------------------------- 関数名 sc55_part_setup(pt,ary,id) 機能 ＳＣ５５のパートパラメータ設定 引数 pt＝パートナンバー(char:1〜16) ary＝パートパラメータ(dim char ary(118)＝{pp1,…,pp119}) id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は118以内で配列の内容全部がＳＣ５５へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Rx CHANNEL (1〜16,17＝OFF) ary(1):Rx PITCH BEND (0〜1:OFF/ON) ary(2):Rx CH PRESSURE(CAf) (0〜1:OFF/ON) ary(3):Rx PROGRAM CHANGE (0〜1:OFF/ON) ary(4):Rx CONTROL CHANGE (0〜1:OFF/ON) ary(5):Rx POLY PRESSURE(PAf) (0〜1:OFF/ON) ary(6):Rx NOTE MESSAGE (0〜1:OFF/ON) ary(7):Rx RPN (0〜1:OFF/ON) ary(8):Rx NRPN (0〜1:OFF/ON) ary(9):Rx MODURATION (0〜1:OFF/ON) ary(10):Rx VOLUME (0〜1:OFF/ON) ary(11):Rx PANPOT (0〜1:OFF/ON) ary(12):Rx EXPRESSION (0〜1:OFF/ON) ary(13):Rx HOLD1 (0〜1:OFF/ON) ary(14):Rx PORTAMENTO (0〜1:OFF/ON) ary(15):Rx SOSTENUTO (0〜1:OFF/ON) ary(16):Rx SOFT (0〜1:OFF/ON) ary(17):MONO/POLY MODE (0〜1:MONO/POLY) ary(18):ASSIGN MODE (0:SINGLE,1:LIMITED-MULTI,2:FULL-MULTI) ary(19):USE FOR RHYTHM PART (0:OFF,1:MAP1,2:MAP2) ary(20):PITCH KEY SHIFT ($28〜$58:−24〜＋24[semitone]) ary(21):PITCH OFFSET FINE(upper) ($08〜$F8:−12.0〜＋12.0[Hz]) ary(22):PITCH OFFSET FINE(lower) 〃 ary(23):PART LEVEL (0〜127) ary(24):VELOCITY SENSE DEPTH (0〜127) ary(25):VELOCITY SENSE OFFSET (0〜127) ary(26):PART PANPOT (0:RANDOM,01(LEFT)〜64〜127(RIGHT)) ary(27):KEY RANGE LOW (0〜127:C-1〜G9) ary(28):KEY RANGE HIGH (0〜127:C-1〜G9) ary(29):CC1 CONTROL NUMBER (0〜127) ary(30):CC2 CONTROL NUMBER (0〜127) ary(31):CHORUS SEND DEPTH (0〜127) ary(32):REVERB SEND DEPTH (0〜127) ary(33):Vibrato rate ($0E〜$72:−50〜＋50) ary(34):Vibrato depth ($0E〜$72:−50〜＋50) ary(35):TVF cutoff freq. ($0E〜$50:−50〜＋16) ary(36):TVF resonance ($0E〜$72:−50〜＋50) ary(37):TVF&TVA Env.attack ($0E〜$72:−50〜＋50) ary(38):TVF&TVA Env.decay ($0E〜$72:−50〜＋50) ary(39):TVF&TVA Env.release ($0E〜$72:−50〜＋50) ary(40):Vibrato delay ($0E〜$72:−50〜＋50) ary(41):SCALE TUNING C ($00〜$7F:−64〜＋63[cent]) ary(42):SCALE TUNING C# ($00〜$7F:−64〜＋63[cent]) ary(43):SCALE TUNING D ($00〜$7F:−64〜＋63[cent]) ary(44):SCALE TUNING D# ($00〜$7F:−64〜＋63[cent]) ary(45):SCALE TUNING E ($00〜$7F:−64〜＋63[cent]) ary(46):SCALE TUNING F ($00〜$7F:−64〜＋63[cent]) ary(47):SCALE TUNING F# ($00〜$7F:−64〜＋63[cent]) ary(48):SCALE TUNING G ($00〜$7F:−64〜＋63[cent]) ary(49):SCALE TUNING G# ($00〜$7F:−64〜＋63[cent]) ary(50):SCALE TUNING A ($00〜$7F:−64〜＋63[cent]) ary(51):SCALE TUNING A# ($00〜$7F:−64〜＋63[cent]) ary(52):SCALE TUNING B ($00〜$7F:−64〜＋63[cent]) ary(53):MOD PITCH CONTROL ($28〜$58:−24〜＋24[semitone]) ary(54):MOD TVF CUTOFF CONTROL ($00〜$7F:−9600〜＋9600[CENT]) ary(55):MOD AMPLITUDE CONTROL ($00〜$7F:−100.0〜＋100.0[%]) ary(56):MOD LFO1 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(57):MOD LFO1 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(58):MOD LFO1 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(59):MOD LFO1 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(60):MOD LFO2 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(61):MOD LFO2 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(62):MOD LFO2 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(63):MOD LFO2 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(64):BEND PITCH CONTROL ($28〜$58:−24〜＋24[semitone]) ary(65):BEND TVF CUTOFF CONTROL ($00〜$7F:−9600〜＋9600[CENT]) ary(66):BEND AMPLITUDE CONTROL ($00〜$7F:−100.0〜＋100.0[%]) ary(67):BEND LFO1 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(68):BEND LFO1 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(69):BEND LFO1 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(70):BEND LFO1 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(71):BEND LFO2 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(72):BEND LFO2 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(73):BEND LFO2 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(74):BEND LFO2 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(75):CAf PITCH CONTROL ($28〜$58:−24〜＋24[semitone]) ary(76):CAf TVF CUTOFF CONTROL ($00〜$7F:−9600〜＋9600[CENT]) ary(77):CAf AMPLITUDE CONTROL ($00〜$7F:−100.0〜＋100.0[%]) ary(78):CAf LFO1 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(79):CAf LFO1 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(80):CAf LFO1 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(81):CAf LFO1 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(82):CAf LFO2 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(83):CAf LFO2 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(84):CAf LFO2 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(85):CAf LFO2 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(86):PAf PITCH CONTROL ($28〜$58:−24〜＋24[semitone]) ary(87):PAf TVF CUTOFF CONTROL ($00〜$7F:−9600〜＋9600[CENT]) ary(88):PAf AMPLITUDE CONTROL ($00〜$7F:−100.0〜＋100.0[%]) ary(89):PAf LFO1 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(90):PAf LFO1 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(91):PAf LFO1 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(92):PAf LFO1 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(93):PAf LFO2 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(94):PAf LFO2 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(95):PAf LFO2 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(96):PAf LFO2 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(97):CC1 PITCH CONTROL ($28〜$58:−24〜＋24[semitone]) ary(98):CC1 TVF CUTOFF CONTROL ($00〜$7F:−9600〜＋9600[CENT]) ary(99):CC1 AMPLITUDE CONTROL ($00〜$7F:−100.0〜＋100.0[%]) ary(100):CC1 LFO1 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(101):CC1 LFO1 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(102):CC1 LFO1 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(103):CC1 LFO1 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(104):CC1 LFO2 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(105):CC1 LFO2 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(106):CC1 LFO2 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(107):CC1 LFO2 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(108):CC2 PITCH CONTROL ($28〜$58:−24〜＋24[semitone]) ary(109):CC2 TVF CUTOFF CONTROL ($00〜$7F:−9600〜＋9600[CENT]) ary(110):CC2 AMPLITUDE CONTROL ($00〜$7F:−100.0〜＋100.0[%]) ary(111):CC2 LFO1 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(112):CC2 LFO1 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(113):CC2 LFO1 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(114):CC2 LFO1 TVA DEPTH ($00〜$7F:0〜100.0[%]) ary(115):CC2 LFO2 RATE CONTROL ($00〜$7F:−10.0〜＋10.0[Hz]) ary(116):CC2 LFO2 PITCH DEPTH ($00〜$7F:0〜600[cent]) ary(117):CC2 LFO2 TVF DEPTH ($00〜$7F:0〜2400[cent]) ary(118):CC2 LFO2 TVA DEPTH ($00〜$7F:0〜100.0[%]) (SC55のマニュアルP75,P79〜P80参照) -------------------------------------------------------------------------------- 関数名 sc55_drum_setup(mp,nt,ary,id) 機能 ＳＣ５５のドラムパラメータ設定 引数 mp＝マップナンバー(char:0〜1) nt＝ノート番号(char:0〜127) ary＝ドラムパラメータ(dim char ary(7)＝{dr1,…,dr8}) id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は7以内で配列の内容全部がＳＣ５５へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):PLAY KEY NUMBER (0〜127) ary(1):LEVEL (0〜127) ary(2):ASSIGN GROUP NUMBER (0:NON,1〜127) ary(3):PANPOT (0:RANDOM,01(LEFT)〜64〜127(RIGHT)) ary(4):REVERB DEPTH (0〜127:0.0〜1.0) ary(5):CHORUS DEPTH (0〜127:0.0〜1.0) ary(6):Rx NOTE OFF (0〜1:OFF/ON) ary(7):Rx NOTE ON (0〜1:OFF/ON) (SC55マニュアルp75,p82参照) -------------------------------------------------------------------------------- 関数名 sc55_print(ms,id) 機能 ＳＣ５５のディスプレイに文字列を表示する 引数 ms＝文字列(str:32文字以内) id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 -------------------------------------------------------------------------------- 関数名 sc55_display(ary,id) 機能 ＳＣ５５のディスプレイにドットパターン(16×16)を表示する 引数 ary＝ドットパターンデータ(dim int a(15)＝{dt1,…,dt16}) id＝ＳＣ５５のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、int型で添え字は必ず15でなければならない。 IDは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 例 　　 5 /*SC55の画面に"善"を表示する 　　 10 dim int d(a5)={ %0001000000010000, 　　 20 %0000100000100000, 　　 30 %0111111111111100, 40 %0000000100000000, 50 %0011111111111000, 60 %0000000100000000, 70 %0111111111111100, 80 %0001000100010000, 90 %0000100100100000, 100 %1111111111111110, 110 %0000000000000000, 120 %0011111111111000, 130 %0010000000001000, 140 %0010000000001000, 150 %0011111111111000, 160 %0010000000001000} 170 sc55_display(d,&h10) -------------------------------------------------------------------------------- ●ＭＴ３２／ＣＭ３２Ｌ／（ＣＭ６４／ＣＭ５００のＬＡパート）専用命令 パラメータの意味などは楽器のマニュアルを参照のこと -------------------------------------------------------------------------------- 関数名 mt32_init(id) 機能 ＭＴ３２の初期化を行なう 引数 id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 注意 ＭＴ３２用の命令はＣＭ３２Ｌ/ＣＭ６４/ＣＭ５００にも使用できる。以下同様。 -------------------------------------------------------------------------------- 関数名 mt32_p_reserve(ary,id) 機能 ＭＴ３２のパーシャルリザーブを行う 引数 ary＝各パートのパーシャルリザーブ値(dim char ary(8)＝{pr1,…,pr9}) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず8でなければならない。 9番目のデータ(添え字で8番目)はリズムパートに相当する。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 -------------------------------------------------------------------------------- 関数名 mt32_reverb(ary,id) 機能 ＭＴ３２のリバーブパラメータの設定 引数 ary＝リバーブパラメータ(dim char ary(2)＝{pr1,pr2,pr3}) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は2以内で配列の内容全部がＭＴ３２へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):REVERB MODE (0:Room,1:Hall,2:Plate,3:Tap Delay) ary(1):REVERB TIME (0〜7) ary(2):REVERB LEVEL (0〜7) (MT32マニュアルp35,CM64マニュアルp30参照) -------------------------------------------------------------------------------- 関数名 mt32_part_setup(ary,id) 機能 ＭＴ３２の各パートのＭＩＤＩチャンネルの設定 引数 ary＝各パートのＭＩＤＩチャンネル値(1〜16,17:OFF) (dim char ary(8)＝{pr1,…,pr9}) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は8以内で配列の内容全部がＭＴ３２へ送信される。 9番目のデータ(添え字で8番目)はリズムパートに相当する。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 -------------------------------------------------------------------------------- 関数名 mt32_drum_setup(nt,ary,id) 機能 ＭＴ３２のリズムパートの設定 引数 nt＝設定を変更するリズムノートナンバー(char:24〜87) ary＝リズムパートのセットアップパラメータ(dim char ary(3)＝{pr1,…,pr4}) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は3以内で配列の内容全部がＭＴ３２へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):TIMBRE (0〜63:i1〜64,64〜127:r1〜64) ary(1):OUTPUT LEVEL (0〜100) ary(2):PANPOT (0〜14) ary(3):REVERB SWITCH (0〜1:OFF/ON) (MT32マニュアルp35,CM64マニュアルp30参照) -------------------------------------------------------------------------------- 関数名 mt32_common(tm,nm,ary,id) 機能 ＭＴ３２のティンバーコモンパラメータの設定 引数 tm＝ティンバーの番号(char:1〜64) nm＝ティンバーの名前(str:１０文字以内) ary＝コモンパラメータ(dim char ary(3)＝{pr1,…,pr4}) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は3以内で配列の内容全部がＭＴ３２へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Structure of Partial#1&2 (0〜12:1〜13) ary(1):Structure of Partial#3&4 (0〜12:1〜13) ary(2):PARTIAL MUTE (0〜15) ary(3):ENV MODE (0〜1:NORMAL,NO SUSTAIN) (MT32マニュアルp34,CM64マニュアルp29参照) -------------------------------------------------------------------------------- 関数名 mt32_patch(pt,ary,id) 機能 ＭＴ３２のパッチパラメータの設定 引数 pt＝パッチ(program)番号(char:1〜128) ary＝パッチパラメータ(dim char ary(6)＝{pr1,…,pr7}) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は6以内で配列の内容全部がＭＴ３２へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):TIMBRE GROUP (0〜3:a,b,i,r) ary(1):TIMBRE NUMBER (0〜63) ary(2):KEY SHIFT (0〜48:−24〜＋24) ary(3):FINE TUNE (0〜100:−50〜＋50) ary(4):BENDER RANGE (0〜24) ary(5):ASSIGN MODE (0〜3:POLY1〜4) ary(6):REVERB SWITCH (0〜1:OFF/ON) 　　　　(MT32マニュアルp35,CM64マニュアルp30参照) -------------------------------------------------------------------------------- 関数名 mt32_partial(tm,pt,ary,id) 機能 ＭＴ３２の音色のパーシャル・パラメータの設定 引数 tm＝ティンバーの番号(char:1〜64) pt＝パーシャル番号(char:1〜4) ary＝パッチパラメータ(dim char ary(57)＝{pr1,…,pr58}) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は57以内で配列の内容全部がＭＴ３２へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):WG PITCH COARSE (0〜96:C1,C#1,〜,C9) ary(1):WG PITCH FINE (0〜100:−50〜＋50) ary(2):WG PITCH KEYFOLLOW (0〜16:−1,−1/2,−1/4,0,1/8,1/4, 3/8,1/2,5/8,3/4,7/8,1, 5/4,3/2,2,s1,s2) ary(3):WG PITCH BENDER SW (0〜1:OFF/ON) ary(4):WG WAVEFORM/PCM BANK (0〜3:SQU1,SAW1,SQU2,SAW2) ary(5):WG PCM WAVE (0〜127:1〜128) ary(6):WG PULSE WIDTH (0〜100) ary(7):WG PW VELO SENS (0〜14:−7〜＋7) ary(8):P-ENV DEPTH (0〜10) ary(9):P-ENV VELO SENS (0〜3) ary(10):P-ENV TIME KEYF (0〜4) ary(11):P-ENV TIME 1 (0〜100) ary(12):P-ENV TIME 2 (0〜100) ary(13):P-ENV TIME 3 (0〜100) ary(14):P-ENV TIME 4 (0〜100) ary(15):P-ENV LEVEL 0 (0〜100:−50〜＋50) ary(16):P-ENV LEVEL 1 (0〜100:−50〜＋50)) ary(17):P-ENV LEVEL 2 (0〜100:−50〜＋50) ary(18):P-ENV SUSTAIN LEVEL (0〜100:−50〜＋50) ary(19):END LEVEL (0〜100:−50〜＋50) ary(20):P-LFO RATE (0〜100) ary(21):P-LFO DEPTH (0〜100) ary(22):P-LFO MOD SENS (0〜100) ary(23):TVF CUTOFF FREQ (0〜100) ary(24):TVF RESONANCE (0〜30) ary(25):TVF KEYFOLLOW (0〜14:−1,−1/2,−1/4,0,1/8,1/4, 3/8,1/2,5/8,3/4,7/8,1, 5/4,3/2,2) ary(26):TVF BIAS POINT/DIR (0〜127) ary(27):TVF BIAS LEVEL (0〜14:−7〜＋7) ary(28):TVF ENV DEPTH (0〜100) ary(29):TVF ENV VELO SENS (0〜100) ary(30):TVF ENV DEPTH KEYF (0〜4) ary(31):TVF ENV TIME KEYF (0〜4) ary(32):TVF ENV TIME 1 (0〜100) ary(33):TVF ENV TIME 2 (0〜100) ary(34):TVF ENV TIME 3 (0〜100) ary(35):TVF ENV TIME 4 (0〜100) ary(36):TVF ENV TIME 5 (0〜100) ary(37):TVF ENV LEVEL 1 (0〜100) ary(38):TVF ENV LEVEL 2 (0〜100) ary(39):TVF ENV LEVEL 3 (0〜100) ary(40):TVF ENV SUSTAIN LEVEL (0〜100) ary(41):TVA LEVEL (0〜100) ary(42):TVA VELO SENS (0〜100:−50〜＋50 ary(43):TVA BIAS POINT 1 (0〜127) ary(44):TVA BIAS LEVEL 1 (0〜12:−12〜0) ary(45):TVA BIAS POINT 2 (0〜127) ary(46):TVA BIAS LEVEL 2 (0〜12:−12〜0) ary(47):TVA ENV TIME KEYF (0〜4) ary(48):TVA ENV TIME V_FOLLOW (0〜4) ary(49):TVA ENV TIME 1 (0〜100) ary(50):TVA ENV TIME 2 (0〜100) ary(51):TVA ENV TIME 3 (0〜100) ary(52):TVA ENV TIME 4 (0〜100) ary(53):TVA ENV TIME 5 (0〜100) ary(54):TVA ENV LEVEL 1 (0〜100) ary(55):TVA ENV LEVEL 2 (0〜100) ary(56):TVA ENV LEVEL 3 (0〜100) ary(57):TVA ENV SUSTAIN LEVEL (0〜100) (MT32マニュアルp34,CM64マニュアルp29参照) -------------------------------------------------------------------------------- 関数名 mt32_print(ms,id) 機能 ＭＴ３２のコンソールに文字列を表示する 引数 ms＝文字列(str:20文字以内) id＝ＭＴ３２のデバイスＩＤ(char) 戻り値 なし 備考 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 -------------------------------------------------------------------------------- ●Ｕ２２０／Ｕ２０専用命令 パラメータの意味などは楽器のマニュアルを参照のこと -------------------------------------------------------------------------------- 関数名 u220_setup(ary,id) 機能 Ｕ２２０のセットアップパラメータの設定 引数 ary＝パラメータ(dim char ary(6)＝{pr1,…,pr7}) id＝Ｕ２２０のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず6でなければならない。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Chorus SW (0〜1:OFF/ON) ary(1):Reverb SW (0〜1:OFF/ON) ary(2):Rx Cntrl Channel (1〜17:1〜16,OFF) ary(3):Patch Change (0〜5:MAP1〜MAP4,Dir,OFF) ary(4):Timbre Change (0〜5:MAP1〜MAP4,Dir,OFF) ary(5):Rhythm Change (0〜5:MAP1〜MAP4,Dir,OFF) ary(6):R.Inst Assign (0〜5:MAP1〜MAP4,Dir,OFF) 　　　 (U220マニュアルp46,p146〜148参照) 注意 Ｕ２２０用の命令はＵ２０に対しても使用できる。以下同様。 -------------------------------------------------------------------------------- 関数名 u220_part_setup(pt,ary,id) 機能 Ｕ２２０のテンポラリ・パート・セットアップパラメータの設定 引数 pt＝パート番号(char:1〜6) ary＝パラメータ(dim char ary(12)＝{pr1,…,pr13}) id＝Ｕ２２０のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず12でなければならない。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Timbre Number (1〜128) ary(1):Voice Reserve (0〜30) ary(2):Receive Channel (1〜17:1〜16,OFF) ary(3):Key Range Low (0〜127:C-1〜G9) ary(4):Key Range High (0〜127:C-1〜G9) ary(5):Velo Level (0〜1:Above/Below) ary(6):Velo Threshold (0〜127) ary(7):Output Assign (0〜4:Dry,Rev,Cho,Dir1,Dir2) ary(8):Level (0〜127) ary(9):Pan (0〜15:L7〜M〜R7) ary(10):Rx Volume (0〜1:OFF/ON) ary(11):Rx Pan (0〜1:OFF/ON) ary(12):Rx Hold (0〜1:OFF/ON) (U220マニュアルp58,p149参照) -------------------------------------------------------------------------------- 関数名 u220_common(ary,id) 機能 Ｕ２２０のテンポラリパッチ・コモンパラメータの設定 引数 ary＝パラメータ(dim char ary(17)＝{pr1,…,pr18}) id＝Ｕ２２０のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず17でなければならない。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Chorus Type (0〜4:Chorus1,Chorus2,FB-Chorus, Flanger,Short Delay) ary(1):Chorus Out Mode (0〜1:Pre Rev,Post Rev) ary(2):Chorus Level (0〜31) ary(3):Chorus Delay (0〜31) ary(4):Chorus Rate (0〜31) ary(5):Chorus Depth (0〜31) ary(6):Chorus Feedback (1〜63:−31〜0〜＋31) ary(7):Reverb Type (0〜7:Room1〜3,Hall1〜2,Gate Delay,CrossDelay) ary(8):Reverb Time (0〜31) ary(9):Reverb Level (0〜31) ary(10):Reverb Delay Feedback (0〜31) ary(11):Reverb Pre Delay Feedback (0〜31) ary(12):Param1 # (0〜63:0〜5,7〜31,64〜95,OFF) ary(13):Param1 Param (0:Timbre Level,1:Env Attack 2:Env Decay,3:Env Sustain 4:Env Release,5:A.Bend Depth 6:A.Bend Rate,7:Detune Depth 8:Vib Rate,9:Vib Wave Form 10:Vib Depth,11:Vib Delay 12:Vib Rise Time,13:Vib Mod Depth 14:Chorus Level,15:Chorus Rate 16:Chorus Feedback,17:Reverb Level 18:Delay Feedback) ary(14):Param2 # (Same as Param1 #) ary(15):Param2 Param (Same as Param1 Param) ary(16):Param3 # (Same as Param1 #) ary(17):Param3 Param (Same as Param1 Param) (U220マニュアルp54,p149参照) -------------------------------------------------------------------------------- 関数名 u220_timbre(tm,name,ary,id) 機能 Ｕ２２０のティンバーパラメータの設定 引数 tm＝ティンバー番号(char:1〜128) name＝ティンバーの名前(str:12文字以内) ary＝パラメータ(dim char ary(25)＝{pr1,…,pr26}) id＝Ｕ２２０のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず25でなければならない。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Tone Media (0〜31:I,1〜31) ary(1):Tone Number (1〜128) ary(2):Timbre Level (0〜127) ary(3):Velocity Sens (1〜15:−7〜＋7) ary(4):Channel Press Sens (1〜15:−7〜＋7) ary(5):Env Attack Rate (1〜15:−7〜＋7) ary(6):Env Decay Rate (1〜15:−7〜＋7) ary(7):Env Sustain Level (1〜15:−7〜＋7) ary(8):Env Release Rate (1〜15:−7〜＋7) ary(9):Pitch Shift Coarse (8〜56:−24〜＋24) ary(10):Pitch Shift Fine (14〜114:−50〜＋50) ary(11):Bend Range Lower (0〜15:−36,−24,−12〜0) ary(12):Bend Range Upper (0〜12) ary(13):Channel After Sens (0〜27:−36,−24,−12〜＋12) ary(14):Poly After Sens (0〜27:−36,−24,−12〜＋12) ary(15):Auto Bend Depth (0〜27:−36,−24,−12〜＋12) ary(16):Auto Bend Rate (0〜15) ary(17):Detune Depth (0〜15) ary(18):Rate (0〜63) ary(19):Waveform (0〜8) ary(20):Depth (0〜15) ary(21):Delay (0〜15) ary(22):Rise Time (0〜15) ary(23):Modulation Depth (0〜15) ary(24):Ch After Sens (0〜15) ary(25):Poly After Sens (0〜15) (U220マニュアルp65,p149参照) -------------------------------------------------------------------------------- 関数名 u220_drum_setup(ary,id) 機能 Ｕ２２０のテンポラリ・ドラム・セットアップパラメータの設定 引数 ary＝パラメータ(dim char ary(6)＝{pr1,…,pr7}) id＝Ｕ２２０のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず6でなければならない。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Rhythm Setup # (0〜3:1〜4) ary(1):Voice Reserve (0〜30) ary(2):Receive Channel (1〜17:1〜16,OFF) ary(3):Level (0〜127) ary(4):Level Boost Sw (0〜1:OFF/ON) ary(5):Rx Volume (0〜1:OFF/ON) ary(6):Rx Hold (0〜1:OFF/ON) (U220マニュアルp63,p149参照) -------------------------------------------------------------------------------- 関数名 u220_drum_inst(nt,ary,id) 機能 Ｕ２２０のドラムインストパラメータの設定 引数 nt＝ノートナンバー(char:35〜99) ary＝パラメータ(dim char ary(19)＝{pr1,…,pr20}) id＝Ｕ２２０のデバイスＩＤ(char) 戻り値 なし 備考 配列は必ず１次元、添え字は19以内で配列の内容全部がＵ２２０へ送信される。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 ary(0):Tone Media (0〜31:I,1〜31) ary(1):Tone Number (0〜127:1〜128) ary(2):Source Key (0〜127:C−1〜G9) ary(3):Mute Inst (34〜98:OFF,B1〜D7) ary(4):Inst Level (0〜31) ary(5):Velocity Sens (0〜15) ary(6):Env Mode (0〜1:Sustain,No Sustain) ary(7):Env Attack Rate (1〜15:−7〜＋7) ary(8):Env Decay Rate (1〜15:−7〜＋7) ary(9):Env Release Rate (1〜15:−7〜＋7) ary(10):Pitch Shift Coarse (0〜27:−36,−24,−12〜＋12) ary(11):Pitch Shift Fine (14〜114:−50〜＋50) ary(12):Channel After Sens (0〜27:−36,−24,−12〜＋12) ary(13):Poly After Sens (0〜27:−36,−24,−12〜＋12) ary(14):Random (0〜15) ary(15):Auto Bend Depth (0〜27:−36,−24,−12〜＋12) ary(16):Auto Bend Rate (0〜15) ary(17):Detune Depth (0〜15) ary(18):Output Assign (0〜3:Dry,Rev,Cho,Dir1) ary(19):Pan (0〜15:L7〜M〜R7) (U220マニュアルp72,p149) -------------------------------------------------------------------------------- 関数名 u220_print(ms,id) 機能 Ｕ２２０のコンソールに文字列を表示する 引数 ms＝文字列(str:12文字以内) id＝Ｕ２２０のデバイスＩＤ(char) 戻り値 なし 備考 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 -------------------------------------------------------------------------------- ●Ｍ１／Ｍ１ＥＸ／Ｍ１Ｒ／Ｍ１ＲＥＸ専用命令 パラメータの意味などは楽器のマニュアルを参照のこと -------------------------------------------------------------------------------- 関数名 m1_midi_ch(ary) (注2) 機能 Ｍ１のシーケンサのＳＯＮＧ０の各トラックのＭＩＤＩチャンネルを設定する 引数 ary＝各パートのチャンネル値(1〜16,17:OFF) (dim char ary(7)＝{ch1,…,ch8}) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず7でなければならない。 注意 Ｍ１用の命令はＭ１ＥＸ/Ｍ１Ｒ/Ｍ１ＲＥＸに対しても使用できる。以下同様。 -------------------------------------------------------------------------------- 関数名 m1_part_setup(ary) (注2) 機能 Ｍ１のシーケンサのＳＯＮＧ０の各トラックのパラメータを設定する 引数 ary＝各パートのパラメータ(dim char ary(39)＝{pr1,…,pr40}) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず39でなければならない。 TRACK 1 ary(0):PROGRAM NUMBER (0〜199:I00〜C99) ary(1):OUTPUT LEVEL (0〜99) ary(2):KEY TRANSPOSE ($F4〜$0C:−12〜12) ary(3):DETUNE ($CE〜$32:−50〜＋50) ary(4):PAN (0〜13:10:0〜0:10,C,C+D,D) TRACK 2〜8 以下同様 　　　　(M1マニュアルp126参照) -------------------------------------------------------------------------------- 関数名 m1_effect_setup(ary) (注2) 機能 Ｍ１のシーケンサのＳＯＮＧ０のエフェクトパラメータを設定する 引数 ary＝エフェクトパラメータ(dim char ary(24)＝{pr1,…,pr25}) 戻り値 なし 備考 配列は必ず１次元、char型で添え字は必ず24でなければならない。 ary(0):Effect 1 Pattern No. (0〜33:1〜32,Thru) ary(1):Effect 2 Pattern No. (0〜33:1〜32,Thru) ary(2):Effect 1 L-Ch E.Balnc (0〜100) ary(3):Effect 1 R-Ch E.Balnc (0〜100) ary(4):Effect 2 L-Ch E.Balnc (0〜100) ary(5):Effect 2 R-Ch E.Balnc (0〜100) ary(6):Output 3 Pan (0〜101:OFF,100:0〜0:100) ary(7):Output 4 Pan (0〜101:OFF,100:0〜0:100) ary(8):Effect I/O (BIT0:Effect 1 L-Ch 0＝OFF/1＝ON BIT1:Effect 1 R-Ch 0＝OFF/1＝ON BIT2:Effect 2 L-Ch 0＝OFF/1＝ON BIT3:Effect 2 R-Ch 0＝OFF/1＝ON) BIT4:Effect 2 0＝PARALLEL/1＝SERIAL) ary(9〜16):Effect 1 Parameter ary(17〜24):Effect 2 Parameter Ｓｔｒｕｃｔｕｒｅ ｏｆ Ｅｆｆｅｃｔ Ｐａｒａｍｅｔｅｒ (ofs＝9 or 17) 1〜3:Hall (4,5:Room,6:Live Stage) ary(ofs+0):Reverb Time (0〜97:0.2〜9.9),(0〜48:0.2〜5.0) ary(ofs+1):Dummy 0 ary(ofs+2):High Damp (0〜99) ary(ofs+3):Pre Delay (0〜200) ary(ofs+4):E/R Level (0〜99) ary(ofs+5):Dummy 0 ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 7〜9:Early Reflection 1,2,3 ary(ofs+0):E/R Time (0〜70:100〜800) ary(ofs+1):Pre Delay (0〜200) ary(ofs+2):Dummy 0 : : ary(ofs+5):Dummy 0 ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 10:Stereo Delayt,11:Cross Delay ary(ofs+0):Delay Time L (L) (0〜500) ary(ofs+1):Delay Time L (H) ary(ofs+2):Feedback ($9D〜$63:−99〜99) ary(ofs+3):High Damp (0〜99) ary(ofs+4):Delay Time R (L) (0〜500) ary(ofs+5):Delay Time R (H) ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 12〜13:Stereo Chorus 1〜2 (14〜15:Flanger) ary(ofs+0):Depth (0〜99) ary(ofs+1):Speed (0〜99:0.03〜3.00 0.03step 100〜199:3.1〜13.0 0.1step 200〜216:14.0〜30.0 1.0step) ary(ofs+2):LFO Status (BIT0:Waveform ＝0:Sin,＝1:Tri BIT1:Phase ＝0:0.0ﾟ,＝1:180ﾟ BIT2:Wave Shape ＝0:Normal ＝1:for Flanger) ary(ofs+3):Feedback ($9D〜$63:−99〜＋99) ary(ofs+4):Delay Time (0〜200),(0〜50) ary(ofs+5):Dummy 0 ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 16〜17:Phase Shifter 1〜2 ary(ofs+0):Depth (0〜99) ary(ofs+1):Speed (0〜99:0.03〜3.00 0.03step 100〜199:3.1〜13.0 0.1step 200〜216:14.0〜30.0 1.0step) ary(ofs+2):LFO Status (BIT0:Waveform ＝0:Sin,＝1:Tri BIT1:Phase ＝0:0.0ﾟ,＝1:180ﾟ BIT2:Wave Shape ＝0:Normal ＝1:for Flanger) ary(ofs+3):Feedback ($9D〜$63:−99〜＋99) ary(ofs+4):Manual (0〜99) ary(ofs+5):Dummy 0 ary(ofs+6):Dummy 0 ary(ofs+7):Dummy 0 18〜19:Stereo Toremolo 1〜2 ary(ofs+0):Depth (0〜99) ary(ofs+1):Speed (0〜99:0.03〜3.00 0.03step 100〜199:3.1〜13.0 0.1step 200〜216:14.0〜30.0 1.0step) ary(ofs+2):LFO Status (BIT0:Waveform ＝0:Sin,＝1:Tri BIT1:Phase ＝0:0.0ﾟ,＝1:180ﾟ BIT2:Wave Shape ＝0:Normal ＝1:for Flanger) ary(ofs+3):Shape ($9D〜$63:−99〜＋99) ary(ofs+4):Dummy 0 ary(ofs+5):Dummy 0 ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 20:Equalizer ary(ofs+0):Dummy 0 : : ary(ofs+3):Dummy 0 ary(ofs+4):Low fc (0〜2:0.25k,0.50k,1.00k) ary(ofs+5):High fc (0〜2:1k,2k,4k) ary(ofs+6):High Gain ($F4〜$0C:−12〜＋12) ary(ofs+7):Low Gain ($F4〜$0C:−12〜＋12) 21:Overdrive ary(ofs+0):Dummy 0 ary(ofs+1):Dummy 0 ary(ofs+2):Drive (0〜99) ary(ofs+3):Level (0〜99) ary(ofs+4):Dummy 0 ary(ofs+5):Dummy 0 ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 22:Distortion ary(ofs+0):Dummy 0 ary(ofs+1):Dummy 0 ary(ofs+2):Distortion (0〜99) ary(ofs+3):Level (0〜99) ary(ofs+4):Dummy 0 ary(ofs+5):Dummy 0 ary(ofs+6):Dummy 0 ary(ofs+7):EQ Low Gain ($F4〜$0C:−12〜＋12) 23:Exciter ary(ofs+0):Blend ($9D〜$63:−99〜＋99) ary(ofs+1):Emphatic Point (0〜9:1〜10) ary(ofs+2):Dummy 0 : : ary(ofs+5):Dummy 0 ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 24:Synphonic Ensamble ary(ofs+0):Depth (0〜99) ary(ofs+1):Dummy 0 : : ary(ofs+5):Dummy 0 ary(ofs+6):EQ High ($F4〜$0C:−12〜＋12) ary(ofs+7):EQ Low ($F4〜$0C:−12〜＋12) 25:Rotary Speaker ary(ofs+0):Depth (0〜99) ary(ofs+1):Dummy 0 ary(ofs+2):Speed Rate ($F6〜$0A:−10〜＋10) ary(ofs+3):Dummy 0 : : ary(ofs+7):Dummy 0 26:Delay/Hall ary(ofs+0):Delay Time (L) (0〜500) ary(ofs+1):Delay Time (H) ary(ofs+2):Feedback ($9D〜$63:−99〜99) ary(ofs+3):High Damp (0〜99) ary(ofs+4):Reverb Time (0〜97:0.2〜9.9) ary(ofs+5):Dummy 0 ary(ofs+6):High Damp (0〜99) ary(ofs+7):Pre Delay (0〜150) 27:Delay/Room ary(ofs+0):Delay Time (L) (0〜500) ary(ofs+1):Delay Time (H) ary(ofs+2):Feedback ($9D〜$63:−99〜99) ary(ofs+3):High Damp (0〜99) ary(ofs+4):Reverb Time (0〜97:0.2〜9.9) ary(ofs+5):Dummy 0 ary(ofs+6):High Damp (0〜99) ary(ofs+7):Pre Delay (0〜150) 28:Delay/Early Reflection ary(ofs+0):Delay Time (L) (0〜500) ary(ofs+1):Delay Time (H) ary(ofs+2):Feedback ($9D〜$63:−99〜99) ary(ofs+3):High Damp (0〜99) ary(ofs+4):E/R Time (0〜30:100〜400) ary(ofs+5):Pre Delay (0〜150) ary(ofs+6):Dummy 0 ary(ofs+7):Dummy 0 29:Delay/Chorus ary(ofs+0):Delay Time L (L) (0〜500) ary(ofs+1):Delay Time L (H) ary(ofs+2):Feedback L ($9D〜$63:−99〜99) ary(ofs+3):High Damp L (0〜99) ary(ofs+4):Delay Time R (L) (0〜500) ary(ofs+5):Delay Time R (H) ary(ofs+6):Feedback R ($9D〜$63:−99〜99) ary(ofs+7):High Damp R (0〜99) 30:Delay/Chorus (31:Delay Flanger) ary(ofs+0):Delay Time (L) (0〜500) ary(ofs+1):Delay Time (H) ary(ofs+2):Feedback ($9D〜$63:−99〜99) ary(ofs+3):High Damp (0〜99) ary(ofs+4):Depth (0〜99) ary(ofs+5):Speed (0〜99:0.03〜3.00 0.03step 100〜199:3.1〜13.0 0.1step 200〜216:14.0〜30.0 1.0step) ary(ofs+6):LFO Status (BIT0:Waveform ＝0:Sin,＝1:Tri BIT1:Phase ＝0:0.0ﾟ,＝1:180ﾟ BIT2:Wave Shape ＝0:Normal ＝1:for Flanger) ary(ofs+7):Feedback 0,($9D〜$63:−99〜99) 32:Delay/Phaser ary(ofs+0):Delay Time (L) (0〜500) ary(ofs+1):Delay Time (H) ary(ofs+2):Feedback ($9D〜$63:−99〜99) ary(ofs+3):High Damp (0〜99) ary(ofs+4):Depth (0〜99) ary(ofs+5):Speed (0〜99:0.03〜3.00 0.03step ary(ofs+6):Feedback ($9D〜$63:−99〜99) ary(ofs+7):Dummy 0 33:Delay/Tremolo ary(ofs+0):Delay Time (L) (0〜500) ary(ofs+1):Delay Time (H) ary(ofs+2):Feedback ($9D〜$63:−99〜99) ary(ofs+3):High Damp (0〜99) ary(ofs+4):Depth (0〜99) ary(ofs+5):Speed (0〜99:0.03〜3.00 0.03step ary(ofs+6):Dummy 0 ary(ofs+7):Shape ($9D〜$63:−99〜99) (M1マニュアルp127参照) -------------------------------------------------------------------------------- 関数名 m1_print(ms) (注2) 機能 Ｍ１のシーケンサのＳＯＮＧ０の名前を設定する 引数 ms＝文字列(str:10文字以内) 戻り値 なし -------------------------------------------------------------------------------- 関数名 send_to_m1(id) (注2) 機能 'm1_midi_ch()'〜'm1_print()'までの設定値をＭ１へ送信する 引数 id＝ＭＩＤＩのデバイスＩＤ値(char:&h30〜&h3f) 戻り値 なし 備考 デバイスＩＤ＝&H30＋(グローバルチャンネル−1) グローバルチャンネルとはGLOBALモードのF5−1で設定出来る。 ＩＤは省略可能。省略すると以前設定したものが選択される。最初の使用時に 省略した場合はドライバ内のデフォルト値が選択される。 必ず'm1_midi_ch()'〜'm1_print()'を設定してからこの命令を実行すること。 'm1_effect_setup'のみ省略が可能。この時はドライバのデフォルトデータが 送信される。 'm1_midi_ch()'〜'm1_print()'の間にＭ１関係以外のコマンドがあると正常なデータが 送信されないので注意すること。 例 10 dim char a(7)＝{2,1,4,3,6,5,8,7} 20 m1_midi_ch(a) 25 /*音色,音量,ｷｰﾄﾗﾝｽﾎﾟｰｽﾞ,ﾃﾞﾁｭｰﾝ,ﾊﾟﾝのﾌｫｰﾏｯﾄ 30 dim char b(39)={ 0,99,0,0,5, /*TRACK 1 40 0,99,0,0,5, /*TRACK 2 50 0,99,0,0,5, /*TRACK 3 60 0,99,0,0,5, /*TRACK 4 70 0,99,0,0,5, /*TRACK 5 80 0,99,0,0,5, /*TRACK 6 90 0,99,0,0,5, /*TRACK 7 100 0,99,0,0,5} /*TRACK 8 110 m1_part_setup(b) 120 dim char c(24)={&H21,&H21} 130 m1_effect_setup(c) 140 m1_print("Zenji.N") 150 send_to_m1(&H30) -------------------------------------------------------------------------------- ●その他 -------------------------------------------------------------------------------- 関数名 m_wave_form(wv,lt,lp,ary) 機能 波形メモリの登録 引数 wv＝登録先波形番号(char:8〜31) lt＝ループタイプ(char:0〜2) lp＝ループポイント(int:0〜65535) ary＝波形データ(dim int ary(0〜65535)＝{.....}) 戻り値 なし 備考 波形番号8〜31に登録できる(波形番号0〜7はプリセット波形などが 設定されておりリザーブ)。 ループタイプとは波形を最後まで処理終えたあと、どうループさせるかを 設定するもの。 0 → ワンショット (波形を一度実行したら最後の値を継続する) 1 →→→→.... リピート (波形の終点までいったならば ループポイントに戻る) 2 →←→←.... オルタニティヴ (波形のループポイントから終点まで 交互に反復する) ループポイントは0〜65535までが有効。これは何番目のデータを ループポイントに設定するかを決めるパラメータで省略すると ループポイントは0、すなわちデータの先頭がループポイントと見なされる。 波形データは符号付き16ビット整数で構成する。 (−32768〜＋32767($8000〜$7fff))データの個数は65535個まで。 それ以上は設定できない。 波形メモリの具体的な使用方法についてはMEASURE5参照。 -------------------------------------------------------------------------------- 関数名 fm_master(v) 機能 ＦＭ音源のトラックのマスターボリューム 引数 v:ボリューム値(char:0最小〜255最大) 戻り値 なし 備考 コンパイル時や中間言語変換時にのみ有効なコマンドなので演奏中に 指定しても無意味。用途としてはＡＤＰＣＭ、ＭＩＤＩ楽器との 最終的な音量バランスを決定するときなど。通常は演奏データよりも先に 書くと良いだろう。'm_init()'でデフォルトとして255が設定される。 増減は線形的でなく指数関数的であるので注意のこと。 -------------------------------------------------------------------------------- 関数名 m_print(ms) 機能 単なる文字表示 引数 ms＝文字列(str:96文字以内) 戻り値 なし -------------------------------------------------------------------------------- 関数名 zmd_play(fn) 機能 コンパイルされたデータの演奏 引数 fn＝ファイル名(str) 戻り値 なし 備考 拡張子を省略した場合は自動的に'.ZMD'を付け足す。 fnがカレントより 見つからない場合は環境変数'zmusic'のパスを参照する。 -------------------------------------------------------------------------------- 関数名 m_pcmplay(nt,pn,fr) 機能 登録してあるノート番号ntのＡＤＰＣＭ音を鳴らす 引数 nt＝ノート番号(int:0〜511) pn＝パンポット(char:0〜3) fr＝再生周波数(char:0〜4) 戻り値 なし 備考 fr: 0＝ 3.9kHz 1＝ 5.2kHz 2＝ 7.8kHz 3＝10.4kHz 4＝15.6kHz 例 m_pcmplay(10,3,4) -------------------------------------------------------------------------------- 関数名 m_switch(sw,fn) 機能 ＺＭＳファイル（ＯＰＭファイル）のジェネレートスイッチ 引数 sw＝スイッチ(char:0＝off,1＝on) fn＝ファイルネーム(str) 戻り値 なし 備考 fnを省略するとデフォルトファイルネームとして 'ZMUSIC.OPM'がカレントに作成される。 なお本命令はステートメントでなくコマンドであるため プログラム中に書くことは出来ない。書いた場合はエラーとなる。 -------------------------------------------------------------------------------- 関数名 zm_ver() 機能 ＺＭＵＳＩＣとＰＣＭ８．Ｘの常駐チェック 引数 なし 戻り値: 上位16ビット＝0 PCM8は常駐していない 上位16ビット＝-1 PCM8が常駐している 下位16ビット＝0 ZMUSICは常駐していない 下位16ビット≠0 ZMUSICが常駐している 備考 ＺＭＵＳＩＣが常駐している場合はそのバージョンＩＤを返す。 上位バイト バージョン整数部, バージョン少数第１桁 下位バイト 対応バージョンコード, バージョン少数第２桁 対応バージョンコード UNIVERSAL VERSION 0 16bit VERSION 1 RS-MIDI VERSION 2 POLYPHON VERSION 3 例 ポリフォン・バージョン１．４９ → バージョンＩＤ＝$1439 -------------------------------------------------------------------------------- 関数名 exec_zms(zms) 機能 ＺＭＳコマンドの実行 引数 zms＝ＺＭＳコマンド文字列(str) 戻り値 なし -------------------------------------------------------------------------------- 関数名 adpcm_to_pcm(adpcm_data_buffer,size,pcm_data_buffer) 機能 ＡＤＰＣＭデータを符号つき１６ビットＰＣＭデータへ変換する 引数 adpcm_data_buffer:入力ＡＤＰＣＭデータ格納バッファ(dim char ary(0〜65535)) size:入力ＡＤＰＣＭデータの個数(int:0〜65535) pcm_data_buffer:出力ＰＣＭデータ格納用バッファ(dim int ary(0〜65535)) 戻り値 なし 備考 出力ＰＣＭデータ格納用配列のサイズは入力ＡＤＰＣＭデータ格納配列のサイズの ２倍は必要。 -------------------------------------------------------------------------------- 関数名 pcm_to_adpcm(pcm_data_buffer,size,adpcm_data_buffer) 機能 符号つき１６ビットＰＣＭデータをＡＤＰＣＭデータへ変換する 引数 pcm_data_buffer:入力ＰＣＭデータ格納バッファ(dim int ary(0〜65535)) size:入力ＰＣＭデータの個数(int:0〜65535) adpcm_data_buffer:出力ＡＤＰＣＭデータ格納用バッファ(dim int ary(0〜65535)) 戻り値 なし 備考 出力ＡＤＰＣＭデータ格納用配列のサイズは入力ＰＣＭデータ格納配列のサイズの 半分以上必要。 -------------------------------------------------------------------------------- （注１）チャンネル番号は'm_ch()'コマンドで対応するデバイスが変動する。 'm_ch()'コマンドの項を参照。 （注２）Ｍ１専用命令は途中でＭ１関係以外の命令が入ると正常なデータが 楽器側へ送信されないので注意。 { -- ZM4.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ ４ ＺＭＳコマンド ここではＣＯＭＭＡＮＤ．Ｘ上から音楽プログラムを書くための書式、 つまりＺＭＳファイル（ＯＰＭファイル）の文法について解説します。 ４．１． ＺＭＳファイルとは ＺＭＵＳＩＣ．ＸではエディタからＭＭＬやコマンドを記述したファイルを 演奏することが出来る。これをＺＭＵＳＩＣシステムでは「ＺＭＳファイル」と 呼ぶ。Ｘ６８ｋ本体に付属している「ＯＰＭＤＲＶ．Ｘ」用の「ＯＰＭファイル」と 概念的には、ほとんど同じである。 ＺＭＳファイルはＥＤ．Ｘなどのスクリーンエディタを使って、ここで解説する 「ＺＭＳコマンド」を記述することによって作成していく。 （ＺＭＳコマンド(Ｔn)以外のトラックに依存しないＺＭＳコマンドを特に 「共通コマンド／コモンコマンド」と呼ぶ）。ＭＵＳＩＣＺ．ＦＮＣに 揃っているコマンドは、ほとんどＺＭＳコマンドで記述することができ、 ＢＡＳＩＣの時と同じ感覚で曲を作ることが出来る。 Ｘ−ＢＡＳＩＣ上で記述した音楽プログラムをＭＵＳＩＣＺ．ＦＮＣの 'm_switch()'コマンドを使用してから実行するとＺＭＳファイルを自動生成する ことが出来る（MEASURE3参照）。ＺＭＳファイル形式はＣＯＭＭＡＮＤ．Ｘ レベルから手軽に演奏出来たり、コンパイルすることも出来て便利なので、 Ｘ−ＢＡＳＩＣで作った曲をＺＭＳファイルにコンバートして管理するのも 良いだろう。 ４．２． コマンド解説を読むにあたって 略しても良いパラメータはその旨を記述してあるがそれ以外は省略不可である。 コマンドは大文字小文字どちらで記述しても構わないが、ここでは説明の都合上 コマンド名を大文字、パラメータを小文字で記述している。 '＊'を付けたものはパラメータを複数行に渡って記述出来る。それ以外の コマンドではその１行で全てのパラメータを記述しなければならない。 ＭＵＳＩＣＺ．ＦＮＣの外部関数命令と対応するものはそのコマンド名を 挙げてある。詳しいパラメータ範囲等はそちらの説明を参照すること。 ４．３． ＺＭＳファイル用コマンド ●初期化 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｉ) 各種音源やＺＭＵＳＩＣ．Ｘ本体の初期化を行う。 通常はＺＭＳの先頭に書く。 ＭＩＤＩ楽器に対して初期化メッセージを送出する （具体的な送信メッセージ内容に関してはMEASURE3のm_init()の項を参照）。 （ZMDデータとしては生成されないコマンド） （MEASURE3 m_init()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｚn) 全音符の絶対音長を設定する。設定範囲は1≦n≦254。 (Ｉ)コマンドでデフォルト値192が自動設定される。通常は設定する必要はない。 ゲーム等のＢＧＭを制作する際、割り込みを軽くする目的で使うと良い。 192, 144, 128, 96といった数値を設定するのが一般的である。 （MEASURE3 m_count()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●トラック確保／チャンネルアサイン −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｍtr,sz) トラックtrにバッファサイズszバイト確保する。1≦tr≦80, 100≦sz≦65535。 例 (m2,3000) トラック２を3000バイト確保する （ZMDデータとしては生成されないコマンド） （MEASURE3 m_alloc()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ａch,tr) チャンネルchをトラックtrへアサインする。1≦ch≦25, 1≦tr≦80。 ＰＣＭ８モード時は26〜32が実用可能。 チャンネル番号はベースチャンネル変更コマンドによって、その対象デバイスが 変動する（(Ｂn)コマンド参照）。 chの部分に規定の文字列を指定することによって(Ｂn)コマンドの影響を 受けずに絶対的に指定することも可能である。 具体的には FM1〜8 ＦＭ音源チャンネル1〜8 MIDI1〜16 ＭＩＤＩチャンネル1〜16 ADPCM ＡＤＰＣＭ音源 ADPCM1〜8 ＰＣＭ８モード時 例 (a1,2) チャンネル１をトラック２へ割り当てる (aFM1,3) ＦＭ音源チャンネル１をトラック３へ割り当てる。 （ZMDデータとしては生成されないコマンド） （MEASURE3 m_assign(),m_assign2()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｂn) ベースチャンネルを設定する。 0＝ＦＭ基準 1＝ＭＩＤＩ基準 n＝0を設定するとチャンネル番号1〜8がＦＭ音源,9がＡＤＰＣＭ,10〜25がＭＩＤＩになる。 n＝1を設定するとチャンネル番号1〜16がＭＩＤＩ,17〜24がＦＭ音源,25がＡＤＰＣＭになる。 ただしＰＣＭ８モードの時は(Ｂn)の値によらずチャンネル番号26〜32が ＡＤＰＣＭチャンネル2〜8に対応する。 （ZMDデータとしては生成されないコマンド） （MEASURE3 m_ch()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●演奏制御 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｐn1,n2,…,ni)または(Ｐ) 演奏を開始する。 n1〜はトラック番号で、1≦ni≦80。全パラメータを省略して (Ｐ)のみでは全トラックの演奏を開始する。 例 (p1,2,3) （ZMDデータ作成時には全く無視されるコマンド） （MEASURE3 m_play()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｓn1,n2,…,ni)または(Ｓ) 演奏を停止する。 n1〜はトラック番号で、1≦ni≦80。全パラメータを省略して (Ｓ)のみでは全トラックの演奏を停止する。 例 (s1,2,3) （ZMDデータ作成時には全く無視されるコマンド） （MEASURE3 m_stop()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｃn1,n2,…,ni)または(Ｃ) 演奏を再開する。 n1〜はトラック番号で、1≦ni≦80。全パラメータを省略して (Ｃ)のみでは全トラックの演奏を再開する。 例 (c1,2,3) （ZMDデータ作成時には全く無視されるコマンド） （MEASURE3 m_cont()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｅch1,ch2,…,chi) 演奏中のチャンネルをリアルタイムにマスク／解除することができる。任意の個数の チャンネル番号を書くことによって指定以外のチャンネルをマスクできる。 チャンネル番号は1≦chi≦25、ただしＰＣＭ８モード時は1≦chi≦32となる。 (Ｂn),'m_ch()'によってチャンネル番号と対象デバイスは変動する点に注意。 後述のＺＰ．Ｒのオプションスイッチ'−Ｅ'と全く同様の機能。 例 (e1,2) チャンネル１,２以外をマスク 必ず(Ｍtr,size),(Ａch,tr),'m_alloc()','m_assign()'以降に書くこと。トラック確保、 チャンネルアサイン前に記述しても意味を持たない。(Ｐ)などの直前に書くのが スタンダードな使い方。 ZP -DとしてＺＰ．Ｒを常駐させたあとに使用できる再演奏機能([SHIFT]＋[XF4])を実行した 時にも影響を与えるので、１つのチャンネルの演奏チェックを何度も行う時には便利。 （ZMDデータとしては生成されないコマンド） （MEASURE3 m_solo()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｆn) 正数でフェードアウト、負数でフェードインを行うことができる。この指定を 行った時点から演奏中の全トラックがフェードイン／アウトし始める。 ただし、１トラックでもすでにフェードイン／アウトしていた場合は無視される。 −85≦n≦−1 フェードイン指定、絶対値が大きいほど音量増加スピードが速い n＝0 フェードイン／アウトの解除 1≦n≦85 フェードアウト指定、絶対値が大きいほど音量の減衰スピードが速い （ZMDデータ作成時には全く無視されるコマンド） （MEASURE3 m_fadeout()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●開発補助 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｄn) [@],[!],[end]コマンドの有効無効化スイッチ。 n＝0で無効、n＝1で有効となる。 コンパイル時のみ有効で演奏中に指定しても無意味。 （ZMDデータとしては生成されないコマンド） （MEASURE3 m_debug()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｑ) 各トラックにセットされたＭＭＬの総ステップタイム数を計算し画面に出力する。 （ZMDデータ作成時には全く無視されるコマンド） （MEASURE3 m_total()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●テンポ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｏn) テンポnを設定する。 設定後、１分間にn個の４分音符を演奏するようになる。20≦n≦300。ただし、 タイマーＡモードの時は77以下は強制的に77となる。 例 (o120) （MEASURE3 m_tempo()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＭＭＬの書き込み −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｔn1,n2,…,n8) ＭＭＬをトラックn1〜n8へ書き込む。１≦ni≦80。n2以降は省略可能。 m_trk(10,"abcde")は(t10)abcdeに相当する。 （MEASURE3 m_trk()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＦＭ音源の音色設定 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｖn,0,v1,v2,…,v55) ＊ ＦＭ音源の音色設定を行う。 nは定義する音色番号で1≦n≦200。 例 (v1,0 / AF OM WF SY SP PMD AMD PMS AMS PAN 60, 15, 2, 0,210, 40, 0, 2, 0, 3, 0 / AR DR SR RR SL OL KS ML DT1 DT2 AME 31, 5, 0, 12, 2, 30, 1, 2, 7, 0, 0 31, 5, 0, 12, 8, 6, 1, 2, 5, 0, 0 31, 5, 0, 12, 8, 28, 1, 2, 3, 0, 0 31, 5, 0, 12, 8, 6, 1, 2, 5, 0, 0) （MEASURE3 m_vset()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (＠n,v1,v2,…,v55) ＊ AL/FB分離形式によるＦＭ音源の音色設定。 nは定義する音色番号で1≦n≦200。 例 / AR DR SR RR SL OL KS ML DT1 DT2 AME (@1, 31, 0, 2, 0, 0, 21, 0, 1, 0, 0, 0 31, 0, 0, 8, 0, 3, 0, 3, 0, 0, 0 31, 0, 0, 8, 0, 3, 0, 1, 0, 0, 0 31, 0, 0, 8, 0, 3, 0, 1, 0, 0, 0 / AL FB OM PAN WF SY SP PMD AMD PMS AMS 5, 7, 15, 3 0, 0, 0, 0, 0, 0, 0) （MEASURE3 m_fmvset()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .FM_VSETn {v1,v2,…,v55} ＊ AL/FB分離形式によるＦＭ音源の音色設定。 nは定義する音色番号で1≦n≦200。 機能とデータフォーマットは全く(＠)コマンドと同じである。 例 / AR DR SR RR SL OL KS ML DT1 DT2 AME fm_vset1 { 31, 0, 2, 0, 0, 21, 0, 1, 0, 0, 0 31, 0, 0, 8, 0, 3, 0, 3, 0, 0, 0 31, 0, 0, 8, 0, 3, 0, 1, 0, 0, 0 31, 0, 0, 8, 0, 3, 0, 1, 0, 0, 0 / AL FB OM PAN WF SY SP PMD AMD PMS AMS 5, 7, 15, 3 0, 0, 0, 0, 0, 0, 0} （MEASURE3 m_fmvset()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＡＤＰＣＭコンフィギュレーション −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− n＝ファイルネーム,Pp,Vv,Mm,d,Cc,s,R,Ff,l ＡＤＰＣＭ音の登録。 n＝設定音色番号(0〜511) p＝ピッチシフトパラメータ(−12〜12) v＝ボリュームパラメータ(1〜100(原音量)〜300) m＝ミキシングノート番号(0〜511) d＝ミキシングディレイパラメータ(0〜65535) c＝カット・オフセットパラメータ(0〜65535) s＝カット・サイズ(0〜65535) f＝フェードイン／アウト・オフセット(0〜65535) l＝フェードイン／アウト・レベル(0〜127) ファイルネーム以降は省略可能。詳しい使い方とパラメータの意味はMEASURE6参照。 （MEASURE3 m_pcmset()，MEASURE6参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .ADPCM_BANK n ＡＤＰＣＭ音の登録先のバンクを指定する。 n＝バンク番号。1≦n≦4。 '(I)'命令でデフォルト値１が設定される （MEASURE6参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .Onk＝ファイルネーム,Pp,Vv,Mm,d,Cc,s,R,Ff,l ＡＤＰＣＭ音の登録。 n＝オクターブ値(−1〜9) k＝音階MML(abcdefg,#,＋,−) p＝ピッチシフトパラメータ(−12〜12) v＝ボリュームパラメータ(1〜100(原音量)〜300) m＝ミキシングノート番号(0〜511) d＝ミキシングディレイパラメータ(0〜65535) c＝カット・オフセットパラメータ(0〜65535) s＝カット・サイズ(0〜65535) f＝フェードイン／アウトオフセット(0〜65535) l＝フェードイン／アウトレベル(0〜127) ファイルネーム以降は省略可能。登録先ノート番号やミキシングノート番号は '.ADPCM_BANK'命令のバンク番号が考慮される。 詳しい使い方とパラメータの意味はMEASURE6参照。 （MEASURE3 m_pcmset()，MEASURE6参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .ERASE m　 または， .ERASE .Onk　　　 (.Oの'.'はあってもなくてもいい) 　　　 m＝ノート番号(０〜511) n＝オクターブ値(-1〜９) k＝音階MML(abcdefg，#，+，-) 　不要なAD PCMノートを削除する。 　ZPCNV.R専用の命令で，ZMS中に実行してもなんの機能も果たさない。 （MEASURE6参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .ADPCM_LIST ファイルネーム ＡＤＰＣＭデータのコンフィギュレーションファイルを読み込み実行する。 （MEASURE3 m_pcmcnf()，MEASURE6参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .ADPCM_BLOCK_DATA ファイルネーム ＡＤＰＣＭブロックデータ「ＺＰＤデータ」の読み込み、登録を行う。 拡張子省略時には'.ZPD'が自動添付される。 （MEASURE3 m_adpcm_block()，MEASURE6参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＭＩＤＩデータ出力 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｘn1,n2,…,ni) ＊ ＭＩＤＩの生データを送信。ＭＵＳＩＣＺ．ＦＮＣの'm_out()'と ほぼ同様のコマンドだがパラメータをいくつでも書くことが出来る(複数行に渡っても可)。 データは0≦ni≦255。256以上はその値を７ビットごとに分けて下位から送信される。 例 8192→$00,$40 32700→$3C,$7F,$01 （MEASURE3 m_out(), MEASURE9参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MIDI_DATA {n1,n2,…ni} ＊ ＭＩＤＩの生データの送信。 データは0≦ni≦255。256以上はその値を７ビットごとに分けて下位から送信される。 例 8192→$00,$40 32700→$3C,$7F,$01 （MEASURE3 m_dirout(), MEASURE9参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .EXCLUSIVE {n1,n2,…,ni} ＊ エクスクルーシブデータの送信。 データは0≦ni≦127。128以上はその値を7ビットごとに分けて下位から送信される。 例 255→$01,$7F 8192→$00,$40 32700→$3C,$7F,$01 （MEASURE3 m_exc(), MEASURE9参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .ROLAND_EXCLUSIVE dev,mdl {n1,n2,…,ni} ＊ ローランド系の楽器へエクスクルーシブメッセージを送る。 詳しい使い方はMEASURE9参照。 dev＝デバイスＩＤ, mdl＝モデルＩＤ エクスクルーシブ・ヘッダやチェックサム・バイトは自動生成して送信してくれる。 データは0≦ni≦127。128以上はその値を7ビットごとに分けて下位から送信される。 例 255→$01,$7F 8192→$00,$40 32700→$3C,$7F,$01 （MEASURE3 m_roland(), MEASURE9参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MIDI_DUMP＝ファイルネーム ＭＩＤＩダンプデータ「ＭＤＤデータ」(MEASURE9参照)を楽器へ送信する。 拡張子省略時には'.MDD'が自動添付される。 （MEASURE3 m_trans(), MEASURE9参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＭＩＤＩデータ入力 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− (Ｒ) ＭＩＤＩの生データを取り込み待機状態にする。 ミュージックプログラム中に記述しても意味を持たない。 詳しい使い方はMEASURE9を参照。 （ZMDデータとしては生成されないコマンド） （MEASURE3 m_rec(), MEASURE9参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＳＣ５５／ＳＣ１５５／ＣＭ３００／ＣＭ５００のＧＳパート専用命令 パラメータの意味などは楽器のマニュアルあるいはMEASURE3を参照のこと −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_INIT id ＳＣ５５の初期化を行なう id:ＳＣ５５のデバイスＩＤ(省略可能、初期値$10) （MEASURE3 sc55_init()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_V_RESERVE id {n1,n2,…,n16} ＊ ＳＣ５５の各パートのボイスリザーブを行う。 id:ＳＣ５５のデバイスＩＤ(省略可能、初期値$10) パラメータは必ず16個設定しなくてはならない。パラメータ各値の総和は24以内。 また、10番目のパラメータはリズムパートに相当する。 （SC55マニュアルp79, またはMEASURE3 sc55_v_reserve()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_REVERB id {n1,n2,…,n7} ＊ ＳＣ５５のリバーブパラメータの設定を行う。 id:ＳＣ５５のデバイスＩＤ（省略可能、初期値$10) パラメータは7個まで。 （SC55マニュアルp79, またはMEASURE3 sc55_reverb()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_CHORUS id {n1,n2,…,n8} ＊ ＳＣ５５のコーラスパラメータの設定を行う。 id:ＳＣ５５のデバイスＩＤ(省略可能、初期値$10) パラメータは8個まで。 （SC55マニュアルp79, またはMEASURE3 sc55_chorus()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_PART_SETUP pt,id {n1,n2,…,n119} ＊ ＳＣ５５のパートのパラメータを設定する。 pt:パートナンバー(1≦pt≦16)省略不可(パートナンバー＝10はリズムパート) id:ＳＣ５５のデバイスＩＤ(省略可能、初期値$10) パラメータは119個まで。 （SC55マニュアルp79〜80, またはMEASURE3 sc55_part_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_DRUM_SETUP map,key,id {n1,n2,…,n8} ＊ ＳＣ５５のドラムキットの設定を変える。 map:マップナンバー(0,1) key:ノートナンバー(0≦key≦127) id:ＳＣ５５のデバイスＩＤ(省略可能、初期値$10) パラメータは8個まで。 （SC55マニュアルp82, またはMEASURE3 sc55_drum_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_PRINT id "文字列" ＳＣ５５のコンソールに文字列を表示する。 id:ＳＣ５５のデバイスＩＤ(省略可能、初期値$10) 文字列は32文字以内。 （MEASURE3 sc55_print()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SC55_DISPLAY id {n1,n2,…,n16} ＊ ＳＣ５５のグラフィックディスプレイにドットパターンを表示する。 id:ＳＣ５５のデバイスＩＤ(省略可能、初期値$10) パラメータは必ず16個。 例 /画面に'善'を出す .sc55_display$10 { %0001000000010000 %0000100000100000 %0111111111111100 %0000000100000000 %0011111111111000 %0000000100000000 %0111111111111100 %0001000100010000 %0000100100100000 %1111111111111110 %0000000000000000 %0011111111111000 %0010000000001000 %0010000000001000 %0011111111111000 %0010000000001000} （MEASURE3 sc55_display()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＭＴ３２／ＣＭ３２Ｌ／（ＣＭ６４／ＣＭ５００のＬＡパート）専用命令 パラメータの意味などは楽器のマニュアルあるいはMEASURE3を参照のこと −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_INIT id ＭＴ３２の初期化を行なう id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) （MEASURE3 mt32_init()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_P_RESERVE id {n1,n2,…,n9} ＊ ＭＴ３２の各パートのパーシャルリザーブを行う。 id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) パラメータは必ず9個、パラメータ各値の総和は32以内。 9番目はリズムパート。 （MEASURE3 mt32_p_reserve()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_REVERB id {n1,n2,n3} ＊ ＭＴ３２のリバーブパラメータを設定する。 id:ＭＴ３２のデバイスＩＤ(省略可能、初期値$10) パラメータは3個まで。 （MT32マニュアルp35, CM64マニュアルp30, またはMEASURE3 mt32_reverb()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_PART_SETUP id {n1,n2,…,n9} ＊ ＭＴ３２の各パートのＭＩＤＩチャンネルを設定する。 id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) パラメータは9個まで、9番目はリズムパート。 (パラメータはＭＩＤＩチャンネルなので1〜16まで有効。17以上はパートOFFとみなす。) （MT32マニュアルp35, CM64マニュアルp30, またはMEASURE3 mt32_part_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_DRUM_SETUP n,id {n1,n2,n3,n4} ＊ ＭＴ３２のリズムキットの設定を変更する。 n:変更対象ノートナンバー(24≦n≦87) id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) パラメータは4個まで。 （MT32マニュアルp35, CM64マニュアルp30, またはMEASURE3 mt32_drum_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_COMMON n,id {"名前",n1,n2,n3,n4} ＊ ＭＴ３２の音色のコモンパラメータを設定する。 n:設定対象ティンバー番号(1≦n≦64) id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) 名前は10文字以内(省略不可) パラメータは4個まで。 （MT32マニュアルp34, CM64マニュアルp29, または MEASURE3 mt32_common()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_PATCH n,id {n1,n2,…,n7} ＊ ＭＴ３２のパッチを設定する。 n:設定対象パッチナンバー(1≦n≦128) id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) パラメータは7個まで。 （MT32マニュアルp35, CM64マニュアルp30, またはMEASURE3 mt32_patch()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_PARTIAL n,p,id {n1,n2,…,n58} ＊ ＭＴ３２の音色のパーシャルパラメータを設定する。 n:設定対象ティンバー番号(1≦n≦64) p:設定対象パーシャルナンバー(1≦p≦4) id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) パラメータは58個まで。 （MT32マニュアルp34, CM64マニュアルp29, またはMEASURE3 mt32_partial()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .MT32_PRINT id "文字列" ＭＴ３２のコンソールに文字列を表示する。 id:ＭＴ３２のデバイスＩＤ（省略可能、初期値$10) 文字列は20文字以内。 （MEASURE3 mt32_print()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●Ｕ２２０／Ｕ２０専用命令 パラメータの意味などは楽器のマニュアルあるいはMEASURE3を参照のこと −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .U220_SETUP id {n1,n2,…,n7} ＊ Ｕ２２０のセットアップパラメータを設定する。 id:Ｕ２２０デバイスＩＤ（省略可能、初期値$10) パラメータは必ず7個。 （U220マニュアルp46,p146,p148, またはMEASURE3 u220_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .U220_PART_SETUP pt,id {n1,n2,…,n13} ＊ Ｕ２２０のテンポラリ・パッチのパートパラメータを設定する。 pt:パートナンバー(1≦pt≦6) id:Ｕ２２０のデバイスＩＤ（省略可能、初期値$10) パラメータは必ず13個。 （U220マニュアルp58,p149, またはMEASURE3 u220_part_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .U220_COMMON id {n1,n2,…,n18} ＊ Ｕ２２０のテンポラリ・パッチのコモンパラメータを設定する。 id:Ｕ２２０のデバイスＩＤ（省略可能、初期値$10) パラメータは必ず18個。 （U220マニュアルp54,p149, またはMEASURE3 u220_common()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .U220_TIMBRE n,id {"音色名",n1,n2,…,n12} ＊ Ｕ２２０に音色パラメータを設定する。 n:セット先音色ナンバー(1≦n≦128) id:Ｕ２２０のデバイスＩＤ（省略可能、初期値$10) 音色名は12文字以内。 パラメータは必ず26個。 （U220マニュアルp72,p149, またはMEASURE3 u220_timbre()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .U220_DRUM_SETUP id {n1,n2,…,n7} ＊ Ｕ２２０のテンポラリ・パッチのドラム・パラメータを設定する。 id＝Ｕ２２０のデバイスＩＤ（省略可能、初期値$10) パラメータは必ず7個。 （U220マニュアルp63,p149, またはMEASURE3 u220_drum_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .U220_DRUM_INST n,id {n1,n2,…,n20} ＊ Ｕ２２０のテンポラリ・ドラムキットの各ノートにおけるパラメータを設定する。 n:ノートナンバー(35≦n≦99) id:Ｕ２２０のデバイスＩＤ（省略可能、初期値$10) パラメータは20個以内。 （U220マニュアルp72,p149, またはMEASURE3 u220_midi_inst()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .U220_PRINT id {"文字列"} Ｕ２２０のテンポラリ・パッチの名前を設定する。 id:Ｕ２２０のデバイスＩＤ（省略可能、初期値$10) 文字列は12文字以内。 （MEASURE3 u220_print()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●Ｍ１専用命令 Ｍ１専用命令は途中でＭ１関係以外の命令が入ると正常なデータが楽器側へ 　送信されないので注意 パラメータの意味などは楽器のマニュアルあるいはMEASURE3を参照のこと −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .M1_MIDI_CH {ch1,ch2,…,ch8} Ｍ１のＳＥＱ０の各パートの受信チャンネルを設定する。 パラメータは必ず8個(1≦chi≦16:MIDI CH,17≦chi:off)。 例 .m1_midi_ch {1,2,3,4,5,6,17,10} (パート1〜6をＭＩＤＩチャンネル1〜6に設定し、パート7はOFF, パート8をＭＩＤＩチャンネル10に設定) （MEASURE3 m1_midi_ch()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .M1_PART_SETUP {n1,n2,…,n40} ＊ Ｍ１のＳＥＱ０の各パートのパラメータを設定する。 パラメータは必ず5×8パート分＝40個。 （M1マニュアルp126, またはMEASURE3 m1_part_set_up()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .M1_EFFECT_SETUP {n1,n2,…,n25} ＊ Ｍ１のＳＥＱ０のエフェクトパラメータの設定。 パラメータは必ず25個。 （M1マニュアルp127, またはMEASURE3 m1_effect_setup()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .M1_PRINT "文字列" Ｍ１のＳＥＱ０のソングネームの設定。 文字列は10文字以内。 （MEASURE3 m1_print()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .SEND_TO_M1 id '.M1_MIDI_CH', '.M1_PART_SEUP', '.M1_EFFECT_SETUP', '.M1_PRINT'で設定した パラメータをＭ１へ送信する。 id:Ｍ１のデバイスＩＤ（省略可能、初期値$30) 備考 デバイスＩＤは$30＋グローバルチャンネル(0〜$f)で求められる。 グローバルチャンネルとはGLOBALモードのF5−1で設定出来る。 必ず'.M1_MIDI_CH'〜'.M1_PRINT'を設定してからこの命令を実行すること。 '.M1_EFFECT_SETUP'のみ省略が可能。この時はドライバのデフォルトデータが 送信される。 '.M1_MIDI_CH'〜'.M1_PRINT'の間にＭ１関係以外のコマンドがあると正常なデータが 送信されないので注意すること。 （MEASURE3 send_to_m1()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●その他 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .WAVE_FORM wv,lt,lp {dt0,dt1,dt2,…,dt65535} 波形メモリの登録。 wv:波形番号(8≦wv≦31) lt:ループタイプ(0≦lt≦2) lp:ループポイント(0≦lp≦65535) dt0,dt1,dt2,…,dt65535:波形データ(−32768≦dti≦32767) 備考 波形番号8〜31に登録できる(波形番号0〜7はプリセット波形などが 設定されておりリザーブ)。 パラメータのループタイプとは波形を最後まで処理を終えたあと、 どうループさせるかを設定するもの。 0 → ワンショット (波形を一度実行したら最後の値を継続する) 1 →→→→.... リピート (波形の終点までいったならば ループポイントに戻る) 2 →←→←.... オルタニティヴ (波形のループポイントから終点まで 交互に反復する) ループポイントは0〜65535までが有効。これは何番目のデータを ループポイントに設定するかを決めるパラメータで省略すると ループポイントは0、すなわちデータの先頭がループポイントと見なされる。 波形データは符号付き16ビット整数で構成する。 (−32768〜＋32767($8000〜$7fff))データの個数は65535個まで。 それ以上は設定できない。 例 .wave_form 8,0,10 {0,5,−5,10,3,−300,10,6,80,10} （MEASURE3 m_wave_form(), 詳しい使い方はMEASURE5参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .FM_MASTER_VOLUME n ＦＭ音源のマスターボリュームの設定。 設定範囲は0≦n≦255で255が最大音量。通常は255。 コンパイル時のみ有効で演奏中に指定しても無意味。 （ZMDデータとしては生成されないコマンド） （MEASURE3 fm_master()参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− / 文字列 '/'より後ろをコメントとして無視する。 例 / ORGAN SOLO （ZMDデータとしては生成されないコマンド） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− .COMMENT 文字列 後ろをコメントとして無視する。 単なるコメント行だが'/'と違うのはコンパイルされたデータ（ＺＭＤデータ）にも 残るという点（ただし演奏には影響なし）。 曲のタイトル、制作日時、自分の名前等をＺＭＳファイル先頭に記述するのが一般的。 例 .comment STAGE 1 BGM VERSION 1.10 (c)1992/11 XVI −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− { -- ZM5.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ ５ ＭＭＬ ここではＺＭＵＳＩＣのＭＭＬについて解説します。 ５．１． ＭＭＬの文法解説を読むにあたって ＺＭＵＳＩＣ．Ｘは基本的にシャープ／Ｈｕｄｓｏｎ製のＯＰＭＤＲＶ．Ｘに 上位コンパチである。つまりＯＰＭＤＲＶ．Ｘに存在したＭＭＬはほぼ共通に 使用することができ、ＯＰＭＤＲＶ．Ｘ用のデータをほとんど変更無しで演奏が 可能である。 ＺＭＵＳＩＣ．ＸではＭＭＬの小文字、大文字の区別を一切していない。 よって状況、ユーザー各位の趣味に応じて自由に使いわけが可能である。ここでは 説明の都合上ＭＭＬを大文字で、パラメータを小文字で記述している。 省略しても良いパラメータはその旨を記述してあるがそれ以外は 省略不可である。また、数値パラメータは頭に'$'をつければ16進数が、'%'を つければ2進数を設定することができる。何もつけなければ10進数である。 各コマンドの頭についている印は各音源の種類を表している。全てのコマンドが 全ての音源に対応しているわけではないので注意すること。対応していない デバイスに対してそのコマンドを用いるとエラーになるケースと無視されるケースが ある。 ○内蔵ＦＭ音源 ◎内蔵ＡＤＰＣＭ ●ＭＩＤＩ音源 ５．２． ＭＭＬ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■音階、休符 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● Ａn〜Ｇn 音階。ＡＢＣ〜Ｇはハ長調のラシド〜ソに対応する。 後ろに＃，＋を付ければ半音上がり、−を付けると半音下がる。 nは音長を表し、1が全音符、2が２分音符…となる。 nはマスタークロック設定コマンド'm_count()'や(Ｚn)によって設定範囲が変動する。 具体的には 1≦n≦マスタークロックの値 が設定範囲となる。以下にデフォルトのマスタークロック＝192のときの 音楽的音長と絶対音長との対応を示す。 音楽的音長 絶対音長 音楽的音長 絶対音長 １ １９２ １２ １６ ２ ９６ １６ １２ ３ ６４ ２４ ８ ４ ４８ ３２ ６ ６ ３２ ６４ ３ ８ ２４ １９２ １ 絶対音長＝int(マスタークロック／音楽的音長)。 nは省略可能で、省略時は後述のＬ／＠Ｌコマンドで設定したデフォルト音長で 演奏される。 nの前に'＊'をつけると絶対音長指定になる。絶対音長とはＺＭＵＳＩＣが処理する カウンタのことでデフォルトでは全音符が192になっている。このとき例えばC4と C*48は同時間発音されるわけである。'＊'の後ろには0〜65534までの数値を 書くことができる。 例 a#4 b*386 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● Ｒn 休符。nは音長を表す。nは音階と同様の指定が可能。 n省略時はデフォルト音長が起用される。 例 r8 r*96 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ＠Ｗn 指定時間、前の状態を保存する。nは音長を表す。nは音階と同様の指定が可能。 n省略時はデフォルト音長が起用される。 例 @w*64 @w4.. −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■変化記号／調号 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ＃ ＋ シャープ（♯，嬰記号）。音階ＭＭＬの直後につけると半音高く演奏する。 ２つ以上記述することもできる。 例 c#4 f+8 g##16 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● − フラット（♭，変記号）。音階ＭＭＬの直後につけると半音低く演奏する。 ２つ以上記述することもできる。 例 c-4 e-8 g--16 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● [K.SIGN 〜] 調号を設定する。どの音階にどの変化記号（♯，♭）がつくのかを設定できる。 〜の部分は変化記号、音階の順に設定し、１個ずつ　, で区切る。 例 [K.SIGN +c,+d,+f,+g] (ホ長調) cdfgに自動的に＃(シャープ)がつく [K.SIGN -a,-b,-d,-e] (変イ長調) abdeに自動的に−(フラット)がつく [K.SIGN -a,+b] aに−(フラット)が、bに＃(シャープ)が自動的につく −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ！ ナチュラル（本位記号）。音階ＭＭＬの直後に設定することによって[K.SIGN 〜]で設定した 調号を臨時に取り消す事ができる。 例 [K.SIGN -a] a a! としたとき、１回目のaは a- で２回目のaはフラットなしで a で演奏される。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■オクターブ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● Ｏn オクターブを設定する。初期値は4。nは−1〜9まで設定可能。 実際の発音域は各操作デバイスによって異なる。 ・ＦＭ音源 オクターブ０のＤ＃からオクターブ８のＤまで。 ・ＡＤＰＣＭ 登録しなければ発音はしないが、セレクトバンク内の(＠コマンド、MEASURE6参照) オクターブ−１のＣからオクターブ９のＧまで対応。 ・ＭＩＤＩ オクターブ−１のＣからオクターブ９のＧまで。実際は各楽器によって違う。 各操作ＭＩＤＩ楽器のマニュアルのインプリメンテーション・チャートを参照。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ＜ ＞ オクターブを相対的に変更する。＜はオクターブを＋1し、＞はオクターブを −1する。設定範囲を越えた場合はエラーとなる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■音長制御 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● Ｌn ＠Ｌn デフォルト音長を設定する(シーケンサでいうステップタイムに相当する)。 音長をパラメータに持つＭＭＬにおいて音長が省略された場合、このコマンドで 設定したものがパラメータとして与えられる。 Ｌのパラメータnは音楽的音長、絶対音長のいずれかを書くことができる。 音楽的音長の場合はn分音符といった意味をなす(設定範囲については音階ＭＭＬの 説明を参照)。符点も設定可能。絶対音長は音名の時と同じように数値の前に'＊'を 書いて設定できる。設定範囲は0≦n≦65534。 ＠Ｌのパラメータnは絶対音長のみで設定範囲は0≦n≦65534。 初期値はＬ4(＝＠Ｌ48)である。 例 l16. @l96 l*2000 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ． 符点。音長を示す数値の後ろに付けると0.5倍されたものが加算される。 さらに続けると元の音長の0.25倍、0.125倍…といったものが加算されていく。 ただし加算結果が65534以下でなければならない。 絶対音長指定の後ろに付けることも出来る。また、加算する音長カウントは整数で 処理されるため、算出された音長がアンダーフローするとエラーになる。 音長を省略した時に符点がついた場合は、その時点でのデフォルト音長に対して 符点処理された音長が、その音符の音長となる。 例 a4.. r8. c*1000. (c*1500と同じ) l4 c. (c4.と同じ) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● Ｑn 1音中で実際に発音している時間を音長のn/8時間単位で設定する (シーケンサでいうゲートタイムに相当する)。 初期値 n＝8、設定範囲は1〜8。1が発音時間がもっとも短く、8が最も長い(テヌート)。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ＠Ｑn キーオフ（発音をやめること）を絶対音長でnカウント早める。 発音音長より大きい値の場合、＠Ｑは機能せずＱ8の状態で演奏される。 例えば ＠Ｑ96 C＊16の場合は発音長が 16−96＜0 となるので ＠Ｑの処理はされず発音長は16カウントとなる。 初期値は＠Ｑ0に相当し設定範囲は0〜32768。 ＠Ｑを設定した時はＱは機能せず、逆にＱを設定した時は＠Ｑは機能しない。 つまり後に設定したものが有効となる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■タイ／スラー −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ＆ 前後の音をつなぐ。同音名の場合は全デバイスにおいてタイとなる。 例 a4&a16. 異音名の場合は、各デバイスによって対応が異なる。 ・ＦＭ音源 スラーとなる 例 a4&a#4 ・ＡＤＰＣＭ '＆'を除いた時のように処理される 例 a4&a#4 → a4a#4のように演奏される ・ＭＩＤＩ 後述のタイ・モード(@Jコマンドにより設定)によって対応が異なる。 通常モード時(@J0) '＆'を除いた時のように処理される 例 a4&a#4 → a4a#4のように演奏される ＦＭ音源部互換モード時(@J1) 　スラーとなる。 例 a4&a#4 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ＾n 音符の直後に書くことによって、nで指定した音長分をその音符の音長に加算する。 nの後ろに符点を書けば、符点を考慮した音長が加算される。nには絶対音長を 書くこともできる。 例 c4^16 d^*1000 'ceg4^16' (d2^8c) や、後のコラムで動作の相違があると書かれている (g,e)24&e @b0,683 c4&c+4 のような表記もＦＭ音源部と同様に機能するようになる(ただし、最初にキーオンした 音階から１オクターブを超えることはできない)。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■連符 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○◎● ｛〜｝n ｛〜｝で囲まれたＭＭＬ群を合計の音長がn分音符音長になるように演奏する。 nには符点を付けたり、'＊'を付けて絶対音長による指定も行なえる。 ｛〜｝の中には音長を操作するＭＭＬを書くことは出来ない。（符点,Ｌ,＠Ｌ,Ｑ,＠Ｑなど） n省略時はデフォルト音長が起用される。 例 {cdef}2 {abc}4.. {cd&de}*192 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■和音 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ○● 'MML…'nn,dly(&) 和音を発音する。'〜'間に書けるＭＭＬは以下の通りである。 音階 c〜b(8個まで) 調号 # + - ! 音長 1〜(符点も可) 絶対音長 *1〜*65534 ｵｸﾀｰﾌﾞｺﾏﾝﾄﾞ O-1〜O9 ｵｸﾀｰﾌﾞｽｲｯﾁ < > １度に８和音まで発音が可能。８音以上音階を書くとエラーとなる。 オクターブスイッチは'〜'(シングルコーテーション)内だけ有効。 '〜'内に音長を書かずに外に数値を書くと、これは絶対音長の指定になる。 設定範囲は0≦nn≦65534で全音符以上の発音時間も設定できる。 ディレイパラメータdlyを設定することによって、和音を一度に発音せず、各音を 絶対音長dlyずつ時間的にずらして１音ずつ発声する(アルペジオ奏法)。 ディレイは初期値0で、省略可能だが省略時は以前設定した値がそのまま起用される。 例 'c4eg' ドミソを４分音符で演奏する。 o4'gb 和音コマンドとは違ってオクターブスイッチは(〜)外へも影響する。 音長は和音コマンド同様にキーの後ろに書くことも、(〜)の外に書くこともできる。 外に書いた場合は絶対カウントとみなされる。絶対音長ではnは0≦n≦32767まで 設定可能なので全音符以上の発音時間を設定することも可能である。 dlyはディレイで絶対カウント単位でポルタメントのかかり方を遅らせることが出来る。 設定可能範囲は0≦dly≦32767。dlyは省略すると以前の設定値が起用される。 音長を省略するとデフォルトの音長(Ｌまたは＠Ｌコマンドで指定したもの)が起用される。 ＭＩＤＩ楽器において、後述の＠Ｇコマンドでベンドレンジを12(1ｵｸﾀｰﾌﾞ)以外に 変更したとき、あるいはＭＩＤＩ楽器のベンドレンジが12に設定されていない時の 動作は表記通りにならない。 例 o4(g2c ┃ ┃ ┃ ┃あるいは ┃ ┃ ┃ ┃ o4 (c,[,loop point]＝{data.......} ＭＵＳＩＣＺ．ＦＮＣ関数 m_wave_form(,[,loop point],) を用いて作成したユーザー波形を波形番号8〜31に登録し使用することが出来る。 この波形が振幅(＠Ｍ／＠Ａコマンド)、波長(＠Ｓコマンド)、 ディレイ(＠Ｈコマンド)などの各パラメータによってどう影響するかを図に示す。 また以下にユーザー波形使用時の留意点を示す。 ・波形データはピッチ・モジュレーション／音量モジュレーション／ＡＲＣＣ共用と なる。登録した波形データはＭＭＬの'Ｓ'コマンドでプリセットの ノコギリ波／矩形波／三角波同様に呼び出して使用する。 ・MML'＠Ｓ'で指定されたクロックの間、１つの波形データを使用する。(下図) ・実際の波形実行のオン／オフは通常の特殊機能と同様。 ・振幅は各ポイントにおける波形データが直値で使用されるが、各特殊機能コマンドの 振幅設定コマンドの正負に応じて各値の正負を逆転して使用させることも可能。(下図) ただし振幅の絶対値は無関係。 ・1/8モードは波形メモリに振幅という観念がないため無効。 ------------------------------------------------------------------------------------ ピッチ・モジュレーション(ＦＭ音源部／ＭＩＤＩ音源部拡張ピッチ・モジュレーションモード時) ------------------------------------------------------------------------------------ 波形番号0:鋸歯波 振幅パラメータ:＋ ＿ ／ ／ ／ ／ ／↑@M @K→＿＿＿＿／ ／ ／ ／ ／ ↓ ←──→ ／ ／ ／ ／ ￣ @Hの ／ ／ ／ ／| 第1ﾊﾟﾗﾒｰﾀ | | @Sの第1ﾊﾟﾗﾒｰﾀ 波形番号0:鋸歯波 振幅パラメータ:− ＼ ＼ ＼ ＼ @K→＿＿＿＿ ＼ ＼ ＼ ＼ ＿ ←──→＼ ＼ ＼ ＼ ＼ ↑ @Hの ＼ ＼ ＼ ＼ |＼↓@M 第1ﾊﾟﾗﾒｰﾀ | |￣ @Sの第1ﾊﾟﾗﾒｰﾀ 波形番号1:矩形波 振幅バラメータ：＋ ￣￣ ￣￣ ￣￣ ￣￣ @K→＿＿＿＿ ＿ ←──→ ↑@M @Hの ＿＿ ＿＿ ＿＿ ＿＿↓ 第1ﾊﾟﾗﾒｰﾀ | | ￣ @Sの第1ﾊﾟﾗﾒｰﾀ 波形番号1:矩形波 振幅バラメータ：− ＿ ￣￣ ￣￣ ￣￣↑@M @K→＿＿＿＿ ↓ ←──→ ￣ @Hの ＿＿ ＿＿ ＿＿ 第1ﾊﾟﾗﾒｰﾀ | | @Sの第1ﾊﾟﾗﾒｰﾀ 波形番号2:三角波 振幅パラメータ：＋ ＿ ／＼ ／＼ ／↑@M @K→＿＿＿＿／ ＼ ／ ＼ ／ ↓ ←──→ ＼ ／ ＼ ／| ￣ @Hの ＼／ ＼／ | 第1ﾊﾟﾗﾒｰﾀ | | @Sの第1ﾊﾟﾗﾒｰﾀ 波形番号2:三角波 振幅パラメータ：− ／＼ ／＼ @K→＿＿＿＿ ／ ＼ ／ ＼ ＿ ←──→＼ ／ ＼ ／ |＼ ↑@M @Hの ＼／ ＼／ | ＼↓ 第1ﾊﾟﾗﾒｰﾀ | |￣ @Sの第1ﾊﾟﾗﾒｰﾀ 波形番号3:鋸歯波シングル 振幅パラメータ:＋ ＿＿＿＿＿＿＿＿＿＿＿＿＿ ／↑@M @K→＿＿＿＿／| ↓ ←──→| | ￣ @Hの @Sの第1ﾊﾟﾗﾒｰﾀ 第1ﾊﾟﾗﾒｰﾀ 波形番号3:鋸歯波シングル 振幅パラメータ:− @K→＿＿＿＿ ＿ ←──→＼ ↑ @Hの |＼↓@M 第1ﾊﾟﾗﾒｰﾀ| |￣￣￣￣￣￣￣￣￣￣￣￣￣ @Sの第1ﾊﾟﾗﾒｰﾀ 波形番号8〜31:ユーザー波形 振幅パラメータ：＋ 波形データ列が＋5,−5,＋10,＋3,0の場合・・・ +10 +5 ￣￣ ￣￣ ＿＿ 0 @K→──── +3 ── ←──→ ＿＿ @Hの -5 第1ﾊﾟﾗﾒｰﾀ ←→ @S第1ﾊﾟﾗﾒｰﾀ 波形番号8〜31:ユーザー波形 振幅パラメータ：− 波形データ列が＋5,−5,＋10,＋3,0の場合・・・ +5 ￣￣ 0 @K→──── -3 ── ←──→＿＿ ￣￣ @Hの -5 ＿＿ 第1ﾊﾟﾗﾒｰﾀ -10 ←→ @S第1ﾊﾟﾗﾒｰﾀ ------------------------------------------------------------------------------ 音量モジュレーション(ＦＭ音源部) ------------------------------------------------------------------------------ 波形番号0:鋸歯波 振幅パラメータ:＋ @V→＿＿＿＿ ＿ ←──→＼ ＼ ＼ ＼ ↑ @Hの ＼ ＼ ＼ ＼ ｜ 第2ﾊﾟﾗﾒｰﾀ ＼ ＼ ＼ ＼ ｜@A ＼ ＼ ＼ |＼↓ | |￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号0:鋸歯波 振幅パラメータ:− @V→＿＿＿＿ ＿ ←──→ ／ ／ ／ ／↑ @Hの ／ ／ ／ ／ ｜@A 第2ﾊﾟﾗﾒｰﾀ ／ ／ ／ ／ ｜ ／ ／ ／ ／| ↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号1:矩形波 振幅バラメータ：＋ @V→＿＿＿＿ ＿ ←──→￣￣ ￣￣ ￣￣ ￣￣ ↑ @Hの ｜ 第2ﾊﾟﾗﾒｰﾀ ｜@A ＿＿ ＿＿ ＿＿ ＿＿↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号1:矩形波 振幅バラメータ：− @V→＿＿＿＿ ＿ ←──→ ￣￣ ￣￣ ￣￣ ￣￣ ↑ @Hの ｜@A 第2ﾊﾟﾗﾒｰﾀ ｜ ＿＿ ＿＿ ＿＿ ＿＿ ↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号2:三角波 振幅バラメータ：＋ @V→＿＿＿＿ ＿ ←──→＼ ／＼ ／ ↑ @Hの ＼ ／ ＼ ／ ｜ 第2ﾊﾟﾗﾒｰﾀ |＼ ／ ＼ ／ ｜@Aのパラメータ | ＼／ ＼／ ↓ ←→ ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号2:三角波 振幅バラメータ：− @V→＿＿＿＿ ＿ ←──→ ／＼ ／＼ ↑ @Hの ／ ＼ ／ ＼ ｜ 第2ﾊﾟﾗﾒｰﾀ ／| ＼ ／ ＼ ｜@Aのパラメータ ／ | ＼／ ＼ ↓ ←→ ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号3:鋸歯波シングル 振幅パラメータ:＋ @V→＿＿＿＿ ＿ ←──→＼ ↑ @Hの ＼ ｜ 第2ﾊﾟﾗﾒｰﾀ ＼ ｜@A |＼↓ | |￣￣￣￣￣￣￣￣￣￣￣￣￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号3:鋸歯波シングル 振幅パラメータ:− @V→＿＿＿＿ ＿＿＿＿＿＿＿＿＿＿＿＿＿ ←──→ ／↑ @Hの ／ ｜@A 第2ﾊﾟﾗﾒｰﾀ ／ ｜ ／| ↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号8〜31:ユーザー波形 振幅パラメータ：＋ 波形データ列が＋5,−5,＋10,＋3,0の場合・・・ +10 +5 ￣￣ ￣￣ ＿＿ 0 @V→──── +3 ── ←──→ ＿＿ @Hの -5 第2ﾊﾟﾗﾒｰﾀ ←→ @S第2ﾊﾟﾗﾒｰﾀ 波形番号8〜31:ユーザー波形 振幅パラメータ：− 波形データ列が＋5,−5,＋10,＋3,0の場合・・・ +5 ￣￣ 0 @V→──── -3 ── ←──→＿＿ ￣￣ @Hの -5 ＿＿ 第2ﾊﾟﾗﾒｰﾀ -10 ←→ @S第2ﾊﾟﾗﾒｰﾀ ------------------------------------------------------------------------------ 拡張ＡＲＣＣ ------------------------------------------------------------------------------ 波形番号0:鋸歯波 振幅パラメータ:＋ @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿ ←──→＼ ＼ ＼ ＼ ↑ @Hの ＼ ＼ ＼ ＼ ｜ 第2ﾊﾟﾗﾒｰﾀ ＼ ＼ ＼ ＼ ｜@A ＼ ＼ ＼ |＼↓ | |￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号0:鋸歯波 振幅パラメータ:− @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿ ←──→ ／ ／ ／ ／↑ @Hの ／ ／ ／ ／ ｜@A 第2ﾊﾟﾗﾒｰﾀ ／ ／ ／ ／ ｜ ／ ／ ／ ／| ↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号1:矩形波 振幅バラメータ：＋ @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿ ←──→￣￣ ￣￣ ￣￣ ￣￣ ↑ @Hの ｜ 第2ﾊﾟﾗﾒｰﾀ ｜@A ＿＿ ＿＿ ＿＿ ＿＿↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号1:矩形波 振幅バラメータ：− @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿ ←──→ ￣￣ ￣￣ ￣￣ ￣￣ ↑ @Hの ｜@A 第2ﾊﾟﾗﾒｰﾀ ｜ ＿＿ ＿＿ ＿＿ ＿＿ ↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号2:三角波 振幅バラメータ：＋ @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿ ←──→＼ ／＼ ／ ↑ @Hの ＼ ／ ＼ ／ ｜ 第2ﾊﾟﾗﾒｰﾀ |＼ ／ ＼ ／ ｜@Aのパラメータ | ＼／ ＼／ ↓ ←→ ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号2:三角波 振幅バラメータ：− @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿ ←──→ ／＼ ／＼ ↑ @Hの ／ ＼ ／ ＼ ｜ 第2ﾊﾟﾗﾒｰﾀ ／| ＼ ／ ＼ ｜@Aのパラメータ ／ | ＼／ ＼ ↓ ←→ ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号3:鋸歯波シングル 振幅パラメータ:＋ @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿ ←──→＼ ↑ @Hの ＼ ｜ 第2ﾊﾟﾗﾒｰﾀ ＼ ｜@A |＼↓ | |￣￣￣￣￣￣￣￣￣￣￣￣￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号3:鋸歯波シングル 振幅パラメータ:− @Cの 第3ﾊﾟﾗﾒｰﾀ→＿＿＿＿ ＿＿＿＿＿＿＿＿＿＿＿＿＿ ←──→ ／↑ @Hの ／ ｜@A 第2ﾊﾟﾗﾒｰﾀ ／ ｜ ／| ↓ | | ￣ @Sの第2ﾊﾟﾗﾒｰﾀ 波形番号8〜31:ユーザー波形 振幅パラメータ：＋ 波形データ列が＋5,−5,＋10,＋3,0の場合・・・ +10 +5 ￣￣ @Cの ￣￣ ＿＿ 0 第3ﾊﾟﾗﾒｰﾀ→──── +3 ── ←──→ ＿＿ @Hの -5 第2ﾊﾟﾗﾒｰﾀ ←→ @S第2ﾊﾟﾗﾒｰﾀ 波形番号8〜31:ユーザー波形 振幅パラメータ：− 波形データ列が＋5,−5,＋10,＋3,0の場合・・・ +5 @Cの ￣￣ 0 第3ﾊﾟﾗﾒｰﾀ→──── -3 ── ←──→＿＿ ￣￣ @Hの -5 ＿＿ 第2ﾊﾟﾗﾒｰﾀ -10 ←→ @S第2ﾊﾟﾗﾒｰﾀ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 波形メモリの応用例 ┃ ┃ ┃ ┃ ┃ ┃・ＦＭ音源のピッチ・モジュレーションで使う場合 　　　　　　 ┃ ┃ ┃ ┃ 波形データは半音を64とした値で処理されます。各値がそのチャンネルの ┃ ┃ ┃ ┃ディチューンと加算されて、それがその瞬間のピッチとして決定されます。 ┃ ┃ ┃ ┃例えばディチューンが10の時に波形メモリのデータが0,5,−5の時は ┃ ┃ ┃ ┃10＋0＝10, 10＋5＝15, 10−5＝5がそれぞれその瞬間のピッチになります。 ┃ ┃ ┃ ┃例 ┃ ┃ (t1) @m1 @s6 s8 @h40 順位相で波形メモリ８番をFM･PMで実行　 ┃ ┃ (t1) @m-1 @s6 s8 @h40 逆位相で波形メモリ８番をFM･PMで実行 ┃ ┃ ┃ ┃ ┃ ┃・ＦＭ音源のアンプリチュード・モジュレーションで使う場合 ┃ ┃ ┃ ┃ 波形データはそのチャンネルのボリューム値に加算され、その和がその瞬間の ┃ ┃ ┃ ┃音量として決定されます。音量の範囲は0〜127ですがこの範囲を越えた場合は ┃ ┃ ┃ ┃この範囲内に修正されます。例えば音量が＠Ｖ125のとき波形メモリのデータが ┃ ┃ ┃ ┃0,5,−5の時は125＋0＝125, 125＋5＝127(130), 125−5＝120がそれぞれその瞬間の ┃ ┃ ┃ ┃音量になります。 ┃ ┃ ┃ ┃例 ┃ ┃ ┃ ┃ (t1) @a1 @s,6 s,8 @h,40 順位相で波形メモリ８番をFM･PMで実行 ┃ ┃ (t1) @a-1 @s,6 s,8 @h,40 逆位相で波形メモリ８番をFM･PMで実行 ┃ ┃ ┃ ┃ ┃ ┃・ＭＩＤＩ音源のピッチ・モジュレーションで使う場合 ┃ ┃ ┃ ┃ 拡張モジュレーション・モード時のみ有効です。効果はＦＭ音源と同じです。 ┃ ┃ ┃ ┃拡張モジュレーション・モードには振幅を半音＝64にするか半音≒683(ベンドレンジ┃ ┃ ┃ ┃＝12の時)にするかの２つのモードがありますが波形データはこの影響を受けます。 ┃ ┃ ┃ ┃たとえば波形データが683であったとすると半音＝64モード時には683/64≒10半音分 ┃ ┃ ┃ ┃の変化量になりますが半音≒683モード時には1半音分の変化量となります。 ┃ ┃ ┃ ┃用途や趣味に合わせて使い分けて下さい。 ┃ ┃ ┃ ┃例 ┃ ┃ (t1) m1 @m1 @s6 s8 @h40 順位相で波形メモリ８番をMIDI･拡張PMで実行 ┃ ┃ (t1) m1 @m-1 @s6 s8 @h40 逆位相で波形メモリ８番をMIDI･拡張PMで実行 ┃ ┃ ┃ ┃ ┃ ┃・ＭＩＤＩ音源の拡張ＡＲＣＣで使う場合 ┃ ┃ ┃ ┃ 波形メモリは拡張ＡＲＣＣモード時にのみ有効です。各波形データは ┃ ┃ ┃ ┃ＡＲＣＣニュートラル値(＠Ｃの第3パラメータ)と加算して、その和が ┃ ┃ ┃ ┃コントロールチェンジへ出力されます。応用次第で ┃ ┃ ┃ ┃疑似ランダム・オート・パンポットやＦＭ音源の様な自由波形による ┃ ┃ ┃ ┃音量モジュレーションなども実現できます。 ┃ ┃ ┃ ┃例 ┃ ┃ (t1) m,1 @a1 @s,6 s,8 @h,40 順位相で波形メモリ８番をMIDI･拡張ARCCで実行┃ ┃ (t1) m,1 @a-1 @s,6 s,8 @h,40 逆位相で波形メモリ８番をMIDI･拡張ARCCで実行┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ { -- ZM6.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ６ ＡＤＰＣＭを扱う ここではＺＭＵＳＩＣシステムでのＡＤＰＣＭデータの取り扱いと、 支援ツール「ＺＰＣＮＶ．Ｒ」「ＺＰＬＫ．Ｒ」について解説します。 ６．１． はじめに ＺＭＵＳＩＣ起動時には当然だがＡＤＰＣＭ音は一つもプリセットされて いない。よってＡＤＰＣＭ音を鳴らすためにはＺＭＵＳＩＣに鳴らしたい ＡＤＰＣＭ音ファイルを登録することが必要になる。 ＺＭＵＳＩＣにＡＤＰＣＭデータを渡す方法は３通りあり、１つは ＡＤＰＣＭ登録コマンドをミュージック・プログラムに直接記述していく方法。 ２つめはＡＤＰＣＭ登録ＺＭＳコマンドを記述したファイルをエディタ （ＥＤ．Ｘ等）で作成しこれを渡す方法である。 ３つ目はそのファイルをＺＰＣＮＶ．ＲでＺＰＤファイルにコンバートし これをＺＭＵＳＩＣに渡す方法である。 ６．２． ＡＤＰＣＭコンフィギュレーションファイル ＡＤＰＣＭ登録ＺＭＳコマンドを箇条書きにしたファイルを、特に 「ＡＤＰＣＭコンフィギュレーションファイル」と呼び、これをＺＭＵＳＩＣへ 受け渡すことでＡＤＰＣＭデータを登録することができる(奨励ファイル拡張子は '.CNF')。 ＡＤＰＣＭ登録ＺＭＳコマンドは <音階>＝<ＡＤＰＣＭファイルネーム>[,ＡＤＰＣＭ加工オプションスイッチ] のスタイルをとるが(下図、MEASURE4参照)、この各パラメータについて詳しく 解説をする。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−┃ ┃●ＡＤＰＣＭコンフィギュレーション ┃ ┃−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−┃ ┃n ファイルネーム,Pp,Vv,Mm,d,Cc,s,R,Ff,l ┃ ┃ ＡＤＰＣＭ音の登録 ┃ ┃ n＝設定音色番号(0〜511) ┃ ┃ p＝ピッチシフトパラメータ(−12〜12) ┃ ┃ v＝ボリュームパラメータ(1〜100(原音量)〜300) ┃ ┃ m＝ミキシングノート番号(0〜511) ┃ ┃ d＝ミキシングディレイパラメータ(0〜65535) ┃ ┃ c＝カット・オフセットパラメータ(0〜65535) ┃ ┃ s＝カット・サイズ(0〜65535) ┃ ┃ f＝フェード・イン／アウトオフセット(0〜65535) ┃ ┃ l＝フェード・イン／アウトレベル(0〜127) ┃ ┃ ファイルネーム以降は省略可能。 ┃ ┃ (MEASURE3 m_pcmset()参照) ┃ ┃−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−┃ ┃.ADPCM_BANK n ┃ ┃ ＡＤＰＣＭ音の登録先のバンクを指定 ┃ ┃ n＝バンク番号(1≦n≦4) ┃ ┃−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−┃ ┃.Onk ファイルネーム,Pp,Vv,Mm,d,Cc,s,R,Ff,l ┃ ┃ ＡＤＰＣＭ音の登録 ┃ ┃ n＝オクターブ値(−1〜9) ┃ ┃ k＝音階MML(abcdefg,#,+,-) ┃ ┃ p＝ピッチシフトパラメータ(−12〜12) ┃ ┃ v＝ボリュームパラメータ(1〜100(原音量)〜300) ┃ ┃ m＝ミキシングノート番号(0〜511) ┃ ┃ d＝ミキシングディレイパラメータ(0〜65535) ┃ ┃ c＝カット・オフセットパラメータ(0〜65535) ┃ ┃ s＝カット・サイズ(0〜65535) ┃ ┃ f＝フェード・イン／アウトオフセット(0〜65535) ┃ ┃ l＝フェード・イン／アウトレベル(0〜127) ┃ ┃ ファイルネーム以降は省略可能。登録先ノート番号やミキシングノート番号は ┃ ┃ '.ADPCM_BANK'命令のバンク番号が考慮される。 ┃ ┃ (MEASURE3 m_pcmset()参照) ┃ ┃−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ●音階 ＡＤＰＣＭ音を鍵盤上の一体どこに割り当てるのかを指定するパラメータ。 先頭にピリオド'.'またはシャープ'#'をつけてオクターブＭＭＬと音階ＭＭＬを 記述することによって指定する方法と0〜511の登録先ノートナンバーを書いて 登録する方法がある 音階ＭＭＬ指定の場合はオクターブ−１のドからオクターブ９のソ(.O−1C〜.O9G) までの128から選択して指定できる。 ＺＭＵＳＩＣではＡＤＰＣＭは４つのグループ（バンク）に分けて管理ができ、 音階で登録する時はこのバンク内への登録となる。つまり、音階ＭＭＬ指定の 場合には、まず、登録先のバンクを決定し、それからそのバンク内の 音階を選択するというプロセスで行う。同一バンク内の登録は一度 バンク決定コマンドを実行すれば２回目は不用である。 ノートナンバー指定の場合はこのセレクトしたバンクを超えた登録が可能である。 以下にその対応を示す。 ＡＤＰＣＭノート番号＝(バンク番号−1)×128＋(オクターブ＋1)×12＋音階 ＡＤＰＣＭノート番号:0〜511 バンク番号:1〜4 オクターブ:−1〜9 音階:CDEFGABがそれぞれ0〜11に対応 ＡＤＰＣＭノート番号 バンク１ 0〜127 バンク２ 128〜255 バンク３ 256〜383 バンク４ 384〜511 ●ＡＤＰＣＭファイルネーム 登録したいＡＤＰＣＭファイルをここに指定する。 ＡＤＰＣＭのファイルは環境変数"zmusic"にパスを記述しておけば （囲み参照）カレントからファイルが見つからない場合はそちらからも 検索してくれる。 また、ここに音階ＭＭＬやノートナンバーを書くことによって、すでに登録した ＡＤＰＣＭ音を参照することが出来る。同じ音を二重に登録したり、ＡＤＰＣＭ音を 二重に加工したい場合などに便利である。 ●ＡＤＰＣＭ加工オプションスイッチ 単に記憶デバイスにあるＡＤＰＣＭファイルを登録するだけでなくＺＭＵＳＩＣでは そのデータに加工を施して登録することが出来る。 ・音程変更 'Ｐ'(小文字も可)の後ろに−12〜＋12の数値を書くことによってＡＤＰＣＭ音の 音程を半音単位で変えることが出来る。 ・音量変更 'Ｖ'(小文字も可)の後ろに1〜300の数値を書くことによってＡＤＰＣＭ音の音量を パーセント単位で変えることが出来る。 ・切り出し 'Ｃ'(小文字も可)の後ろにオフセット値と切り出しサイズを記述することによって ＡＤＰＣＭデータ中の任意の一部分を取り出すことが出来る。 サイズを省略するとオフセットより後ろすべてを切り出すことになる。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ size(0〜65535) ┃ ┃ ←──────→ ┃ ┃ ┌───────┬───────┬───┐ ┃ ┃ │ │ 有効部分 │ │ ┃ ┃ └───────┴───────┴───┘ ┃ ┃ ───────→ ┃ ┃ offset(0〜65535) ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ・逆転 'Ｒ'(小文字も可)を書くことによって逆転再生を指定することが出来る。 ・フェード・イン／フェード・アウト 'Ｆ'(小文字も可)の後ろにオフセット値とスタートレベル(フェード・イン時)、 またはエンドレベル(フェード・アウト時)を設定すると波形のエンベロープを 変更することが出来る。オフセットの値を正にすることでフェード・アウト、 負にすることでフェード・インの指定となる。 パラメータは両方とも省略可能だが、ただしその場合は両パラメータとも0が 設定される（「データ先頭からフェード・アウト」に相当）。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ offsetを正の値にした場合 ┃ ┃ ┃ ┃ 128＿＿＿＿＿＿＿ ┃ ┃ |＼ ┃ ┃ | ＼ ┃ ┃ | ＼ ┃ ┃ | ＼ ┃ ┃ | ↑ level ┃ ┃ | │(0〜127) ┃ ┃ 0￣￣￣￣￣￣￣￣￣￣￣ ┃ ┃ ──────→ ┃ ┃ offset(0〜65535) ┃ ┃ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ offsetを負の値にした場合 ┃ ┃ ┃ ┃ 128 ＿＿＿＿＿＿＿ ┃ ┃ ／| ┃ ┃ ／ | ┃ ┃ ／ | ┃ ┃ ／ | ┃ ┃ level ↑ | ┃ ┃ (0〜127)│ | ┃ ┃ 0￣￣￣￣￣￣￣￣￣￣￣ ┃ ┃ ←─── ┃ ┃ offset(−1〜−65535) ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━┛ ・合成 'Ｍ'(小文字も可)の後ろに0〜511の数値または音階ＭＭＬを書くことによって そのノート番号や音階に以前登録されたＡＤＰＣＭ音と合成することが出来る。 さらにその後ろに , で区切った後で数値を書くとそのバイト数分遅らせて 合成することが出来る。 ●注意 ＡＤＰＣＭ加工オプションスイッチは、いずれも省略可能で、どれか１つのみの 指定でも構わない。また加工のプロセスは各スイッチの設定順序には無関係で 図３のような処理順序で行われる。 また、ＡＤＰＣＭ登録コマンドでＺＭＵＳＩＣにＡＤＰＣＭを登録する時、 ＡＤＰＣＭ加工スイッチを用いる場合にはＺＭＵＳＩＣの組み込みスイッチの '−Ｗ'でワークエリアを十分に取っておかないとエラーとなる(目安としては コンフィギュレーションファイル内に存在する最大ファイルサイズの４倍くらい。 ミックスを用いる場合は更にその２倍くらい)。エラーとなった場合は加工も 指定されたノートへの登録も行われない。後述のＺＰＣＮＶ．ＲでＺＰＤを 作成する場合にはＺＭＵＳＩＣは無関係なのでＡＤＰＣＭバッファや ワークエリアの確保は不要である。 ┏━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 音程・音量変更 ┃ ┃ ↓ ┃ ┃ 切り出し ┃ ┃ ↓ ┃ ┃ 逆転 ┃ ┃ ↓ ┃ ┃ フェード・イン／フェード・アウト ┃ ┃ ↓ ┃ ┃ 合成 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━┛ ●例 .ADPCM_BANK 2 .o2c=BASS.PCM .o2d=SNARE.PCM,v150 バンク２のオクターブ２のｃ(ＡＤＰＣＭノート番号＝164)に"BASS.PCM"を、 そしてオクターブ２のd(ＡＤＰＣＭノート番号＝166)に"SNARE.PCM"を ボリューム150%にして登録する。 .o2d=SNARE.PCM,cV150,P+4 .o2d#=CLAP.PCM,mo2d "SNARE.PCM"をボリューム150%にし、さらに4半音下げたものをオクターブ２のdへ 登録。そしてこれと"CLAP.PCM"を合成したものをオクターブ２のd#へ登録する。 .o3d=CYMBAL.PCM,c1000,5000,r "CYMBAL.PCM"の1000バイト目から5000バイトを切り出し、これを逆転したものを オクターブ２のdへ登録する。 .o2e-=VOICE.PCM,f1000,20,m200,2000 "VOICE.PCM"の1000バイト目からデータ終端までを音量20まで滑らかに下げていき、 これに対してノート番号200(バンク２のオクターブ５のc)に登録されたデータを 2000カウント遅らせて合成してオクターブ２のe♭へ登録する。 ●ＡＤＰＣＭコンフィギュレーション・ファイルのＺＭＵＳＩＣへの登録法 ＭＵＳＩＣＺ．ＦＮＣを用いてＸ−ＢＡＳＩＣ上で作られた曲データ中に 指定したい場合は m_pcmcnf("ＡＤＰＣＭコンフィギュレーション・ファイルネーム") を使う(MEASURE3参照)。 ＺＭＳ中に指定したい場合は .adpcm_list ＡＤＰＣＭコンフィギュレーション・ファイルネーム を用いる(MEASURE4参照)。 また、通常の演奏データのように A>copy ＡＤＰＣＭコンフィギュレーション・ファイルネーム opm としたり A>zp ＡＤＰＣＭコンフィギュレーション・ファイルネーム のようにＺＭＵＳＩＣへ登録することも可能である(MEASURE7参照)。こちらの場合は 曲がたとえ演奏中であってもリアルタイムにＡＤＰＣＭセットを変更することが出来る。 また、ＺＭＵＳＩＣ常駐スイッチの'−Ｓ'を用いて A>zmusic -w50 -p200 -sdrum.cnf (拡張子の省略は不可) のようにＺＭＵＳＩＣ常駐時にＡＤＰＣＭコンフィギュレーション・ファイルを 登録することも出来る。ただし、その際には必要分のワークやＡＤＰＣＭバッファを 確保しなければならない。 ６．３． ＺＰＣＮＶ．ＲとＺＰＤ ＺＰＣＮＶ．Ｒは、前節で解説したコンフィギュレーションファイルに従って必要な ＡＤＰＣＭデータをひとつのファイルにまとめてしまうアプリケーションである。 ひとまとめにする際に音程音量変換、合成作業といった加工処理もしてしまうため ＡＤＰＣＭデータの登録処理にかかる時間は極めて少なくて済む（ＡＤＰＣＭ コンフィギュレーション・ファイルをＺＭＵＳＩＣへ渡す方式では１個１個のデータを 読み込み、それから加工を行ったりするため、大量のＡＤＰＣＭデータを 登録する場合には、フロッピーディスクなどの中／低速メディアユーザーや １０ＭＨｚマシンユーザーは処理が終了するまで長時間待たされることがある)。 加工処理ルーチンやその際に使用するワークはＺＰＣＮＶ．Ｒが独自で持っているため、 実行にはＺＭＵＳＩＣの常駐は必要ない。 ＺＭＵＳＩＣではＡＤＰＣＭコンフィギュレーション・ファイルをもとに ひとまとめにしたこのデータをＡＤＰＣＭブロックデータ、「ＺＰＤ」と呼ぶ。 ●ＺＰＣＮＶ．Ｒの使い方 A>zpcnv filename1 filename2 とするだけで良い。ワークエリアなどの指定は一切不要である。 filename1はコンバートしたいコンフィギュレーションファイル名(拡張子を省略した時は '.CNF'が自動添付される)。 filename2は出来たブロックデータのファイルネームでこちらは省略することが可能。 省略時はfilename1に拡張子'.ZPD’を付けたものでセーブされる。 ●ＺＰＣＮＶ．Ｒ専用ＺＭＳ命令 例えば .o2d=SNARE.PCM,v150,p+4 .o2d#=CLAP.PCM,mo2d ("SNARE.PCM"をボリューム150%にし、さらに4半音下げたものをオクターブ２のdへ 登録。そしてこれと"CLAP.PCM"を合成したものをオクターブ２のd#へ登録する) というケースで、得たいのが.o2d#の方のみで.o2dは単なるテンポラリー的な 存在でしか無かった時に、 .ERASE o2d をコンフィギュレーションファイル後尾に設定すると、そのデータを除外して ＺＰＤを生成してくれる。 不本意にＺＰＤが大きくなるのを防ぐことができる。 本命令はＺＰＣＮＶ．Ｒ専用のＺＭＳ命令でＺＭＵＳＩＣの曲データ中に 指定しても(エラーにはならないが)機能はしないダミー命令として扱われる。 ●ＺＰＤのＺＭＵＳＩＣへの登録法 ＭＵＳＩＣＺ．ＦＮＣを用いてＸ−ＢＡＳＩＣ上で作られた曲データ中に 指定したい場合は m_adpcm_block("ＡＤＰＣＭコンフィギュレーション・ファイルネーム") を使う(MEASURE3参照)。 ＺＭＳ中に指定したい場合は .adpcm_block_data ＡＤＰＣＭコンフィギュレーション・ファイルネーム を用いる(MEASURE4参照)。 また、通常の演奏データのように A>copy ＡＤＰＣＭコンフィギュレーション・ファイルネーム opm としたり A>zp ＡＤＰＣＭコンフィギュレーション・ファイルネーム のようにＺＭＵＳＩＣへ登録することも可能である(MEASURE7参照)。こちらの場合は 曲がたとえ演奏中であってもリアルタイムにＡＤＰＣＭセットを変更することが出来る。 また、ＺＭＵＳＩＣ常駐スイッチの'−Ｂ'を用いて A>zmusic -bdrum_set.zpd (拡張子の省略は可能) のようにＺＭＵＳＩＣ常駐時にＺＰＤを登録することも出来る。ワーク等の指定は 不要で、ＡＤＰＣＭバッファの確保は自動的に行われる。 ６．４． ＡＤＰＣＭバッファが０の時、不足している時 ＡＤＰＣＭバッファを確保しなかった場合はＡＤＰＣＭ関連の命令を用いると エラーになります。 ＺＰＤを登録しようとした時にバッファが必要分より少ない場合はエラーと なりますが、ＡＤＰＣＭ登録コマンドでＺＭＵＳＩＣにＡＤＰＣＭを登録しよう とした時にバッファが不足している時はいちばん古く登録したものが切り捨てられ 登録されます。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 環境変数zmusicについて ┃ ┃ ┃ ┃ ┃ ┃ ＺＭＵＳＩＣでは、カレントよりファイルが見つからない場合は ┃ ┃ ┃ ┃環境変数'zmusic'に書かれたパスにしたがってファイルを検索します。なお、 ┃ ┃ ┃ ┃ＺＭＵＳＩＣシステムではＡＤＰＣＭデータに限らずファイルを読み込む時は ┃ ┃ ┃ ┃必ずこのルールに従うので、ハードディスク上など多くのディレクトリに分散されて┃ ┃ ┃ ┃必要ファイルが収められている時は、なるべく設定しておくべきです。 ┃ ┃ ┃ ┃設定例 ┃ ┃set zmusic=a:\drums;a:\pcmfiles;b:\rythm\snare; ┃ ┃ ↑小文字のみ可 ┃ ┃ ┃ ┃ 環境変数はHuman68kの仕様から255文字を超えて設定することはできません。 ┃ ┃ ┃ ┃255文字を超えてZ-MUSICのファイルパスを記述したい場合には、環境変数zmusic0〜 ┃ ┃ ┃ ┃zmusic9に分けて設定して下さい。この時環境変数zmusicは木でいう幹に、 ┃ ┃ ┃ ┃環境変数zmusic0〜zmusic9は枝の扱いになります。幹から枝への参照は、 ┃ ┃ ┃ ┃環境変数zmusic中に'/'とその後ろに補助環境変数zmusic0〜zmusic9までを表す ┃ ┃ ┃ ┃数値'0'〜'9'を書き、さらにその後ろにベースとなるパスを書くことによって ┃ ┃ ┃ ┃指定できます。 ┃ ┃ ┃ ┃例えば ┃ ┃ ┃ ┃zmusic標準のADPCMライブラリのディレクトリ名である ┃ ┃ ┃ ┃BASS, SNARE, TOMTOM, CYMBAL, ETHNIC, EFFECTS, ACCENT, ORCH, RAP, ADDITION ┃ ┃ ┃ ┃を検索させる場合を考えます。これらのディレクトリが、ＦドライブのADPCM_LIB ┃ ┃ ┃ ┃の下に存在する場合、 ┃ ┃ ┃ ┃SET zmusic=/0F:\ADPCM_LIB; ┃ ┃ ↑^zmusic0を示す数値 ┃ ┃ 補助環境変数の検索を指示するコマンド記号'/'。('-'で代用も可能) ┃ ┃ ┃ ┃SET zmusic0=BASS;SNARE;TOMTOM;CYMBAL;ETHNIC;EFFECTS;ACCENT;ORCH;RAP;ADDITION┃ ┃ ┃ ┃と指定すればよいことになります。これで ┃ ┃ ┃ ┃ F:\ADPCM_LIB\BASS, F:\ADPCM_LIB\SNARE, F:\ADPCM_LIB\TOMTOM, ┃ ┃ F:\ADPCM_LIB\CYMBAL, F:\ADPCM_LIB\ETHNIC, F:\ADPCM_LIB\EFFECTS, ┃ ┃ F:\ADPCM_LIB\ACCENT, F:\ADPCM_LIB\ORCH, F:\ADPCM_LIB\RAP, ┃ ┃ F:\ADPCM_LIB\ADDITION ┃ ┃ ┃ ┃を検索するようになります。通常の表記との混在ももちろん可能です。 ┃ ┃ ┃ ┃設定例 ┃ ┃ ┃ ┃SET zmusic=A:\ZPD_DATA;A:\PCMFILES;F:\BOSPCM;/0F:\ADPCM_LIB;/1F:\MUSIC_DATA;┃ ┃SET zmusic0=BASS;SNARE;TOMTOM;CYMBAL;ETHNIC;EFFECTS;ACCENT;ORCH;RAP;ADDITION┃ ┃SET zmusic1=SC55_DATA;CM64_DATA;INTERNAL_DATA; ┃ ┃ ┃ ┃また、補助環境変数zmusic0〜zmusic9をカテゴリに分類して検索パスを設定すれば ┃ ┃ ┃ ┃簡潔にデータ格納ディレクトリ検索パスを記述することができます。上はzmusic0を ┃ ┃ ┃ ┃ADPCMライブラリ、zmusic1を曲データのライブラリとして管理した例です。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ６．５．ＰＣＭファイルリンカ「ＺＰＬＫ．Ｒ」 ＺＭＵＳＩＣシステム・バージョン２．０より、AD PCMデータの加工・リンクツール 「ＺＰＬＫ．Ｒ」を正式な支援ツールとして追加した。 ●その機能と特長 ・最大３２個の複数のファイルをつなげて１つのファイルにして出力できる。 １つのファイルにつき最大６５５３５回の反復指定が可能。反復パターンは４種類。 ・単一ファイルをいくつもつなげて１つの大きなファイルにすることも可能。 ・入力ファイルとして１６ビットＰＣＭファイル、ＡＤＰＣＭファイルを 与えることができる。混在も可能。 ・リンク作業の前に、各入力ファイルのサブ・データコンバートを行なうことが できるので１６ビットＰＣＭにＡＤＰＣＭファイルをリンクさせたり、また、 その逆も可能。 ・出力ファイルはその出力直前に１６ビットＰＣＭデータコンバート、 ＡＤＰＣＭデータコンバート、逆転再生、音量変換、周波数変換、ポルタメント、 エンベロープ変更など多彩な加工処理を行なう事ができる。 ・インパルス・データを与えることにより、たたみ込み演算を行なうことができる。 したがって、任意の音声データに対してホールの残響効果やボコーダー処理などの 本格的なエフェクト処理をすることができる。 ●文法 ZPLK.R <[オプション1] 入力ﾌｧｲﾙ1> [[オプション2〜32] 入力ﾌｧｲﾙ2〜32] <出力ﾌｧｲﾙ名> 　入力ファイルネームは最低１個は必要。書き込みファイル名は'PCM'に設定すると ファイルを書き出さず、音声として出力できる(ZMUSIC.XやPCMDRV.SYS組み込み時)。 ファイルネームの指定は拡張子やパスの省略をせずきちんと書くこと。ファイルが カレントより見つからない場合は環境変数'zmusic'に書かれたパスにしたがって ファイルを検索する。 ●オプションスイッチ -A 出力ファイルを出力する前にそのデータを１６ビットＰＣＭデータと 見なしてＡＤＰＣＭデータへ変換する。 -Bs,d,p,s 出力ファイルを出力する前にそのデータを１６ビットＰＣＭデータと 見なしてポルタメントを行なう。(連続的に滑らかに周波数変更を行なう。) s 開始時の周波数をs[Hz]とみなす。ただしsは1〜65535。 d 終了時の周波数をd[Hz]とする。ただしdは1〜65535。 p 出力ファイルのpバイト目から周波数変換を行なう。省略時はp=0。 s 変換するサイズをsバイトとする。省略時はpで指定された位置から 後ろ全部を変換対象領域とする。pも省略した場合は出力全域に対して 変換処理を施す。 -Cp,s 出力ファイルを出力する前にそのデータの任意の一部分を摘出しそれを 出力する。 p 出力ファイルのpバイト目から切り出す。省略時はp=0。 s 切り出すサイズをsバイトとする。省略時はpで指定された位置から 後ろ全部を切り出す。pも省略した場合はエラーとなる。 -Fs,l,m 出力ファイルを出力する前にそのデータを１６ビットＰＣＭデータと 見なしてエンベロープの形状を変化させる。 s 出力ファイルのsバイト目からエンベロープ形状を変更する。 省略時はs=0。 l エンベロープ形状初期音量(m=0時)／最終音量(m=1時)を0〜127の128段階で 設定する。省略時はl=0。 m エンベロープの変更パターンを設定する。省略時はm=1 0 フェード・イン・タイプ 1 フェード・アウト・タイプ -Ifilename インバルスデータのファイルネームを与えると出力ファイル出力する前に 　 そのデータとのたたみ込み演算を行なう。ただし、与えられたファイルネームの 拡張子を'.P16'とした場合はそのインパルスデータを１６ビットＰＣＭデータ、 '.PCM'とした場合はＡＤＰＣＭデータとしてみなす。 -P 出力ファイルを出力する前にそのデータをＡＤＰＣＭデータと見なして １６ビットＰＣＭデータへ変換する。 -R 出力ファイルを出力する前にそのデータを１６ビットＰＣＭデータと 見なして逆転させる。 -Vn 出力ファイルを出力する前にそのデータの音量をパーセント単位で 指定する。nの範囲は0〜300。スイッチ無指定や値省略時は100とする。 -Ti,o,p,s 出力ファイルを出力する前にそのデータを１６ビットＰＣＭデータと 見なして周波数の変更を行なう。 i 元の周波数をs[Hz]とみなす。ただしsは1〜65535。 o 変換後の周波数をd[Hz]とする。ただしdは1〜65535。 p 出力ファイルのpバイト目から周波数変換を行なう。省略時はp=0。 s 変換するサイズをsバイトとする。省略時はpで指定された位置から 後ろ全部を変換対象領域とする。pも省略した場合は出力全域に対して 変換処理を施す。 -Xl,r,t リンク制御 l ループタイプの設定。省略時 l=0。 0 そのまま。 1 正順、逆順の順にループさせる。 2 逆順、正順の順にループさせる。 3 入力ファイルの逆順をループさせる。 r 反復回数の設定。省略時 r=1。範囲1〜65535。 t リンク作業の前に入力ファイルに対して加工を行なう。省略時 t=0。 0 何も行なわない。 1 入力ファイルを１６ビットＰＣＭデータと見なしてＡＤＰＣＭデータへ 変換する。 2 入力ファイルをＡＤＰＣＭデータと見なして１６ビットＰＣＭデータへ 変換する。 ☆注意☆ 複数の変換を指定した場合は以下の手順で各変換を行なう。 ┏━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 音量変更周波数変換 ┃ ┃ ↓ ┃ ┃ ポルタメント ┃ ┃ ↓ ┃ ┃ 切り出し ┃ ┃ ↓ ┃ ┃ 逆転 ┃ ┃ ↓ ┃ ┃ フェード・イン／フェード・アウト ┃ ┃ ↓ ┃ ┃ インパルス演算 ┃ ┃ ↓ ┃ ┃ １６ビットＰＣＭ／ＡＤＰＣＭ変換 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━┛ ●パラメータの特殊設定 周波数変換(-Tスイッチ)、ポルタメント変換(-Bスイッチ)において、２つの 周波数パラメータの設定をするかわりにＺＭＵＳＩＣシステムで御馴染みの 半音ステップの変換パラメータで設定することもできる。 例えばある音を半音下げたい時には -Tp-1 また、半音上げたい時は -Tp+1 とします。また、ポルタメントの時も同様で -Bp-10 -Bp+6 といった記述ができる。サブスイッチ'p'の値の範囲は-144〜+144(ただし0は除く)。 ●使用例 A>zplk a.p16 -x0,10 b.p16 -a c.pcm a.p16 というファイルの後ろに b.p16 を１０回くっつけて、 ADPCMへコンバートし c.pcm というファイル名でセーブする。 A>zplk -x0,5 a.p16 -x,,2 b.pcm -v80 c.p16 a.p16 というファイルを５回繰り返し、これに b.pcm を１６ビットＰＣＭへ 変換したものをくっつけて、それを音量を80%に設定し c.p16 という ファイル名でセーブする。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 国際基準イ＝ａ1=４４０Ｈｚに基づく１２平均率音階周波数表 ┃ ┃ (試験に出るＸ１より転載) ┃ ┃ (単位はHz) ┃ ┃ O0 O1 O2 O3 O4 O5 O6 O7 O8 ┃ ┃Ｃ 16.352 32.703 65.406 130.81 261.63 523.25 1046.5 2093.0 4186.0┃ ┃Ｃ＃ 17.324 34.648 69.296 138.59 277.18 554.37 1108.7 2217.5 4434.9┃ ┃Ｄ 18.354 36.708 73.416 146.83 293.66 587.33 1174.7 2349.3 4698.6┃ ┃Ｄ＃ 19.445 38.891 77.782 155.56 311.13 622.25 1244.5 2489.0 4978.0┃ ┃Ｅ 20.602 41.203 82.407 164.81 329.63 659.26 1318.5 2637.0 5274.0┃ ┃Ｆ 21.827 43.654 87.307 174.61 349.23 698.46 1396.9 2793.8 5587.7┃ ┃Ｆ＃ 23.125 46.249 92.499 185.00 369.99 739.99 1480.0 2960.0 5919.9┃ ┃Ｇ 24.500 48.999 97.999 196.00 392.00 783.99 1568.0 3136.0 6271.9┃ ┃Ｇ＃ 25.957 51.913 103.83 207.65 415.30 830.61 1661.2 3322.4 6644.9┃ ┃Ａ 27.500 55.000 110.00 220.00 440.00 880.00 1760.0 3520.0 7040.0┃ ┃Ａ＃ 29.135 58.270 116.54 233.08 466.16 932.33 1864.7 3729.3 7458.6┃ ┃Ｂ 30.868 61.735 123.47 246.96 493.88 987.77 1975.5 3951.1 7902.1┃ ┃ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ { -- ZM7.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ７ プレイヤーＺＰ．Ｒ ここではＺＭＵＳＩＣ．Ｘ支援ツールのサンプルとして作成した プレイヤー「ＺＰ．Ｒ」について解説します。 ７．１． ＺＰ．Ｒについて ＺＭＵＳＩＣ．Ｘは A>copy ファイルネーム opm とすることでコマンドラインから演奏データの演奏を行える。また、 A>copy con opm としたあと、ＺＭＳコマンドを入力することによって演奏の停止や継続、 再演奏などの制御を行うことが出来る。これらの演奏制御をより快適に、 手軽に行えるようにするために開発されたのがＺＰ．Ｒである。 ＺＰ．Ｒは演奏ツールとしての機能の他に「ジュークボックス機能」や 「トータルステップカウントの計算」「キーボードによるリアルタイム演奏制御機能 (デバッグツール)」などの機能が備わっている。 ７．２． コマンドスイッチについて ●演奏制御 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｐ 演奏データ・ファイルネーム,セットアップファイル１,…,セットアップファイル４ 演奏データをディスクから読み込んで演奏する。演奏データのファイル名の後ろに ','で区切って最高４つまでのセットアップファイルを演奏前に読み込み、実行が可能。 セットアップファイルとは、例えばＡＤＰＣＭデータのコンフィギュレーション・ファイル、 ＡＤＰＣＭのブロックデータ、ＭＩＤＩダンプデータ(ＭＤＤ)などのこと。（セットアップ ファイルのＭＩＤＩダンプデータは拡張子'.MDD'の時のみ有効） セットアップファイルの拡張子は省略出来ないが演奏データの方は拡張子を省略でき、 その場合は'.ZMD'→'.ZMS'→'.OPM'の順で自動添付してファイルを検索する(見つから なかった場合はエラー)。 例 A>zp -p music.zms, drum.cnf, u220_seup.mdd A>zp -p etude スイッチ'−Ｐ'は省略することもでき、上の例は A>zp music.zms, drum.cnf, u220_seup.mdd A>zp etude とすることも可能。 さらに、演奏データを省略してＺＰＤやＭＤＤ、ＡＤＰＣＭコンフィギュレーション ファイルといったセットアップファイルのみの実行も可能である(拡張子の省略は できない)。ＺＰＤとＡＤＰＣＭコンフィギュレーション・ファイルは曲が演奏中で あっても実行可能なので、演奏中の曲のＡＤＰＣＭのセットをリアルタイムに 変更することができる。 例 A>zp list.cnf (ＡＤＰＣＭコンフィギュレーション・ファイルlist.cnfを 実行する) A>zp drum_set.zpd (ＺＰＤファイルdrum_set.zpdを登録する) A>zp M1preset.mdd (ＭＤＤファイルM1preset.mddを楽器へ転送する) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｐn1,n2,n3,…ni 演奏を開始する。コマンドスイッチの後ろにトラック番号(1≦ni≦80)を書くと そのトラックのみ演奏を開始する。トラック番号は横につなげていくつでも 書くことが出来る。また、トラック番号を書かずにコマンドスイッチのみを 指定した場合は演奏可能な全てのトラックの演奏を開始する。 例 A>zp -p (全トラック演奏開始) A>zp -s1, 2, 10 (トラック1, 2, 10の演奏を開始する) (MEASURE3 m_play(), MEASURE4 (P)コマンド参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｓn1,n2,n3,…ni −Ｃn1,n2,n3,…ni それぞれ演奏の停止、再開を行う。 コマンドスイッチの後ろにトラック番号(1≦ni≦80)を書くとそのトラックに対して 機能する。トラック番号は横につなげていくつでも書くことができる。 また、トラック番号を書かずにコマンドスイッチのみを指定した場合は演奏中の 全トラックに対して機能する。 例 A>zp -s (全トラック演奏停止) A>zp -c (全トラック演奏再開) A>zp -s1, 2, 10 (トラック1, 2, 10の演奏を停止する) A>zp -c1, 2, 10 (トラック1, 2, 10の演奏を再開する) (MEASURE3 m_stop(), m_cont(), MEASURE4 (S)コマンド, (C)コマンド参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●チャンネル・マスク −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｅn1,n2,n3,…,ni 指定チャンネルのみを演奏しそれ以外のチャンネルの演奏をマスクする。 チャンネル番号はＰＣＭ８モードでない時は1≦ni≦25、ＰＣＭ８独立チャンネルモード では1≦ni≦32となる。チャンネル番号をすべて省略した場合は、マスクを総て解除 (全チャンネル演奏可能に)する。実行はリアルタイムに行うことができ、 演奏中の曲の任意のチャンネルをマスクしたり解除したりすることが可能。 例 A>zp -e1, 2, 3 (チャンネル1〜3以外をマスクする) A>zp -e (全チャンネルのマスクを解除する) チャンネル表現にFM1〜8, ADPCM1〜8, MIDI1〜16といった表記もできる。 例 A>zp -efm1, adpcm2, midi3 (MEASURE3 m_solo(), MEASURE4 (E)コマンド参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｍn1,n2,n3,…,ni 指定チャンネルの演奏をマスクする。それ以外のチャンネルは通常演奏を行う。 チャンネル番号はＰＣＭ８モードでない時は1≦ni≦25、ＰＣＭ８独立チャンネルモード では1≦ni≦32となる。チャンネル番号をすべて省略した場合は、マスクを総て解除 (全チャンネル演奏可能に)する。実行はリアルタイムに行うことができ、 演奏中の曲の任意のチャンネルをマスクしたり解除したりすることが可能。 例 A>zp -m1, 2, 3 (チャンネル1〜3をマスクする) A>zp -m (全チャンネルのマスクを解除する) チャンネル表現にFM1〜8, ADPCM1〜8, MIDI1〜16といった表記もできる。 例 A>zp -efm1, adpcm2, midi3 (MEASURE3 m_mute()参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●出力レベルの変更 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｆn フェード・イン／アウトを行う。−85≦n≦−1のときフェード・イン、 1≦n≦85のときフェード・アウトの指定となり、数値の絶対値が大きいほど音量の 増減スピードは速くなる。n＝0はフェード・イン／アウトの停止。 パラメータを省略した場合はデフォルト値のスピードでフェード・アウトを行う。 例 A>zp -f20 (フェード・アウトをフェード・アウト・スピード20で行う) A>zp -f-16 (フェード・インをフェード・イン・スピード16で行う) A>zp -f0 (フェード・イン／アウトを中断する) A>zp -f (デフォルトスピードでフェード・アウトを行う) (MEASURE3 m_fadeout(), MEASURE4 (F)コマンド参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｏlv,n1,n2,…,ni 指定チャンネルの出力割合を設定する。 lvは出力音量の割合で、設定範囲は0≦lv≦128。128が最大音量かつ基本状態。 lvの値が小さいほど音量も小さくなる。lvによって決定づけられる実際の音量は各楽器や 音源によって違うので注意(ＦＭ音源ではlv＝80付近でほとんど無音状態になる)。 niは出力割合lvの設定を行うチャンネル番号。チャンネル番号は ＰＣＭ８モードでない時は1≦ni≦25、ＰＣＭ８独立チャンネルモードでは1≦ni≦32 となる。lvのみを設定し、チャンネル番号をすべて省略した場合は、全チャンネル が出力レベルlvに設定される。 全パラメータを省略した場合は、全チャンネルの出力割合を基本状態(lv＝128)へ戻す。 実行はリアルタイムに行うことができ、演奏中の曲の任意のチャンネルの出力割合を 変更することが可能。 例 A>zp -o110, 1, 2, 3 (チャンネル1, 2, 3の出力割合を110/128に設定する) A>zp -o96 (全チャンネルの出力割合を96/128に設定する) A>zp -o (全チャンネルの出力割合を通常状態(128/128)に戻す) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●初期化 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｉ ＺＭＵＳＩＣの演奏ワークやＦＭ音源やＭＩＤＩ楽器等を初期化する。曲が演奏中 であれば演奏を停止してから処理を行う。 例 A>zp -i （MEASURE3 m_init(), MEASURE4 (I)コマンド参照） −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●トータルステップタイムの計算 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｑ −Ｑ演奏データ・ファイルネーム '−Ｑ'で、演奏中やその時点でＺＭＵＳＩＣのトラックバッファに格納されている 演奏データのステップタイムの合計値を計算し表示する。ファイル名を後ろに付ければ それを読み込みバッファに格納してから合計値を計算する。 [do]〜[loop]以外で(例えば[coda]〜[tocoda]によって)無限ループを構成している 曲に対してこれを実行すると無限に計算を繰り返してしまう(NMIを押すしかない)。 なお、 トラック番号：ループ外の総カウント数 ループ内の総カウント数 というフォーマットで出力される（16進数）。 例 A>zp -q A>zp -qmusic.zmd (MEASURE3 m_total(), MEASURE4 (Q)コマンド参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＭＩＤＩダンプデータ（ＭＤＤ）制御 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ａ ＭＩＤＩ楽器からのデータを受信するためにＺＭＵＳＩＣを待機状態にする。 (MEASURE3 m_rec(), MEASURE4 (R)コマンド, MEASURE9参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ａファイルネーム '−Ａ'として取り込んだ楽器のデータをファイルにセーブする。拡張子省略時は '.MDD'が自動的に添付される。ＺＭＵＳＩＣではこのファイルをＭＩＤＩダンプデータ (ＭＤＤ)と呼ぶ。 (MEASURE3 m_save(), MEASURE9参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｘファイルネーム '−Ａ'スイッチで作成したＭＩＤＩダンプデータを楽器へ転送する。拡張子を省略すると '.MDD'が自動添付される。 例 A>zp -xu220.mdd (MEASURE3 m_trans(), MEASURE4 .MIDI_DUMP命令, MEASURE9参照) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ジュークボックス機能 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｊインデックスファイル,セットアップファイル１,…,セットアップファイル４ '−Ｊ'を設定してその後ろにインデックスファイル(後述)の名前を書くとこれを読み込み このファイルに書かれた演奏データを読み込み、これらを次々に演奏する(ジューク ボックス機能)。インデックスファイルの拡張子を省略した場合は、拡張子'.JUK'が 自動添付される。 演奏開始指定のスイッチ'−Ｐ'と同様に４つまでセットアップファイルを指定すれば、 ジュークボックス開始前に、これらをまず実行することが出来る。 例 A>zp -jINDEX,MT32SOUND.MDD また、ジュークボックス機能実行中には以下のキー操作が可能となる。 [SHIFT]＋[OPT.1] 次の曲へ [SHIFT]＋[OPT.2] フェードアウトして次の曲へ [SHIFT]＋[CTRL] 演奏の一時停止／再開 [SHIFT]＋[XF4] 再演奏 [SHIFT]＋[XF5] フェードアウトして再演奏 [CTRL]＋[OPT.1] 前の曲へ [CTRL]＋[OPT.2] フェードアウトして前の曲へ ●インデックスファイル インデックスファイルは 繰り返し回数(1〜255)，演奏データファイル名 の書式をとる。ＺＰ．Ｒのジュークボックス機能では最大６４曲までの演奏データの 登録ができる。 演奏データはＺＭＤのみ有効。演奏データファイル名の拡張子は省略可能で、 省略時は'.ZMD'が自動添付される。 繰り返し回数は省略可能で省略時は繰り返し回数＝１が自動設定される。 インデックスファイルに書かれた最後の曲の演奏を完了すると最初の曲へ戻る。 例 2,ETUDE 3,PRELUDE FUGE ('ETUDE.ZMD'を２ループ演奏し、次に'PRELUDE.ZMD'を３ループ演奏し、最後に 'FUGE.ZMD'を１ループ演奏して、これが終了すると初めの'ETUDE.ZMD'へ戻る) なお、ジュークボックス演奏させるＺＭＤには以下の条件がある。 １．無限ループは[do]〜[loop]命令を使用している場合のみ有効。 ２．ジュークボックスで演奏させる曲データには、ＺＰＤ指定('.adpcm_block_data') 以外のＡＤＰＣＭデータ登録命令が存在してはならない(例えば'.adpcm_list'命令 や'.Onk ファイルネーム,Pp,Vv,Mm,d,Cc,s,R,Ff,l'命令)。 ●キー定義の変更 キーと機能の対応は上記のようにデフォルトでは定められているが、これを環境変数 'zp_jukectrl'にキービットマップ値を列記することによってユーザーの好みに変更可能 である。 set zp_jukectrl=<次の曲へ#1, 次の曲へ#2> <フェードアウト&次の曲へ#1,フェードアウト&次の曲へ#2> <停止/再開#1, 停止/再開#2> <再生#1, 再生#2> <フェードアウト&再生#1,フェードアウト&再生#2> <前の曲へ#1, 前の曲へ#2> <フェードアウト&前の曲へ#1,フェードアウト&前の曲へ#2> キー例 [SHIFT]=$E0 [CTRL]=$E1 [OPT.1]=$E2 [OPT.1]=$E3 [XF1]=$A5 [XF2]=$A6 [XF3]=$A7 [XF4]=$B0 [XF5]=$B1 設定例 set zp_keyctrl=$e2,$b1 $e3,$b1 $e3,$b1 $e3,$e0 $e2,$e0 $e3,$a7 $e0,$a6 ↑ 「次の曲へ」は[OPT.1]+[XF5]を意味する ●注意 ・インデックスファイルに指定されている曲やその曲が使用するデータは ジュークボックス機能開始前に読み込んでしまうため、多くのメモリを消費する。 しかし、ジュークボックス機能では、演奏データやその他の必要データを 先読みしてしまうため、ＺＭＵＳＩＣ．Ｘが確保した各バッファを一切使用しない。 よってＺＭＵＳＩＣ．Ｘ側の各バッファの大きさはいくらでも構わない。 A>zmusic -t0 -p0 -w0 (トラックバッファ、ＡＤＰＣＭバッファ、ワークエリア＝0) として常駐しても問題なくジュークボックス機能は実行できる。 ・処理の都合上、後述のデバッグ・ツールとの併用はできない(一度後述の '-R'スイッチにて終了する必要がある)。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●デバッグ・ツール機能 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｄ ＺＰ．Ｒが常駐し以降、以下のキー操作が可能となる(デバッグ・ツール)。 [SHIFT]＋[OPT.1] 一時停止 [SHIFT]＋[OPT.2] 一時停止解除 [SHIFT]＋[XF5] 早送り(押している間有効) [SHIFT]＋[XF4] REPLAY [SHIFT]＋[XF3] 低速演奏(押している間有効) [SHIFT]＋[XF1] フェードアウト [SHIFT]＋[XF2] フェードイン 例 A>zp -d ●キー定義の変更 キーと機能の対応は上記のようにデフォルトでは定められているが、これを環境変数 'zp_keyctrl'にキービットマップ値を列記することによってユーザーの好みに変更可能 である。 set zp_keyctrl=<再生#1, 再生#2> <停止#1, 停止#2> <再開#1, 再開#2> <早送り#1, 早送り#2> <低速#1, 低速#2> <フェードアウト#1, フェードアウト#2> <フェードイン#1, フェードイン#2> キー例 [SHIFT]=$E0 [CTRL]=$E1 [OPT.1]=$E2 [OPT.1]=$E3 [XF1]=$A5 [XF2]=$A6 [XF3]=$A7 [XF4]=$B0 [XF5]=$B1 設定例 set zp_keyctrl=$e2,$b1 $e3,$b1 $e3,$b1 $e3,$e0 $e2,$e0 $e3,$a7 ↑ 「再生」は[OPT.1]+[XF5]を意味する ●注意 処理の都合上、ジュークボックスとの併用はできない(一度後述の'-R'スイッチにて 終了する必要がある)。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●常駐解除 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｒ '−Ｊ','−Ｄ'はＺＰ．Ｒがシステムに常駐するので、機能を停止するためには 常駐解除を行わなければならない。'−Ｒ'を設定するとＺＰ．Ｒがシステムに常駐 していた場合常駐解除の処理を行う。ただしＺＰ．Ｒが常駐していないのにこの スイッチを設定するとエラーとなる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●同期演奏機能 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｗ 演奏データ・ファイルネーム,セットアップファイル１,…,セットアップファイル４ 　−Ｐと同じく演奏開始の機能で設定パラメメータ−Ｐと同様。セットアップファイルの 実行後、演奏は開始せず、ＭＩＤＩデータの$FA(スタートメッセージ)を受信するまで 待機状態になる。$FAを受信すると即座に演奏を開始する。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 複数のＸ６８による同期演奏 ┃ ┃ ┃ ┃０．ＺＭＵＳＩＣを/Eオプションを設定して常駐する ┃ ┃ ┃ ┃１．Ｘ６８−ＡのＭＩＤＩ　ＯＵＴからＸ６８−ＢのＭＩＤＩ　ＩＮへつなぐ ┃ ┃ ┃ ┃２．Ｘ６８−ＢのＭＩＤＩ　ＯＵＴを楽器１へつなぐ ┃ ┃ ┃ ┃３．Ｘ６８−ＢのＭＩＤＩ　ＴＨＲＵを楽器２へつなぐ ┃ ┃ ┃ ┃４．Ｘ６８−Ｂを ┃ ┃ ┃ ┃ A>ZP /W filename ┃ ┃ ┃ ┃　　として演奏待機状態にする ┃ ┃ ┃ ┃５．Ｘ６８−Ａを ┃ ┃ ┃ ┃ A>ZP filename ┃ ┃ ┃ ┃ で演奏開始する。 ┃ ┃ ┃ ┃ ※２台以上の場合はＸ６８−xのMIDI OUTをＸ６８−(x+1)のMIDI INへつないで ┃ ┃ ┃ ┃ いくか、Ｘ６８−xのMIDI THRUをＸ６８−(x+1)のMIDI INへつないでく２通りが ┃ ┃ ┃ ┃ 考えられるが実用的には４台までが限界と思われる。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ { -- ZM8.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ８ ＡＤＰＣＭツールＺＶＴ．Ｘ ここでは、自分でサンプリングデータを作成したり 加工したりするツール「ＺＶＴ．Ｘ」の使用法について 解説します。 ８．１． ＺＶＴ．Ｘについて ＺＶＴ．ＸはＸ６８ｋのサンプリングデータ(ＡＤＰＣＭデータ)を扱うための ツールである。動作は外部コマンドとして機能する「コマンドモード」と視覚的に 操作が行える「ビジュアルモード」とに分かれる。ここでは各モード別々に 説明する。 ８．２． ビジュアルモード ●基本操作 基本的に画面下に表示されているメニューにカーソルを合わせリターンキーもしくは スペースキーを押すことでそれぞれの機能が実行される。メニューには、選択されると 直ぐに機能するものと若干のパラメータ等を聞いてくるものに分かれる。 このパラメータ等の入力時に[ESC]キーを押すことによってそのモードから 抜けることが出来る。 なお、メニューに表されている機能以外にも機能がありこれらはキーボードによる キー入力により実行される（もちろんメニューに表示されているコマンドも キー入力によって実行可）。メニューに表示されている機能は実は、ほんの一部のため、 「ＺＶＴ．Ｘ」を使いこなすためにはキー・コマンドを覚える必要がある。 ●カーソル操作 カーソル移動にはカーソルキーを使う。 ＡＤＰＣＭデータを読み込んだり、サンプリングを実行すると、｢START POINT｣と ｢END POINT｣の行にデータ列、さらに枠内に波形と青と赤の縦線が表示される。 ｢START POINT｣｢END POINT｣に表示されている数列は、それぞれ枠中の青と赤の縦線が 指し示している付近のＡＤＰＣＭデータやＰＣＭデータである。この青と赤の縦線を 波形カーソルとよび、波形に対してなんらかの加工処理を行う場合は、この２つの 波形カーソルに挟まれた範囲に対して行われる。波形カーソルは、(通常の)カーソルを ｢START POINT｣や｢END POINT｣に合わせ、テンキーを操作することによって移動させる ことができる（図１）。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ┃ ┃ 7 8 9 ┃ ┃ 4 5 6 ┃ ┃ 1 2 3 ┃ ┃ 0 , . ┃ ┃ ┃ ┃ [7] 左へ32ｽﾃｯﾌﾟ移動 [9] 右へ32ｽﾃｯﾌﾟ高速移動 ┃ ┃ [4] 左へ１ｽﾃｯﾌﾟ移動 [6] 右へ１ｽﾃｯﾌﾟ移動 ┃ ┃ [1] 左へ波長の1/16ｽﾃｯﾌﾟ移動 [3] 右へ波長の1/16ｽﾃｯﾌﾟ移動 ┃ ┃ [0] 波形の先頭へ瞬間移動 ┃ ┃ [,] 波形の真ん中へ瞬間移動 ┃ ┃ [.] 波形の最後尾へ瞬間移動 ┃ ┃ ┃ ┃ 図１ 波形カーソルのキー操作 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ●キーコマンド(アルファベット順) （）内の文字はコマンドメニュー名に対応する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ａ Ｂ アクセス対象バンクをセレクトする。 ＺＶＴ．Ｘには加工したりサンプリングしたりするデータエリアが２つあり、 コマンド機能の対象となるデータをそれぞれバンクＡ、バンクＢと呼んでいる。 本コマンドでこの操作対象バンクを選択することができる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｃ スタートポイントとエンドポイント間以外の波形を切り捨てる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｄ (DISK) ディスクモードへ入る。 １. LOAD 波形データのロードを行う。 ファイルネームを聞いてくるのでパスや拡張子を含めて 91文字以内で入力する。ファイル名を省略したり、 ワイルドカードを使用するとファイル選択モード(囲み参照)に 入る。 ２. SAVE 波形データのセーブを行う。 ファイルネームを聞いてくるのでパスや拡張子を含めて 91文字以内で入力する。ファイル名を省略したり、 ワイルドカードを使用するとファイル選択モード(囲み参照)に 入る。 ３. SAVE BY 4PHASES 原波形を含む４段階の波形データを自動生成しセーブする。 (ただし自動生成されるデータはＡＤＰＣＭデータ形式固定) このモードを選択すると次に １. VOLUME ２. PITCH が現れる。１を選べば４段階のボリュームで、２を選べば ４段階の音程でセーブされることになる。 これを選択後さらに １. MINUS ２. PLUS のメニューが現れる。これはどの方向に４段階のデータを 生成するかを決めるものである。 ボリュームを選んだ場合にマイナス方向を選択すると 原波形のボリュームの 100%, 88%, 76%, 60% のデータが自動生成されセーブされる。プラス方向では 原波形のボリュームの 100%, 114%, 126%, 140% のデータがセーブされる。 音程を選んだ時には各方向に半音単位の変化量でセーブされる。 つまり原波形が今オクターブ４のCだったとすると マイナス方向では O4のC, O3のB, O3のA#, O3のA プラス方向では O4のC, O4のC#, O4のD, O4のD# がセーブされることになる。 最後にファイルネームを聞いてくるが拡張子は無視され 自動生成される。ファイルの拡張子は強制的に '.4' '.3' '.2' '.1'の４つになる（原波形が'.4'）。 ファイルネームを省略したり、ワイルドカートを使用すると ファイルセレクトモードへと移行する。 ４. TEST PLAY ファイルを音声データと見なして再生する。 ファイルネームを聞いてくるのでパスや拡張子を含めて 91文字以内で入力する。ファイル名を省略したり、 ワイルドカードを使用するとファイル選択モード(囲み参照)に 入る。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ファイル選択モード ┃ ┃ ┃ ┃ ┃ ┃ ディスク関連のコマンドでファイルネームを省略したり、ワイルドカードを ┃ ┃ ┃ ┃設定するとファイル選択モードになります。ここではカーソルキーによるファイルの┃ ┃ ┃ ┃選択やディレクトリ間の移動がスムーズに行えるようになっています。 ┃ ┃ ┃ ┃ 使用キーは以下の通りです。 ┃ ┃ ┃ ┃カーソルキー カーソルの移動 ┃ ┃RETURN/ENTER ファイルやディレクトリの選択 ┃ ┃ESC ファイル選択モードを終了する（ファイル選択の拒否） ┃ ┃TAB カーソルを左最上部へ瞬間移動。またディレクトリの移動も ┃ ┃ これで可能。 ┃ ┃ スピーディーに親ディレクトリに移動可能。 ┃ ┃？ ファイルネームの入力。ワイルドカードを指定すると ┃ ┃ それに対応したファイルのみが画面に現れる。 ┃ ┃SPACE 再生(PCM/ADPCMモードの影響を受ける点に注意) ┃ ┃数字キー(0〜4) SPACEキーでのPCMデータ再生における再生周波数の切り換え ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ファイルの拡張子とデータ形式 ┃ ┃ ┃ ┃拡張子'.PCM'のファイルはＺＶＴ．ＸではＡＤＰＣＭファイルと自動的に見なして ┃ ┃ ┃ ┃ロード／セーブします。また拡張子'.P16'のファイルは１６ビットＰＣＭファイルと┃ ┃ ┃ ┃見なしてロード／セーブします。それ以外の拡張子を持ったファイルをアクセスする┃ ┃ ┃ ┃場合は、その時点でのデータモードがＡＤＰＣＭならＡＤＰＣＭとして、 ┃ ┃ ┃ ┃データモードが１６ビットＰＣＭデータなら１６ビットＰＣＭデータとしてアクセス┃ ┃ ┃ ┃します。なるべく'.PCM'、'.P16'のどちらかを用いるようにしましょう。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｅ ＰＣＭデータ及びＡＤＰＣＭデータにエフェクト(加工)をかける。 １.↑/↓ ２.←/→ ３.ADD 0 TO TAIL ４.REVERSE ５.CHORUS ６.DELAY ７.SFX ８.SMOOTHING ９.ENVELOPE の９種類のエフェクトより１つを選択する。 １．↑/↓ ＰＣＭデータをグラフのＹ軸方向にシフトするもの(マイナス値で下へ) 機能選択後、どのくらいシフトするか(オフセット値)を聞いてくる ２．←/→ ＰＣＭデータをグラフのＸ軸方向にシフトするもの(マイナス値で左へ) 機能選択後、どのくらいシフトするか(オフセット値)を聞いてくる ３．ADD 0 TO TAIL データの最後尾にn個の0を加える 機能選択後、オフセット値を聞いてくる ４．REVERSE 逆転 ５．CHORUS 音が透き通った感じになる ６．DELAY エコーがかかったような音になる ７．SFX 金属音に変化する ８．SMOOTHING こもったような音に変化する ９．ENVELOPE エンベロープを変形する(フェード・イン／アウト) 機能選択後、イン／アウト・レベル(0〜127)とエンベロープの 変更方向を聞いてくる １．＜ … フェード・イン ２．＞ … フェード・アウト 設定したパラメータとその効用は図２参照 なお、機能は青赤の２つの波形カーソルに挟まれた区間に対して働く事に注意。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ エンベロープ変更方向 '＞' ┃ ┃ ┃ ┃ 128＿＿＿＿＿＿＿ ┃ ┃ |＼ ┃ ┃ | ＼ ┃ ┃ | ＼ ┃ ┃ | ＼ ┃ ┃ | ↑ level ┃ ┃ | │(0〜127) ┃ ┃ 0￣￣￣￣￣￣￣￣￣￣￣ ┃ ┃ ↑ ↑ ┃ ┃ 青ｶｰｿﾙ 赤ｶｰｿﾙ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ エンベロープ変更方向 '＜' ┃ ┃ ┃ ┃ 128 ＿＿＿＿＿＿＿ ┃ ┃ ／| ┃ ┃ ／ | ┃ ┃ ／ | ┃ ┃ ／ | ┃ ┃ level ↑ | ┃ ┃ (0〜127)│ | ┃ ┃ 0￣￣￣￣￣￣￣￣￣￣￣ ┃ ┃ ↑ ↑ ┃ ┃ 青ｶｰｿﾙ 赤ｶｰｿﾙ ┃ ┃ ┃ ┃ 図２ エンベロープ変更方向とイン／アウト・レベル ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ オフセット値について ┃ ┃ ┃ ┃ 「←/→」と「ADD 0 TO TAIL」では、機能メニューを選択後、オフセット値を ┃ ┃ ┃ ┃聞いてきますがこれはデータモードによって効用が異なります。 ┃ ┃ ┃ ┃ 例えばＰＣＭモードの時1000と入力するとオフセットはＰＣＭデータ1000個分 ┃ ┃ ┃ ┃(つまり2000バイト)ということになります。またＡＤＰＣＭモードで1000と ┃ ┃ ┃ ┃入力した場合にはＡＤＰＣＭデータ1000個分(つまり1000バイト)ということに　　 ┃ ┃ ┃ ┃なります。 ┃ ┃ ┃ ┃オフセット値の例 ┃ ┃ ┃ ┃ データモードがＰＣＭの時 ┃ ┃ 3.9kHz １秒＝３９００ ┃ ┃ 5.2kHz １秒＝５２００ ┃ ┃ 7.8kHz １秒＝７８００ ┃ ┃ 10.4kHz １秒＝１０４００ ┃ ┃ 15.6kHz １秒＝１５６００ ┃ ┃ ┃ ┃ データモードがＡＤＰＣＭの時 ┃ ┃ 3.9kHz １秒＝１９５０ ┃ ┃ 5.2kHz １秒＝２６００ ┃ ┃ 7.8kHz １秒＝３９００ ┃ ┃ 10.4kHz １秒＝５２００ ┃ ┃ 15.6kHz １秒＝７８００ ┃ ┃ ┃ ┃ 「↑/↓」のオフセット値はＰＣＭデータへ直接加算される数値を意味して　　 ┃ ┃ ┃ ┃いるのでデータモードには全く無関係です。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｆ (SAMPLING RATE) サンプリング時や再生時の周波数を設定をする。 サンプリング周波数は一般に、周波数が高ければ高いほど高音質となる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｉ 波形の頭と後尾を見付ける。単純なアルゴリズムによる探査のため複雑な 波形に対しては希望の結果を得られないことがある。また、データモードによって 動作のしかたが微妙に違うため、データモードを変えて実行すると違った結果を 得ることができる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｊ 　音程の変更を１Ｈｚ単位で行なえる。コマンド入力後、変更前の周波数と 変更後の周波数を聞いてくる。周波数パラメータ設定範囲は1〜65535。変換前と 変換後の周波数は厳密に入力する必要はなく、両周波数の整数比を入力する だけでもよい。つまり、「１オクターブ上げる(周波数を２倍にする)」場合、 変更前周波数=1Hz 変更後周波数=2Hz でも 変更前周波数=100Hz 変更後周波数=200Hz でも得られる結果は同じである。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 国際基準イ＝ａ1=４４０Ｈｚに基づく１２平均率音階周波数表 ┃ ┃ (試験に出るＸ１より転載) ┃ ┃ (単位はHz) ┃ ┃ O0 O1 O2 O3 O4 O5 O6 O7 O8 ┃ ┃Ｃ 16.352 32.703 65.406 130.81 261.63 523.25 1046.5 2093.0 4186.0┃ ┃Ｃ＃ 17.324 34.648 69.296 138.59 277.18 554.37 1108.7 2217.5 4434.9┃ ┃Ｄ 18.354 36.708 73.416 146.83 293.66 587.33 1174.7 2349.3 4698.6┃ ┃Ｄ＃ 19.445 38.891 77.782 155.56 311.13 622.25 1244.5 2489.0 4978.0┃ ┃Ｅ 20.602 41.203 82.407 164.81 329.63 659.26 1318.5 2637.0 5274.0┃ ┃Ｆ 21.827 43.654 87.307 174.61 349.23 698.46 1396.9 2793.8 5587.7┃ ┃Ｆ＃ 23.125 46.249 92.499 185.00 369.99 739.99 1480.0 2960.0 5919.9┃ ┃Ｇ 24.500 48.999 97.999 196.00 392.00 783.99 1568.0 3136.0 6271.9┃ ┃Ｇ＃ 25.957 51.913 103.83 207.65 415.30 830.61 1661.2 3322.4 6644.9┃ ┃Ａ 27.500 55.000 110.00 220.00 440.00 880.00 1760.0 3520.0 7040.0┃ ┃Ａ＃ 29.135 58.270 116.54 233.08 466.16 932.33 1864.7 3729.3 7458.6┃ ┃Ｂ 30.868 61.735 123.47 246.96 493.88 987.77 1975.5 3951.1 7902.1┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｋ (PITCH) 半音単位でピッチをシフトする。パラメータは−12から＋12。 ±１オクターブの音程変換が可能。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｍ (MONITOR) モニター機能のオン／オフ。｢AUDIO IN｣端子からの入力をＸ６８ｋの Ａ／Ｄ，Ｄ／Ａコンバータを通してヘッドホンなどで聴く事が出来る。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｎ ポルタメント(音程を滑らかに変化させる)を１Hz単位で行なう。コマンド入力後、 その音の基本周波数と変化希望周波数を聞いてくる。周波数パラメータ設定範囲は 1〜65535。２つの周波数パラメータは厳密に入力する必要はなく、両周波数の整数比を 入力するだけでもよい。つまり、「１オクターブ上へ滑らかに変化させる(周波数を 滑らかに２倍にする)」場合、 変更前周波数=1Hz 変更後周波数=2Hz でも 変更前周波数=100Hz 変更後周波数=200Hz でも得られる結果は同じである。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｏ (PANPOT) 再生やモニター機能のパンポットを設定する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｐ (PLAY) バンクセレクトされているバンクのデータを再生する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｑ (EXIT) [ESC]＋[Q]でZVT.Xを終了する。誤操作を避けるためこのコマンドのみ ２キーコマンドになっている。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｒ (RECORD) 録音を行う。オートサンプリング機能のスイッチ（TRIGGER）がオン、さらに モニター機能（MONITOR)オンの時にはオートサンプリングを行うがこれら のスイッチが片方でもオフの時には通常のサンプリングを行う。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ オートサンプリングとは ┃ ┃ ┃ ┃オートサンプリングとは音が入力された事を自動的に感知して録音を開始する機能の┃ ┃ ┃ ┃ことです。ＺＶＴ．Ｘではオートサンプリング機能のスイッチ（TRIGGER）と ┃ ┃ ┃ ┃モニター機能（MONITOR)の両方がONの時に録音キーを押すとこの機能が働きます。 ┃ ┃ ┃ ┃どちらかがOFFだとこの機能は働きません。オートサンプリング・モードでない時は ┃ ┃ ┃ ┃録音キー[R]が押された瞬間から録音を開始します。 ┃ ┃ ┃ ┃ オートサンプリングの音の入力待ちの時は一切のキー入力を受け付けません。 ┃ ┃ ┃ ┃何か、音の入力があるまで音を待ち続けます。 ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ＺＶＴ．Ｘのオートサンプリング機能動作フローチャート ┃ ┃ ┃ ┃ [R]キーを押す ┃ ┃ ↓ ┃ ┃ 音の入力があるまでひたすら待つ ┃ ┃ ↓ ┃ ┃ 音が入力されると実際に録音を開始する ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｓ (DATA SIZE) サンプリングする音の時間をデータサイズによって設定する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｔ (SAMPLING TIME) サンプリングする音のデータサイズを「秒」で設定する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｖ (VOLUME) 音量を変化させる。パラメータはパーセント単位。1〜300%の範囲のみ有効。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｘ アクセスバンクの切り換え。[X]キーを押すたびにセレクトバンクが、Ａ／Ｂと 交互に切り換わる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Ｚ 　２つのデータ間のたたみ込み演算を行なう。２つの音声データの特性を１つに まとめたりすることができる。演算結果をどちらのバンクに格納するかを聞いてくる。 １．Ａ＊Ｂ→Ｂ … 演算結果をＢへ格納する ２．Ａ＊Ｂ→Ａ … 演算結果をＡへ格納する なお、演算にはかなりの時間を必要とする。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ＠ (TRIGGER) オートサンプリング機能の有効／無効を設定する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ＊ ＰＣＭのデータ表示を10進数または16進数へ交互に切り換える。 デフォルトは16進数モード。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ＋ (COMPOUND) バンクＡとＢのデータをミキシングして１つのデータにする。 パラメータとしてミックス方向を聞いてくる。 １．Ａ→Ｂ … ＡとＢをミックスしてミックスされたデータはＢへ格納する ２．Ａ←Ｂ … ＡとＢをミックスしてミックスされたデータはＡへ格納する −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− − バンクＡとＢのデータ間の算術／論理演算を行なう。演算子を 1.ADD 和 2.SUB 差 3.OR 論理和 4.AND 論理積 5.EOR 排他的論理和 の５つから選択する。演算子タイプ選択後、演算結果をどちらのバンクに 格納するのかを聞いてくる。 １．Ａ○Ｂ→Ｂ … 演算結果をＢへ格納する ２．Ａ○Ｂ→Ａ … 演算結果をＡへ格納する −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ／ ソースバンクのデータをデスティネーションバンクのデータのスタートポイントへ はめこむ。パラメータとしてはめこむ方向を聞いてくる。 １．Ａ→Ｂ … ＡをＢのスタートポイントへはめこむ ２．Ａ←Ｂ … ＢをＡのスタートポイントへはめこむ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ＝ バンク間のデータのコピー。パラメータとしてコピー方向を聞いてくる。 １．Ａ→Ｂ … ＡをＢへコピーする ２．Ａ←Ｂ … ＢをＡへコピーする −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ？ 各バンクの情報を表示する。 ADPCM DATA ADDRESS:ＡＤＰＣＭデータが格納されているアドレス START POINT:青カーソルのオフセット位置 END POINT:赤カーソルのオフセット位置 ADPCM DATA SIZE:ＡＤＰＣＭデータの大きさ EFFECTIVE DATA SIZE:青カーソルと赤カーソルに挟まれた区間の大きさ PCM DATA ADDRESS:ＰＣＭデータが格納されているアドレス FREE AREA:フリーエリア −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− CLR セレクトされているバンクのデータをクリアする。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− TAB データモード(ＰＣＭ／ＡＤＰＣＭ)の切り換えを行う。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ８．３． コマンドモード ＺＶＴ．Ｘの機能をＨｕｍａｎ６８ｋのコマンドラインから実行することができる。 A>zvt <ｺﾏﾝﾄﾞ･ｽｲｯﾁ列1> <ﾌｧｲﾙﾈｰﾑ1> <ﾌｧｲﾙﾈｰﾑ2> A>zvt -m[n] [ｺﾏﾝﾄﾞ･ｽｲｯﾁ列1] <ﾌｧｲﾙﾈｰﾑ1> [ｺﾏﾝﾄﾞ･ｽｲｯﾁ列2] <ﾌｧｲﾙﾈｰﾑ2> <ﾌｧｲﾙﾈｰﾑ3> という書式でコマンド指定を行う。 ファイルネーム１で指定されたＡＤＰＣＭデータ・ファイルを読み込み、これを コマンド・スイッチで指定された機能で加工処理を行い、これを ファイルネーム２としてセーブする、がコマンドモードの基本動作となる。 ミキシング(合成)指定のときのみファイルネーム３の指定を必要とし、 コマンド・スイッチ列２が有効となる。よってこの時はファイルネーム１で指定された ＡＤＰＣＭデータ・ファイルを読み込み、これをコマンド・スイッチ列１で加工し、 ファイルネーム２で指定されたＡＤＰＣＭデータファイルを読み込み、これを コマンド・スイッチ列２で加工し、この２つを合成して、ファイルネーム３として セーブする、ということになる。 ●コマンドオプションスイッチの解説 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −４Ｐ＋ −４Ｐ− ビジュアルモードの４段階データセーブに相当するもの。ファイルネーム１の ＡＤＰＣＭデータを読み込み、これに対して半音単位で4段階のピッチシフトを 　　 行い拡張子'.4','.3','.2','.1'を添付したファイルネーム２でセーブする。 '−４Ｐ'の後ろの＋,−の符号はピッチシフトの方向を表す。＋が音程を４段階に 上昇させる指定で、逆に−が音程を４段階に下降させる指定となる。 例えば、FILE1.PCMがオクターブ４のCだったときに A>zvt -4p+ FILE1.PCM ABC とすると オクターブ４のC(原波形)が'ABC.4' オクターブ４のC#が'ABC.3' オクターブ４のDが'ABC.2' オクターブ４のD#が'ABC.1' としてセーブされる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −４Ｖ＋ −４Ｖ− ビジュアルモードの４段階データセーブに相当するもの。ファイルネーム１の ＡＤＰＣＭデータを読み込み、これに対して％単位で４段階の音量変更を行い 拡張子'.4','.3','.2','.1'を添付したファイルネーム２でセーブする。 '−４Ｖ'の後ろの＋,−の符号は音量変更の方向を表す。＋が音量を４段階に 上昇させる指定で、逆に−が音量を４段階に下降させる指定となる。 例えば、 A>zvt -4v+ FILE1.PCM ABC とすると FILE1.PCMの音量の100%(原波形)が'ABC.4' FILE1.PCMの音量の114%が'ABC.3' FILE1.PCMの音量の126%が'ABC.2' FILE1.PCMの音量の140%が'ABC.1' としてセーブされる。 また、 A>zvt -4v- FILE1.PCM ABC とすると FILE1.PCMの音量の100%(原波形)が'ABC.4' FILE1.PCMの音量の88%が'ABC.3' FILE1.PCMの音量の76%が'ABC.2' FILE1.PCMの音量の60%が'ABC.1' としてセーブされる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ａ ファイルネーム１のＰＣＭデータをファイルネーム２のＡＤＰＣＭデータへ 　　　 変換する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｃ 上の逆の動作。ＰＣＭデータは16ビット符号付きで格納される。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｇ 基本的にビジュアルモードはＧ−ＲＡＭがラムディスク等で使用されていると 起動不可能である。しかしこのスイッチを指定するとＧ−ＲＡＭディスク等を 破壊し強制的にビジュアルモードへ移行させることが出来る。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｉn ファイルネーム１のＡＤＰＣＭデータとファイルネーム２のＡＤＰＣＭデータへ 　　　　はめこみファイルネーム３でセーブする。−Ｉの後ろにオフセット値を書けるが 　　　　これはＡＤＰＣＭのバイト数となる。(通常は0または省略で構わない) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｌfilename1, filename2 ビジュアルモード起動時にfilename1をバンクＡに、filename2をバンクＢに 読み込んで起動する。起動時に読み込める音声ファイルはＡＤＰＣＭに 限定される。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｍn ファイルネーム１のＡＤＰＣＭデータとファイルネーム２のＡＤＰＣＭデータを 加工指定があればそれぞれ加工処理し、これらをミックス(合成)し ファイルネーム３でセーブする。−Ｍの後ろにオフセット値を書けるがこれは ＡＤＰＣＭのバイト数となる。(通常は0または省略で構わない) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｐn ファイルネーム１のＡＤＰＣＭデータの音程をn半音分シフトし 　　　　ファイルネーム２でセーブする。パラメータは−12から＋12まで設定可能。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −Ｖn ファイルネーム１のＡＤＰＣＭデータの音量を%単位で変更しファイルネーム２で セーブする。 パラメータはパーセンテージで1〜300%まで設定可能。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●コマンド・スイッチの複数設定について コマンド・スイッチの'Ｐ','Ｖ'は同時に設定可能である。 また、コマンド・スイッチ'Ｐ','Ｖ'はコマンド・スイッチの'４','Ａ','Ｃ','Ｍ'と同時に 設定可能である。 以下に使用具体例をいくつか示す。 A>zvt -p3 -v150 ABC.PCM DEF.PCM とすると'ABC.PCM'のＡＤＰＣＭデータを＋3半音分シフト、音量を150%にしたものを 'DEF.PCM'でセーブする。 A>zvt -a -p+5 ABC.PCM DEF.PCM とすると'ABC.PCM'のＰＣＭデータを5半音分上へシフトした上でＡＤＰＣＭデータへ変換し、 これを'DEF.PCM'でセーブする。 A>zvt -c -p-5 ABC.PCM DEF.PCM -v180 のようにファイルネームの後にスイッチを設定可能である。この例では'ABC.PCM'の ＡＤＰＣＭデータを−5半音分シフトし、さらに音量を原波形の180％に変更した ＰＣＭデータを'DEF.PCM'でセーブする。 A>zvt -p-3 -v50 ABC.PCM -p5 -v120 DEF.PCM GHI.PCM -m とすると'ABC.PCM'のＡＤＰＣＭデータを−3半音分シフト、音量を50%にしたものと 'DEF.PCM'のＡＤＰＣＭデータを＋5半音分シフト、音量を120%にしたものとを ミックスし'GHI.PCM'でセーブする。 A>zvt -4v+ -v80 -p-7 ABC.PCM DEF では'ABC.PCM'のＡＤＰＣＭデータを−7半音分シフトし音量を 80%×100%＝80%に変更したものを'DEF.4'でセーブする。 そして 80%×114%＝91.2%に変更したものを'DEF.3'でセーブする。 80%×126%＝100.8%に変更したものを'DEF.2'でセーブする。 80%×140%＝112%に変更したものを'DEF.1'でセーブする。 ●ワイルドカードについて ファイルネームにワイルドカードが使用可能である。例えば A>zvt -v150 -p5 *.PCM *1.PCM A>zvt -m *.PCM A*.PCM *B.PCM といった使い方が可能。ただし、使えない場合もある。 ●ファイルネーム'PCM'について ZMUSIC.XまたはPCMDRV.SYSが組み込まれている時、出力側のファイルネームに'PCM'を設定した 場合は、生成されたデータをファイルとして生成せずに、直接聴く事が出来る。 例えば A>zvt -p-3 -v50 ABC.PCM -p5 -v120 DEF.PCM PCM -m とすると'ABC.PCM'のＡＤＰＣＭデータを−3半音分シフト、音量を50%にしたものと 'DEF.PCM'のＡＤＰＣＭデータを＋5半音分シフト、音量を120%にしたものとを ミックスし、これをセーブせず音声として聴く事が出来る。 { -- ZM9.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ９ ＭＩＤＩデータを扱う ここではＺＭＵＳＩＣ．Ｘの機能の１つである ＭＩＤＩ楽器の設定をファイルとしてセーブする機能に ついて解説します。また、楽器のメモリーを操作する エクスクルーシブメッセージについて具体的な用例を 挙げて解説します。 ９．１． ＭＩＤＩ楽器のメモリデータをファイルにセーブする ＺＭＵＳＩＣ．Ｘには常駐後に使用可能となるシステムファイル名'MIDI'を用いて 楽器の状態（音色や設定など）をファイルに落とす機能がある。これによって楽器の 設定状態や音色のデータをＸ６８ｋで管理することが出来る。ここではこの機能の 具体的な使用方法について述べる。 まず、楽器側にＭＩＤＩ ＯＵＴ端子が無くてはならない。さらに楽器側に 自分のメモリ内のデータを外部へ送信する機能が必要である。ＭＩＤＩ ＯＵＴ端子が あるような楽器ならば大抵は備わっている機能であるので楽器のマニュアルを参照して みよう。大抵は「ＭＩＤＩ データダンプ」「バルクダンプ」といった項目に 載っているはずである。 次にＸ６８ｋのＭＩＤＩ ＩＮ端子と楽器のＭＩＤＩ ＯＵＴ端子を ＭＩＤＩケーブルで接続する。 以上の準備が大前提で話を進めていくことにする。 ●コマンドラインから行う場合（その１） 0. ドライバの常駐を確認する 1. 楽器側のバルクダンプのメニューを出し確認する 2. A>copy con opm を実行する 3. (R)と入力リータン 4. 楽器のバルクダンプを実行する 5. [SHIFT]＋[BREAK]でコマンドに戻る 6. 楽器のコンソールに"COMPLETED"等のメッセージを確認するまでひたすら待つ 7. A>copy midi filename を実行する ●コマンドラインから行う場合（その２） 0. ドライバの常駐を確認する 1. 楽器側のバルクダンプのメニューを出し確認する 2. A>zp-aを実行する 3. 楽器のバルクダンプを実行する 4. 楽器のコンソールに"COMPLETED"等のメッセージを確認するまでひたすら待つ 5. A>zp-a filename を実行する ●ＢＡＳＩＣから行う場合 0. ドライバの常駐を確認しmusicz.fncを組み込んだＢＡＳＩＣを立ちあげる 1. 楽器側のバルクダンプのメニューを出し確認する 2. m_rec()を実行する 3. 楽器のバルクダンプを実行する 4. 楽器のコンソールに"COMPLETED"等のメッセージを確認するまでひたすら待つ 5. m_save("filename")を実行しセーブする ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 注意点 ┃ ┃ ┃ ┃ ┃ ┃ データの取り込み用バッファとしてトラックバッファ、文字型データへの変換の際┃ ┃ ┃ ┃にワークエリアを使用します。データ取り込み中ビープ音が鳴った場合は ┃ ┃ ┃ ┃トラックバッファやワークが不足している事を表します。データの取り込みを ┃ ┃ ┃ ┃行う時はトラックバッファ、ワークエリアともに十分に確保して ┃ ┃ ┃ ┃ＺＭＵＳＩＣ．Ｘを常駐させるべきです。具体的には ┃ ┃ ┃ ┃A>zmusic -t200 -w200 ┃ ┃ ┃ ┃とします(この例ではトラックバッファ、ワークエリアともに200キロバイト確保して┃ ┃ ┃ ┃常駐している)。また、ビープ音が鳴った場合にデータをセーブしてもそのデータは ┃ ┃ ┃ ┃信用性がありません。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ＭＩＤＩダンプデータについて ┃ ┃ ┃ ┃ ┃ ┃ 楽器内部のメモリーをファイルへ落とした物をＺＭＵＳＩＣシステムでは ┃ ┃ ┃ ┃ＭＩＤＩダンプデータと呼びます。さて、このデータは16進数の文字型の ┃ ┃ ┃ ┃データです。ですから ┃ ┃ ┃ ┃a>ed ファイルネーム ┃ ┃ ┃ ┃でエディタからエディットが可能です（ただしＭＩＤＩダンプデータの先頭につく ┃ ┃ ┃ ┃改行コードは、実は重要な意味を果たしていますので消したりしてはいけません）。┃ ┃ ┃ ┃文字型にした理由はデータ中に＄１Ａを発見するとＣＯＯＫＥＤモードの ┃ ┃ ┃ ┃デバイスドライバはファイルの最後と判断して動作を終了してしまうためです。 ┃ ┃ ┃ ┃この方が簡単にエディタから読み込めて書き替えがきくし、問題はないでしょう ┃ ┃ ┃ ┃（もちろん機械語レベルの操作のためにＺＭＵＳＩＣファンクションコールでは ┃ ┃ ┃ ┃文字型でない生データのやり取りもサポートしています（MEASURE10参照）。 ┃ ┃ ┃ ┃何かアプリケーションを作成する場合はそちらを使うべきです）。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ エクスクルーシブ送信後のウェイト ┃ ┃ ┃ ┃ ＺＭＵＳＩＣ．ＸではＭＩＤＩダンプデータの送信時や、共通コマンドの実行時、┃ ┃ ┃ ┃EOX(END OF EXCLUSIVE MESSAGE)$F7を送信した場合、その後、ウェイトを入れる ┃ ┃ ┃ ┃ようにプログラムされています。これは楽器側がエクスクルーシブを処理するのに ┃ ┃ ┃ ┃時間を必要とするためです。このウェイトの値はＺＭＵＳＩＣ．Ｘ常駐時の ┃ ┃ ┃ ┃オプションスイッチ'-X'で設定することができます。 ┃ ┃ ┃ ┃　ＭＭＬの＠ＸやＸコマンドを用いてエクスクルーシブを送信した場合は(テンポの ┃ ┃ ┃ ┃ずれを避けるために)EOXの送信後にウェイトを入れていません。この場合、 ┃ ┃ ┃ ┃ユーザーが休符やウェイトコマンドを挿入するなどして適度なウェイトを与えて ┃ ┃ ┃ ┃下さい。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ９．２． ＭＩＤＩダンプデータの楽器への転送 以上のようにして出来たファイルを、逆に楽器側へ転送する方法について述べる。 ●コマンドラインから行う場合（その１） 0. ドライバの常駐を確認する 1. A>copy filename midi を実行する 2. 待つ ●コマンドラインから行う場合（その２） 0. ドライバの常駐を確認する 1. A>zp-x filename を実行する 2. 待つ ●ＢＡＳＩＣから行う場合 0. ドライバの常駐を確認しmusicz.fncを組み込んだＢＡＳＩＣを立ちあげる 1. m_trans("ファイルネーム")を実行する 2. 待つ ●曲中に設定する時 ＢＡＳＩＣプログラム … m_trans("ファイルネーム")命令を用いる ソースファイル(ＺＭＳファイル) … .midi_dump＝ファイルネーム命令を用いる ９．３． ローランドエクスクルーシブについて 多くのユーザーがローランドの楽器を使用していると思われるが、ここでは そのローランド製のＭＩＤＩ楽器のエクスクルーシブについて特に解説をする。 ＺＭＵＳＩＣ．Ｘでは'roland_exclusive'や'm_roland()'をはじめ、 ＭＭＬレベルでも'Ｘ'コマンド等が用意されており、かなり容易に楽器のメモリを 書き替える事が可能である。ここでは'roland_exclusive'命令を使って ＣＭ３２Ｐ(あるいはＣＭ６４のＰＣＭ音源パート)のパーシャルリザーブの行い方を 例として解説を行う。 ９．３．１． マニュアルの後ろを見てみる マニュアルの後ろを見てみよう。ＣＭ６４ならば33ページを開く。 まず'＊６−３'という表に注目しよう。この表の中段に | 00 04 | 00aa aaa | PARTIAL RESERVE (PART 1) 0-31 | | 00 05 | 00aa aaa | PARTIAL RESERVE (PART 2) 0-31 | | 00 06 | 00aa aaa | PARTIAL RESERVE (PART 3) 0-31 | : : | 00 09 | 00aa aaa | PARTIAL RESERVE (PART 6) 0-31 | が見つかるはずである。これを確認したら次にこの表'＊６−３'のタイトルを見ると ＳＹＳＴＥＭ ＡＲＥＡ とある。ここで、この表の右にあるアドレスマップからこの'SYSTEM AREA'という 文字を捜す。 52 00 00 が'SYSTEM AREA'のベース・アドレスということが分かる。つまり、表'＊６−３'の 中のパラメータを設定したい場合は、表の左に書いてあるオフセット・アドレスと このベース・アドレスを足したアドレスに値を送れば良いことになる。この例でいくと 52 00 00 ＋ 00 04 ＝ 52 00 04 がパーシャルリザーブのパラメータのアドレスということになる(表'＊６−３'の タイトルの下をみると「パーシャルリザーブは６パート分を一度に送らなければ 無効です」とあるのでもちろんこれに従うこと)。 結局、以下のようにコマンドを書けば良いことになる。 .roland_exclusive dev,mdl { $52,$00,$04 2 3 5 4 3 6} （１パラメータ毎に改行しているが特に意味はない。$52,00,04がアドレス、 それ以降がパラメータ） この例ではパート1〜6、それぞれ2,3,5,4,3,6声をリザーブしている。 もちろん楽器の最大同時発声数を超えてはならない。この例では2＋3＋5＋4＋3＋6＝23で まだ31−23＝8声分の余裕がある。 さて、今の例でdev,mdlというのが出てきたがこれは操作対象の楽器のＩＤ番号の ことである。 mdlはモデルＩＤと呼ばれるものでメーカーがその楽器に与えた識別番号の ことである。ＭＴ３２/ＣＭ３２Ｌ/ＣＭ３２Ｐ/ＣＭ６４はすべて＄１６と決められている （ＣＭ６４ならばマニュアルのp28の上部に記載されている）。 devはデバイスＩＤと呼ばれるもので、同じ機種(あるいは同一のデバイスＩＤを 持った)楽器でもこれを変えておけば個別に操作が可能となる、ユーザーが任意に 設定可能な識別番号である。しかしＣＭ３２Ｌ/ＣＭ３２Ｐ/ＣＭ６４は＄１０に固定である。結局、 上の例は .roland_exclusive $10,$16 { $52,$00,$04 2 3 5 4 3 6} ということになる。 以上の手順をまとめると、 １) 設定したいパラメータの表を捜す ２) 表のタイトルをアドレスマップより捜す ３) 設定したいパラメータのオフセット値と２)で見付けたベースアドレスを加算する ４) ２種類のＩＤを確認してコマンドを書く となる。 ９．３．２． その他の例 ＣＭ３２Ｐ(あるいはＣＭ６４のＰＣＭパート)の各パートの受信ＭＩＤＩチャンネル を設定するときは roland_exclusive $10,$16 {$52,$00,$0a,0,1,2,3,4,16} のようになる。この例ではパート1〜5をそれぞれチャンネル1〜5へ、パート６は ＯＦＦにしている。ＭＩＤＩチャンネルは通常1〜16ということになっているが 内部処理的には0〜15なので注意すること。そういうわけでパラメータの０は ＭＩＤＩチャンネル１、パラメータの１はＭＩＤＩチャンネル２…以下同様という ことになる。最後のパラメータの16はＭＩＤＩチャンネル17ということではなく そのパートをミュートする(使用しない)ということを意味する。 多くのローランド系の楽器は ＭＩＤＩチャンネル 実際のパラメータ値 1〜16 0〜15 ＯＦＦ 16 ということになっている。 同様にしてリバーブの設定や各パートの細かい設定(リバーブのON/OFF， キートランスポーズの設定など)も行うことができる。もちろんＢＡＳＩＣコマンドの 'm_roland()'やＭＭＬの'Ｘ'コマンドもいままで述べてきた同様な方法で行える。 注意点としては通常1〜128で使用していたものが内部処理的には0〜127と なっていたり、−64〜＋63で使用していたものが0〜127シフトされて いたりするのでパラメータの設定にはマニュアルを確認することが必要である。 { -- ZM10.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ１０ ＺＭＵＳＩＣのファンクションコール ここではＺＭＵＳＩＣ．Ｘが常駐した後に 使用出来るファンクションコールについて 説明します。使用にはＭＰＵ６８０００の 機械語の知識が必要です。 一般的な使用をする限り読み飛ばして 構いません。 １０．１． ファンクションコールのコール法 コール方法その１(ＯＰＭＤＲＶ．Ｘコンパチモード) moveq.l #n,d1 *n＝ファンクションナンバー lea 〜,a1 *パラメータが必要であれば設定 moveq.l #m,d2 *パラメータが必要であれば設定 IOCS _OPMDRV コール方法その２(高速応答モード) moveq.l #n,d1 *n＝ファンクションナンバー lea 〜,a1 *パラメータが必要であれば設定 moveq.l #m,d2 *パラメータが必要であれば設定 trap #3 戻り値はd0.lとa0.lのみで、その他のレジスタは全部保存されます。 ファンクション内でエラーが発生すればd0にそのエラーコード(MEASURE12参照)が 代入されています。 d0.l＝0は正常終了を表します。戻り値にd0を使用している場合は別です。 ファンクション$00〜$0FまではＯＰＭＤＲＶ．Ｘとコンパチでほぼ同等の機能を 果たします。「その１」はあくまで「ＯＰＭＤＲＶ．Ｘ」との互換性を 保つために設けたコール方法で「その２」の方法の方が応答が高速です。 ドライバの常駐チェックは具体的にはリスト１の様にします。原理はTRAP #3 のベクタが指し示すアドレス−8から"ZmuSiC"があるかどうかを調べているだけです。 　さらに"ZmuSiC"の後ろにはバージョンコード２バイトが格納されています。 上位バイト バージョン整数部, バージョン少数第１桁 下位バイト 対応バージョンコード, バージョン少数第２桁 対応バージョンコード UNIVERSAL VERSION 0 16bit VERSION 1 RS-MIDI VERSION 2 POLYPHON VERSION 3 例 POLYPHON VERSION 1.52 → "ZmuSiC",$15(.b),$32(.b) リスト１ chk_drv: * > eq＝常駐確認 * > mi＝常駐していない move.l $8c.w,a0 subq.w #8,a0 cmpi.l #'ZmuS',(a0)+ bne chk_drv_err cmpi.w #'iC',(a0)+ bne chk_drv_err rts chk_drv_err: moveq.l #-1,d0 rts -------------------------------------------------------------------------------- ファンクション$00 m_init 機能: 音源、ドライバの初期化 引数: なし 戻り値: なし -------------------------------------------------------------------------------- ファンクション$01 m_alloc 機能: トラックバッファの確保 引数: d2の上位16ビット＝トラックナンバー(1〜80) d2の下位16ビット＝バッファサイズ($00A0〜$ffff) 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$02 m_assign 機能: 確保したトラックバッファをどの音源に割り当てるかを設定する 引数: d2の上位16ビット＝チャンネル番号（1〜25，ただし ＰＣＭ８独立チャンネルモード時は1〜32となる） d2の下位16ビット＝トラック番号（1〜80） 戻り値: なし d0.l＝エラーコード 備考: チャンネル番号とその対応デバイスはベースチャンネルモードによって 変動する。 m_ch("FM")、(B0)の時 チャンネル番号 1〜8 内蔵ＦＭ音源チャンネル1〜8 9 内蔵ＡＤＰＣＭ音源 10〜25 ＭＩＤＩチャンネル1〜16 26〜32 ＡＤＰＣＭチャンネル2〜8(ＰＣＭ８独立チャンネルモード時) m_ch("MIDI")、(B1)の時 チャンネル番号 1〜16 ＭＩＤＩチャンネル1〜16 17〜24 内蔵ＦＭ音源チャンネル1〜8 25 内蔵ＡＤＰＣＭ音源 26〜32 ＡＤＰＣＭチャンネル2〜8(ＰＣＭ８独立チャンネルモード時) -------------------------------------------------------------------------------- ファンクション$03 m_vget 機能: ＦＭ音源音色データの取り出し 引数: d2.l＝音色番号(1〜200) a1.l＝データ格納領域のアドレス(55バイト分) 戻り値: 0(a1)〜54(a1):音色データ d0.l＝エラーコード 備考 0(a1)〜54(a1)とパラメータの対応 ０:AF(ﾌｨｰﾄﾞﾊﾞｯｸ/ｱﾙｺﾞﾘｽﾞﾑ) (0〜63) １:OM(ｽﾛｯﾄﾏｽｸ) (0〜15) ２:WF(ｳｪｰｳﾞﾌｫｰﾑ) (0〜3) ３:SYC(ｼﾝｸﾛ) (0,1) ４:SPD(ｽﾋﾟｰﾄﾞ) (0〜255) ５:PMD (0〜127) ６:AMD (0〜127) ７:PMS (0〜7) ８:AMS (0〜3) ９:PAN (0〜3) 10:DUMMY 11(OP1),22(OP2),33(OP3),44(OP4):AR(ｱﾀｯｸﾚｰﾄ) (0〜31) 12(OP1),23(OP2),34(OP3),45(OP4):1DR(1stﾃﾞｨｹｲﾚｰﾄ) (0〜31) 13(OP1),24(OP2),35(OP3),46(OP4):2DR(2ndﾃﾞｨｹｲﾚｰﾄ) (0〜31) 14(OP1),25(OP2),36(OP3),47(OP4):RR(ﾘﾘｰｽﾚｰﾄ) (0〜15) 15(OP1),26(OP2),37(OP3),48(OP4):1DL(1stﾃﾞｨｹｲﾚﾍﾞﾙ) (0〜15) 16(OP1),27(OP2),38(OP3),49(OP4):TL(ﾄｰﾀﾙﾚﾍﾞﾙ) (0〜127) 17(OP1),28(OP2),39(OP3),50(OP4):KS(ｷｰｽｹｰﾘﾝｸﾞ) (0〜3) 18(OP1),29(OP2),40(OP3),51(OP4):MUL(ﾌｪｰｽﾞﾏﾙﾁﾌﾟﾗｲ) (0〜15) 19(OP1),30(OP2),41(OP3),52(OP4):DT1(ﾃﾞｨﾁｭｰﾝ1) (0〜7) 20(OP1),31(OP2),42(OP3),53(OP4):DT2(ﾃﾞｨﾁｭｰﾝ2) (0〜3) 21(OP1),32(OP2),43(OP3),54(OP4):AME(AMSｲﾈｰﾌﾞﾙ) (0,1) パラメータの機能や詳しい解説は専門書や「ＢＡＳＩＣマニュアル」の M_VSET()やM_VGET()の項を参照のこと。 -------------------------------------------------------------------------------- ファンクション$04 m_vset 機能: ＦＭ音源音色の設定 引数: d2.l＝音色番号(1〜200) a1.l＝データ格納領域のアドレス(55バイト分) 戻り値: なし d0.l＝エラーコード 備考: パラメータフォーマットについてはファンクション$03の備考を参照。 -------------------------------------------------------------------------------- ファンクション$05 m_tempo 機能: テンポの設定／取り出し 引数: 20≦d2.l≦300:音楽的テンポ値(１分間に4分音符を何個演奏するか) d2.l＝−1:d0.lに現在のテンポ値、a0.lに現在のタイマー値を返す 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$06 m_trk 機能: ＭＭＬデータのバッファへの書き込み 引数: d2.l＝トラック番号（1〜80） a1.l＝ＭＭＬ文字列データ格納アドレス 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$07 m_free 機能: トラックバッファの空き容量 引数: d2.l＝トラック番号（1〜80） 戻り値: d0.l＝空き容量値 備考: ＺＭＤ演奏中の場合は戻り値の内容は保証されない。 -------------------------------------------------------------------------------- ファンクション$08 m_play 機能: 演奏開始 引数: トラック1〜32がd2.lのビット0〜31 トラック33〜64がd3.lのビット0〜31 トラック65〜80がd4.wのビット0〜15 に対応し、ビット＝1で指定されたトラックの演奏を開始する。 ただし、d2.l＝d3.l＝d4.w＝0の場合は全トラック演奏開始する。 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$09 m_stat 機能: 演奏状態の検査 引数: チャンネル1〜32がd2.lのビット0〜31に対応し、 ビット＝1のチャンネルに対して検査を行う。 d2.l＝0の時は全チャンネル検査を行なう 戻り値: 検査査定されたチャンネルのうちどれかひとつでも演奏中なら、d0.l＝1を返す。 d2.l＝0で全チャンネルを検査対象にした場合は、演奏中のチャンネルに 対応したビット＝1をd0.lに返す。 備考: チャンネル番号とその対応デバイスはベースチャンネルモードによって 変動する。 m_ch("FM")、(B0)の時 チャンネル番号 1〜8 内蔵ＦＭ音源チャンネル1〜8 9 内蔵ＡＤＰＣＭ音源 10〜25 ＭＩＤＩチャンネル1〜16 26〜32 ＡＤＰＣＭチャンネル2〜8(ＰＣＭ８独立チャンネルモード時) m_ch("MIDI")、(B1)の時 チャンネル番号 1〜16 ＭＩＤＩチャンネル1〜16 17〜24 内蔵ＦＭ音源チャンネル1〜8 25 内蔵ＡＤＰＣＭ音源 26〜32 ＡＤＰＣＭチャンネル2〜8(ＰＣＭ８独立チャンネルモード時) -------------------------------------------------------------------------------- ファンクション$0A m_stop 機能: 演奏停止 引数: トラック1〜32がd2.lのビット0〜31 トラック33〜64がd3.lのビット0〜31 トラック65〜80がd4.wのビット0〜15 に対応し、ビット＝1で指定されたトラックの演奏を停止する。 ただし、d2.l＝d3.l＝d4.w＝0の場合は全トラック演奏停止する。 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$0B m_cont 機能: 演奏再開 引数: トラック1〜32がd2.lのビット0〜31 トラック33〜64がd3.lのビット0〜31 トラック65〜80がd4.wのビット0〜15 に対応し、ビット＝1で指定されたトラックの演奏を再開する。 ただし、d2.l＝d3.l＝d4.w＝0の場合は全トラック演奏再開する。 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$0C m_atoi 機能: トラックバッファの先頭アドレスを得る 引数: d2.l＝トラック番号（1〜80） 戻り値: d0.l＝トラックバッファの先頭アドレス値 -------------------------------------------------------------------------------- ファンクション$0D init_all 機能: 音源ドライバの初期設定 引数: なし 戻り値: なし -------------------------------------------------------------------------------- ファンクション$0E int_stop 機能: 演奏割り込みの中断 引数: なし 戻り値: なし -------------------------------------------------------------------------------- ファンクション$0F m_play2 機能: 前回に実行されたm_playをもう一度実行する 引数: なし 戻り値: なし 備考: 前回のm_play実行時のパラメータでもう一度m_playを呼び出す。 ファンクション$11で演奏を開始したあと、このファンクションを 実行しても無意味。 -------------------------------------------------------------------------------- ファンクション$10 adpcm_read 機能 ＡＤＰＣＭデータの登録と加工 引数 a1.l＝ファイルネーム格納アドレス または (a1).l＝ソースデータナンバー(0〜511) d2.l＝設定ノートナンバー(0〜511) d3の上位16ビット＝ピッチシフトパラメータ ( 0〜11:ピッチダウン 12:ニュートラル 13〜24:ピッチアップ) d3の下位16ビット＝ボリュームパラメータ (1%〜300%) d3.l＝0でデータにノンタッチ d4の上位16ビット＝ディレイカウント(0〜65535) d4の下位16ビット＝ミキシング元ノートナンバー(0〜511) ＝−1でミキシングは行わない d5の上位16ピット＝オフセットカウント(0〜65535) d5の下位16ビット＝カットサイズ(0〜65535) d5.l＝0でデータの切り出しを行わない d6.l≠0で逆転 d6.l＝0で逆転なし d7の上位16ピット＝オフセットカウント(0〜65535) d7のビット8〜15＝モード(−1:フェード・イン,＋1:フェード・アウト) d7のビット0〜7＝フェード・イン／アウト・レベル(0〜127) 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$11 play_cnv_data 機能: ＺＭＤの演奏 引数: d2.l＝データ総サイズ d2.l＝0の場合はドライバ内にデータを転送せず即演奏(高速応答) a1.l＝演奏データ格納アドレス(備考参照) 戻り値: なし d0.l＝エラーコード 備考： ＺＭＤの構造 Offset ＋0 :$10(.b) ←偶数アドレス} ＋1〜＋6:'ZmuSiC' }メモリ上に無くても構わない ＋7 :Version Number(.b) ←a1.lで指し示すべきアドレス(奇数アドレス) なお、内部フォーマットについての詳しい解説はMEASURE12参照 -------------------------------------------------------------------------------- ファンクション$12 se_play 機能: 効果音演奏 引数: d2.l＝何トラックから割り込ませるか（1〜32） a1.l＝演奏データ格納アドレス(備考参照) 戻り値: なし 備考： 効果音の構造 Offset ＋0 :$10(.b) ←偶数アドレス} ＋1〜＋6:'ZmuSiC' }メモリ上に無くても構わない ＋7 :Version Number(.b) } ＋8〜 :共通コマンド } ＋? :Number of tracks(.w) ←a1.lで指し示すべきアドレス(偶数アドレス) なお、内部フォーマットについての詳しい解説はMEASURE12参照 -------------------------------------------------------------------------------- ファンクション$13 se_adpcm1 機能: ＡＤＰＣＭの効果音演奏 引数: a1.l＝ＡＤＰＣＭデータ格納アドレス d2.l＝ＡＤＰＣＭデータサイズ d3(bit00〜07)＝PAN(0〜3) d3(bit08〜15)＝FRQ(0〜4) d3(bit16〜23)＝優先レベル(低0〜255高) 戻り値: なし 備考: 優先レベルの例 現在鳴っている音の 新しく鳴らそうとしている音の 結果 優先レベル 優先レベル 0 0 新しいのが鳴る 0 1 新しいのが鳴る 1 0 新しいのが拒否される 通常は0(従来通り)で構わない。ゲーム等の面と面のつなぎのメッセージやイベントの メッセージなどの爆発音等の効果音等に邪魔されたくない時に使用するとよい。 優先レベルはＰＣＭ８独立チャンネルモード時は意味をなさない。 -------------------------------------------------------------------------------- ファンクション$14 se_adpcm2 機能: ＺＭＵＳＩＣ内に登録済みのＡＤＰＣＭ音の効果音演奏 引数: d2.l＝ノート番号(0〜511) d3(bit00〜07)＝PAN(0−3) d3(bit08〜15)＝FRQ(0−4) d3(bit16〜23)＝優先レベル(低0〜255高) 戻り値: なし 備考： 優先レベルについてはファンクション$13と同様。 -------------------------------------------------------------------------------- ファンクション$15 set_ch_mode 機能: ベースチャンネルモード指定 引数: d2.l≠0 ＭＩＤＩチャンネル基準モード d2.l＝0 ＦＭチャンネル基準モード 戻り値: なし 備考: このファンクションの設定内容によってチャンネル番号と対応デバイスが 変化する。 d2.l＝0の時（m_ch("FM")、(B0)の時） チャンネル番号 1〜8 内蔵ＦＭ音源チャンネル1〜8 9 内蔵ＡＤＰＣＭ音源 10〜25 ＭＩＤＩチャンネル1〜16 26〜32 ＡＤＰＣＭチャンネル2〜8(ＰＣＭ８独立チャンネルモード時) d2.l≠0の時（m_ch("MIDI")、(B1)の時） チャンネル番号 1〜16 ＭＩＤＩチャンネル1〜16 17〜24 内蔵ＦＭ音源チャンネル1〜8 25 内蔵ＡＤＰＣＭ音源 26〜32 ＡＤＰＣＭチャンネル2〜8(ＰＣＭ８独立チャンネルモード時) -------------------------------------------------------------------------------- ファンクション$16 midi_rec 機能: ＭＩＤＩデータの記録 引数: なし 戻り値: なし 備考: ファンクション実行後、ＭＩＤＩインターフェースのＭＩＤＩ−ＩＮ端子より 受信したデータをトラックバッファへ格納していく。バッファオーバーフローを 起こすとビープ音が鳴る。この場合データ内容は意味をなさない。 -------------------------------------------------------------------------------- ファンクション$17 midi_rec_end 機能: ＭＩＤＩデータ記録モード終了 引数: d2.l＝0 文字列データへ変換 d2.l≠0 データを加工しない 戻り値: d0.l＝データサイズ a0.l＝data address エラーの場合はd0.l＝エラーコード/a0.l＝0となる 備考: ファンクション$16を終了する。文字列データ(d2.l＝0)へ変換する際、 ワークエリアを使用する。文字列データ作成時にワークが不足していると ビーブ音が鳴る。この場合データ内容は意味をなさない。 -------------------------------------------------------------------------------- ファンクション$18 midi_trns 機能: ＭＩＤＩデータの転送 引数: d2.l＝0 アスキー文字列データ転送モード d2.l≠0 バイナリデータ転送モード(データサイズ) a1.l＝データ先頭アドレス 戻り値: なし d0.l＝エラーコード -------------------------------------------------------------------------------- ファンクション$19 calc_total 機能: 各トラックの演奏データのステップタイムの合計値を求め 演奏トラックワークのp_totalに格納する 引数: d2≠0:計算してp_totalに格納する。 d2＝0:計算してp_totalに格納して結果を画面に表示する。 戻り値: d0.L＝−1:演奏データにエラーが残存しているため、計算を行えなかった d0.L＝−2:どのトラックにも演奏データは存在しなかった 　　　　d0.L＝0:正常終了 備考: トラックバッファに格納されている演奏データについて計算処理を行う。 演奏中の場合は、演奏を停止して計算処理をする。 -------------------------------------------------------------------------------- ファンクション$1a fade_out 機能: 演奏中の全トラックに対してフェード・イン／アウトを行う 引数: d2.l＝−85〜−1:フェード・イン d2.l＝0:フェード・アウト・モード解除 d2.l＝1〜85:フェード・アウト 戻り値: d0.l＝0:設定完了 d0.l＝−1:設定失敗(すでにフェード・イン／アウト実行中) 備考: d2.l＝0以外ではd2.lの絶対値は音量の増減スピードに相当し、絶対値が 大きいほど増減スピードは速くなる。 d2.l＝0では単に各トラックの音量が下がるのを停止するのみ。通常音量には 戻すことはしない。 演奏中のトラックのうち１トラックでもフェード・イン／アウトを実行中なら 本ファンクションは拒絶される(戻り値:d0.l＝−1になる)。 -------------------------------------------------------------------------------- ファンクション$1b m_vset2 機能: ＦＭ音源音色の設定(AL/FB分離フォーマット形式) 引数: d2.l＝音色番号(1〜200) a1.l＝パラメータデータ格納アドレス(55バイト分) 戻り値: なし d0.l＝エラーコード 備考 0(a1)〜54(a1)とパラメータの対応 00(OP1),11(OP2),22(OP3),33(OP4):AR(ｱﾀｯｸﾚｰﾄ) (0〜31) 01(OP1),12(OP2),23(OP3),34(OP4):1DR(1stﾃﾞｨｹｲﾚｰﾄ) (0〜31) 02(OP1),13(OP2),24(OP3),35(OP4):2DR(2ndﾃﾞｨｹｲﾚｰﾄ) (0〜31) 03(OP1),14(OP2),25(OP3),36(OP4):RR(ﾘﾘｰｽﾚｰﾄ) (0〜15) 04(OP1),15(OP2),26(OP3),37(OP4):1DL(1stﾃﾞｨｹｲﾚﾍﾞﾙ) (0〜15) 05(OP1),16(OP2),27(OP3),38(OP4):TL(ﾄｰﾀﾙﾚﾍﾞﾙ) (0〜127) 06(OP1),17(OP2),28(OP3),39(OP4):KS(ｷｰｽｹｰﾘﾝｸﾞ) (0〜3) 07(OP1),18(OP2),29(OP3),40(OP4):MUL(ﾌｪｰｽﾞﾏﾙﾁﾌﾟﾗｲ) (0〜15) 08(OP1),19(OP2),30(OP3),41(OP4):DT1(ﾃﾞｨﾁｭｰﾝ1) (0〜7) 09(OP1),20(OP2),31(OP3),42(OP4):DT2(ﾃﾞｨﾁｭｰﾝ2) (0〜3) 10(OP1),21(OP2),32(OP3),43(OP4):AME(AMSｲﾈｰﾌﾞﾙ) (0,1) 44:AL(ｱﾙｺﾞﾘｽﾞﾑ) (0〜7) 45:FB(ﾌｨｰﾄﾞﾊﾞｯｸ) (0〜7) 46:OM(ｽﾛｯﾄﾏｽｸ) (0〜15) 47:PAN (0〜3) 48:WF(ｳｪｰｳﾞﾌｫｰﾑ) (0〜3) 49:SYC(ｼﾝｸﾛ) (0,1) 50:SPD(ｽﾋﾟｰﾄﾞ) (0〜255) 51:PMD (0〜127) 52:AMD (0〜127) 53:PMS (0〜7) 54:AMS (0〜3) パラメータの機能や詳しい解説は専門書や「Ｘ−ＢＡＳＩＣマニュアル」の M_VSET()やM_VGET()の項を参照のこと。 -------------------------------------------------------------------------------- ファンクション$1c send_rd_exc 機能: ローランド・エクスクルーシブ・データの転送 引数: d2.l＝データサイズ d3(bit16〜31)＝デバイスＩＤ d3(bit0〜15)＝モデルＩＤ a1.l＝データ格納アドレス 戻り値: なし -------------------------------------------------------------------------------- ファンクション$1d send_exc 機能: エクスクルーシブ・データの転送 引数: d2.l＝データサイズ a1.l＝データ格納アドレス 戻り値: なし -------------------------------------------------------------------------------- ファンクション$1e sc55_p_rsv 機能: ローランドＳＣ５５のパーシャル(ボイス)リザーブ 引数: d2.l＝データサイズ(d2.l＝16でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝パラメータデータ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 sc55_v_reserve()参照。 -------------------------------------------------------------------------------- ファンクション$1f sc55_reverb 機能: ローランドＳＣ５５のリバーブパラメータセット 引数: d2.l＝データサイズ(1≦d2.l≦7でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝パラメータデータ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 sc55_reverb()参照。 -------------------------------------------------------------------------------- ファンクション$20 sc55_chorus 機能: ローランドＳＣ５５のコーラスパラメータセット 引数: d2.l＝データサイズ(1≦d2.l≦8でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝パラメータデータ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 sc55_chorus()参照。 -------------------------------------------------------------------------------- ファンクション$21 sc55_part_parameter 機能: ローランドＳＣ５５のパートパラメータ 引数: d2.l＝データサイズ(1≦d2.l≦119でないと楽器の状態は保証されず) d3(bit16〜31)＝PART NUMBER(1〜16) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝パラメータデータ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 sc55_part_setup()参照。 -------------------------------------------------------------------------------- ファンクション$22 sc55_drum_parameter 機能: ローランドＳＣ５５のドラムパラメータ 引数: d2.l＝データサイズ(1≦d2.l≦8でないと楽器の状態は保証されず) d3(bit24〜31)＝Map Number(0〜1) d3(bit16〜23)＝Note Number(0〜127) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 sc55_drum_setup()参照。 -------------------------------------------------------------------------------- ファンクション$23 sc55_print 機能: ローランドＳＣ５５の画面に文字列を表示する 引数: d2.l＝文字列サイズ(1≦d2.l≦32でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝文字列格納アドレス 戻り値: なし -------------------------------------------------------------------------------- ファンクション$24 sc55_display 機能: ローランドＳＣ５５の画面にグラフィックを表示する 引数: d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス(パラメータの個数は16個に固定) (必ず偶数。さもなくばアドレスエラーが発生する) 戻り値: なし 備考: パラメータフォーマットはMEASURE3 sc55_display()参照。 -------------------------------------------------------------------------------- ファンクション$25 mt32_p_rsv 機能: ローランドＭＴ３２のパーシャルリザーブを行う 引数: d2.l＝データサイズ(d2.l＝9でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 mt32_p_reserve()参照。 -------------------------------------------------------------------------------- ファンクション$26 mt32_reverb 機能: ローランドＭＴ３２のリバーブパラメータの設定 引数: d2.l＝データサイズ(1≦d2.l≦3でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 mt32_reverb()参照。 -------------------------------------------------------------------------------- ファンクション$27 mt32_setup 機能: ローランドＭＴ３２のパートパラメータの設定 引数: d2.l＝データサイズ(1≦d2.l≦9でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 mt32_part_setup()参照。 -------------------------------------------------------------------------------- ファンクション$28 mt32_drum 機能: ローランドＭＴ３２のドラムパラメータの設定 引数: d2.l＝データサイズ(1≦d2.l≦4でないと楽器の状態は保証されず) d3(bit16〜31)＝NOTE NUMBER(0〜127) (ただし受信可能範囲(24〜87)以外は無視される) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 mt32_drum_setup()参照。 -------------------------------------------------------------------------------- ファンクション$29 mt32_common 機能: ローランドＭＴ３２の音色のコモンパラメータの設定 引数: d2.l＝データサイズ(1≦d2.l≦15でないと楽器の状態は保証されず) d3(bit16〜31)＝Program NUMBER(1〜64) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: a1.lから格納されているパラメータデータは以下の書式に従う。 Program Name(最大10文字),$00(.b),Param1(.b),Param2(.b),…,Param4(.b) パラメータフォーマットはMEASURE3 mt32_common()参照。 -------------------------------------------------------------------------------- ファンクション$2a mt32_partial 機能: ローランドＭＴ３２の音色のパーシャルパラメータの設定 引数: d2.l＝データサイズ(1≦d2.l≦58でないと楽器の状態は保証されず) d3(bit24〜31)＝PROG NUMBER(1〜64) d3(bit16〜23)＝PARTIAL NUMBER(1〜4) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 mt32_partial()参照。 -------------------------------------------------------------------------------- ファンクション$2b mt32_patch 機能: ローランドＭＴ３２のパッチパラメータの設定 引数: d2.l＝データサイズ(1≦d2.l≦7でないと楽器の状態は保証されず) d3(bit16〜31)＝PATCH NUMBER(1〜128) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 mt32_patch()参照。 -------------------------------------------------------------------------------- ファンクション$2c mt32_print 機能: ローランドＭＴ３２の画面に文字列を表示する 引数: d2.l＝文字列サイズ(1≦d2.l≦20でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝文字列格納アドレス 戻り値: なし -------------------------------------------------------------------------------- ファンクション$2d u220_setup 機能: ローランドＵ２２０のセットアップパラメータの設定 引数: d2.l＝データサイズ(d2.l＝7でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 u220_setup()参照。 -------------------------------------------------------------------------------- ファンクション$2e u220_common 機能: ローランドＵ２２０テンポラリパッチのコモンパラメータの設定 引数: d2.l＝データサイズ(d2.l＝18でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 u220_setup()参照。 -------------------------------------------------------------------------------- ファンクション$2f u220_d_setup 機能: ローランドＵ２２０テンポラリパッチのドラムパラメータの設定 引数: d2.l＝データサイズ(d2.l＝7でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 u220_drum_setup()参照。 -------------------------------------------------------------------------------- ファンクション$30 u220_p_setup 機能: ローランドＵ２２０テンポラリパッチのパートパラメータの設定 引数: d2.l＝データサイズ(d2.l＝13でないと楽器の状態は保証されず) d3(bit16〜31)＝PART NUMBER(1〜6) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 u220_part_setup()参照。 -------------------------------------------------------------------------------- ファンクション$31 u220_print 機能: ローランドＵ２２０テンポラリパッチエリアにメッセージ表示 引数: d2.l＝文字列サイズ(1≦d2.l≦12でないと楽器の状態は保証されず) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝文字列格納アドレス 戻り値: なし -------------------------------------------------------------------------------- ファンクション$32 u220_timbre 機能: ローランドＵ２２０ティンバーパラメータの設定 引数: d2.l＝データサイズ(27≦d2.l≦39でないと楽器の状態は保証されず) d3(bit16〜31)＝PROGRAM NUMBER(1〜128) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: a1.lから格納されているデータは以下の書式に従う。 Timbre Name(12文字以内),$00(.b),Param1(.b),Param2(.b),…,param26(.b) パラメータフォーマットはMEASURE3 u220_timbre()参照。 -------------------------------------------------------------------------------- ファンクション$33 u220_drum 機能: ローランドＵ２２０テンポラリエリアのリズムキットの書き換え 引数: d2.l＝データサイズ(1≦d2.l≦20でないと楽器の状態は保証されず) d3(bit16〜31)＝NOTE NUMBER(35〜99) d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) a1.l＝データ格納アドレス 戻り値: なし 備考: パラメータフォーマットはMEASURE3 u220_drum_inst()参照。 -------------------------------------------------------------------------------- ファンクション$34 m1_midi_ch 機能: ＫＯＲＧ Ｍ１のシーケンサＳＯＮＧ０の受信ＭＩＤＩチャンネルの設定 引数: a1.l＝データ格納アドレス 戻り値: なし 備考: 0(a1)＝パート１の受信ＭＩＤＩチャンネル(1〜16) 1(a1)＝パート２の受信ＭＩＤＩチャンネル(1〜16) : 7(a1)＝パート８の受信ＭＩＤＩチャンネル(1〜16) -------------------------------------------------------------------------------- ファンクション$35 send_to_m1 機能: ファンクション$34,$36,$37で設定したパラメータを ＫＯＲＧ Ｍ１のシーケンサＳＯＮＧ０へ設定 引数: d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) 戻り値: なし -------------------------------------------------------------------------------- ファンクション$36 m1_p_setup 機能: ＫＯＲＧ Ｍ１のシーケンサＳＯＮＧ０のトラックパラメータの設定 引数: a1.l＝データ格納アドレス(パラメータデータは必ず40個なければならない) 戻り値: なし 備考: パラメータフォーマットはMEASURE3 m1_part_setup()参照。 -------------------------------------------------------------------------------- ファンクション$37 m1_e_setup 機能: ＫＯＲＧ Ｍ１のシーケンサＳＯＮＧ０のエフェクトパラメータの設定 引数: a1.l＝データ格納アドレス(パラメータは必ず25個なければならない) 戻り値: なし 備考: パラメータフォーマットはMEASURE3 m1_effect_setup()参照。 -------------------------------------------------------------------------------- ファンクション$38 m1_print 機能: ＫＯＲＧ Ｍ１のシーケンサＳＯＮＧ０のソングネームの設定 引数: d2.l＝文字列サイズ(1≦d2.l≦10でないと楽器の状態は保証されず a1.l＝文字列格納アドレス 戻り値: なし -------------------------------------------------------------------------------- ファンクション$39 block_adpcm_data 機能: ＺＰＤの登録 引数: a1.l＝ＺＰＤ・ファイルのファイルネーム格納アドレス 戻り値: なし d0.l＝エラーコード 備考: ファイルネームは 文字列,$00(.B) の書式に従う。 -------------------------------------------------------------------------------- ファンクション$3a get_trk_tbl 機能: 演奏トラックテーブル／絶対チャンネルテーブルのアドレス 引数: なし 戻り値: d0.l＝絶対チャンネルテーブルのアドレス a0.l＝演奏トラックテーブルのアドレス 備考： m_ch("FM"),(B0)のときはd0.lの指し示すアドレスから 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24 m_ch("MIDI"),(B1)のときはd0.lの指し示すアドレスから 9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,0,1,2,3,4,5,6,7,8 a0.lの指し示すアドレスからは演奏すべきトラックナンバーが最大32個 格納されている。終端コードは$ff(.B)。 例えばトラック1〜9を演奏する(している)時は 0,1,2,3,4,5,6,7,8,$ff (値はトラック番号−1) のようになっている。 -------------------------------------------------------------------------------- ファンクション$3b set_loop_time 機能: 全トラックがd2.b回以上ループしたらa1.lへBSRする 引数: d2.b＝0 loop time(s) (0〜255) a1.l＝飛び先アドレス(＝0で解除) 戻り値: なし -------------------------------------------------------------------------------- ファンクション$3c get_play_work 機能: 演奏トラックワークのアドレスを返す 引数: d2.b＝trk number(1〜80) 戻り値: a0.l＝演奏ワーク・アドレス d0.l＝コンパイル・ワーク・アドレス 備考: 具体的なワーク内容についてはMEASURE13を参照。 -------------------------------------------------------------------------------- ファンクション$3d get_timer_mode 機能: どのタイマで割り込みを実現しているかを返す 引数: なし 戻り値: d0.l＝0 timer A d0.l＝1 timer B -------------------------------------------------------------------------------- ファンクション$3e set_fm_master_vol 機能: ＦＭ音源のマスターボリュームを設定する 引数: d2.l＝マスターボリューム値(0〜255) 戻り値: なし 備考: 演奏中は無効。ＺＭＤ作成前にのみ有効。 -------------------------------------------------------------------------------- ファンクション$3f set_timer_value 機能: タイマーの値を設定する 引数: d2.l＝タイマー値 戻り値: なし 備考: 設定した値は、現在テンポ源となっている割り込みタイマーに対して 直接書き込まれる。 -------------------------------------------------------------------------------- ファンクション$40 release_support 機能: ＺＭＵＳＩＣ．Ｘ用(またはＺＭＳＣ．Ｘ用)のサブプログラムの名前を登録する (あるいは登録したものを取り消す) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 引数: 登録時 a1.l＝filename address (解除プログラムの名前を登録) 戻り値: d0.l＝0≦result code 正常登録されました。(ok) d0.l＝−1 既に４つ登録されており、これ以上の登録は出来ません。(error) 備考: 名前を登録しておくとＺＭＵＳＩＣ．Ｘ解除時に 一緒に解除する。filename(100文字以内)は 'a:\bin\zp -r',0 のようなフォーマットとする。 最大４つまで登録可能。 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 引数: キャンセル時 a1.l＝0 d2.l＝登録終了時に返ってきたresult code 戻り値: d0.l＝0 キャンセル完了(ok) d0.l＝−1 エラー 備考: result codeにより任意のプログラムの登録キャンセルが可能。 -------------------------------------------------------------------------------- ファンクション$41 jump_active 機能: [!]/[@]/[end]コマンドの有効化／無効化スイッチ 引数: d2.l＝0 無効 d2.l≠0 有効 戻り値: なし 備考: 演奏中は無効。ＺＭＤ作成前にのみ有効。 -------------------------------------------------------------------------------- ファンクション$42 set_mclk 機能: 全音符の絶対音長を設定する 引数: d2.l＝1〜254 戻り値: なし 備考: 演奏中は無効。ＺＭＤ作成前にのみ有効。 -------------------------------------------------------------------------------- ファンクション$43 picture_sync 機能: 映像同期モードのオン／オフ 引数: d2.l＝0 映像同期モードオフ ≠0 映像同期モードオン 戻り値: 状態 設定しようとする状態 結果 ＯＮ ＯＦＦ ＯＦＦ(正常終了:d0.l＝0) ＯＮ ＯＮ エラー(d0.l＝−1) ＯＦＦ ＯＦＦ エラー(d0.l＝−1) ＯＦＦ ＯＮ ＯＮ(正常終了:d0.l＝0) 備考:　 具体的な使用方法についてはMEASURE14を参照のこと。 -------------------------------------------------------------------------------- ファンクション$44 mask_channels 機能: 演奏チャンネルのマスクキングを行う 引数: d2.l＝マスクしたいチャンネルのビットパターン bit＝1 mask ch bit＝0 enable ch 備考: m_ch("fm")または(B0)のときはビット0〜24がＦＭ1〜8, ＡＤＰＣＭ1, ＭＩＤＩ1〜16に対応し m_ch("midi")または(B1)のときはビット0〜24がＭＩＤＩ1〜16, ＦＭ1〜8, ＡＤＰＣＭ1に 対応する。 'm_ch()',(Ｂn)によらずＰＣＭ８独立チャンネルモード時はビット25〜31が ＡＤＰＣＭ2〜8に対応する。 -------------------------------------------------------------------------------- ファンクション$45 buffer_info 機能: 各バッファのアドレス、サイズ、終了アドレスの情報を得る 引数: なし 戻り値: 0(a0)＝トラックバッファの先頭アドレス trk_top 4(a0)＝トラックバッファのサイズ trk_buf_size 8(a0)＝トラックバッファ終了アドレス trk_buf_end ＝ＺＭＵＳＩＣの最終アドレス (dev_end_adr) 12(a0)＝ＡＤＰＣＭバッファ先頭アドレス adpcm_buffer_top 16(a0)＝ＡＤＰＣＭバッファサイズ adpcm_buffer_size 20(a0)＝ＡＤＰＣＭバッファ終了アドレス adpcm_buffer_end 24(a0)＝汎用ワークエリア先頭アドレス adpcm_work_top 28(a0)＝汎用ワークエリアサイズ adpcm_work_size 32(a0)＝汎用ワークエリア終了アドレス adpcm_work_end 36(a0)＝新規に登録される adpcm_buffer_next ＡＤＰＣＭデータが 格納されるアドレス adpcm_buffer_top≦adpcm_buffer_next≦adpcm_buffer_end 40(a0)＝次にワークが使用される場合の adpcm_work_now 汎用ワーク使用可能開始アドレス adpcm_work_top≦adpcm_work_now≦adpcm_work_end 44(a0)＝汎用ワークエリアの本当のサイズ adpcm_work_true_size 48(a0)＝演奏トラックワーク格納アドレス seq_wk_tbl 52(a0)＝効果音トラックワーク格納アドレス seq_wk_tbl2 56(a0)＝ＡＤＰＣＭデータの管理テーブル adpcm_tbl 格納アドレス 60(a0)＝波形メモリの管理テーブル wave_tbl 格納アドレス 64(a0)＝ＦＭ音源音色バッファのアドレス neiro 68(a0)＝各トラックの先頭アドレス trk_po_tbl 格納テーブルアドレス(1,2,3,...80) 72(a0)＝m_allocで確保した各トラックの trk_len_tbl サイズ格納アドレス(1,2,3,...80) 備考: 各バッファのアドレスを書き替えることによって、バッファを外部のものに 切り換えたりすることも可能となる。たとえばＡＤＰＣＭバッファを ＺＭＵＳＩＣ常駐時に確保しなかったとしても、あとで、別プログラムが 用意した領域を指し示すようにadpcm_buffer_top等を書き替え、 ポインタであるadpcm_buffer_nextをadpcm_buffer_next＝adpcm_buffer_top と初期化してやれば、その領域をＡＤＰＣＭバッファとして使用できるように なる。 汎用ワークエリアはＡＤＰＣＭコンフィギュレーションファイルの 一時退避場所としてや、波形メモリのバッファ(ＺＭＳ時)、 ＡＤＰＣＭデータ加工時のワークとして使用されておりデータ内容保守の 関係で状況に応じてワークサイズ(adpcm_work_size)が伸縮する。よって 汎用ワークエリアを外部プログラムで用意したものと差し換えるには adpcm_work_top,adpcm_work_size, adpcm_work_endを設定しさらに adpcm_work_now＝adpcm_work_top adpcm_work_true_size＝adpcm_work_size とする必要がある。 -------------------------------------------------------------------------------- ファンクション$46 set_zpd_tbl 機能: ＺＰＤデータの情報を登録する 引数: a1.l＝ＺＰＤ情報テーブルのアドレス (a1.l＝ＺＰＤファイルの先頭アドレス＋8に相当) 戻り値: なし 備考: ＡＤＰＣＭデータの管理テーブルであるadpcm_tblの先頭からノート番号0から順番に ＡＤＰＣＭ データ格納アドレス(.L), ＡＤＰＣＭ データサイズ(.L)…… のように格納されている。adpcm_tblのアドレスはファンクション$45で 求めることができるので、まったく外部のプログラムから ＡＤＰＣＭデータの差し換えをすることも可能。 -------------------------------------------------------------------------------- ファンクション$47 set_output_level 機能: 演奏チャンネルの出力割合を設定する 引数: d2.l＝変更したいチャンネルのビットパターン bit＝1 変更希望チャンネル bit＝0 変更しないチャンネル d3.b＝0〜127 (出力レベル。0は消音) d3.b＝128以上 (通常に戻す) 備考: m_ch("FM")または(B0)のときはビット0〜24がＦＭ1〜8, ＡＤＰＣＭ1, ＭＩＤＩ1〜16に対応し m_ch("MIDI")または(B1)のときはビット0〜24がＭＩＤＩ1〜16, ＦＭ1〜8, ＡＤＰＣＭ1に 対応する。 'm_ch()',(Ｂn)によらずＰＣＭ８独立チャンネルモード時はビット25〜31が ＡＤＰＣＭ2〜8に対応する。 ＦＭ音源の場合は変化が指数関数的であるので注意 (d3.b＝90付近でほとんど消音する)。 -------------------------------------------------------------------------------- ファンクション$48 eox_wait 機能: ＥＯＸ($F7)送信後のウェイト時間を設定する 引数: d2.l＝ウェイト値(0〜65535) 備考: d2.l＝0 ウェイトなし d2.l＝1 ウェイト最小(約0.017秒) d2.l＝65535 ウェイト最大(約1092秒) -------------------------------------------------------------------------------- ファンクション$49 set_wave_form1 機能: 波形メモリの登録(その１) 引数: a1.l＝波形データ先頭アドレス d2.l＝データサイズ(データ数ではなくてデータの物理サイズ) d3(bit16〜23)＝波形番号(8〜31) d3(bit24〜31)＝ループ・タイプ(0〜2) d3.w＝ループポイント(0〜65535) 戻り値: なし d0.l＝エラーコード 備考:波形メモリの具体的な仕様についてはMEASURE5を参照。 -------------------------------------------------------------------------------- ファンクション$4a set_wave_form2 機能 波形メモリの登録(その２) 引数 a1.l＝波形データ先頭アドレス d2.l＝データ数(データの物理サイズではなくてデータの個数) d3(bit16〜23)＝波形番号(8〜31) d3(bit24〜31)＝ループ・タイプ(0〜2) d3.w＝ループポイント(0〜65535) 戻り値: なし d0.l＝エラーコード 備考:波形メモリの具体的な仕様についてはMEASURE5を参照。 -------------------------------------------------------------------------------- ファンクション$4b mask_tracks 機能: トラック単位のマスク 引数: d2.l＝そのトラックのマスクを解除する(1〜80) d2.l＝0(全トラックマスク解除) d2.l＝そのトラックをマスクする(−80〜−1) 備考: すでにファンクション$44のチャンネルマスクでマスクしてあると それらは以後トラックマスクとして処理される。つまり以後本ファンクションで 制御可能となる。 -------------------------------------------------------------------------------- ファンクション$4c set_output_level2 機能: トラック単位の出力割合を設定する 引数: d2.l＝変更したいトラック番号(1〜80) d2.l＝0 (全トラックを操作対象とする) d3.b＝0〜127 (出力レベル。0は消音) d3.b＝128以上 (通常に戻す) 備考: すでにファンクション$44のチャンネルマスクでマスクしてあると それらは以後トラックマスクとして処理される。つまり以後本ファンクションで 制御可能となる。 -------------------------------------------------------------------------------- ファンクション$4d get_loop_time 機能: 演奏中の現在の繰り返し回数を得る 引数: なし 戻り値: d0.l＝1〜255(現在の繰り返し回数) d0.l＜0(演奏終了、または停止中) -------------------------------------------------------------------------------- ファンクション$4e get_1st_comment 機能: 演奏中の演奏データに登場した最初のコメント文を得る 引数: なし 戻り値: a0.l＝文字列格納アドレス。文字列の終端は$00。 ------------------------------------------------------------------------------ ファンクション$4f int_start 機能: ＺＭＵＳＩＣの割り込みを再開する 引数: なし 戻り値: なし 備考:　 通常は用いる必要はない。ファンクション$0eで割り込みを停止／禁止した 　　　　あとで、割り込みを復帰する目的等で使う。 ------------------------------------------------------------------------------ ファンクション$50 zm_status 機能: ZMUSICの常駐状況の情報テーブルのアドレスを返す ﾊﾟﾗﾒｰﾀ: なし 戻り値: a0.l=情報テーブルの格納アドレス 備考: 情報テーブルの内容は以下のとおり。 0(a0).b=MIDIチャンネル有効か (ne=有効,0=無効) 1(a0).b=$FF RS232C MIDI $00 MIDI I/F(CZ6BM1相当品) $01 POLYPHON MIDI 2(a0).b=強制MIDIチャンネル有効モードか (ne=YES,0=NO) 3(a0).b=ADPCMの発音にPCM8.Xを使用中か (ne=YES,0=NO) 4(a0).w=PCM8モード (minus=独立チャンネルモード,plus=ポリモード) 6(a0).bの第0ビット=1 ジュークボックス類が常駐している。 =0 常駐していない 6(a0).bの第1ビット=1 演奏制御を割り込みで行なうプログラムが 常駐している。(ZP /Dなど) =0 常駐していない 7(a0).b=$01 演奏待機状態(ファンクション$54参照) =$FF 演奏開始 (このエリアを外部アプリケーションで$00にしておけば 演奏開始や演奏待機状態になったことを知ることができる) 8(a0).b} ： } 直前に読んだファイルのファイル名(ZPD,MDD,CNFなど) 98(a0).b} -$1(a0)} エラーが発生した場合、そのエラーコードが、このエリアに : } 格納される。-$8(a0)がいちばん新しく発生したエラーで、 -$8(a0)} -$1(a0)がいちばん昔に発生したエラー。古い物はどんどん 切り捨てられていく。外部アプリケーション側でこの８バイトを 初期化($00に)しておけば、その時点から発生したエラーを 知ることができる。 -$c(a0).l ZMUSICの割り込みが発生されるたびにインクリメントされる ここをアプリケーション側でクリアしておけば その時点からのステップカウントが求められる (ＺＭＵＳＩＣの割り込みは１ステップカウントごとに 発生する)。 注意 ワークの書き換えはZMUSICプログラム本体を十分理解してから行なうこと。 -------------------------------------------------------------------------------- ファンクション$51 sc55_init 機能: ＳＣ５５の初期化を行なう 引数: d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) 戻り値: なし ------------------------------------------------------------------------------ ファンクション$52 mt32_init 機能: ＭＴ３２の初期化を行なう 引数: d3.b＝デバイスＩＤ(d3.b＝−1で前回のを使用する) 戻り値: なし ------------------------------------------------------------------------------ ファンクション$53 リザーブ 機能: 引数: 戻り値: ------------------------------------------------------------------------------ ファンクション$54 intercept_play 機能: 演奏開始制御 引数: d2.l＝-1 演奏させないモードに設定 d2.l＝0 演奏させないモードを解除、 さらにトラックバッファ内の演奏データを演奏開始 d2.l＝1 演奏させないモードを解除 戻り値: なし 備考： 演奏させないモードに設定したあとは、あとで必ずモード解除 (d2.l=0 か d2.l=1)を行なうこと -------------------------------------------------------------------------------- ファンクション$55 m_inp1 機能: １バイトＭＩＤＩ入力 引数: d2.l＝0 入力データがない場合はエラーコードを持って帰還 d2.l≠0 入力データがない場合は1/60×d2.l秒間データの受信を待つ 戻り値: d0.b=入力データ ただし、d0.l=負の場合はエラー -------------------------------------------------------------------------------- ファンクション$56 m_out1 機能: １バイトＭＩＤＩ出力 引数: d2.b＝出力データ 戻り値: なし -------------------------------------------------------------------------------- ファンクション$57 occupied_size 機能: 各バッファの実際の使用容量を返す 引数: a1.l=戻り値の格納バッファアドレス(12バイト必要) 戻り値: なし 備考: 0(a1).l トラックバッファの使用容量 4(a1).l ＡＤＰＣＭバッファの使用容量 8(a1).l 汎用ワークエリアの使用容量 -------------------------------------------------------------------------------- { -- ZM11.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ１１ エラー ここではエラー発生時のエラーメッセージ、 エラーの原因と対処方法について解説します。 １１．１． ＭＵＳＩＣＺ．ＦＮＣのエラー −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:1 メッセージ:パラメータの省略は出来ません 原因と処置:省略できないパラメータが省略されている。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:2 メッセージ:トラック番号が規定外です 原因と処置:トラック番号の有効範囲は1〜80。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:3 メッセージ:ＺＭＵＳＩＣ．Ｘが未登録です 原因と処置:ＺＭＵＳＩＣ．Ｘを組み込んでいなければ演奏は出来ない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:4 メッセージ:トラックバッファのサイズの指定が規定外です [原因と処置:トラックバッファサイズの有効範囲は100〜65535。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:5 メッセージ:トラックバッファの確保ができません 原因と処置:トラックバッファが不足していると考えられるのでＺＭＵＳＩＣ．Ｘを 一度、解除してトラックバッファを大き目に設定して再常駐してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:6 メッセージ:チャンネル番号が規定外です 原因と処置:チャンネル番号の有効範囲は1〜25。 ただしＰＣＭ８独立チャンネルモード時は1〜32。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:7 メッセージ:配列の型が規定外です 原因と処置:配列変数の型を命令の仕様通りにする。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:8 メッセージ:ＺＭＵＳＩＣ．Ｘは現在動作を停止中です 原因と処置:外部のアプリケーションによりＺＭＵＳＩＣ．Ｘが動作を停止している。 そのアプリケーションでＺＭＵＳＩＣ．Ｘを再始動させる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:9 メッセージ:Ｉコマンドの使用法に誤りがあります 原因と処置:バンク番号は上位バイト下位バイト分けて書かなければならない。 有効範囲は両方とも0〜127である。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:10 メッセージ:この命令はコンパイル出来ません 原因と処置:その命令はステートメントではなくコマンドである。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:11 メッセージ:＠Ｘコマンドの使用法に誤りがあります 原因と処置:値は最低１個は書かなければならない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:12 メッセージ:＠Ｉコマンドの使用法に誤りがあります 原因と処置:各パラメータの有効範囲は0〜127。値の省略はできない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:13 メッセージ:相対ボリュームの指定に誤りがあります 原因と処置:相対ボリュームのパラメータの有効範囲は1〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:14 メッセージ:＠Ｃコマンドの使用法に誤りがあります 原因と処置:ＦＭ音源部とＭＩＤＩ音源部ではその機能が違う点に注意。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:15 メッセージ:＠Ａコマンドの使用法に誤りがあります 原因と処置:振幅値の有効範囲は0〜127。また、パラメータが多すぎたりして いないか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:16 メッセージ:内蔵音源には無関係のコマンドです 原因と処置:ＭＩＤＩ専用の命令をＦＭ音源やＡＤＰＣＭに対して使用している。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:17 メッセージ:＠Ｈコマンドの使用法に誤りがあります 原因と処置:モジュレーションディレイの有効範囲は0〜65534。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:18 メッセージ:＠Ｓコマンドの使用法に誤りがあります 原因と処置:モジュレーションスピードの有効範囲は1〜16383。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:19 メッセージ:未定義のＭＭＬです 原因と処置:ＺＭＵＳＩＣ．Ｘには存在しないコマンドを実行しようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:20 メッセージ:未定義の［〜］コマンドです 原因と処置:ＺＭＵＳＩＣ．Ｘには存在しないコマンドを実行しようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:21 メッセージ:］がありません 原因と処置:［〜］系のコマンドで終端の］がない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:22 メッセージ:繰り返し回数が規定外です 原因と処置:繰り返し回数の有効範囲は1〜255。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:23 メッセージ:繰り返し構造が異常です 原因と処置:多重ループを組んだ場合はネスト構造になっていなければならない。 詳しくはMEASURE5 |:〜:|コマンドの項を参照。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:24 メッセージ:繰り返し番号が規定外です 原因と処置:繰り返し番号の有効範囲は1〜255。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:25 メッセージ:オクターブ値がありません 原因と処置:オクターブの値を書く。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:26 メッセージ:オクターブ値が規定外です 原因と処置:オクターブ値の有効範囲は−1〜9。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:27 メッセージ:音長が規定外です 原因と処置:音楽的音長の有効範囲は1〜64。絶対音長の有効範囲は1〜65534。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:28 メッセージ:トラックバッファが不足しています 原因と処置:'m_alloc()'命令または(Ｍ)命令で、そのトラックのトラックバッファを 大き目に確保し直す。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:29 メッセージ:＠Ｂコマンドの使用法に誤りがあります 原因と処置:ベンド値の有効範囲は-8192〜8191。ディレイ値の有効範囲は0〜32767。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:30 メッセージ:ＡＤＰＣＭには無関係のコマンドです 原因と処置:ＦＭ音源やＭＩＤＩ音源用のコマンドをＡＤＰＣＭに対して使用出来ない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:31 メッセージ:タイの指定方法に誤りがあります 原因と処置:'&'コマンドや'^'コマンドの使用方法に誤りがあるか、 '^'コマンドにおいて合計音長が65534を超えている可能性がある。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:32 メッセージ:Ｔコマンドの使用法に誤りがあります 原因と処置:テンポの値の有効範囲は タイマーＡモード:77〜300 タイマーＢモード:20〜300 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:33 メッセージ:＠Ｔコマンドの使用法に誤りがあります 原因と処置:タイマー値の有効範囲は タイマーＡモード:0〜1023 タイマーＢモード:0〜255 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:34 メッセージ:音長値がありません 原因と処置:音長を記述する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:35 メッセージ:音量値がありません 原因と処置:音量値を記述する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:36 メッセージ:音量値が規定外です 原因と処置:音量値の有効範囲は0〜16。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:37 メッセージ:＠Ｋコマンドの使用法に誤りがあります 原因と処置:ベンド値の有効範囲は-768〜768。ディレイ値の有効範囲は0〜32767。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:38 メッセージ:キーコードの値が規定外です 原因と処置:キーコードの有効範囲はオクターブ−1のCからオクターブ９のGまで。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:39 メッセージ:音色番号が規定外です 原因と処置:音色番号の有効範囲はＦＭ音源では1〜200、ＭＩＤＩでは1〜128、 ＡＤＰＣＭのバンクは1〜4。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:40 メッセージ:｝がありません 原因と処置:連符コマンドの終端記号を書く。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:41 メッセージ:｛〜｝内に音符が多すぎます 原因と処置:音符の数が多すぎるためそれぞれの音符の音長が、計算結果で アンダーフローを起こしていると考えられる。音符の数を減らすか 絶対音長指定を用いる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:42 メッセージ:｛〜｝内に音符がありません 原因と処置:音符を書く。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:43 メッセージ:Ｑ，＠Ｑコマンドの使用法に誤りがあります 原因と処置:Ｑコマンドのパラメータの有効範囲は1〜8。 ＠Ｑコマンドの有効範囲は1〜32768。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:44 メッセージ:｛〜｝の中に規定外のものが存在します 原因と処置:連符内には音長を操作するコマンド(Ｌ,＠Ｌ,Ｑ,＠Ｑ,^)を使用出来ない。 音長を操作するコマンドがないか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:45 メッセージ:Ｙコマンドの使用法に誤りがあります 原因と処置:レジスタ番号、コントロール番号、データが不適当でないか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:46 メッセージ:Ｊコマンドの使用法に誤りがあります 原因と処置:パラメータのトラック番号の有効範囲は1〜80である。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:47 メッセージ:Ｐ／＠Ｐコマンドの使用法に誤りがあります 原因と処置:Ｐコマンドの有効範囲は0〜3、＠Ｐコマンドの有効範囲は0〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:48 メッセージ:Ｋコマンドの使用法に誤りがあります 原因と処置:Ｋコマンドの有効範囲は−768〜＋768。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:49 メッセージ:和音コマンドの使用法に誤りがあります 原因と処置:和音コマンドの'〜'中に不適当なコマンドが記述されていないか 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:50 メッセージ:和音の数が多すぎるか、あるいは後ろの’がありません 原因と処置:和音コマンドでは８和音以上の和音を発音できない。 単に終端記号を付け忘れている場合はそれを記述する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:51 メッセージ:＠Ｖコマンドの使用法に誤りがあります 原因と処置:＠Ｖコマンドの有効範囲は0〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:52 メッセージ:ポルタメントコマンドの使用法に誤りがあります 原因と処置:ポルタメントコマンド(〜)中に不適当なコマンドが記述されていないか 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:53 メッセージ:ベロシティの値が規定外です 原因と処置:ベロシティの有効範囲は0〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:54 メッセージ:Ｎ／＠Ｎコマンドの使用法に誤りがあります 原因と処置:チャンネル番号の有効範囲は1〜25。 ただしＰＣＭ８独立チャンネルモード時は1〜32。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:55 メッセージ:＠Ｍコマンドの使用法に誤りがあります 原因と処置:振幅値の有効範囲は-32768〜32767。また、パラメータが多すぎたりして いないか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:56 メッセージ:Ｈコマンドの使用法に誤りがあります 原因と処置:２つのパラメータ両方の省略はできない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:57 メッセージ:＠Ｚコマンドの使用法に誤りがあります 原因と処置:アフタータッチの値は0〜127でなければならない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:58 メッセージ:パラメータの指定方法が規定外です 原因と処置:パラメータの個数や設定有効範囲を確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:59 メッセージ:ディレイの値が長すぎます 原因と処置:ポルタメントのディレイの有効範囲は0〜32767。 和音のディレイの有効範囲は0〜255。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:60 メッセージ:ＡＤＰＣＭ用のバッファが不足しています 原因と処置:ＺＭＵＳＩＣ．Ｘを一度、常駐解除してＡＤＰＣＭバッファを大きめに 設定して再常駐してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:61 メッセージ:ＡＤＰＣＭの使用は出来ません 原因と処置:ＡＤＰＣＭバッファを確保しないで常駐させたためＡＤＰＣＭの使用が 出来なくなっている。ＺＭＵＳＩＣ．Ｘを一度、常駐解除してから ＡＤＰＣＭバッファを確保して再常駐してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:62 メッセージ:ディスクの読み込みに失敗しました 原因と処置:ファイルが見当たらないか、ファイルが壊れているか、 ファイルサイズが異常。読み込み先デバイスの状態を もう一度、確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:63 メッセージ:Ｗコマンドの使用法に誤りがあります 原因と処置:パラメータのトラック番号の有効範囲は1〜80である。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:64 メッセージ:ワークエリアが不足しています 原因と処置:ＺＭＵＳＩＣ．Ｘを一度、常駐解除してワークを大き目に設定して 再常駐してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:65 メッセージ:正体不明のエラーが発生しました 原因と処置:他のプログラム等によってＺＭＵＳＩＣ．Ｘが破壊されている可能性が あるので必要ファイルをセーブして、すみやかにリセットすべきである。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:66 メッセージ:バージョンナンバーが違うか、あるいはＺＭＵＳＩＣ用のデータではありません 原因と処置:Ｘ６８ｋシステムディスク付属のＤＵＭＰ．Ｘなどで 演奏データを確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:67 メッセージ:ＡＤＰＣＭ音色定義コマンドの使用法に誤りがあります 原因と処置:文法が違うかパラメータの与え方がおかしいと考えられる。 MEASURE6を参照。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:68 メッセージ:ＭＩＤＩインターフェースボードが未装着です 原因と処置:ＭＩＤＩボードが装着されていない時はＭＩＤＩ楽器を操作出来ない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:69 メッセージ:ＭＩＤＩ楽器に対するパラメータが規定外です 原因と処置:楽器個別コマンドの仕様を確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:70 メッセージ:パラメータ値が規定外です 原因と処置:その命令のパラメータの有効範囲をもう一度確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:71 メッセージ:ファイルの書き出しに失敗しました 原因と処置:ファイル名が異常か、ディスクが書き込み禁止であったり、 フリーエリアが不足している可能性がある。書き込み先のデバイスを もう一度確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:72 メッセージ:Ｘコマンドの使用法に誤りがあります 原因と処置:値は最低１個は書かなければならない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:73 メッセージ:データは受信されていません 原因と処置:ＭＩＤＩケーブルが断線しているか、送信側のＭＩＤＩ楽器の操作を 誤っている可能性がある。楽器のマニュアルとＭＩＤＩケーブルが正しく 接続されているか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:74 メッセージ:波形番号が規定外です 原因と処置:波形番号の有効範囲は0〜31。ただし、波形番号0〜3はプリセット波形、 波形番号8〜31はユーザー波形(波形メモリ)。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:75 メッセージ:Ｍコマンドの使用法に誤りがあります 原因と処置:ピッチ・モジュレーションのモードは0〜2、ＡＲＣＣモードは0〜1。 Ｍコマンドの値を両方省略していないか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:76 メッセージ:波形メモリ登録コマンドの使用法に誤りがあります 原因と処置:ループパターンが0〜2になっているか、ループポイントの値が正しいかを 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:77 メッセージ:；コマンドの使用法に誤りがあります 原因と処置:パラメータは最低１個は必要。パラメータの有効範囲は0〜255。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:78 メッセージ:￥コマンドの使用法に誤りがあります 原因と処置:スピードパラメータの絶対値は85以下。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:79 メッセージ:？コマンドの使用法に誤りがあります 原因と処置:パラメータの有効範囲は0〜255。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:80 メッセージ:＠Ｆコマンドの使用法に誤りがあります 原因と処置:周波数パラメータの有効範囲は0〜6。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:81 メッセージ:＠Ｇコマンドの使用法に誤りがあります 原因と処置:パラメータの有効範囲は0〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:82 メッセージ:＠Ｙコマンドの使用法に誤りがあります 原因と処置:パラメータの個数は３つ、または４つ。各パラメータの有効範囲は0〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:83 メッセージ:＠Ｅコマンドの使用法に誤りがあります 原因と処置:パラメータは最低１個は必要。パラメータの有効範囲は0〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− １１．２． ＺＭＳファイルコンパイル時のエラー ＺＭＳファイルを A>zmusic -c ファイルネーム とするとＺＭＳをコンパイルしたＺＭＤを得ることができるが、この時ＺＭＳに 誤りがあれば当然エラーを発生する。この時のエラーメッセージは英文になるが エラーメッセージの末尾についた番号はＭＵＳＩＣＺ．ＦＮＣのエラーと 対応したものになっている。たとえば MUSIC.OPM 22 ILLEGAL CHANNEL NUMBER AT @N (No.54) と出た場合、ＭＵＳＩＣＺ．ＦＮＣのエラーのエラー番号54と同内容のエラー −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− エラー番号:54 メッセージ:チャンネルアサインコマンドの使用法に誤りがあります 原因と処置:チャンネル番号の有効範囲は1〜25。 ただしＰＣＭ８独立チャンネルモード時は1〜32。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− が発生している事をあらわす。 つまりＺＭＳコンパイル時に発生するエラーの多くは全くＭＵＳＩＣＺ．ＦＮＣの エラーと１対１に対応するものなので説明は省略する。 ここではＺＭＳのコンパイル時に発生するエラーでＭＵＳＩＣＺ．ＦＮＣのエラーと 対応しないもののみを示す。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:SYNTAX ERROR. 原因と処置:あるＺＭＳコマンドのパラメータを最後まで書かないで、次の ＺＭＳコマンドを実行しようとしていたり、ファイルが終わっていたり して正常にＺＭＳコマンドを実行できない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:(A) COMMAND ERROR. 原因と処置:チャンネルアサインのＺＭＳコマンドの使用法に誤りがある。 チャンネル番号の有効範囲は1〜25。 ただしＰＣＭ８独立チャンネルモード時は1〜32。 また、トラック番号の有効範囲は1〜80。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:(M) COMMAND ERROR. 原因と処置:トラックバッファ確保のＺＭＳコマンドの使用法に誤りがある。 トラック番号の有効範囲は1〜80で、バッファサイズの有効範囲は0〜65535。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:(T) COMMAND ERROR. 原因と処置:ＭＭＬ書き込みコマンドのＺＭＳ命令の使用法に誤りがある。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:FM VOICE SET COMMAND ERROR. 原因と処置:ＦＭ音源の音色設定のＺＭＳコマンドの使用法に誤りがある。 音色のパラメータの書式や有効範囲はMEASURE4を参照。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ADPCM CONFIGURATION COMMAND ERROR. 原因と処置:ＡＤＰＣＭの登録ＺＭＳコマンドの使用法に誤りがある。 書式やパラメータの意味や有効範囲はMEASURE6を参照。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ILLEGAL PARAMETER FORMAT IN COMMON COMMAND. 原因と処置:ＺＭＳの共通コマンドにおいて不当にパラメータ等を省略している。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:WORK AREA IS TOO SMALL. 原因と処置:ワークエリアが不足している。一度、ＺＭＵＳＩＣ．Ｘを常駐解除して 　 ワークエリアを大きめに設定して再常駐させる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:(O) COMMAND ERROR. 原因と処置:テンポ設定ＺＭＳコマンドの使用法に誤りがある。設定できるテンポは タイマＡモードの時は77〜300、タイマＢモードの時は20〜300。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:UNDEFINED COMMAND ERROR. 原因と処置:未定義のＺＭＳ共通コマンドを使用しようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:PARAMETER OUT OF RANGE. 原因と処置:有効範囲を越えた値をＺＭＳの共通コマンドのパラメータとして 与えている。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ エラーファイルの活用 ┃ ┃ ┃ ┃ ┃ ┃ コンパイル時のエラーメッセージをうまく活用すると開発効率が上がります。 ┃ ┃ ┃ ┃ 例えば、以下のようにして'MUSIC.ZMS'というＺＭＳをコンパイルした場合、 ┃ ┃ ┃ ┃A>zmusic -c MUSIC > ER ┃ ┃ ┃ ┃エラーが発生すると'ER'というファイルネームのファイルが出来ます(これを ┃ ┃ ┃ ┃エラーファイルと呼びます)。さて、ここで ┃ ┃ ┃ ┃A>ed ER ┃ ┃ ┃ ┃としてエディタでエラーファイルを読み込んで下さい。エラーファイルの読み込みを┃ ┃ ┃ ┃確認したら[ESC]を押してから[V]を押して下さい。するとMUSIC.ZMSファイルを ┃ ┃ ┃ ┃読み込み、'MUSIC.ZMS'のエラーの発生した行へとカーソルがジャンプします(これは┃ ┃ ┃ ┃エディタＥＤ．Ｘのタグジャンプという機能です)。後はエディタで誤った箇所を ┃ ┃ ┃ ┃訂正するだけです。エラーが複数あった場合は[SHIFT]＋[F6]で、もう一度 ┃ ┃ ┃ ┃エラーファイルの画面にして次のエラーメッセージの行にカーソルを動かして ┃ ┃ ┃ ┃再び[ESC]＋[V]を実行してみましょう。すると'MUSIC.ZMS'ファイルのそのエラーの ┃ ┃ ┃ ┃ある行へジャンプしているはずです。こうしてエラーを修正していきます。エラーが┃ ┃ ┃ ┃全くない場合はエラーファイルは「空」になります。 ┃ ┃ ┃ ┃ ちなみにエラーファイルは ┃ ┃ ┃ ┃MUSIC.ZMS 18 SYNTAX ERROR ┃ ┃MUSIC.ZMS 35 M_TRK ERROR ┃ ┃ : ┃ ┃ : ┃ ┃ ┃ ┃のようにファイル名、行番号、エラー内容の順番になっています(タグファイル ┃ ┃ ┃ ┃フォーマット)。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ １１．３． ＺＰＣＮＶ．Ｒのエラー −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:File open error. Does the FILENAME1 surely exist in your device? 原因と処置:ＡＤＰＣＭコンフィギュレーションファイルが読み込めない。 記憶デバイスにファイルがあるか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:File read error. Check FILENAME1. 原因と処置:ＡＤＰＣＭコンフィギュレーションファイルの読み込みに失敗した。 ファイルが破壊されていないか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:???? is unable to read. 原因と処置:ＡＤＰＣＭデータの読み込みに失敗した。そのファイルが本当に 存在しているかどうか確認してみる。また、環境変数'zmusic'のパスが 正しく設定されているか確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal File length. 原因と処置:読み込もうとしたＡＤＰＣＭデータのファイルサイズが異常。 大きすぎるか、ファイルサイズが0の可能性がある。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:File open error. Check FILENAME2. 原因と処置:書き込み用ファイルがオープン出来ない。異常なファイルネームを 指定しているか、記憶デバイスが書き込み禁止になってる可能性がある。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:File write error. Check FILENAME2. 原因と処置:ＺＰＤの書き込みに失敗した。記憶デバイスの容量が十分かどうか 確認してみる。また、ファイルネームが異常でないか、書き込み禁止の ファイルに対して上書きしようとしていないかなどを確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Out of memory. 原因と処置:作業メモリが不足している。メモリを増設するか、 必要のないプログラムの常駐を解除しフリーエリアを確保する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Syntax error. 原因と処置:ＡＤＰＣＭコンフィギュレーションの文法に誤りがある。 文法や用法の詳しい解説はMEASURE6を参照。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Refered to empty note number. 原因と処置:参照しようとしたノート番号にはＡＤＰＣＭが登録されていない。 ＡＤＰＣＭコンフィギュレーションファイルの内容を もう一度確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal parameter format. 原因と処置:数値を不当に省略している。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal note number. 原因と処置:ノート番号の有効範囲は0〜511。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal pitch shift parameter. 原因と処置:音程変更の有効範囲は−12(１オクターブ下)〜＋12(１オクターブ上)まで。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal volume value. 原因と処置:音量変更の有効範囲は1%〜300%まで。ただし原音量を100とする。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal delay value. 原因と処置:ミキシングディレイの有効範囲は0〜65535。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Cut size is too big. 原因と処置:ＡＤＰＣＭの切り出しサイズの有効範囲は0〜65535。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal offset value. 原因と処置:フェード・イン／アウト・オフセット、切り出しオフセットの 有効範囲は0〜65535。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal output level. 原因と処置:フェード・イン／アウト・レベルの有効範囲は0〜127。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal Bank number. 原因と処置:ＡＤＰＣＭのバンクの有効範囲は1〜4。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− １１．４． ＺＰ．Ｒのエラー ＺＰ．ＲがＺＭＵＳＩＣ．Ｘを制御してその際に発生したエラーは、 ERROR n として表示される。nはエラーコードでＭＵＳＩＣＺ．ＦＮＣのエラーの エラーコードと同一である。ここでは、ＺＰ．Ｒ特有のエラーについてだけ 解説する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:V-DISP interrupt has already used by other applications. 原因と処置:ＺＰ．Ｒのジュークボックス機能やデバグ・ツールでは Ｖ−ＤＩＳＰ割り込みを使用する。何か別のプログラムが この割り込みをすでに使用しているため、ＺＰ．Ｒの常駐が 行えなかった。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ZMUSIC.X is not included. 原因と処置:ＺＭＵＳＩＣ．Ｘが組み込まれていないため、ＺＰ．Ｒは使用できない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal file size. 原因と処置:読み込もうとしたファイルサイズが0か大きすぎる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Out of memory. 原因と処置:作業メモリが不足している。メモリを増設するか、 必要のないプログラムの常駐を解除しフリーエリアを確保する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Read error. 原因と処置:データの読み込みに失敗した。ファイルが破壊されていないか 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:File not found. 原因と処置:ファイルが見つからなかった。記憶デバイスにそのファイルが本当に 存在しているか、環境変数'zmusic'が正しく設定されているか 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Too many filenames are written in index-file. 原因と処置:ジュークボックスのインデックスファイルに64曲以上の曲名を 書いている。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ZP.R is not kept in your system. 原因と処置:ＺＰ．Ｘが常駐していないのに常駐解除を実行した。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ZP.R has already kept. 原因と処置:ＺＰ．Ｘは既に常駐しているのに、さらに常駐しようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Fail in making of string MIDI data. 原因と処置:ＭＩＤＩデータの文字型データ変換に失敗した。ＺＭＵＳＩＣ．Ｘを 一度常駐解除し、トラックバッファやワークを増やして再常駐して、 一連の作業をもう一度やり直してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Write error. 原因と処置:ファイルの書き出しに失敗した。記憶デバイスの容量が不足していないか 確認してみる。また、ファイルネームが異常でないか、書き込み禁止の ファイルに対して上書きしようとしていないかなどを確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Unidentified file. 原因と処置:ＺＭＵＳＩＣシステムとは無関係のファイルをアクセスしようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal command has existed. 原因と処置:ＡＤＰＣＭ定義コマンド(n ファイルネーム,Pp,Vv,Mm,d,Cc,s,R,Ff,l)や ＡＤＰＣＭコンフィギュレーション実行コマンド(.adpcm_list) を用いたＺＭＤはジュークボックス機能で演奏することはできない。 ＺＰＤを用いて演奏するように改造する必要がある。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ADPCM buffer is too small. 原因と処置:ＡＤＰＣＭバッファが小さすぎるためＺＰＤを登録することが できなかった。ＺＭＵＳＩＣ．Ｘを一度常駐解除し、 ＡＤＰＣＭバッファを大き目に設定して再常駐させてもう一度 試してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Track buffer is too small. 原因と処置:トラックバッファが小さすぎるため演奏データを演奏することが できなかった。ＺＭＵＳＩＣ．Ｘを一度常駐解除し、 トラックバッファを大き目に設定して再常駐させて、もう一度 試してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Version number mismatch. 原因と処置:バージョンの違うＺＭＤを演奏しようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:MIDI is Unable to use. 原因と処置:ＭＩＤＩボードがないのにＭＩＤＩの曲を演奏しようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:An error is still remained in ZMD/ZMS. 原因と処置:演奏データにエラーが残っているためにステップタイムの計算(/Q)が 　　　　　 行えなかった。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal parameter. 原因と処置:既定外のパラメータを設定した。パラメータを使用範囲に訂正する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− １１．５． ＺＭＵＳＩＣ．Ｘのエラー −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:MUSIC BIOS has already included in your system. 原因と処置:ＺＭＵＳＩＣ．Ｘあるいはその他の音楽ドライバーが既に 常駐しているため常駐できなかった。または、割り込みベクタなどが 不当に書き替えられている可能性がある。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Didn't you include special ADPCM driver? 原因と処置:ＰＣＭ８．Ｘ以外の何か特殊なＡＤＰＣＭドライバが 組み込まれているためＺＭＵＳＩＣ．Ｘは常駐できなかった。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Out of memory. 原因と処置:作業メモリが不足している。メモリを増設するか、 必要のないプログラムの常駐を解除しフリーエリアを確保する。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ZmuSiC is not kept in your system. 原因と処置:ＺＭＵＳＩＣ．Ｘが常駐していないのに常駐解除しようとした。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:ZmuSiC is unable to release. 原因と処置:ＺＭＵＳＩＣ．Ｘが不当に書き替えられているため 常駐解除できなかった。また、特殊な環境から常駐をした場合、 常駐解除できないことがある。この時は一度その環境に戻ってから 常駐解除を行わなくてはならない。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Illegal version number.Unable to release. 原因と処置:バージョンが違うために解除出来なかった。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Unknown error! Please reset your system. 原因と処置:正体不明のエラーが発生した。プログラムが不当に書き替えられている 可能性がある。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:File not found. 原因と処置:コンパイルしようとしたＺＭＳファイルが見つからない。そのファイルが 実在するかどうか、環境変数'zmusic'が正しく設定されているかどうかを 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Write error. 原因と処置:コンパイルされて生成されたＺＭＤの書き込みに失敗した。異常な ファイルネームを設定していないか、記憶デバイスの容量は十分か 書き込み禁止のファイルに対して上書きしようとしていないかを 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Unable to read. 原因と処置:コンパイルしようとしたＺＭＳの読み込みに失敗した。ファイルサイズが 0でないかどうか、ファイルが破壊されていないかどうかを 確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Work area is not enough. 原因と処置:ＺＭＳのコンパイルがワークエリア不足で中断された。ワークを大き目に 確保してもう一度コンパイルしてみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Track buffer is not enough. 原因と処置:ＺＭＳのコンパイルがトラックバッファ不足で中断された。 トラックバッファを大き目に設定してもう一度コンパイルしてみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Block ADPCM data '〜' couldn't be found. 原因と処置:指定されたＺＰＤが見つからない。そのＺＰＤが実在するか、 環境変数'zmusic'が正しく設定されているかどうかを確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− メッセージ:Start up file '〜' couldn't be found. 原因と処置:指定されたスタートアップファイルが見つからない。その スタートアップファイルが実在するか、環境変数'zmusic'が 正しく設定されているかどうかを確認してみる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ビープ音について ┃ ┃ ┃ ┃ ┃ ┃ ＣＯＭＭＡＮＤ．Ｘから ┃ ┃ ┃ ┃Ａ＞ＣＯＰＹ ファイルネーム ＯＰＭ ┃ ┃ ┃ ┃として演奏させた場合に、そのファイル中にエラーがあった場合はエラーメッセージ┃ ┃ ┃ ┃等は出力せずビープ音を発声します(ビープ音の登録がなされていないシステムでは ┃ ┃ ┃ ┃もちろん鳴りませんが)。これは手抜きではなく、なにか別のアプリケーションから ┃ ┃ ┃ ┃同様の操作をされたときにエラーメッセージなどで画面等を壊さないために ┃ ┃ ┃ ┃こうなりました。ビープ音が鳴った時はその演奏データを一度コンパイルしたりして┃ ┃ ┃ ┃エラーの内容を確認すべきです。 ┃ ┃ ┃ ┃ また、ＭＩＤＩデータの取り込み中にビープ音が鳴った場合はデータの ┃ ┃ ┃ ┃取り込み用バッファ、具体的にはトラックバッファ、ワークエリアが ┃ ┃ ┃ ┃不足しています。一度ＺＭＵＳＩＣ．Ｘを解除しそれらを大き目にとって ┃ ┃ ┃ ┃再常駐させて下さい。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ { -- ZM12.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ１２ ＺＭＤ／ＺＰＤフォーマット ここではＺＭＤフォーマット，ＺＰＤのフォーマットに ついて解説します。 一般的な使用をする限りは読み飛ばして構いません。 １２．１． 解説を読むにあたって 文中の(.B)(.W)(.L)等はデータ長を表している。 (.B) バイト (.W) ワード(２バイト) (.L) ロングワード(４バイト) １２．２． ＺＭＤフォーマット ＺＭＤは以下のようになっている。 $10(.B) ダミーコード "ZmuSiC" ＺＭＤファイルＩＤ VERSION NUMBER(.B) 現在のバージョンナンバー 共通コマンド群… ＦＭ音源音色設定やＡＤＰＣＭ設定…etc. $FF(.B) 共通コマンド終了コード 次の番地が奇数の場合は もう一個$FF(.B)が来る 総トラック数(.W) トラック１のデータアドレスまでのオフセットアドレス(.L) } $00(.B),トラック１の絶対チャンネル番号(.B) } トラック２のデータアドレスまでのオフセットアドレス(.L) } $00(.B),トラック２の絶対チャンネル番号(.B) } : }総トラック数分ある : } トラックnのデータアドレスまでのオフセットアドレス(.L) } $00(.B),絶対チャンネル番号(.B) } 各トラックの演奏データ.... 総トラック数分ある １２．３． 共通コマンド・ＺＭＤコード ●ＦＭ音源音色設定 (ZMS (Ｖ)コマンド) $04(.B),音色番号(.B),音色データ(55バイト) 合計５７バイト 音色番号＝1〜200 音色のデータフォーマットはMEASURE10 ファンクション$04 m_vset参照 ●テンポ (ZMS (Ｏ)コマンド) $05(.B),テンポ値(.W) 合計３バイト テンポ値＝20〜300 ●ベースチャンネル設定 (ZMS (Ｂ)コマンド) $15(.B),モード値(.B) 合計２バイト モード値＝0:ＦＭ音源チャンネル基準モード モード値≠0:ＭＩＤＩチャンネル基準モード チャンネルモードはMEASURE3 m_ch()、MEASURE4 (Ｂn)コマンド参照 ●ＭＩＤＩデータ転送 (ZMS (Ｘ)コマンド、.MIDI_DATAコマンド) $18(.B),データ数(.W),データ(.B),…… 合計は不定 ローランド・エクスクルーシブ・コマンドやＭＩＤＩ楽器機種別コマンドは このコードに展開される ●ＦＭ音源音色設定 (ZMS (＠)コマンド、.FMVSETコマンド) $1B(.B),音色番号(.B),音色データ(55バイト) 合計５７バイト 音色番号＝1〜200 音色のデータフォーマットはMEASURE10 ファンクション$04 m_vset2参照 ●ＡＤＰＣＭコンフィギュレーション $40(.B),note number(.W),pitch parameter(.W),volume parameter(.W) ,mix delay parameter(.W),mix note number(.W) ,cut offset(.W),cut size(.W) ,reverse switch(.B) ,fade in/out offset(.W),fade in or out(.B),fade in/out level(.B) ,filename....,0(.B) 合計不定 あるいは $40(.B),note number(.W),pitch parameter(.W),volume parameter(.W) ,mix delay parameter(.W),mix note number(.W) ,cut offset(.W),cut size(.W) ,reverse switch(.B) ,fade in/out offset(.W),fade in or out(.B),fade in/out level(.B) ,0(.W),操作対象ノート番号(.W) 合計２４バイト note number(.W):0〜511 fade in or out(.B):(−1:fade in,＋1:fade out) その他のパラメータの範囲については MEASURE10 ファンクション$10 adpcm_read参照 ●全音符クロックのセット (ZMS (Ｚ)コマンド) $42(.B),master clock(.B),tempo base counter(.L) 合計６バイト master clock:(Ｚn)のnの値 tempo base counter＝(16×4000×60000)/(master clock×256) ●波形メモリデータの登録 (ZMS .WAVE_FORMコマンド) $4A(.B),number of data(.W),登録波形番号(.B) ,loop type(.B),loop point(.W),data(.W),…… 合計は不定 ●ＡＤＰＣＭコンフィギュレーション・ファイルの読み込み (ZMS .ADPCM_LISTコマンド) $60(.B),FILENAME文字列…,$00(.B) 合計は不定 ●文字列表示 (ZMS .PRINTコマンド) $61(.B),文字列…,$00(.B) 合計は不定 ●ＭＩＤＩダンプデータ(ＭＤＤ)の読み込みと送信 (ZMS .MIDI_DUMPコマンド) $62(.B),FILENAME文字列…,$00(.B) 合計は不定 ●ＺＰＤデータの受け渡し (ZMS .ADPCM_BLOCK_DATAコマンド) $63(.B),FILENAME文字列…,$00(.B) 合計は不定 ●ダミーＺＭＤ $7e(.B) 合計１バイト 何の機能も果たさないＺＭＤコード　機械語のＮＯＰに相当 ●コメント (ZMS .COMMENTコマンド) $7F(.B),文字列…,$00(.B) 合計は不定 １２．４． ＭＭＬ・ＺＭＤコード ■＄００〜＄７Ｆ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●音階 (MML Ａ〜Ｇ) ノート番号(.B),step time(.B),gate time(.B) 合計３バイト ノート番号:0〜127 step time :1〜254 gate time :1〜255(255はタイ／スラーとして扱われる) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄８０〜＄８Ｆ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●休符 (MML Ｒ) $80(.B),step time(.B),gate time(.B) 合計３バイト step time :1〜254 gate time :1〜255(255はタイ／スラーとして扱われる) ●ノイズモードオフ (MML Ｙ15,0、＠Ｏ) $82(.B) 合計１バイト ●同期待ちコマンド (MML Ｗ) $83(.B) 合計１バイト ●臨時ベロシティ復元 $84(.b) 合計１バイト −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄９０〜９Ｆ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●テンポ (MML ＠Ｔ) $90(.B),タイマー値(.W) 合計３バイト 　タイマー値の有効範囲は常駐しているタイマーの種類によって変動する タイマーＡ：0〜1023 タイマーＢ：0〜255 ●テンポ (MML Ｔ) $91(.B),テンポ値(.W) 合計３バイト テンポ値の有効範囲は常駐しているタイマーの種類によって変動する タイマーＡ：77〜300 タイマーＢ：20〜300 ●相対タイマーＵＰ (MML ＠Ｔ＋) $92(.B),相対タイマー値(.W) 合計３バイト 相対タイマー値(タイマＡモード)：1〜1023 相対タイマー値(タイマＢモード)：1〜255 ●相対タイマＤＯＷＮ (MML ＠Ｔ−) $93(.B),相対タイマー値(.W) 合計３バイト 相対タイマー値(タイマＡモード)：1〜1023 相対タイマー値(タイマＢモード)：1〜255 ●相対テンポＵＰ (MML Ｔ＋) $94(.B),相対テンポ値(.W) 合計３バイト 相対テンポ値(タイマＡモード)：1〜230 相対テンポ値(タイマＢモード)：1〜280 ●相対テンポＤＯＷＮ (MML Ｔ−) $95(.B),相対テンポ値(.W) 合計３バイト 相対テンポ値(タイマＡモード)：1〜230 相対テンポ値(タイマＢモード)：1〜280 ●相対ピッチベンドＵＰ (ＺＭＤ専用命令) $96(.B),相対ピッチベンド値(.W) 合計３バイト 相対ピッチベンド値：1〜16383 ●相対ピッチベンドＤＯＷＮ (ＺＭＤ専用命令) $97(.B),相対ピッチベンド値(.W) 合計３バイト 相対ピッチベンド値：1〜16383 ●モジュレーション波形選択 (MML Ｓ) $98(.B),ピッチ・モジュレーション／拡張ピッチ・モジュレーションの波形番号(.B) ,アンプリチュード・モジュレーション／拡張ＡＲＣＣの波形番号(.B) 合計３バイト 波形番号 0:鋸歯波、1:矩形波、2:三角波、3:鋸歯波シングル 各パラメータとも−1を指定した場合は省略を意味する ●ＭＩＤＩのピッチ・モジュレーション・モードの設定 (MML Ｍ) $99(.B),ピッチ・モジュレーション・モード(.B),ＡＲＣＣモード(.B) 合計３バイト ピッチ・モジュレーション・モード：0＝通常モード／1＝拡張モード#1／2＝拡張モード#2 ＡＲＣＣ：0＝通常モード／1＝拡張モード 各パラメータとも−1を指定した場合は省略を意味する 拡張モードについてはMEASURE5 Ｍコマンドの項参照 ●ＡＲＣＣ・コントロール・チェンジ番号登録 (MML ＠Ｃ) $9A(.B),CONTROL CHANGE number(.B) ,ARCC reset value(.B) ,ARCC neutral value(.B) 合計４バイト CONTROL CHANGE number:0〜127 ARCC reset value:0〜127 ARCC neutral value:0〜127 各パラメータとも−1を指定した場合は省略を意味する ●ＡＤＰＣＭ再生 (MML Ｙ2,) $9B(.B),note number(.W) 合計３バイト note number:0〜511 ●モジュレーション非同期／同期設定 (MML Ｈ) $9c(.b),ピッチ・モジュレーション同期スイッチ(.B) ,アンプリチュード・モジュレーション／拡張ＡＲＣＣ同期スイッチ(.B) 合計３バイト 同期スイッチ＝−1:省略 ＝ 0:同期オン ＝＋1:同期オフ(非同期) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄Ａ０〜ＡＦ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●音色切り換え (MML ＠) $A0(.B),音色番号(.B) 合計２バイト 音色番号:1〜200 ●音色切り替え (ハードＬＦＯ／パンポットをいじらない音色設定) $A1(.B),音色番号(.B) 合計２バイト 音色番号:1〜200 ●ＡＤＰＣＭ再生周波数変更 (MML Ｙ13,) $A2(.B),周波数値(.B) 合計２バイト 周波数値: 0＝3.9kHz 1＝5.2kHz 2＝7.8kHz 3＝10.4kHz 4＝15.6kHz 5＝16bit ＰＣＭデータ方式(ＰＣＭ８独立チャンネルモード時) 6＝8bit ＰＣＭデータ方式(ＰＣＭ８独立チャンネルモード時) ●チャンネルアサイン変更 (MML Ｎ,＠Ｎ) $A3(.B),絶対チャンネル番号(.B) 合計２バイト 絶対チャンネル番号＝ 1〜7 内蔵ＦＭ音源チャンネル1〜8 8 内蔵ＡＤＰＣＭ音源 9〜24 ＭＩＤＩチャンネル1〜16 25〜31 ＡＤＰＣＭチャンネル2〜8(ＰＣＭ８独立チャンネルモード時) ●ノイズ (MML Ｙ15,) $A5(.B),ノイズ周波数(.B) 合計２バイト ノイズ周波数：128〜159(128＋0〜128＋31) ●フェード・イン／アウト (MML ￥) $A6(.B),フェード・イン／アウト・スピード(.B) 合計２バイト フェード・イン／アウト・スピード −85〜−1:フェード・イン 0:フェード・アウト・モード解除 1〜85:フェード・アウト パラメータの機能と意味についての詳しい解説は MEASURE10 ファンクション$1a fade_outを参照 ●ダンパーペダル (MML ＠Ｄ) $A7(.B),ダンパー値(.B) 合計２バイト ダンパー値:0〜127 ●ベンドレンジ変更 (MML ＠Ｇ) $A8(.B),ベンド幅(.B) 合計２バイト ベンド幅:0〜127 ●ＡＤＰＣＭ周波数変更 (MML ＠Ｆ) $A9(.B),周波数値(.B) 合計２バイト 周波数値: 0＝3.9kHz 1＝5.2kHz 2＝7.8kHz 3＝10.4kHz 4＝15.6kHz 5＝16bit ＰＣＭデータ方式(ＰＣＭ８独立チャンネルモード時) 6＝8bit ＰＣＭデータ方式(ＰＣＭ８独立チャンネルモード時) ●相対ボリュームＵＰ (MML ~) $AA(.B),相対ボリューム値(.B) 合計２バイト 相対ボリューム値：1〜127 ●相対ボリュームＤＯＷＮ (MML _) $AB(.B),相対ボリューム値(.B) 合計２バイト 相対ボリューム値：1〜127 ●キーオフ無しモード (MML ＠Ｒ) $AC(.b),mode(.b) 合計２バイト mode:0＝通常モード 1＝キーオフ無しモード ●絶対音長０による強制発音(MML *0) $AD(.B),note number(.B) 合計２バイト note number:0〜127 ●アンプリチュード・モジュレーション／ＡＲＣＣ／拡張ＡＲＣＣ (MML ＠Ａ) $AE(.B),振幅値(.B) 合計２バイト 振幅値：-128〜127 ●同期信号送信コマンド (MML Ｗ) $AF(.B),トラック番号(.B) 合計２バイト トラック番号：0〜79 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄Ｂ０〜＄ＢＦ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●パンポット０ (MML Ｐ0) $B0(.B) 合計１バイト ●パンポット１ (MML Ｐ1) $B1(.B) 合計１バイト ●パンポット２ (MML Ｐ2) $B2(.B) 合計１バイト ●パンポット３ (MML Ｐ3) $B3(.B) 合計１バイト ●多段階パンポット (MML ＠Ｐ) $B4(.B),パンポット値(.B) 合計２バイト パンポット値：0〜127 ●Ｙコマンド (MML Ｙ) $B5(.B),レジスタ番号(.B),データ値(.B) 合計３バイト レジスタ番号:0〜255 データ番号:0〜255 ●ボリューム (MML Ｖ,＠Ｖ) $B6(.B),ボリューム値(.B) 合計２バイト ボリューム値:0〜127 ただし値は(127−実際の設定ボリューム)に相当する ●ＡＤＰＣＭ ＰＡＮ (MML Ｙ3,) $B7(.B)パンポット値(.B) 合計２バイト パンポット値＝0:消音 1:左 2:右 3:中央 ●ＡＤＰＣＭ効果音モード設定 (MML Ｙ14,) $B8(.B),モード値(.B) 合計２バイト モード値＝0:通常 ＝1:効果音モード再生指定 ●ベロシティ (MML Ｕ,＠Ｕ) $B9(.B),ベロシティ値(.B) 合計２バイト ベロシティ値：0〜127 ●ピッチ・モジュレーション・スイッチ (MML ＠Ｍ) $BB(.B),スイッチ値(.B) 合計２バイト スイッチ値＝0:ＯＦＦ ＝1:ＯＮ ●アンプリチュード・モジュレーション／ＡＲＣＣスイッチ (MML ＠Ａ) $BC(.B),スイッチ値(.B) 合計２バイト スイッチ値＝0:ＯＦＦ ＝1:ＯＮ ●オートベンド・スイッチ (MML ＠Ｂ) $BD(.B),スイッチ値(.B) 合計２バイト スイッチ値＝0:ＯＦＦ ＝1:ＯＮ ●アフタータッチシーケンス・スイッチ (MML ＠Ｚ) $BE(.B),スイッチ値(.B) 合計」２バイト スイッチ値＝0:ＯＦＦ ＝1:ＯＮ ●強制キーオフ (MML `) $BF(.B) 合計１バイト −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄Ｃ０〜＄ＣＦ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●［〜］コマンド系 (MML [〜]) $C0(.B),コマンド番号(.B) 合計２バイト コマンド番号 ＝0〜2 RESERVED ＝3 [D.C.] ＝4 [SEGNO][$] ＝5 [D.S.] ＝6 [CODA] ＝7 [TOCODA][*] ＝8 [FINE][^] ＝9 [DO] ＝10 [LOOP] ＝11 [!] ＝12 [@] ●リピートコマンド開始 (MML |:) $C1(.B),$CF(.B),repeat counts(.B) 合計３バイト repeat counts:1〜255 ●リピートコマンド終端 (MML :|) $C2(.B),オフセット(.W) 合計３バイト オフセット値は必ず正　 次のＺＭＤを指し示しているポインタからこのオフセットを減算することになる　 　減算の結果、ポインタはリピート開始コマンドＺＭＤの2バイト目の$CFを指している ●リピートコマンドスキップ＃１ (MML |) $C3(.B),回数指定値(.B),抜け出しオフセット値(.W) 合計４バイト 回数指定値：1〜255 抜け出しオフセット値は必ず正 ●リピートコマンドスキップ＃２ (MML |) $C4(.B),抜け出しオフセット値(.W) 合計３バイト 抜け出しオフセット値は必ず正 ●ＭＩＤＩのタイ／スラーモード指定 (MML ”) $C5(.B),モード値(.B) 合計２バイト モード値＝0:従来モード 1:ＦＭ音源互換モード ●特殊コマンド制御スイッチ (MML ＝) $C7(.B),スイッチ値(.B) 合計２バイト ビットオン(＝1)でスイッチオン オフ(0)でスイッチオフ 第0ビット：ピッチ・モジュレーション 第1ビット：ＡＲＣＣ／ＡＭＯＤ 第2ビット：オートベンド 第3ビット：アフタータッチシーケンス ●相対パンポットＵＰ (MML ＠Ｐ＋) $C8(.B),相対パンポット値(.B) 合計２バイト 相対パンポット値:1〜127 ●相対パンポットＤＯＷＮ (MML ＠Ｐ−) $C9(.B),相対パンポット値(.B) 合計２バイト 相対パンポット値:1〜127 ●相対ベロシティＵＰ (MML Ｕ＋) $CA(.B),相対ベロシティ値(.B) 合計２バイト 相対ベロシティ値：1〜127 ●相対ベロシティＤＯＷＮ (MML Ｕ−) $CB(.B),相対ベロシティ値(.B) 合計２バイト 相対ベロシティ値：1〜127 ●全トラック・フェードアウト／イン (ＺＭＤ専用命令) $CC(.B),フェードイン／アウト・スピード(.B) 合計２バイト フェードイン／アウトスピード −85〜−1:フェードイン 0:フェードアウトモード解除 1〜85:フェードアウト パラメータの機能と意味についての詳しい解説は MEASURE10 ファンクション$1a fade_outを参照 ●絶対音長０による和音発音 (MML *0&) $CD(.B),note number(.B) 合計２バイト note number:0〜127 ●強制再演奏コマンド (MML Ｊ) $CE(.B),トラック番号(.B) 合計２バイト トラック番号：0〜79 未使用のトラックに対して本命令を実行した場合の動作保証はされない ●リピートコマンドのＺＭＤコードの2バイト目 $C1(.B),$cf(.B),repeat counts(.B) ↑ この部分 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄Ｄ０〜＄ＤＦ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ウェイト (MML ＠Ｗ) $D0(.B),step time(.B),$00(.B) 合計３バイト step time:1〜254 ●キー・トランスポーズ／デチューン (MML ＠Ｋ,＠Ｂ) $D1(.B),トランスポーズ値#1(.W),トランスポーズ#2値(.W) 合計５バイト トランスポーズ値#1は半音＝64として算出された値(−768〜＋768) トランスポーズ値#2は半音≒683として算出された値(−8192〜＋8191) ●ＮＲＰＮ設定 (MML ＠Ｙ) $D2(.B),アドレス(.W),データ(.W) 合計５バイト アドレス：$00,$00〜$7F,$7F データ：$00,$00〜$7F,$7F ●バリエーション／バンク変更 (MML Ｉ) $D3(.B),バリエーション番号(.W) 合計３バイト バリエーション番号：$00,$00〜$7F,$7F ●ワーク直接書き換えコマンド (MML ？) $D5(.B),offset(.B),data(.B) 合計３バイト offset:0〜255 data:0〜255 ●モジュレーション・スピード設定コマンド (MML ＠Ｓ) $D6(.B),ピッチ・モジュレーション／拡張ピッチ・モジュレーションのスピード(.w) ,アンプリチュード・モジュレーション／拡張ＡＲＣＣのスピード(.w) 合計５バイト ピッチ・モジュレーション／拡張ピッチ・モジュレーションのスピード:1〜32767 アンプリチュード・モジュレーション／拡張ＡＲＣＣのスピード:1〜32767 各パラメータとも0を指定した場合は省略を意味する ●ワーク直接書き換えコマンド相対ＵＰ (MML ？a,+n) $D7(.B),offset(.B),data(.B) 合計３バイト offset:0〜255 data:1〜255 ●ワーク直接書き換えコマンド相対ＤＯＷＮ (MML ？a,-n) $D8(.B),offset(.B),data(.B) 合計３バイト offset:0〜255 data:1〜255 ●臨時ベロシティ $D9(.B),ベロシティ値(.B) 合計２バイト ベロシティ値：0〜127 ●臨時相対ベロシティＵＰ $DA(.B),相対ベロシティ値(.B) 合計２バイト 相対ベロシティ値：1〜127 ●臨時相対ベロシティＤＯＷＮ $DB(.B),相対ベロシティ値(.B) 合計２バイト 相対ベロシティ値：1〜127 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄Ｅ０〜＄ＥＦ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ポルタメント (MML (〜)) $E0(.B),ノート番号(.B),step time(.W),gate time(.W),delay(.W) ,増分(.W),補正パラメータ(.B),符号(.B) 合計１２バイト step time:1〜32767 gate time:1〜32767(32768以上はタイ／スラーとして扱われる) delay:0〜32767 増分＝int(ベンド幅÷step time) 補正パラメータ＝round(256×(ベンド幅 MOD step time)/step time) (増分、補正パラメータはＢＲＥＳＥＮＨＡＭのアルゴリズムによる計算結果 ベンド幅はＦＭ音源トラックでは半音＝64、ＭＩＤＩトラックでは半音≒683 とする) 符号はポルタメント方向で、−1がピッチダウン、＋1がピッチアップに対応する ●オートベンド (MML ＠Ｂ,＠Ｋ) $E1(.B),開始値(.W),目的値(.W),開始値(.W),目的値(.W) ,ディレイ値(.W),符号(.B) 合計１２バイト 前者の開始値/目的値は半音＝64として算出された値 後者の開始値／目的値は半音≒683として算出された値 また、目的値は相対値で表される ディレイ:0〜32767 符号はベンド方向で、−1がピッチダウン、＋1がピッチアップに対応する ●和音 (MML '〜') $E2(.B),step time(.W),gate time(.W) ,ディレイ値(.B),ノート番号1(.B)〜8 合計１４バイト step time:1〜32767 gate time:1〜32767(32768以上はタイ／スラーとして扱われる) delay:0〜255 ノート番号:0〜127 ●アフタータッチ・シーケンス (MML ＠Ｚ) $E3(.B),アフタータッチ値1(.B)〜8 合計９バイト アフタータッチ値:0〜127 :−1はノータッチ期間 ●モジュレーション・デプス (MML ＠Ｍ) $E6(.B),振幅(.W) 合計３バイト 振幅:−32768〜＋32768(ＦＭ音源トラック) 0〜127(ＭＩＤＩトラック・通常モード) −8192〜＋8191(ＭＩＤＩトラック)・拡張モード ●ディレイセット (MML ＠Ｈ) $E8(.B),ピッチ・モジュレーション用ディレイ(.W) ,アンプリチュード・モジュレーション／ＡＲＣＣ用ディレイ(.W) 合計５バイト ピッチ・モジュレーション用ディレイ:0〜65534 アンプリチュード・モジュレーション／ＡＲＣＣ用ディレイ:0〜65534 各パラメータとも−1を指定した場合は省略を意味する ●ローランド・エクスクルーシブ (MML Ｘ) $EA(.B),データ(.B)…,チェックサム(.B),$FF(.B) 合計は不定 データ:0〜127 チェックサム:0〜127 ●ＩＤセット (MML ＠Ｉ) $EB(.B),MAKER(.B),DEVICE(.B),MODEL(.B) 合計４バイト MAKER:0〜127 DEVICE:0〜127 MODEL:0〜127 ●ＭＩＤＩデータ送信 (MML ＠Ｘ) $EC(.B),データ数(.W),データ(.B)… 合計は不定 データ数:1〜65535 データ:0〜255 ●エフェクト・コントロール (MML ＠Ｅ) $ED(.B),パラメータ#1(.B),〜#3(.B) 合計４バイト パラメータ#1(REVERB LEVEL):0〜127 パラメータ#2(CHORUS LEVEL):0〜127 パラメータ#3:未使用 ＭＴ３２／ＣＭ３２Ｌ／ＣＭ６４(ＬＡパート)のケース パラメータ#1(パート番号):1〜8 パラメータ#2(REVERB switch):0 or 1 パラメータ#3:未使用 各パラメータとも−1を指定した場合は省略を意味する ●ピッチ・モジュレーション・デプス1/8モード (MML ＠Ｍ) $EE(.B),省略ビットパターン(.B),振幅#1(.W),…,振幅#8(.W)×8 合計１８バイト 省略ビットパターンとはそのビットに対応したパラメータが有効か 無効(省略されている)かを表したもの ビット0〜7がそれぞれパラメータの１番目から８番目に対応する ビット＝0 省略(これに対応するパラメータは意味をなさず) ビット＝1 設定 振幅#1〜#8:−32768〜＋32768(ＦＭ音源トラック) 0〜127(ＭＩＤＩトラック・通常モード) −8192〜＋8191(ＭＩＤＩトラック)・拡張モード ●アンプリチュード・モジュレーション／ＡＲＣＣ・デプス1/8モード (MML ＠Ａ) $EF(.B),省略ビットパターン(.B),振幅#1(.B),…,振幅#8(.B)×8 合計１０バイト 省略ビットパターンとはそのビットに対応したパラメータが有効か 無効(省略されている)かを表したもの ビット0〜7がそれぞれパラメータの１番目から８番目に対応する ビット＝0 省略(これに対応するパラメータは意味をなさず) ビット＝1 設定 振幅#1〜#8:0〜127 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ■＄Ｆ０〜＄ＦＦ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− ●ＮＯＰ (ＺＭＤ専用命令) $F0(.B) 合計１バイト 何も処理を行わず次へスキップ ●スキップコマンド1 (ＺＭＤ専用命令) $F1(.B),offset(s)(.W) 合計３バイト offset:0〜65535 オフセット・バイトだけ先へスキップ ●スキップコマンド2 (ＺＭＤ専用命令) $F2(.B),offset(s)(.W) 合計３バイト offset:0〜65535 オフセット・バイトだけ前に戻る ●ノートオフ (ＭＩＤＩトラック専用ＺＭＤ専用命令) $FC(.B),ノート番号(.B),ベロシティ値(.B) 合計３バイト ノート番号:0〜127 ベロシティ値:0〜127 ●ノートオン (ＭＩＤＩトラック専用ＺＭＤ専用命令) $FD(.B),ノート番号(.B),ベロシティ値(.B) 合計３バイト ノート番号:0〜127 ベロシティ値:0〜127 ●絶対音長指定音階 (MML ＊によって絶対音長指定された音階／休符) $FE(.B),ノート番号(.B),step time(.W),gate time(.W) 合計６バイト ノート番号:0〜127,$80,$D0($80では休符、$D0ではウェイトとなる) step time :0〜65534 gate time :0〜65535(65535はタイ／スラーとして扱われる) ●トラック終了 (ＺＭＤ専用命令) $FF(.B) 合計１バイト このコードを発見すると演奏を終了してそのトラックは ノン・アクティヴ(DEAD)となる。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− １２．５． ＺＰＤフォーマット $10(.B) ダミーコード "ZmAdpCm" ＺＰＤファイルＩＤ ノート番号(.W) 登録先のノート番号(0〜511) ＡＤＰＣＭデータまでのオフセット・アドレス(.L) ＡＤＰＣＭデータ長(.L) ノート番号(.W) 登録先のノート番号(0〜511) ＡＤＰＣＭデータまでのオフセット・アドレス(.L) ＡＤＰＣＭデータ長(.L) : : $FFFF(.W) エンドコード ＡＤＰＣＭデータ… ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ オフセット値について ┃ ┃ ┃ ┃ ┃ ┃ ＺＭＵＳＩＣ用のデータで扱うオフセット値はオフセット値の格納してある次の ┃ ┃ ┃ ┃アドレスからのオフセットです。今例えば、$A000番地に ┃ ┃ ┃ ┃ワードサイズのオフセット$0E00が格納されていたとするとポイントするアドレスは ┃ ┃ ┃ ┃$A002＋$0E00＝$AE02となります。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ { -- ZM13.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ１３ 　　 　　　 ワークエリア 　ここでは、演奏トラックワークとその他の ワークの内容についての解説を行います。 ＺＭＵＳＩＣ支援ツールを制作する時などに 役立ちます。 １３．１． 演奏トラックワーク １３．１．１． 演奏トラックワークの解説を読むにあたって ・演奏トラックのワークの解説は ワーク名(ワークサイズ) ワークオフセット ｛ワークの説明｝ の書式で記述されている。ワークサイズは (.B) バイト (.W) ワード(２バイト) (.L) ロングワード(４バイト) とする。 ・同時に使用されることがないと保証されているワーク・アドレスは、重複して ２つ以上のワークが設定されていることがある(例えば1/8モード・ピッチ・ モジュレーションと波形メモリによるピッチ・モジュレーションは同時に 使用できないため、関連ワークは重複するオフセットアドレスに設定されている)。 ・解説文中では以下の略号が用いられている。 ＰＭ ピッチ・モジュレーション ＡＭ アンプリチュード・モジュレーション ・具体的なワークへのアクセス法はリスト１、リスト２のようにして行う。 リスト１ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃Z_MUSIC macro func *ドライバへのファンクションコール・マクロ ┃ ┃ moveq.l func,d1 ┃ ┃ trap #3 ┃ ┃ endm ┃ ┃ ┃ ┃ moveq.l #n,d2 *1≦n≦80:トラック番号 ┃ ┃ Z_MUSIC #$3c *a0:トラックnの演奏トラックワークの ┃ ┃ *先頭アドレス ┃ ┃ ┃ ┃*アクセス例 ┃ ┃ move.w p_gate_time(a0),d0 *トラックnのある瞬間の ┃ ┃ *ゲートタイムを得る ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ リスト２ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃Z_MUSIC macro func *ドライバへのファンクションコール・マクロ ┃ ┃ moveq.l func,d1 ┃ ┃ trap #3 ┃ ┃ endm ┃ ┃ ┃ ┃ moveq.l #1,d2 *トラック番号＝1 ┃ ┃ Z_MUSIC #$3c *a0:トラック１の演奏トラックワークの ┃ ┃ *先頭アドレス ┃ ┃ move.l a0,seq_wk_tbl *ベースアドレスとなるのでこれを格納 ┃ ┃ ┃ ┃ *トラック12のワーク先頭アドレスを求める時 ┃ ┃ movea.l seq_wk_tbl(pc),a0 *ベースアドレス取り出し ┃ ┃ moveq.l #11,d0 *トラック番号12(内部表現では11) ┃ ┃ lsl.w #8,d0 *256倍 ┃ ┃ adda.w d0,a0 *a0:トラック12のワーク先頭アドレス ┃ ┃*アクセス例 ┃ ┃ move.w p_gate_time(a0),d0 *トラックnのある瞬間の ┃ ┃ *ゲートタイムを得る ┃ ┃ ┃ ┃seq_wk_tbl: ds.l 1 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ １３．１．２． 演奏トラックワークの解説 p_on_count(.W) $00 現在発音中の音符の音長カウンタ(ステップタイム)。定められたテンポに従って −1されていく。0になった時点でＺＭＵＳＩＣは次の音符を演奏しにいく。 p_gate_time(.W) $02 現在発音中の音符の発音長カウンタ(ゲートタイム)。定められたテンポに従って −1されていく。0になった時点でＺＭＵＳＩＣはキーオフ処理を行う。 p_data_pointer(.L) $04 その時点のＺＭＤコマンドポインタ。ステップタイムが0になるたびに、 そのコマンド長分、増加していく。 p_fo_spd(.B) $08 フェードイン／アウトのスピードの絶対値。1≦p_fo_spd≦85。 p_ch(.B) $09 そのトラックがアサインされている絶対チャンネル。0≦p_ch≦25。 ＰＣＭ８独立チャンネルモードにおけるＡＤＰＣＭ拡張チャンネル番号については 後述のp_extra_ch(.B)を参照。 p_not_empty(.B) $0a そのトラックの生死。 −1:死亡 0:演奏中 1:演奏終了 $7f:同期待ち中 $99:演奏停止中(m_stop時) $EE:同期待ち停止中(m_stop時) p_amod_step(.B) $0b ディレイモード・ＡＭ(拡張ＡＲＣＣ)の波形生成用・整数増分。 p_mstep_tbl(.W) $0c〜$1b 1/8モード・ＰＭ(拡張ＰＭ)用波形生成用・整数増分。(×8) p_wvpm_loop(.L) $0c ＰＭ(拡張ＰＭ)用・波形メモリループ開始アドレス。 p_wvpm_lpmd(.W) $10 ＰＭ(拡張ＰＭ)用・波形メモリループモード。(−1,0,＋1) p_altp_flg(.B) $12 ＰＭ(拡張ＰＭ)用・波形メモリ反復モードフラグ。(0:順行中、1:逆行中) p_fo_mode(.B) $1c 現在のフェードモード。( −1:フェードアウト ＋1:フェードイン $47:ファンクション$47/$4C実行中) p_pgm(.B) $1d 現在の音色番号。(0〜199) p_pan(.B) $1e 現在のパンポット。(0〜3) p_vol(.B) $1f 現在の音量。(127最小〜0最大) p_mrvs_tbl(.B) $20〜$27 1/8モード・ＰＭ(拡張ＰＭ)用波形生成用・補正値。(×8) p_wvpm_point(.L) $20 ＰＭ(拡張ＰＭ)用・波形メモリ・ポインタ。 p_wvpm_end(.L) $24 ＰＭ(拡張ＰＭ)用・波形メモリ・終了アドレス。 p_sp_tie(.W) $28 ＦＭ音源互換タイ・モード(@J1)においてスラーを行った時の ２つの音の音程の差を格納してある。 例 c&e では683×4＝2732がここに格納される。 p_om(.B) $28 ＦＭ音源音色パラメータのＯＭの値。(&b0000〜&b1111) p_sync(.B) $29 ＦＭ音源音色パラメータのＳＹＮＣの値。(0,1) p_af(.B) $2a ＦＭ音源音色パラメータのＡＦの値。 p_se_mode(.B) $2b そのトラックが現在効果音モードかどうか。 $ff:normal $00:se mode $01:masking mode(FNC $44 or $4B) p_pmod_tbl(.W) $2c〜$3b 1/8モード・ＰＭ(拡張ＰＭ)の振幅値。(×8) (-32768〜32767) p_total(.L) $3c その時点までのステップタイムの合計。ファンクション$19 または、ファンクション$43を実行後のみ意味を持つ。 p_fo_lvl(.B) $40 フェーダーの出力割合。(MIN)0〜128(MAX･NORMAL) p_note(.B) $42〜$49 現在発音中のノート一覧。(×8) p_extra_ch(.B) $4a ＰＣＭ８独立チャンネルモード時のＡＤＰＣＭ拡張チャンネル番号。(0〜7) p_aftc_n(.B) $4b アフタータッチ・シーケンスのポインタ。(0〜7) p_bend_rng_f(.W) $4c オート・ベンドのベンド幅(ＦＭ音源トラック専用)。 半音＝64で表される相対表現値。(-768〜768) p_bend_rng_m(.W) $4e オート・ベンドのベンド幅(ＭＩＤＩトラック専用)。 半音≒683で表される相対表現値。(-8192〜8191) p_detune_f(.W) $50 ディチューン(ＦＭ音源トラック専用)。(-768〜768) p_detune_m(.W) $52 ディチューン(ＭＩＤＩトラック専用)。(-8192〜8191) p_port_dly(.W) $54 ポルタメント・ディレイ。(0〜32767) p_bend_dly(.W) $56 ベンド・ディレイ。(0〜32767) p_port_work(.B) $58 ポルタメント用補正値ワーク。 p_port_rvs(.B) $59 ポルタメント用補正値。 p_port_work2(.W) $5a ポルタメント／オート・ベンドにおける現在のピッチベンド値。 ＦＭ音源トラックでは半音＝64、ＭＩＤＩトラックでは半音≒683とする。 p_amod_tbl(.B) $5c〜$63 1/8モード・ＡＭの振幅値。(×8) (-128〜127) p_arcc_tbl(.B) $5c〜$63 1/8モード・ＡＲＣＣ(拡張ＡＲＣＣ)の振幅値。(×8) (-128〜127) p_arvs_tbl(.B) $64〜$6b 1/8モード・ＡＭ(拡張ＡＲＣＣ)用波形生成用・補正値。(×8) p_wvam_point(.L) $64 ＡＭ(拡張ＡＲＣＣ)用・波形メモリ・ポインタ。 p_wvam_end(.L) $68 ＡＭ(拡張ＡＲＣＣ)用・波形メモリ・終了アドレス。 p_pmod_work4(.W) $6c ＰＭ(拡張ＰＭ)用スピードワーク。 p_port_flg(.W) $6e ポルタメント実行中かどうか。 0:off −1 or ＋1:補正する方向(on) p_bend_flg(.W) $70 オート・ベンド実行中かどうか。 0:off −1 or ＋1:補正する方向(on) p_aftc_tbl(.B) $72〜$79 アフタータッチ・シーケンス値。(×8) (0〜127,負数は省略値) p_aftc_dly(.W) $7a アフタータッチ・シーケンス用 音長の1/8カウント。 p_aftc_work(.W) $7c アフタータッチ・シーケンス用 音長の1/8カウントワーク。 p_astep_tbl(.B) $7e〜$85 1/8モード・ＡＭ(拡張ＡＲＣＣ)用波形生成用・整数増分。(×8) p_wvam_loop(.L) $7e ＡＭ(拡張ＡＲＣＣ)用・波形メモリループ開始アドレス。 p_wvam_lpmd(.W) $82 ＡＭ(拡張ＡＲＣＣ)用・波形メモリループモード。(−1,0,＋1) p_alta_flg(.B) $84 ＡＭ(拡張ＡＲＣＣ)用・波形メモリ反復モードフラグ。(0:順行中、1:逆行中) p_pmod_step2(.W) $86 ＰＭ(拡張ＰＭ)用波形生成用・整数増分(使い捨て)。 p_pmod_work(.W) $88 ＰＭ(拡張ＰＭ)用ディレイワーク。 p_pmod_work2(.W) $8a ＰＭ(拡張ＰＭ)用 現在の音程。 ・ＦＭ音源トラックでは半音＝64 ・ＭＩＤＩトラックでは拡張モード１では半音＝64 拡張モード２では半音≒683とする。 p_pmod_work3(.B) $8c ＰＭ(拡張ＰＭ)用波形生成用・補正値ワーク。 p_pmod_n(.B) $8d 1/8モード・ＰＭ(拡張ＰＭ)用ポインタ。(0〜7) p_sync_wk(.B) $8e トラック同期コマンド用ワーク。 $00:同期信号受信 $ff:同期待ち状態 p_rpt_last?(.B) $8f |:〜:|の繰り返しコマンドにおいて、繰り返しが最後かどうか。(bit＝1:last) bit0:多重ループ深い bit1: ↑ : ｜ : ↓ bit7:多重ループ浅い p_@b_range(.B) $90 ピッチベンドレンジ。(0〜127) p_arcc(.B) $91 ＭＩＤＩトラック:ＡＲＣＣ(拡張ＡＲＣＣ)で制御するコントロールチェンジ番号(0〜127)。 ＦＭ音源トラック:ＡＭでどのオペレータに対してモジュレーション操作をするか。 bit＝1:操作対象オペレータ bit＝0〜3:オペレータ1〜4 p_pmod_flg(.W) $92 現在ＰＭ(拡張ＰＭ)が実行中かどうか。 ・ＦＭ音源トラックのＰＭ、ＭＩＤＩトラックの拡張ＰＭではワードサイズ 0:off −1 or ＋1:補正する方向(on) ・ＭＩＤＩトラックの通常ＰＭではバイトサイズ 0:off 0以外:on p_pmod_sw(.B) $94 ＰＭ(拡張ＰＭ)のスイッチ。 ・ＦＭ音源トラックのＰＭ、ＭＩＤＩトラックの拡張ＰＭ 0:off −1 or ＋1:補正する方向(on) ・ＭＩＤＩトラックの通常ＰＭ 0:off 0以外:on p_amod_sw(.B) $95 ＡＭのスイッチ。 0:off −1 or ＋1:補正する方向(on) p_arcc_sw(.B) $95 ＡＲＣＣ(拡張ＡＲＣＣ)のスイッチ。 ・通常ＡＲＣＣ 0:off 0以外:on ・拡張ＡＲＣＣ 0:off −1 or ＋1:補正する方向(on) p_bend_sw(.B) $96 オート・ベンドのスイッチ。 　0:off −1 or ＋1:補正する方向(on) p_aftc_flg(.B) $97 現在アフタータッチ・シーケンスを実行中か。 0:off 0以外:on p_md_flg(.B) $98 汎用ワーク。 bit0 ピッチ・ベンドをリセットするかどうか (ＭＩＤＩトラック専用 0:no 1:yes) bit1 ピッチ・モジュレーションをリセットするかどうか (ＭＩＤＩトラック専用 0:no 1:yes) bit2 ＡＲＣＣ(拡張ＡＲＣＣをリセットするかどうか (ＭＩＤＩトラック専用 0:no 1:yes) bit3 ＭＩＤＩのタイ／スラー・モード (ＭＩＤＩトラック専用 0:normal 1:extended mode) bit4 ＰＭ(拡張ＰＭ)の波形のリセットを行うかどうか (0:行う 1:行わない) bit5 ＡＭ(拡張ＡＲＣＣ)の波形のリセットを行うかどうか (0:行う 1:行わない) bit6 ＰＭ(拡張ＰＭ)の波形のキーオンとの同期非同期のモード (0:同期 1:非同期) bit7 ＡＭ(拡張ＡＲＣＣ)の波形のキーオンとの同期非同期のモード (0:同期 1:非同期) p_waon_flg(.B) $99 現在発音中の音は和音かそれとも単音か。($00:単音 $ff:和音) p_pmod_dly(.W) $9a ＰＭ(拡張ＰＭ)用ディレイ。(0〜65534) p_amod_dly(.W) $9c ＡＭ用ディレイ。(0〜65534) p_arcc_dly(.W) $9c ＡＲＣＣ(拡張ＡＲＣＣ)用ディレイ。(0〜65534) p_port_step(.W) $9e ポルタメント／オート・ベンド用 音程整数増分、 ＦＭ音源トラックでは半音＝64、ＭＩＤＩトラックでは半音≒683とする。 p_bank_msb(.B) $a0 ＭＩＤＩ音色バリエーション上位バイト(0〜127) p_bank_lsb(.B) $a1 ＭＩＤＩ音色バリエーション下位バイト(0〜127) p_effect1(.B) $a2 ＭＩＤＩ汎用エフェクト１(0〜127) p_effect3(.B) $a3 ＭＩＤＩ汎用エフェクト３(0〜127) p_ol1(.B) $a0 ＦＭ音源音色パラメータのオペレータ１のトータル・レベル(アウトプット・レベル)。 p_ol2(.B) $a1 ＦＭ音源音色パラメータのオペレータ２のトータル・レベル(アウトプット・レベル)。 p_ol3(.B) $a2 ＦＭ音源音色パラメータのオペレータ３のトータル・レベル(アウトプット・レベル)。 p_ol4(.B) $a3 ＦＭ音源音色パラメータのオペレータ４のトータル・レベル(アウトプット・レベル)。 p_d6_last(.B) $a4 拡張ＡＲＣＣにおいて前回送信したコントロールチェンジ値を保存しておくワーク。 p_cf(.B) $a4 ＦＭ音源の４つのオペレータのうちどのオペレータがキャリアかを示している。 bit＝1:carrier bit＝0〜3:オペレータ1〜4 p_amod_step2(.B) $a5 ＡＭ(拡張ＡＲＣＣ)用波形生成用・整数増分ワーク(使い捨て)。 p_pb_add(.B) $a6 bit0:休符の時ベンド後のピッチを保存するか。(0:しない 1:する) bit1:休符の時ピッチを保存するか。(0:しない 1:する) p_vset_flg(.B) $a7 キーオン前に音量をリセットするか。(0:しない 0以外:する) p_arcc_rst(.B) $a8 ＡＲＣＣ(拡張ＡＲＣＣ)終了時の初期化値。 p_arcc_def(.B) $a9 ＡＲＣＣ(拡張ＡＲＣＣ)開始時の基準値。 p_coda_ptr(.L) $aa [coda]のあるアドレス。 p_pointer(.L) $ae [segno]のあるアドレス。 p_do_loop_ptr(.L) $b2 [do]のあるアドレス。 p_pmod_work5(.W) $b6 1/8モード・ＰＭ(拡張ＰＭ)用 音長の1/8カウント。 p_pmod_work6(.W) $b8 1/8モード・ＰＭ(拡張ＰＭ)用 音長の1/8カウントワーク。 p_amod_flg(.B) $ba 現在ＡＭが実行中かどうか。 　0:off −1 or ＋1:補正する方向(on) p_arcc_flg(.B) $ba 現在ＡＲＣＣ(拡張ＡＲＣＣ)が実行中かどうか。 ・通常ＡＲＣＣ 0:off 0以外:on ・拡張ＡＲＣＣ 　0:off −1 or ＋1:補正する方向(on) p_aftc_sw(.B) $bb アフタータッチ・シーケンスのスイッチ。($00:off $00以外:on) p_dumper(.B) $bc ダンパー。($00＝off $00以外＝on) p_tie_flg(.B) $bd 前の音符にタイ／スラーの指定があったか。(0:なかった 0以外:あった) p_pmod_dpt(.W) $be ディレイモード・ＰＭ(拡張ＰＭ)の振幅値。(1/8モード時は0になる) p_seq_flag(.B) $c0 bit0:[d.c.]処理をしたことがあるか。(0:ない 1:ある) bit1:[fine]処理をすべきかどうか。(0:すべきでない 1:すべきである) bit2:[coda]を以前に設定したことがあるか。(0:ない 1:ある) bit3:[segno]が今までにあるかないか。(0:ない 1:ある) bit4:[d.s.]処理をしたことがあるか。(0:ない 1:ある) bit5:reserved。 bit6:key off bit。(キーオフ処理をするたびに、このビットが1になる) bit7:key on bit。(キーオン処理をするたびに、このビットが1になる) p_do_loop_flag(.B) $c1 [do]が以前に設定されているか。($00:されていない $01〜:現在の繰り返し回数) p_pmod_spd(.W) $c2 ＰＭ(拡張ＰＭ)の波長の1/4カウント。(1〜32767) p_amod_spd(.W) $c4 ＡＭ(拡張ＡＲＣＣ)の波長の1/4カウント。(1〜32767) p_total_olp(.L) $c6 [do]〜[loop]外のステップタイムの合計。ファンクション$19 または、ファンクション$43を実行後のみ意味を持つ。 p_pmod_step(.W) $ca ディレイモード・ＰＭ(拡張ＰＭ)の波形生成用・整数増分。 p_tie_pmod(.B) $cc タイ／スラーの途中でＰＭ(拡張ＰＭ)関係のパラメータチェンジが 　行われたかどうか。($00:行われなかった $00以外:行われた) p_tie_bend(.B) $cd タイ／スラーの途中でオート・ベンド関係のパラメータチェンジが 　行われたかどうかン。($00:行われなかった $00以外:行われた) p_tie_amod(.B) $ce タイ／スラーの途中でＡＭ関係のパラメータチェンジが 　行われたかどうか。($00:行われなかった $00以外:行われた) p_tie_arcc(.B) $ce タイ／スラーの途中でＡＲＣＣ(拡張ＡＲＣＣ)関係のパラメータチェンジが 　行われたかどうか。($00:行われなかった $00以外:行われた) p_tie_aftc(.B) $cf タイ／スラーの途中でアフタータッチ・シーケンス関係のパラメータチェンジが 　行われたかどうか。($00:行われなかった $00以外:行われた) p_pan2(.B) $d0 パンポット。(L M R) (0〜64〜127) p_non_off(.B) $d1 キーオフ無しモードかどうか。($00:通常モード $00以外:キーオフ無しモード) p_frq(.B) $d2 ＡＤＰＣＭの再生周波数。(0〜6) (ただし5,6はＰＣＭ８独立チャンネルモード時のみ有効) p_velo(.B) $d3 ベロシティ。(0〜127) p_amod_work4(.W) $d4 ＡＭ(拡張ＡＲＣＣ)の波長の1/4カウントワーク。 p_pmod_rvs(.B) $d6 ディレイモード・ＰＭ(拡張ＰＭ)用補正値。 p_waon_dly(.B) $d7 和音用ディレイ値。(0〜255) p_waon_work(.B) $d8 和音用ディレイワーク。 p_waon_num(.B) $d9 和音において何番目のノートをキーオンするか。(0〜7)($ff:全ノートキーオン終了) p_note_last(.B) $d9 単音で発音したノートのノート番号の一時退避ワーク。 p_rpt_cnt(.B) $da〜$e1 その時点での繰り返し回数。($00は空きワーク 1〜255:繰り返し回数) $da:多重ループ深い $db: ↑ : ｜ : ↓ $e1:多重ループ浅い p_maker(.B) $e2 そのトラックが操作している楽器のメーカーＩＤ。 ＠Ｉコマンドの第１パラメータに相当。 p_device(.B) $e3 そのトラックが操作している楽器のデバイスＩＤ。 ＠Ｉコマンドの第２パラメータに相当。 p_module(.B) $e4 そのトラックが操作している楽器のモデルＩＤ。 ＠Ｉコマンドの第３パラメータに相当。 p_last_aft(.B) $e5 前回アフタータッチ・シーケンスで出力されたアフタータッチ値。 p_amod_work(.W) $e6 ＡＭ用ディレイワーク。 p_arcc_work(.W) $e6 ＡＲＣＣ(拡張ＡＲＣＣ)用ディレイワーク。 p_amod_work2(.B) $e8 ＡＭ用 現在の音量。(0〜127) p_arcc_work2(.B) $e8 ＡＲＣＣ(拡張ＡＲＣＣ)用 現在のコントロール値。(0〜127) p_amod_work3(.B) $e9 ＡＭ(拡張ＡＲＣＣ)用波形生成用・補正値ワーク。 p_amod_work7(.B) $ea ＡＭ(拡張ＡＲＣＣ)用 ノコギリ波生成用ワーク。 (一周期終了後の、波形の開始値の記憶) p_amod_n(.B) $eb 1/8モード・ＡＭ用ポインタ。(0〜7) p_arcc_n(.B) $eb 1/8モード・ＡＲＣＣ(拡張ＡＲＣＣ)用ポインタ。(0〜7) p_arcc_work5(.W) $ec 1/8モード・ＡＭ用 音長の1/8カウント。 p_amod_work5(.W) $ec 1/8モード・ＡＲＣＣ(拡張ＡＲＣＣ)用 音長の1/8カウント。 p_arcc_work6(.W) $ee 1/8モード・ＡＭ用 音長の1/8カウントワーク。 p_amod_work6(.W) $ee 1/8モード・ＡＲＣＣ(拡張ＡＲＣＣ)用 音長の1/8カウントワーク。 p_pmod_wf(.B) $f0 ＰＭ(拡張ＰＭ)の波形形状。 −31〜−8:ユーザー波形番号 0:ノコギリ波 1:矩形波 2:三角波 3:ノコギリ波シングル p_amod_dpt(.B) $f1 ディレイモード・ＡＭ(拡張ＡＲＣＣ)の振幅値。(1/8モード時は0になる) (-128〜127) p_amod_wf(.B) $f2 ＡＭ(拡張ＡＲＣＣ)の波形形状。 −31〜−8:ユーザー波形番号 0:ノコギリ波 1:矩形波 2:三角波 3:ノコギリ波シングル p_dmp_n(.B) $f3 ＦＭ音源トラック用ダンパー処理ワーク。 p_ch＋p_dmp_nしたチャンネルで次回の発音を行う。(0〜7) p_pmod_omt(.B) $f4 1/8モード・ＰＭ(拡張ＰＭ)用 パラメータ省略ビットパターン。 bit＝0:省略 bit＝1:有効 bit0〜7:第１パラメータ〜第８パラメータ p_amod_omt(.B) $f5 1/8モード・ＡＭ用 パラメータ省略ビットパターン。 bit＝0:省略 bit＝1:有効 bit0〜7:第１パラメータ〜第８パラメータ p_arcc_omt(.B) $f5 1/8モード・ＡＲＣＣ(拡張ＡＲＣＣ)用 パラメータ省略ビットパターン。 bit＝0:省略 bit＝1:有効 bit0〜7:第１パラメータ〜第８パラメータ p_pmod_mode(.B) $f6 拡張ＰＭのモード番号。 −1:通常ＰＭモード 0:半音＝64モード 1:半音≒683モード p_arcc_mode(.B) $f7 拡張ＡＲＣＣのモード番号。 −1:通常ＡＲＣＣモード 0:拡張ＡＲＣＣモード p_pmod_chain(.B) $f8 1/8モード・ＰＭ(拡張ＰＭ)波形接続ワーク。 −1:接続待機 0:波形通常実行中 1:強制接続 p_amod_chain(.B) $f9 1/8モード・ＡＭ、ＡＲＣＣ(拡張ＡＲＣＣ)波形接続ワーク。 −1:接続待機 0:波形通常実行中 1:強制接続 p_jump_flg(.B) $fa [!]コマンド・ステータス・ワーク。 −1:通常演奏状態 0:ジャンプ実行中 1:ジャンプ終了 p_waon_mark(.B) $fb 主チャンネルのパラメータ変更をしたか。(0:していない 0以外:した) p_marker(.W) $fc p_marker＋0(.B):このトラックは効果音トラックか。 (0:通常トラック 0以外:効果音トラック) p_marker＋1(.B):フェーダー移動フラグ(オーバーフローするとフェーダーが動く)。 p_amod_rvs(.B) $fe ディレイモード・ＡＭ、ＡＲＣＣ(拡張ＡＲＣＣ)用補正値。 p_ne_buff(.B) $ff 効果音トラックにおけるp_not_empty(.B)の一時退避ワーク。 p_user(.B) $ff ユーザー汎用ワーク。 １３．１．３． ワーク参照にあたっての注意 ワークの不当な書き替えは、演奏に支障をきたすだけでなく、ＺＭＵＳＩＣの暴走を 引き起こす可能性もあるため、細心の注意を必要とする。また、特殊な使用目的 以外では、各ワークは読み出し専用と考え、書き替えはなるべく行わないように すべきである。 各ワークは、必ずしも使用されているとは限らず、条件によっては、そのワークが 持つ値は何の意味も持たない場合がある。例えばＰＭのスイッチp_pmod_sw(.B)が ＯＦＦ(0)の場合、ＰＭ関連ワークに格納されている値は何の意味も持たない。 また、ＭＭＬやコマンドで与えたパラメータ値とワーク内部で表現される 内部表現形式とは多少の食い違いがあるので注意すること。例えば音色番号は ＭＭＬパラメータでは @<音色番号:1〜200> であるが、ワーク(内部表現)では p_pgm(.B):0〜199 となっている。 １３．１．４． ブレゼンハムのアルゴリズム(Bresenham's algorithm)について ＺＭＵＳＩＣではオートベンドやポルタメント、ピッチ・モジュレーションや アンプリチュード・モジュレーションなどの波形の生成実行にブレゼンハムの アルゴリズム(Bresenham's algorithm)を使用している。このパラメータ計算と その実行について解説をする。 ・パラメータの計算 図１のようなv1→v2への値変化を行いたい場合を考える。つまり、絶対カウント st間にちょうどv1からv2へ幅yだけ変化させたいということである。 整数増分パラメータは <整数増分パラメータ>＝int(y/st) (ただしst≠0。yは正数、負数いずれも可) そして補正パラメータは <補正パラメータ>＝abs(y mod st)×256/st <補正方向>＝sgn(y) で求められる。 ┏━━━━━━━━━━━━━┓ ┃ v2 ┃ ┃ ／ ↑ ┃ ┃ ／ ｜ ┃ ┃ ／ ｜y ┃ ┃ ／ ｜ ┃ ┃ ／ ↓ ┃ ┃ v1←───→ ┃ ┃ st ┃ ┗━━━━━━━━━━━━━┛ 図１パラメータ ・実行 実際の実行は st≠0 v1←初期値 rvs_wk(補正値ワーク):＝0 として、 repeat v1:＝v1＋<整数増分パラメータ> rvs_wk:＝rvs_wk＋<補正パラメータ> if (Carry flag is set) then v1:＝v1＋<補正方向> st:＝st−1 until st＝0 のようなアルゴリズムにより施行される。 なお、演奏トラックワークとブレゼンハムのアルゴリズムにおけるパラメータとの 対応は ●ポルタメント 補正値:p_port_rvs(.B) $59 補正方向:p_port_flg(.W) $6e 整数増分:p_port_step(.W) $9e 補正値ワーク:p_port_work(.B) $58 計算結果:p_port_work2(.W) $5a ●オート・ピッチベンド 補正値:p_port_rvs(.B) $59 補正方向:p_bend_flg(.W) $70 整数増分:p_port_step(.W) $9e 補正値ワーク:p_port_work(.B) $58 計算結果:p_port_work2(.W) $5a ●ピッチ・モジュレーション 補正値:p_pmod_rvs(.B) $d6 補正方向:p_pmod_flg(.W) $92 整数増分:p_pmod_step2(.W) $86 補正値ワーク:p_pmod_work3(.B) $8c 計算結果:p_pmod_work2(.W) $8a ●アンプリチュード・モジュレーション/拡張ＡＲＣＣ 補正値:p_amod_rvs(.B) $fe 補正方向:p_amod_flg(.B) $ba 整数増分:p_amod_step2(.B) $a5 補正値ワーク:p_amod_work3(.B) $e9 計算結果:p_amod_work2(.B) $e8 のようになっている。また、1/8モードのピッチ・モジュレーションや、1/8モードの アンプリチュード・モジュレーションでは整数増分と補正値が８つ分テーブルに 格納されており、随時使用される。 ●1/8モード・ピッチ・モジュレーション 補正値テーブル:p_mrvs_tbl(.B) $20〜$27 整数増分テーブル:p_mstep_tbl(.W) $0c〜$1b ●1/8モード・アンプリチュード・モジュレーション/拡張ＡＲＣＣ 補正値テーブル:p_arvs_tbl(.B) $64〜$6b 整数増分テーブル:p_astep_tbl(.B) $7e〜$85 １３．２． バッファ管理ワーク ファンクション$45でＺＭＵＳＩＣの各バッファのアドレスを知ることができる。 ここでは、これらのバッファの構造や役割について解説をする。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ファンクション$45 buffer_info ┃ ┃ ┃ ┃機能: 各バッファのアドレス、サイズ、終了アドレスの情報を得る ┃ ┃ ┃ ┃引数: なし ┃ ┃ ┃ ┃戻り値: 0(a0)＝トラックバッファの先頭アドレス trk_top ┃ ┃ 4(a0)＝トラックバッファのサイズ trk_buf_size ┃ ┃ 8(a0)＝トラックバッファ終了アドレス trk_buf_end ┃ ┃ ＝ＺＭＵＳＩＣの最終アドレス (dev_end_adr) ┃ ┃ 12(a0)＝ＡＤＰＣＭバッファ先頭アドレス adpcm_buffer_top ┃ ┃ 16(a0)＝ＡＤＰＣＭバッファサイズ adpcm_buffer_size ┃ ┃ 20(a0)＝ＡＤＰＣＭバッファ終了アドレス adpcm_buffer_end ┃ ┃ 24(a0)＝汎用ワークエリア先頭アドレス adpcm_work_top ┃ ┃ 28(a0)＝汎用ワークエリアサイズ adpcm_work_size ┃ ┃ 32(a0)＝汎用ワークエリア終了アドレス adpcm_work_end ┃ ┃ ┃ ┃ 36(a0)＝新規に登録される adpcm_buffer_next ┃ ┃ ＡＤＰＣＭデータが ┃ ┃ 格納されるアドレス ┃ ┃ adpcm_buffer_top≦adpcm_buffer_next≦adpcm_buffer_end ┃ ┃ ┃ ┃ 40(a0)＝次にワークが使用される場合の adpcm_work_now ┃ ┃ 汎用ワーク使用可能開始アドレス ┃ ┃ adpcm_work_top≦adpcm_work_now≦adpcm_work_end ┃ ┃ ┃ ┃ 44(a0)＝汎用ワークエリアの本当のサイズ adpcm_work_true_size ┃ ┃ ┃ ┃ 48(a0)＝演奏トラックワーク格納アドレス seq_wk_tbl ┃ ┃ 52(a0)＝効果音トラックワーク格納アドレス seq_wk_tbl2 ┃ ┃ ┃ ┃ 56(a0)＝ＡＤＰＣＭデータの管理テーブル adpcm_tbl ┃ ┃ 格納アドレス ┃ ┃ ┃ ┃ 60(a0)＝波形メモリの管理テーブル wave_tbl ┃ ┃ 格納アドレス ┃ ┃ ┃ ┃ 64(a0)＝ＦＭ音源音色バッファのアドレス neiro ┃ ┃ ┃ ┃ 68(a0)＝各トラックの先頭アドレス trk_po_tbl ┃ ┃ 格納テーブルアドレス(1,2,3,...80) ┃ ┃ ┃ ┃ 72(a0)＝m_allocで確保した各トラックの trk_len_tbl ┃ ┃ サイズ格納アドレス(1,2,3,...80) ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ●トラックバッファ トラックバッファはＺＭＤを格納するために確保されているが、ＭＤＤ作成時に 汎用ワークとして使用されることがある。 外部アプリケーションで確保したメモリ領域をＺＭＵＳＩＣから参照させるには (trk_top)＝メモリ領域の先頭アドレス (trk_buf_size)＝メモリ領域のサイズ (trk_buf_end)＝メモリ領域の最終アドレス を設定する。 ●ＡＤＰＣＭバッファ ＡＤＰＣＭバッファにはＺＰＤをはじめとしたＡＤＰＣＭデータが格納される。 ＡＤＰＣＭバッファのサイズが0の時はＡＤＰＣＭ関連の命令やファンクションは 使用できない。 外部アプリケーションで確保したメモリ領域をＺＭＵＳＩＣから参照させるには (adpcm_buffer_top)＝メモリ領域の先頭アドレス (adpcm_buffer_size)＝メモリ領域のサイズ (adpcm_buffer_end)＝メモリ領域の最終アドレス (adpcm_buffer_next)＝メモリ領域の先頭アドレス を設定する。 ●汎用ワークエリア 汎用ワークエリアは、ＡＤＰＣＭコンフィギュレーション一時退避場所としてや、 ＡＤＰＣＭデータ加工時のワークエリア、波形メモリのバッファ(ＺＭＳ時)、 ＭＤＤ作成時のワークエリアとして多目的に使用される。 ＡＤＰＣＭコンフィギュレーション一時退避場所、波形メモリの バッファ(ＺＭＳ時)として使用した場合は便宜上のワークサイズ(adpcm_work_size)が 伸縮する。 外部アプリケーションで確保したメモリ領域をＺＭＵＳＩＣから参照させるには (adpcm_work_top)＝メモリ領域の先頭アドレス (adpcm_work_size)＝メモリ領域のサイズ (adpcm_work_end)＝メモリ領域の最終アドレス (adpcm_work_now)＝メモリ領域の先頭アドレス (adpcm_work_true_size)＝メモリ領域のサイズ を設定する。 ●演奏トラックワーク 演奏中の各トラックのワーク。トラックは80本あり(ＺＭＳＣ．Ｘでは32本) １本のトラックにつき256バイトのワークが割り当てられている。各ワークの 役割については１３．１．を参照のこと。 (seq_wk_tbl)＋トラック番号(0〜79)×256 で任意のトラックのワーク先頭アドレスを求めることができる。 ●効果音トラックワーク 効果音トラックの演奏トラックワーク。トラックは32本あり、役割、 ワークサイズはまったく演奏トラックワークと同等。 ●ＡＤＰＣＭ管理テーブル 各ノート番号に割り当てられたＡＤＰＣＭデータを管理するワーク。 バンク１ ノート番号０ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号１ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号２ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) : : ノート番号127 ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) バンク２ ノート番号０ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号１ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号２ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) : : ノート番号127 ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) バンク３ ノート番号０ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号１ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号２ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) : : ノート番号127 ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) バンク４ ノート番号０ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号１ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) ノート番号２ ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) : : ノート番号127 ＡＤＰＣＭデータアドレス(.L),ＡＤＰＣＭデータサイズ(.L) という構成を取っている(8×128×4＝4096bytes)。 任意のバンク番号(1〜4)、ノート番号(0〜127)に対応する管理ワークアドレスは (adpcm_tbl)＋(バンク番号−1)×128×8＋ノート番号×8 にて求めることができる。 ●波形メモリ管理テーブル 各波形番号に割り当てられた波形メモリデータ列を管理するワーク。 波形番号8 start address(.L),end address(.L),loop point(.L),loop mode(.W) 波形番号9 start address(.L),end address(.L),loop point(.L),loop mode(.W) 波形番号10 start address(.L),end address(.L),loop point(.L),loop mode(.W) : : 波形番号31 start address(.L),end address(.L),loop point(.L),loop mode(.W) という構成を取っている(14×24＝336bytes)。アドレスとループポイントは 絶対アドレス、ループモード値は0〜2で与えたものが −1,0,＋1 にパラメータシフト されている点に注意。 任意の波形番号に対応したワークアドレスは (wave_tbl)＋(波形番号−8)×14 にて求めることができる。 ●ＦＭ音源音色バッファ ＦＭ音源の音色は１音色につき55バイトで構成されている。よって (neiro)＋(音色番号(1〜200)−1)×55 で、任意の音色の格納アドレスを参照できる。 ●各トラックの先頭アドレス 各トラックの先頭アドレスはtrk_po_tblに格納されているアドレスから トラック１の先頭アドレス(.L) トラック２の先頭アドレス(.L) トラック３の先頭アドレス(.L) ： ： トラック80の先頭アドレス(.L) のように格納されている。よって、任意のトラック番号のトラックの先頭アドレスは ((trk_po_tbl)＋トラック番号(0〜79)×4) で求めることができる。 ●各トラックの長さ 各トラックの長さはtrk_len_tblに格納されているアドレスから トラック１の長さ(.L) トラック２の長さ(.L) トラック３の長さ(.L) ： ： トラック80の長さ(.L) のように格納されている。よって任意のトラック番号のトラックの長さは ((trk_len_tbl)＋トラック番号(0〜79)×4) で求めることができる。 このワークの値は「ファンクション$01 m_alloc」が実行された場合のみ意味を持つ。 ＺＭＤファイルを演奏した場合はm_allocされないのでワークの値は無意味。 { -- ZM14.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ１４ 効果音モードと映像同期モード ここでは、ＺＭＵＳＩＣの特殊機能である 「効果音モード」と「映像同期モード」についての 解説を行います。本章を理解するには ＭＰＵ６８０００の機械語の知識が必要です。 通常の音楽演奏のみを行なうユーザーは読み飛ばして 構いません。 「効果音モード」の解説はオリジナル・ゲーム・ プログラムで実際に使用することを想定して 具体的に解説します。 １４．１． 効果音モード １４．１．１． ＺＭＵＳＩＣの組み込み ●組み込みメッセージの制御 −Ｇ ＺＭＵＳＩＣを組み込んだ後にＺＭＵＳＩＣのロゴやバージョン番号、確保した バッファの容量等の情報が画面に出力される。このスイッチを設定するとこれらを いっさい表示しないようにすることができる。機能自体に特別な深い意味はないが アプリケーションを起動する際の画面バランスに気を使う場合は設定するとよい。 ●多重割り込みに対応させる −Ｍ ゲームのメインプログラムでラスタースクロールやその他のＭＦＰを使った割り込みを 使用している場合には設定したほうがよい。設定しないとＺＭＵＳＩＣの割り込み 処理中に一切の割り込みがキャンセルされてしまい、希望通りの処理がなされない 場合がある。 しかしこのモードでＭＦＰを使った割り込み処理が極端に重くなった場合は、 音楽側のテンポに影響が出ることがある。 ＰＣＭ８モード時には暗黙のうちにこのモードが選択される。 ●初期化制御 −Ｎ ＺＭＵＳＩＣでは通常、新たに演奏データを演奏しようとするとＭＩＤＩ楽器に 初期化パラメータを設定したりＦＭ音源の初期化等をしている。この初期化処理は 新たに演奏する曲の都合を無視したものである。たとえばＭＩＤＩ音源の10チャンネル 以下しか使用していない曲をこれから演奏しようという時に11チャンネル以上の 初期化も行ってしまう。この「余計な処理」はゲームの曲の切り替え時において ゲーム画面のスクロールの一時停止といった目に見える症状になってしまう場合がある。 そこでこの'−Ｎ’オプションスイッチを設定すると以後この「余計な処理」処理を 省くことができる。ただしＦＭ音源／ＭＩＤＩ楽器に対して一切の初期化処理を 行わなくなるので各演奏データには必要な初期化データを盛り込む必要が 出てくる（後述）。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ２通りの演奏データ形式 ┃ ┃ ┃ ┃ ゲームの演奏データを設計する場合に二通りのバリエーションが存在する。 ┃ ┃ ┃ ┃ １つはＭＩＤＩ対応曲と内蔵音源対応曲を分けてそれぞれ用意する場合（Ｏｈ！Ｘ ┃ ┃ ┃ ┃１９９２年６月号付録の「ＳＩＯＮII」やコナミの「出たな!!ツインビー」など）。 ┃ ┃ ┃ ┃ もう１つは内蔵音源がメインでＭＩＤＩボードがある場合はＭＩＤＩ音源もこれに ┃ ┃ ┃ ┃重なって鳴るといった、１つのデータで両方をまかなうタイプのもの（コナミの ┃ ┃ ┃ ┃「パロディウスだ!!」など）。 ┃ ┃ ┃ ┃ ＺＭＵＳＩＣでは常駐処理の時にＭＩＤＩボードの有無を検査してＭＩＤＩボードが┃ ┃ ┃ ┃なければ以後、ＭＩＤＩ部の演奏を自動的にミュートして内蔵音源部のみ演奏出来る ┃ ┃ ┃ ┃モードになる。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ●汎用ワークエリアの設定 −Ｗn ゲーム等の曲で演奏のたびにＡＤＰＣＭコンフィギュレーションファイルを読んだり ＡＤＰＣＭの加工処理を行ったりするのはまったくの非常識であるため汎用ワークは 不要ということになる。よって普通は −Ｗ0 でいいことになる。 ●ＡＤＰＣＭデータ −Ｂ ＺＰＤファイルネーム −Ｐn ゲーム中に用いるすべてのＢＧＭが１つのＺＰＤデータを用いてる場合は −Ｂ ＺＰＤファイルネーム でドライバ組み込み時に組み込んでしまうとよい。'−Ｂ'は組み込むＺＰＤファイルの ファイルサイズ分自動的にＡＤＰＣＭバッファを確保してくれるため便利である。 ゲーム中に数回ＺＰＤデータを切り替えたりする場合は'−Ｐ'で必要最大分バッファを 確保して、あとからファンクションコールなどを使ってＺＰＤデータや ＡＤＰＣＭデータを登録するということになる。 また、演奏する曲がまったくＡＤＰＣＭを使用しない場合はＡＤＰＣＭバッファを 特に確保する必要はない。 ●トラックバッファ −Ｔn 曲データをゲームプログラム開始前に一括してメインプログラムの管理領域に 読み込んでしまうのが賢明である。そして曲の切り替え時にはあらかじめ 読み込んでおいた演奏データの先頭アドレスをＺＭＵＳＩＣに与えてやればよいので ある（具体例は後述）。ということはつまりＺＭＵＳＩＣのトラックバッファは まったく不要ということであるから、その場合 −Ｔ0 でよいことになる。 また、ゲームのメインプログラムが大きくて一括して読み込めない場合は 1ステージ内に必要分を先読みするようにすればよい(例ステージＢＧＭ、ボスＢＧＭ)。 １４．１．２． ゲームに負担をかけない演奏データとは？ まず、演奏データ制作者はゲームのプログラムに負担をかけないように心掛けて 演奏データを作成しなければならない。また、曲の切り替りに時間がかからない様に しなければならない。例えばスクロールシューティングゲームでステージＢＧＭから ボスのテーマに切り替る時に、スクロールが止まってしまってはスピード感を損ねて しまう。 したがって曲データはすべて応答の高速であるＺＭＤレベルで管理すべきである。 さもないと曲の切り替るたびにコンパイルする動作を強いられ、曲の切り替えが とても遅くなるからである。 ここでは曲の切り替りの早い演奏データを作るためのテクニックについてのべる。 ●共通コマンドは使わない ＦＭ音源音色の定義コマンドやＭＩＤＩエクスクルーシブコマンドなどのトラックに 依存しない、いわゆる「共通コマンド」は割り込みで処理されないために 曲の切り替え時のウェイトになりかねない。つまりＺＭＳファイルをコンパイルして ＺＭＤを得た時に共通コマンド部分のＺＭＤコードが皆無ならばよいのである。 そこでＭＭＬで簡単に置き換えられる共通コマンドはすべてＭＭＬに置き換えた ほうがよい。たとえばテンポ設定ＺＭＳコマンド(Ｏn)は用いずＭＭＬの テンポコマンドを用いるようにしたり、'.ROLAND_EXCLUSIVE'命令や '(Ｘn 1,n 2,n 3,…,n i)'などはＸコマンドや、＠Ｘコマンドを用いたりしてＭＭＬへ 直していく。 また、どうしても置き換わらないもの 音色登録 ＭＩＤＩ楽器個別コマンド などは後述する方法で解決する。 結局ゲームに用いる演奏データには 初期化コマンド…(Ｉ) ベースチャンネル設定…(Ｂn) トラック確保…(Ｍtr,size) チャンネルアサイン…(Ａch,tr) 以外の共通コマンドを用いないようにする。以上の４つのコマンドはコンパイル時に 消化され、共通コマンドコードとしてＺＭＤデータに生成されない。 ●音色登録 演奏データには様々な音色が使用されるが、この音色データを１曲ごとに持たせて 演奏の開始時にいちいち登録していたのでは曲の切り替りが遅くなってしまう （アクションゲームのような極端な高速切り替えが要求されていないＲＰＧやＡＤＶなら 別に構わないであろうが）。 ＺＭＵＳＩＣではＦＭ音源200音色分(No.1〜No.200)の専用バッファを持っており、 ドライバが解除されたりしなければ、この領域はいつまでも保存されている。よって、 そのゲーム中に使用されるＦＭ音色をあらかじめドライバの組み込み時に オプションスイッチ'−Ｓ'で転送してしまい演奏データには一切のＦＭ音色データを 持たないようにすればよい。効果音で用いられるＦＭ音色も一緒に送ってしまうと よい。 ＭＩＤＩ楽器の音色の場合もＦＭ音源音色の場合と同様である。そのゲーム中の ＢＧＭで使用する音色データをＭＩＤＩ楽器へあらかじめ登録してしまえばよいの である(ＭＩＤＩ楽器の初期化コマンドを実行すると設定した音色までも初期化される 事があるので注意)。 音色のセットアップファイルの例をリスト１に示す。このリスト１のようなものを A>zmusic −sSETUP.ZMS のようにしてドライバ常駐とともに組み込んでしまえばよいのである。 もちろんコンパイルして A>zmusic −sSETUP.ZMD の様にしても構わない。 複数のＭＩＤＩ楽器に対応している場合はＭＵＳＩＣコンフィギュレーションの ような場所で楽器を選ばせ、その時点であらかじめ用意しておいたその楽器の 音色データをセレクトして転送するようにすればよいであろう。 ●ＭＩＤＩ楽器個別コマンド 音色データやグローバルなＭＩＤＩ楽器の設定はゲームが開始される前にあらかじめ 登録しておくことで解決するが、１曲ごとに変えたい設定もある。たとえばパーシャル リザーブなどである。 楽器個別命令も共通コマンドであるためなんとかＭＭＬへコンバートしたいところで ある。こういったものはエクスクルーシブメッセージで処理を実現しているため ＭＭＬの＠ＸやＸへ変換できなくはないが、いちいち楽器のマニュアルを見ながら ＭＭＬを書いていくのは大変である。 こういう場合には同梱の支援ツール「ＺＭＤ１８．Ｒ」を使用するとよい。 このＺＭＤ１８．ＲはＺＭＤデータ中にあるＭＩＤＩ楽器個別コマンドを ＭＭＬに変換するものである。 具体的な使い方を以下に示す。 たとえばＭＵＳＩＣ．ＺＭＳというＭＩＤＩ楽器個別コマンドが多用された ＺＭＳファイルがあったとする。これを A>zmusic -c MUSIC としてコンパイルし、ＭＵＳＩＣ．ＺＭＤを得る。 つぎに A>zmd18 MUSIC とすると画面に (T1)@X$F0,$41,$10,$16,$12,$7F,$00,$00,$00,$01,$F7 (T1)@X$F0,$41,$10,$16,$12,$08,$00,$00,$43,$48,$4F,$52,$44,$20,$20,$20 (T1)@X$20,$20,$00,$00,$03,$00,$24,$35,$0B,$01,$02,$00,$24,$09,$00,$00 (T1)@X$00,$00,$00,$00,$00,$32,$32,$32,$32,$32,$3E,$17,$55,$64,$17,$04 (T1)@X$27,$08,$18,$64,$00,$00,$00,$0D,$18,$4D,$53,$64,$59,$4C,$48,$5E (T1)@X$4A,$5B,$0C,$1B,$0C,$00,$00,$00,$00,$00,$09,$2B,$64,$64,$64,$63 (T1)@X$24,$30,$0B,$01,$03,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$32 (T1)@X$32,$32,$32,$32,$40,$17,$38,$64,$17,$05,$67,$06,$2B,$64,$00,$00 (T1)@X$00,$07,$16,$64,$62,$64,$5E,$54,$4F,$5E,$46,$5B,$0C,$1B,$0C,$00 (T1)@X$00,$00,$04,$0B,$0E,$0F,$64,$60,$5C,$5B,$6B,$F7 (T1)@X$F0,$41,$10,$42,.... (T1)@X..... ： ： といったものが出てくる。これらがＺＭＤ中のＭＩＤＩ楽器個別コマンドが ＭＭＬへとコンバートされたものである。 これをリダイレクトしてどこかに保存し、ＭＵＳＩＣ．ＺＭＳのトラック１の先頭へ 挿入する。また、ＥＯＸ($F7)の後には若干のウェイトが必要なので休符を 添付してやる。あとは、ＭＵＳＩＣ．ＺＭＳ中の共通コマンドを全て削除すれば作業の 終わりである。 ●コメント 演奏データのタイトルや作者名を記述するのに使われている.comment文も演奏時には 文字列をスキップする動作を強いられるため、これがウェイトになりかねないので 用いないようにする。 ●テンポ 曲のテンポは共通コマンド(Ｏn)を用いずにＭＭＬのＴコマンドを用いて 変化させたほうがいいということは、すでに述べた通りである。 ゲーム中に用いる曲の場合、テンポがステージ毎にあまりにも速かったり遅かったり すると効果音もそのテンポにつられて速くなったり遅くなったりする。例えばある ステージでＢＧＭがテンポ100で演奏されていてレーザーの発射音が 「ちゅーーん・ちゅーーん」だったとする。そして別のステージに突入し、 ＢＧＭのテンポが倍の200になったとすると「ちゅん・ちゅん」になってしまう。 これを防止（というかつじつまを合せる）するのが(Ｚn)コマンドである。 この命令は全音符の絶対音長をデフォルトの192からnへ変更するものである。 テンポが速くなるというのはタイマ割り込みの割り込み間隔が速くなるという ことであるから、この割り込み間隔を一定にしつつ曲のテンポを変えることを 考えればいいのである。 先程のＢＧＭのテンポが速くなったために効果音も速く鳴ってしまった例は、 (効果音と、もとのＢＧＭが全音符の絶対音長が192基準で作られているならば)、 テンポ200の曲の方を全音符の絶対音長を96にしてやれば、テンポ200でも 割り込み間隔はテンポ100と全く同じものとなり、この曲はテンポ200、 効果音はテンポ100で演奏され万事解決となる。 つまりタイマ値を大体一定（あんまり厳密でなくて構わないが）にし、 ひとつのひとつの音符の絶対音長の長短でテンポを調整するイメージである。 テンポＭＭＬコマンドＴはこの全音符の絶対音長変更コマンドの(Ｚn)を考慮して タイマ値を算出してしまうのでタイマ値を直接設定できる＠Ｔコマンドを用いると 分かりやすいであろう。 ところでこの(Ｚn)コマンドは共通コマンドであるからＺＭＤデータとしても 生成されてしまう。共通コマンドの削減をこれまで繰り返し言ってきたが、 このコマンドは実行に大して時間を食わないので、例外として扱って構わないだろう。 ●初期化 前節で解説したようにＺＭＵＳＩＣを'−Ｎ'オプションを付けて初期化なしモードで 常駐させている場合、各演奏データに楽器初期化等のコマンドを盛り込まないと前の 演奏データの設定状態が受け継がれることになってしまう。 ＺＭＵＳＩＣでは初期化モードでない通常モードの場合、新たな演奏データの 演奏開始直前に以下のようなメッセージを送信している。 ＦＭ音源部 ノイズモードオフ(Ｙ15,0相当) ＡＤＰＣＭ音源 特になし。 ＭＩＤＩ音源部 リセット　オール　コントローラーズ($Bn,$79,$00) オムニ モード オン($Bn,$7D,$00) モノ モード オフ($Bn,$7F,$00) ローカル オン($Bn,$7A,$7F) ファインチューニングをニュートラルへ($Bn,$65,$00,$Bn,$64,$01, $Bn,$06,$40,$Bn,$26,$00) コースチューニングをニュートラルへ($Bn,$65,$00,$Bn,$64,$02,$Bn,$06,$40) ピッチ・ベンドレンジ＝１オクターブ($Bn,$65,$00,$Bn,$64,$00,$Bn,$06,$0C) ボリューム＝63($Bn,$07,$3F) パンポット＝中央($Bn,$0A,$40)) ピッチ・モジュレーション＝0($Bn,$01,$00) ダンパー オフ($Bn,$40,00) ピッチ・ベンドをニュートラルへ($En,$00,$40) 以上から必要なものをピックアップして演奏データに盛り込むべきである。 初期化なしモードとそうでない場合の違いはこれらの初期化動作が行われるか、 行われないかの違いになってくる。こうしてみるとＦＭ音源とＡＤＰＣＭ音源は 初期化なしモードと通常モードの区別を特に意識する必要はないかもしれない。 演奏データをゲームプログラムなどに取り込む前に一度、初期化なしモードで 演奏してみるとよいだろう。それで演奏がおかしかったならば、どの初期化メッセージ が足りなかったのかを見極めて、随時それらを盛り込んでいくとよいだろう。 ローランド系のＤＴＭ楽器（ＣＭやＭＴ、ＳＣシリーズなど）では楽器の メモリアドレスのある箇所にダミーデータを書き込むと本体内の全パートを 初期化してくれる便利な機能がある。これを使えば上のような初期化メッセージを いちいち送らなくても少ない手間で初期化が行える。いくつか例を挙げておく。 （初期化したあとの楽器の状態については各楽器のマニュアルを参照し確認すること） ●ＭＴ３２/ＣＭ３２Ｌ/ＣＭ６４/ＣＭ３２Ｐ/ＣＭ５００のＬＡ音源部 $7F,$00,$00にダミーデータを書き込む 例 共通コマンド….ROLAND_EXCLUSIVE $10,$16＝{$7F,$00,$00,$00} ＭＭＬ…@I$41,$10,$16 X$7F,$00,$00,$00 ●ＳＣ５５/ＳＣ１５５/ＣＭ３００/ＣＭ５００のＧＳ音源部 $40,$00,$7Fにダミーデータを書き込む 例 共通コマンド….ROLAND_EXCLUSIVE $10,$42＝{$40,$00,$7F,$00} ＭＭＬ…@I$41,$10,$42 X$40,$00,$7F,$00 (ＳＣ５５は初期化するとベンドレンジが２半音範囲になってしまう点に注意すること) ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ＣＯＭＣＨＫ．Ｒ ┃ ┃ ┃ ┃ ┃ ┃ 開発途中はいろいろと曲のデータの方も日に日に手を入れられ改良されていく ┃ ┃ ┃ ┃でしょうから、共通コマンドを撲滅するのは最終的な段階で構わないでしょう。 　 ┃ ┃ ┃ ┃ そこで最終的なチェック用としてコンパイルして生成したＺＭＤデータに ┃ ┃ ┃ ┃共通コマンドがあるかないかを検査するプログラム「ＣＯＭＣＨＫ．Ｒ」を ┃ ┃ ┃ ┃提供します。 ┃ ┃ ┃ ┃ 使い方は ┃ ┃ ┃ ┃ＣＯＭＣＨＫ ＺＭＤファイル ┃ ┃ ┃ ┃とするだけです。共通コマンドがあれば「ある」と、なければ「ない」という結果を┃ ┃ ┃ ┃出力してくれます。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ １４．１．３． ＢＧＭデータの改変具体例 ここでは、いままで解説してきた事柄を実際の音楽プログラムに対して行ってみる ことにしよう。 リスト２のようなミュージックプログラムがあったとしてこれをゲーム向きの データへ修正していくとする。 まず、コンパイルをしてＺＭＤを得る。 A>zmusic -c LIST2 このＺＭＤデータに対してＺＭＤ１８．Ｒを実行しリダイレクトして 共通コマンド部分をＭＭＬに変換する。 A>zmd18 LIST2 > LIST3 リスト３のようなものが得られる。再びリスト２を読み込んで上から順番に 共通コマンドをつぶしていく。まず１番上の.comment文を'／'に置き換えて無効化 する。そこから下にみていくと、テンポコマンドがあるがこれを無効化しＭＭＬに直す。 その下のＭＩＤＩ楽器個別コマンドを'／'で無効化する。ちょうどこれらの 共通コマンドの働きと同じものがＺＭＤ１８．Ｒによって生成されたリスト３である。 このリスト３をリスト２のＭＭＬ部分の先頭に挿入する。前述のようにＥＯＸ($F7)の あとには多少のウェイトが必要であるから、休符'r16'を２つあるＥＯＸの後ろに 挿入する。このままでは１トラックだけr16×2＝r8分演奏が遅れてしまうため他の トラックにつじつま合せを施す。 こうしてできたのがリスト４でこれをコンパイルすれば共通コマンドなしの ＺＭＤの完成となる。 １４．１．４． 演奏開始ルーチン できた曲データ(ＺＭＤ)をゲームのメインプログラムから演奏するためには、 ＺＭＵＳＩＣを呼び出すための簡単なマネージメント・プログラム(つまりは 演奏開始ルーチン)が必要である。さまざまな演奏開始ルーチンが考えられるが サンプルとしてリスト５を示す。 この例では各演奏データがmusic0、music1、music2…とそれぞれ偶数番地に 読み込まれているとする。そこでmusic0を演奏したいならばd0.lに0、music1を 演奏したいならばd0.lに1を入れ、このルーチンplay_musicをサブルーチンコールする ようにする。これで演奏が開始される。 演奏データに埋め込まれているドライバのバージョンＩＤをa1レジスタが 指標していなければならないというファンクション$11の仕様から、演奏データの 格納アドレスa1に7を足している。詳しくはファンクション$11の解説を参照。 １４．１．５． 効果音データの作成とその活用方法 ゲームのＢＧＭに重ねて効果音を鳴らす場合はその演奏データのトラックと チャンネルのアサイン関係をしっかり把握していなければならない。演奏データの プログラマと効果音データのプログラマが異なる場合には、データ仕様を事前に 打ち合わせをしておくことをお勧めする。 ●効果音データの制約 効果音データも基本的にはＢＧＭデータと同じようにＺＭＳファイルを コンパイルしたＺＭＤで表現される。しかし、ＢＧＭデータとの大きな違いは １．共通コマンドを持てない ２．効果音用の演奏トラックワークには初期値がない ３．以下のＭＭＬコマンドを使用した時の動作が保証されない ・［］系コマンド([DO]〜[LOOP]は使用可) ・ 和音コマンド 効果音の演奏制御は、高速応答を要求されるのでパラメータの有効範囲チェック等は いっさい行っていない。不当なパラメータで関連ファンクションをコールした場合は 暴走する危険性がある。また、２．にもある通りワークの初期化も行わないため ディチューンやボリューム等の基本パラメータの初期値も不定である。よって必ず 設定すること。 また、効果音にＭＭＬのテンポコマンドを用いることは禁止していないが、 その効果音が鳴るたびにＢＧＭのテンポが変化してしまうため使用しない方がよい。 効果音データの実例をリスト６に示す。音色データはすでに述べたように事前に 登録してあるものとする。これをコンパイルして得たＺＭＤをダンプデータに 変換したものがリスト７である。ＺＭＤにはヘッダ'ZmuSiC'などが付くが、これは まったく不要であるため取ってしまう(残しておいても構わないがメモリのムダに なるので)。そしてリスト７の10バイト以降をアセンブラのソース・プログラム形式に 変換してやるとリスト８のようなものになる。 リスト９のように複数トラックの効果音データも作成可能である。これを コンパイルし同様に変換してやるとリスト１０のようになる。 ●効果音の演奏における２つの形式 効果音を鳴らす場合には２通りの形式が存在する。 １つは効果音が鳴るチャンネルをあらかじめ空けておく形式である。つまり効果音が 鳴るチャンネルをあらかじめ決めておいてＢＧＭデータを作成するわけである。 たとえばＦＭ音源の１チャンネルから７チャンネルまでをＢＧＭ専用チャンネルとし、 ８チャンネル目を効果音チャンネルと割り当てる、といった場合である。 ２つ目はＢＧＭを演奏しているチャンネルに割り込んで効果音を演奏する形式である。 たとえばＦＭ音源の１から８チャンネルすべてのチャンネルでＢＧＭを演奏し、 そのうち８チャンネルが効果音に切り換わったりする、といった場合である。この場合、 効果音が頻繁に演奏されると８チャンネル目はほとんど効果音しか鳴らなくなり ＢＧＭの一声が欠けて聞こえることになる。よってＢＧＭの設計をする際に、 効果音が被ってくるチャンネルにはメロディやベース等の重要なパートを割り当て ないようにすべきである。 ●１番目の形式 リスト１１は効果音のマネージメント・プログラムの一例である（リスト１１中の サンプル効果音は、それぞれリスト８、リスト１０とまったく同じもの)。 se_play1を見てほしい。 トラック１から６までをＦＭ音源１チャンネルから６チャンネルに割り当てて これをＢＧＭで使用し、ＦＭ音源７〜８チャンネルを効果音として使用する場合を 考える。たとえばd0.lに効果音番号0をいれてse_play1を呼ぶと、トラック７番から ＦＭ音源第７チャンネルでse0のデータが演奏される。se_play1中の moveq.l #7,d2 というのは、何番トラックで効果音を演奏するかを設定している。いま、 トラック１〜６まででＢＧＭを演奏しているのでトラック７は未使用である。よって 何にもジャマされずごく普通に演奏がなされる。 なぜこの例で効果音se0がＦＭ音源第７チャンネルで演奏されるかというと、それは se0の効果音データに演奏絶対チャンネル番号が６(0〜7のうちの6)というのが 埋め込まれているからである(囲み参照)。 同様の条件で、se1を鳴らす場合も同様である。se1は複数トラックによって 構成された効果音データである。 moveq.l #7,d2 とあるためトラック７から演奏するのである。まず、se1の第１トラックはd2.lで 指定した通りトラック７で演奏される。次にse1の第２トラックはd2.lで指定した トラック番号＋１のトラック８で演奏される。 このように複数トラックで構成された効果音は、d2.lで指定したトラック番号から 順番にトラックが割り当てられ演奏される。 ●２番目の形式 では今度はトラック１〜８がＦＭ音源１〜８チャンネルにアサインされＢＧＭが 演奏されていたとして、これに効果音を鳴らす場合を考える。こちらは前節で解説した ２番目の形式である。 se_play1は結論からいえばこのままこの形式に対応できる。単一トラックのse0も 複数トラック構成のse1にも対応できる。正しく効果音が鳴っている間は、その チャンネルはＢＧＭ演奏を中断し、効果音を演奏し、演奏が終了すると何事も なかったようにそのチャンネルのＢＧＭ演奏を再開する。 では moveq.l #7,d2 を moveq.l #1,d2 にしてse0を鳴らしたとしたらどうなるであろうか。つまりse0がＢＧＭの トラック１から割り込むという場合である。 たしかにＢＧＭのトラック１（ＦＭ音源第１チャンネル）の演奏が中断されるが、 効果音se0はＦＭ音源第７チャンネルで演奏されることになっているので、その チャンネルで効果音を演奏しようとすると、ＢＧＭ側のＦＭ音源第７チャンネルに アサインされたトラック７がＦＭ音源第７チャンネルをアクセスしてくる。言い換えると 複数の違った演奏データを同時にたった１個のＦＭ音源チャンネルで演奏しようする 状況が起こるわけである。そこで効果音、ＢＧＭ、ともに演奏が異常状態に陥る。 se1は２本のトラックで構成された効果音であるがこの２本目のトラックが ＦＭ１チャンネルに割当てられていたとする。つまりse1の上から５段目が$00,$07で なくて$00,$00となっている場合である。これを moveq.l #7,d2 で７トラックから割り込ませるとする。 さて実行されるとＢＧＭのトラック７に、ＦＭ音源第７チャンネルにアサインされた se1の第１トラックが割り込んでくる。以後ＦＭ第７チャンネルは効果音を演奏する。 ＦＭ音源第７チャンネルにアサインされたＢＧＭ側のトラックは効果音に占領されて いるトラック７しかないので、どのトラックからも効果音演奏を妨害されず うまくいく。 そしてつぎにＢＧＭ側のトラック８に、ＦＭ音源第１チャンネルにアサインされた se1の第２トラックが割り込んでくる。ＢＧＭ側のトラック８はそれまでＦＭ音源 第８チャンネルで演奏していたＢＧＭを中断しＦＭ音源第１チャンネルで効果音を 演奏し始める。しかしその後、ＢＧＭ側のトラック１がＦＭ音源第１チャンネルを アクセスしてくるのでおかしなことになってくる。 つまりse1の第１トラックは正常に演奏されるが、第２トラックは正常に演奏されない のである。 つまりこの「効果音トラックがＢＧＭ演奏に割り込む」形式ではひとつ大前提が あるのである。これから演奏する効果音のチャンネルが、割り込むトラックに アサインされているチャンネルと同一でなければならないのである。 この部分はたいへん重要である。 以上の話を図式化したものを図１に示す。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ 絶対チャンネル ┃ ┃ ┃ ┃ ┃ ┃ 内部表現の絶対チャンネルはベースチャンネルに無関係に操作対象デバイスを┃ ┃ ┃ ┃決定するものです。 ┃ ┃ ┃ ┃絶対チャンネル０〜７がＦＭ音源の１〜８、絶対チャンネル８がＡＤＰＣＭ１、┃ ┃ ┃ ┃絶対チャンネル９〜２４がＭＩＤＩ１〜１６。そしてＰＣＭ８独立チャンネル ┃ ┃ ┃ ┃モード時には絶対チャンネル２５〜３１がＡＤＰＣＭ２〜８に対応します。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ●その他の応用 効果音データはその演奏絶対チャンネルを持っていた。だから同じ効果音を違った チャンネルで鳴らすためには、その絶対チャンネルの違ったデータを別に持たなければ ならないのであろうか。それでも構わないが、メモリを浪費するので、効果音データの その絶対チャンネルが書かれている部分を書き替えてひとつの効果音データを流用した 方が賢明である。 リスト１１のse_play2はその一例である。パラメータは効果音番号と演奏チャンネル の２つ。効果音データのアドレスを得たあと、そのアドレス＋7に演奏させたい 絶対チャンネルを書き込んでいる。効果音が複数トラックで構成されている場合は、 例えばse1ならば(効果音データのアドレス＋7)の他に(効果音データのアドレス＋13) にも絶対チャンネルを設定しなければならない。 se_play2では割り込むトラックはその絶対チャンネル＋1の値にしている。これは ＢＧＭのトラック１〜８がＦＭ音源の第１チャンネルから第８チャンネル (絶対チャンネルにして０〜７)にアサインされていることを前提としている。 se_play3はse_play2を少し改良したものである。これは効果音をＦＭ音源 第７チャンネルと第８チャンネルを交互に用いて鳴らす処理を付けてみたものである。 こちらもＢＧＭのトラック１〜８がＦＭ音源の第１チャンネルから第８チャンネル (絶対チャンネルにして０〜７)にアサインされていることを前提としている。 こういった、状況に応じて効果音データを書き替えるような処理を工夫すると、 様々な効果を実現可能である。３Ｄのゲームならば効果音データのパンポットを、 その３次元座標に合せて書き替えて、疑似立体音響を実現させることも可能だろう。 ●ＭＩＤＩ対応曲にＦＭの効果音 今まではＦＭ音源のＢＧＭにＦＭ音源の効果音を割り込ませる話だったがＭＩＤＩ 対応の曲にＦＭ音源の効果音を割り込ませるにはどうしたらよいのかを解説する。 ＢＧＭをＭＩＤＩで、効果音はＦＭ音源で、という場合は各音源の目的が既に 区別されているので、効果音の使用チャンネルがＢＧＭの使用チャンネルと かち合わないため、前述の形式１のように実現できる。たとえばトラック1〜16 までをＭＩＤＩでＢＧＭに使用している場合なら、効果音は未使用トラックである トラック17以降に割り込ませれば（割り込んではいないが）よいことになる。 この方式は分かりやすく管理もしやすい。 では、ＦＭ音源＋ＭＩＤＩ楽器でＢＧＭを、そしてＦＭ音源で効果音を、という 場合はどうであろうか。複雑そうだがこれは結局ＦＭ音源のみのＢＧＭにＦＭ音源の 効果音を割り込ませた方法がほとんどそのまま使える。 たとえばＦＭ音源の第１チャンネルから第６チャンネルにアサインした トラック１〜６、そしてＭＩＤＩにアサインしたトラック7〜12でＢＧＭを 演奏していたとする。つまりＦＭ音源第７，８チャンネルは未使用という時に、 この空いている２つのチャンネルを使って効果音を鳴らす場合を考える。これは チャンネルがまったくかち合わないことから未使用トラックで効果音を鳴らせば よいので前述の形式１がそのまま適用できる。よって効果音はトラック13以降へ 割り込ませてやれば（割り込んではいないが）よいことになる。 最後にＦＭ音源第１チャンネルから第８チャンネルまでをトラック１〜８に アサインし、ＭＩＤＩをトラック9〜16にアサインし、これでＢＧＭ演奏して、 これにＦＭ音源の効果音を割り込ませる場合を考える。ＦＭ音源の効果音はＭＩＤＩに 対して何の影響も与えないことからトラック9〜16を除外して考えていいわけで あるから、そうなると話はまったく前述の形式２と同じになってくる。つまり、 効果音をＦＭ音源第８チャンネルで演奏するならトラック８に割り込ませればいい ことになる。 ●ＭＩＤＩの効果音 ＭＩＤＩで効果音を鳴らす場合にはもっと話が単純化する。ただＭＩＤＩチャンネル というものは単一チャンネルでもＦＭ音源チャンネルでいう複数分として動作するから、 一つのＭＩＤＩチャンネルに対して複数のトラックをアサインするケースが頻繁に 出てくる。というわけで前述の形式１，２とも大した区別はなくなるわけである。 しかし、管理の容易さから形式１を奨励する。つまり効果音専用の ＭＩＤＩチャンネルを取っておいてこのチャンネルを用いて効果音を鳴らすようにする わけである。 ●ＡＤＰＣＭ音の効果音 ＡＤＰＣＭはＰＣＭ８．Ｘモードでない時は単音であるため形式２のみ有効である。 ＦＭ音源とＡＤＰＣＭが連続するようなチャンネルアサイン構造にしておいて、 ＦＭ音源とＡＤＰＣＭ音源を両方使った効果音というのも演奏できる。 また、複雑なものでないワン・ショットのＡＤＰＣＭの効果音の演奏ならば専用の ファンクション・コール(ファンクション$13とファンクション$14)が設けてあるので、 それらを用いた方が高速応答が実現できる。 リスト１２にその一例を示す。 まず、リスト中のADPCM_se_play1を見てほしい。これは任意のアドレスに格納されて いるＡＤＰＣＭデータをファンクションコール$13を使って、ＢＧＭに割り込ませて 鳴らすためのサブルーチンである。ＢＧＭ側でＡＤＰＣＭをドラム等で使用している 場合はそれを一時停止して効果音を演奏する。効果音が鳴り終ると自動的にＢＧＭの 演奏にもどる。 ADPCM_se_play1ではアドレスに配置されたＡＤＰＣＭデータに便宜的に番号をつけ、 呼び出す時にはd0.lにその番号を代入して呼び出すようになっている。その後ろにある adr_frq_tblは各効果音ＡＤＰＣＭデータのサイズ、優先レベル(囲み参照)、 データの開始アドレスの管理テーブルである。 ADPCM_se_play2はＺＭＵＳＩＣにすでにＺＰＤデータ等によって登録済みの ＡＤＰＣＭ音を効果音で鳴らすためのサブルーチンである。ファンクションコール$14 をそのまま使っただけの単純なものである。d0.lに指定する効果音番号は ＡＤＰＣＭコンフィギュレーションで設定したノートナンバーに相当する。例えば コンフィギュレーションで 12＝bomb.pcm のように書き、これをＺＰＤとしてＺＭＵＳＩＣに登録してあれば、このbomb.pcmを 効果音で鳴らすには、d0.lに12を入れればよい。 後ろについているfrq_pan_tblというテーブルはADPCM_se_play1のadr_frq_tblから データサイズとデータアドレスを取り去ったような書式をしている。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ＡＤＰＣＭ効果音の優先レベル ┃ ┃ ┃ ┃ ┃ ┃ Ｘ６８ｋのＡＤＰＣＭは(ＰＣＭ８独立チャンネルモード時を除いては)単声 ┃ ┃ ┃ ┃です。ですから、効果音の発音要求は基本的に後着優先、つまり新しく発音要求 ┃ ┃ ┃ ┃されたものが発音されることになっています。しかし、ゲームなどで面と面との ┃ ┃ ┃ ┃繋ぎのイベントの音声メッセージなど、どうしても爆発音などでかき消されたく ┃ ┃ ┃ ┃ない場合があります。そこでＺＭＵＳＩＣでは非ＰＣＭ８モードでは効果音を ┃ ┃ ┃ ┃発音させる時に優先レベルというものを設定可能になっています。優先レベルは ┃ ┃ ┃ ┃０〜２５５まで設定可能ですが実用上は０，１程度で十分でしょう。 ┃ ┃ ┃ ┃ 以下に優先レベルの例を示します。 ┃ ┃ ┃ ┃ ┃ ┃ ┌─────────┬──────────┬───────┐ ┃ ┃ │発音中の優先レベル│発音要求の優先レベル│ 結果 │ ┃ ┃ ├─────────┼──────────┼───────┤ ┃ ┃ │ 0 │ 0 │ 発音要求採択 │ ┃ ┃ │ 0 │ 1 │ 発音要求採択 │ ┃ ┃ │ 1 │ 0 │ 発音要求却下 │ ┃ ┃ │ 1 │ 1 │ 発音要求採択 │ ┃ ┃ └─────────┴──────────┴───────┘ ┃ ┃ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ １４．２． 映像との同期 ＺＭＵＳＩＣには映像と音楽演奏を同期させるためのファンクションコールや 機能が装備されている。ここではこの機能について解説を行う。 １４．２．１． ファンクションコール$43を用いる ファンクション$43で映像同期モードをオンにしてから演奏を開始すると、 演奏開始からある時点までの絶対音長の合計値が演奏トラックワーク p_total(.l) $3C に格納されていく。これをユーザープログラム側で監視すれば、曲に合わせて画面等を 切り換えることが出来る（例えばオーケストラヒットが鳴るたびに絵を換えるなど）。 ちなみにワークp_totalの増加には以下の規則がある。 １．p_total()はＭＭＬの[do]命令で初期化される。また、この時点までの p_totalの値を p_total_olp $C6 へ退避する。 ２．p_totalは同期モードオンを行った時にのみ初期化される。'm_init()'命令、 (Ｉ)命令、ファンクション$00などでは初期化されない。 ３．p_totalは同期モードオンを行った時から値に意味を持ち始める。 具体的な使用プロセスは以下のようになる。 １．ファンクション$43で同期モードをオンにする。 ２．曲の演奏を開始する。 ３．演奏トラックワークp_totalを参照し(MEASURE13参照)、狙った タイミングになるまで待つ。 ４．狙ったタイミングになったならその仕事をする。 ５．やりたいことが全て終わったらファンクション$43で同期モードをオフにする。 演奏データのトラック１が４小節演奏されたら(合計ステップタイムにして192×4＝768) 次の処理をするようなサンプルを以下に示す。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃Z_MUSIC macro func *ドライバへのファンクションコール・マクロ ┃ ┃ moveq.l func,d1 ┃ ┃ trap #3 ┃ ┃ endm ┃ ┃ ┃ ┃ moveq.l #1,d2 *トラック番号＝1 ┃ ┃ Z_MUSIC #$3c *a0＝トラック１の演奏トラックワークの ┃ ┃ *先頭アドレス ┃ ┃wait_lp: *４小節演奏するまでループ ┃ ┃ cmpi.l #768,p_total(a0) ┃ ┃ bcs wait_lp ┃ ┃ *次の処理へ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ １４．２．２． ユーザー開放ワークを使用する 演奏トラックワークの p_user(.b) $ff は、ユーザーが自由に使用してよいワークとされている。これに対してＭＭＬの ワーク直接書き替えコマンド ？a,d a:ワークオフセット(0〜255) d:データ(0〜255) を用いて書き込みを行い監視プログラムとの通信を行い、映像の同期を行うことが できる。このp_userは'm_init()'命令、(Ｉ)命令、ファンクション$00などでは初期化 されず、値は不安定となるので、演奏データの冒頭でこれを初期化する必要がある。 具体的な使用プロセスは １．演奏データは曲の先頭で ?$ff,0 (書き込む値は0でなくてもよい) を実行してp_userを初期化する。 ２．ユーザープログラム側でp_userを監視し、希望の値が書き込まれるまで待つ。 ３．演奏データは(目的のタイミングで) ?$ff,1 (書き込む値は1でなくてもよい) を実行し、監視プログラム側につぎの指示を促す。 以下に演奏データのトラック１が、p_userに０以外の値を書き込むまで待ち、 書き込みを確認後、次の処理へ移る、というようなサンプルを示す。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃(i) ┃ ┃(m1,1000)(a1,1) ┃ ┃(t1)@1 o4 q8 v15 L4 ?$ff,0 cdef gabpcm8 A>zmusic -o -p200 -t100 '-Ｏ'の後ろに数値を書くと８声あるＡＤＰＣＭチャンネルのうち何チャンネルを 音楽演奏に割り当てるかを設定できる。余ったチャンネルは、効果音専用に扱われる。 組み込み例 A>pcm8 A>zmusic -o6 -p200 -t100 (２チャンネル(8-6=2)効果音用に使用する) ●独立チャンネルモード 　ＰＣＭ８を組み込み、そのあと通常通りにＺＭＵＳＩＣを組み込む。 これでＰＣＭ８が管理する疑似的な８つのＡＤＰＣＭチャンネルを個別に 使えるモードになる。 　ハード的な制約によりパンポット(音場)は各チャンネル独立には機能しないが、 音量やキーオン／キーオフ、周波数(５段階)は完全に独立にコントロールできる。 組み込み例 A>pcm8 A>zmusic -p200 -t100 １５．２． 独立チャンネルモード ●チャンネルアサイン 　ＡＤＰＣＭを指すチャンネル番号を異なったトラックにアサインすることによって それぞれのトラックが順番にＡＤＰＣＭ１チャンネル，ＡＤＰＣＭ２チャンネル，…， ＡＤＰＣＭ８チャンネルのように割り当てられていく。 　ＭＵＳＩＣＺ．ＦＮＣでは、例えばトラック９〜１６をＡＤＰＣＭ１〜８チャンネル に割り当てたい場合は m_ch("FM")の時 for i＝9 to 16:m_alloc(i,1000):m_assign(9,i):next m_ch("MIDI")の時 for i＝9 to 16:m_alloc(i,1000):m_assign(25,i):next あるいは'm_assign2()'を用いて for i＝9 to 16:m_alloc(i,1000):m_assign2("ADPCM"＋str$(i−8),i):next の様にする。 　ＺＭＳ書式では m_ch("FM")の時 (m9,1000) (a9,9) (m10,1000)(a9,10) (m11,1000)(a9,11) (m12,1000)(a9,12) (m13,1000)(a9,13) (m14,1000)(a9,14) (m15,1000)(a9,15) (m16,1000)(a9,16) m_ch("MIDI")の時 (m9,1000) (a25,9) (m10,1000)(a25,10) (m11,1000)(a25,11) (m12,1000)(a25,12) (m13,1000)(a25,13) (m14,1000)(a25,14) (m15,1000)(a25,15) (m16,1000)(a25,16) または (m9,1000) (a ADPCM1,9) (m10,1000)(a ADPCM2,10) (m11,1000)(a ADPCM3,11) (m12,1000)(a ADPCM4,12) (m13,1000)(a ADPCM5,13) (m14,1000)(a ADPCM6,14) (m15,1000)(a ADPCM7,15) (m16,1000)(a ADPCM8,16) のように行う。 ●ＰＣＭ８独立チャンネルモードで使用解禁となるＭＭＬ 　従来ＡＤＰＣＭトラックで使用可能のＭＭＬはすべて使用可能である。 ＰＣＭ８独立チャンネルモードでは従来ではＡＤＰＣＭトラックでは使用が 禁止されていたＶ，＠Ｖのボリュームコマンドが使用可能になる。ボリュームは 0〜16が有効範囲で原音量は9。＠Ｖ使用時は1〜16へ換算される。 ●機能拡張されるＭＭＬ 　独立チャンネルモードでは周波数設定コマンドである＠Ｆ命令は各トラック独立に 機能するようになる。 　また、ＰＣＭ８が扱うことのできる新データ方式「１６ビットＰＣＭデータ」 「８ビットＰＣＭデータ」(囲み参照)を扱うことができるようになる。 ＠Ｆ5　 １６ビットＰＣＭデータ方式 ＠Ｆ6　 　８ビットＰＣＭデータ方式 １５．３． 注意 　ＺＭＵＳＩＣの音楽演奏も割り込み処理、またＰＣＭ８の発音処理も 割り込み処理である。よって１０ＭＨｚのＸ６８ｋだとお互いの割り込み処理が フル回転（？）したときには音楽のテンポに影響が出る場合がある。 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃　　　　　　　　　 　８，１６ビットＰＣＭデータ方式とは？ ┃ ┃ ┃ ┃ ┃ ┃　Ｘ６８ｋの扱うＡＤＰＣＭデータとはいわばサンプリングしてできた ┃ ┃ ┃ ┃ＰＣＭデータが一種のアルゴリズムで圧縮されていると考えられます。 ┃ ┃ ┃ ┃音量の変更や周波数変換、合成処理を行うにはこのＡＤＰＣＭデータ方式から ┃ ┃ ┃ ┃ＰＣＭデータ方式へ変換しなければなりません。ＰＣＭ８ではこの変換処理を ┃ ┃ ┃ ┃割り込みでリアルタイムで行っていますが、もしこの処理を省けるならば ┃ ┃ ┃ ┃かなり割り込み処理を軽くすることが出来るはずです。そこでＰＣＭ８では ┃ ┃ ┃ ┃無圧縮のＰＣＭデータを演奏出来るようになっています。 ┃ ┃ ┃ ┃　１６ビットＰＣＭデータ方式は符号付き１６ビット整数により表現された ┃ ┃ ┃ ┃データです(−32768〜32767)。同一音長のＡＤＰＣＭデータの４倍のデータ長に ┃ ┃ ┃ ┃なります。ちょうどＺＶＴ．Ｘで'−Ｃ'スイッチにより生成されるＰＣＭデータと ┃ ┃ ┃ ┃同じものです。１つのデータが２バイト構成であることから必ずデータ長は偶数で ┃ ┃ ┃ ┃なければ正常に鳴りません。 ┃ ┃ ┃ ┃　８ビットＰＣＭデータは方式は同様に符号付き８ビット整数により表現された ┃ ┃ ┃ ┃データです(−128〜127)。同一音長のＡＤＰＣＭデータの２倍のデータ長に ┃ ┃ ┃ ┃なります。 ┃ ┃ ┃ ┃　８ビットＰＣＭデータ／１６ビットＰＣＭデータともに特別な設定もなしに ┃ ┃ ┃ ┃ＺＰＣＮＶでＺＰＤデータを作成出来ます。もちろんＡＤＰＣＭデータと混在させて┃ ┃ ┃ ┃ＺＰＤデータにすることも出来ます。 ┃ ┃ ┃ ┃　再生周波数はどちらとも１５．６ｋＨｚ固定ですがＡＤＰＣＭ方式との混在が ┃ ┃ ┃ ┃可能でＡＤＰＣＭデータ側はこの時も５段階の周波数が使用可能です。 ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ { -- ZM16.MAN ------------------------------------------------ ＭＥＡＳＵＲＥ１６ 付録 ＺＭＵＳＩＣ用のＣ言語ライブラリに ついて解説します。 １６．１．ＺＭＵＳＩＣ用Ｃ言語ライブラリの構成 　ＺＭＵＳＩＣ用のＣ言語ライブラリは以下の３つのファイルで構成されている。 ZMUSIC.L Ｃ言語用ライブラリ(ソースリストファイル名はZMLIB.HAS) ZMUSIC.H Ｃ言語用インクルードファイル ZMUSIC.DEF ＢＣ．Ｘ用ＤＥＦファイル ZMLIB.HASからZMUSIC.Lを生成するには A>HAS ZMLIB A>LIB /U ZMUSIC.L ZMLIB.O とする(HASはフリーソフトのハイスピードアセンブラ、LIBはＣコンパイラPRO68kに 付属のライブラリアン)。 １６．２．ＺＭＵＳＩＣ．Ｈの利用法 自分のシステムの、インクルード・ファイルが格納してあるディレクトリに ZMUSIC.Hをコピーする。 例 A>COPY ZMUSIC.H A:\INCLUDE ZMUSIC.XをＣ言語のプログラムから使いたい場合は、そのプログラムの冒頭に #INCLUDE の１行をつける。 なお、ZMUSIC.Hに含まれる関数の名前はMUSICZ.FNCとまったく同じである。 各関数の詳しい仕様はZMUSIC.H本体、またはMEASURE3のMUSICZ.FNCの項を参照のこと。 　基本的にＸ−ＢＡＳＩＣ用外部関数であるMUSICZ.FNCにコンパチに作られているが、 一部の言語仕様の違いから互換でない関数もある。Ｘ−ＢＡＳＩＣでは配列の 要素数を関数側で自動認知することができるがＣ言語ではそれができない。そのため、 MUSICZ.FNCではパラメータの個数等を省略できた関数がZMUSIC.Hでは省略できない、 といった仕様変更のなされた関数がある(以下３つ)。 m_dirout() m_exc() m_roland() またさらに、Ｘ−ＢＡＳＩＣではパラメータ個数を書かなくてもよかった関数も Ｃ言語では書かせるような仕様に変更されたものがある(以下１１個)。 sc55_reverb() sc55_chorus() sc55_part_setup() sc55_drum_setup() mt32_reverb() mt32_part_setup() mt32_drum_setup() mt32_common() mt32_patch() mt32_partial() u220_drum_inst() MUSICZ.FNCにはなかったコマンドが新設されている。 m_wave_form2() 波形メモリ登録コマンド#2 (short int専用版/配列データ加工なし) ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ZMUSIC.L関数一覧 ┃ ┃ ┃ ┃int m_alloc( int track_no, int buffer_size ); ┃ ┃ ┃ ┃int m_assign( int channel_no, int track_no ); ┃ ┃ ┃ ┃int m_vget( int tone_no, char *data_ptr ); ┃ ┃ ┃ ┃int m_vset( int tone_no, char *data_ptr ); ┃ ┃ ┃ ┃int m_tempo( int tempo ); /* tempo=-1でリクエスト */ ┃ ┃ ┃ ┃int m_trk( int track_no, char *MML_ptr ); ┃ ┃ ┃ ┃int m_free( int track_no ); ┃ ┃ ┃ ┃int m_play( int track_no1, int track_no2, int track_no3, int track_no4, ┃ ┃ int track_no5, int track_no6, int track_no7, int track_no8, ┃ ┃ int track_no9, int track_no10 ); ┃ ┃ /* track_no1=0 で全トラック演奏開始 */ ┃ ┃ /* track_no?=0 または 'NASI' 以降を無視する。 */ ┃ ┃ ┃ ┃int m_stat( int track_bit_pattern ); ┃ ┃ /* track_bit_pattern=0 で全チャンネル検査 */ ┃ ┃ ┃ ┃int m_stop( int track_no1, int track_no2, int track_no3, int track_no4, ┃ ┃ int track_no5, int track_no6, int track_no7, int track_no8, ┃ ┃ int track_no9, int track_no10 ); ┃ ┃ /* track_no1=0 で全トラック演奏停止 */ ┃ ┃ /* track_no?=0 または 'NASI' 以降を無視する。 */ ┃ ┃ ┃ ┃int m_cont( int track_no1, int track_no2, int track_no3, int track_no4, ┃ ┃ int track_no5, int track_no6, int track_no7, int track_no8, ┃ ┃ int track_no9, int track_no10 ); ┃ ┃ /* track_no1=0 で全トラック演奏継続 */ ┃ ┃ /* track_no?=0 または 'NASI' 以降を無視する。 */ ┃ ┃ ┃ ┃void m_init( void ); ┃ ┃ ┃ ┃int m_atoi( int track_no ); ┃ ┃ ┃ ┃int m_assign2( char *channel, int track_no ); ┃ ┃ ┃ ┃void m_ch( char *device ); ┃ ┃ ┃ ┃int m_pcmset( int note_no, char *filename, ┃ ┃ int pitch, int vol, int mix_note_no, int delay, ┃ ┃ int cut, int reverse, int fade_in_out ); ┃ ┃ /* int pitch以降のパラメータを省略する場合は 'NASI' とすること */ ┃ ┃ ┃ ┃void m_pcmplay( int note_no, int pan, int freq ); ┃ ┃ ┃ ┃void m_rec( void ); ┃ ┃ ┃ ┃void m_rstop( void ); ┃ ┃ ┃ ┃int m_save( char *filename ); ┃ ┃ ┃ ┃int m_trans( char *filename ); ┃ ┃ ┃ ┃int m_fmvset( int tone_no, char *data_ptr ); ┃ ┃ ┃ ┃int m_out( int d1, int d2, int d3, int d4, int d5, ┃ ┃ int d6, int d7, int d8, int d9, int d10 ); ┃ ┃ /* d?=-1 以降を無視する。 */ ┃ ┃ ┃ ┃int m_dirout( char *adrs, int size ); ┃ ┃ /* sizeの省略不可 */ ┃ ┃ ┃ ┃int m_exc( char *adrs, int size ); ┃ ┃ /* sizeの省略不可 */ ┃ ┃ ┃ ┃int m_roland( int devID, int modelID, char *adrs, int size ); ┃ ┃ /* sizeの省略不可 */ ┃ ┃ ┃ ┃int m_total( void ); ┃ ┃ ┃ ┃int m_fadeout( int speed ); ┃ ┃ ┃ ┃int m_pcmcnf( char *filename ); ┃ ┃ ┃ ┃int sc55_v_reserve( char *adrs, int devID ); ┃ ┃ /* size=16 */ ┃ ┃ ┃ ┃int sc55_reverb( char *adrs, int devID, int size ); ┃ ┃ /* size=7 */ ┃ ┃ ┃ ┃int sc55_chorus( char *adrs, int devID, int size ); ┃ ┃ /* size=8 */ ┃ ┃ ┃ ┃int sc55_part_setup( char part_no, char *adrs, int devID, int size ); ┃ ┃ /* size=119 */ ┃ ┃ ┃ ┃int sc55_drum_setup( char map_no, char note_no, ┃ ┃ char *adrs, int devID, int size ); ┃ ┃ /* size=8 */ ┃ ┃ ┃ ┃int sc55_print( char *message, int devID ); ┃ ┃ /* size=32 */ ┃ ┃ ┃ ┃int sc55_display( int *pattern, int devID ); ┃ ┃ ┃ ┃int m_adpcm_block( char *filename ); ┃ ┃ ┃ ┃int mt32_p_reserve( char *adrs, int devID ); ┃ ┃ /* size=9 */ ┃ ┃ ┃ ┃int mt32_reverb( char *adrs, int devID, int size ); ┃ ┃ /* size=3 */ ┃ ┃ ┃ ┃int mt32_part_setup( char *adrs, int devID, int size ); ┃ ┃ /* size=9 */ ┃ ┃ ┃ ┃int mt32_drum_setup( char note_no, char *adrs, int devID, int size ); ┃ ┃ /* size=4 */ ┃ ┃ ┃ ┃int mt32_common( char timbre_no, char *timbre_name, ┃ ┃ char *adrs, int devID, int size ); ┃ ┃ /* size=4 */ ┃ ┃ ┃ ┃int mt32_patch( char patch_no, char *adrs, int devID, int size ); ┃ ┃ /* size=7 */ ┃ ┃ ┃ ┃int mt32_partial( char timbre_no, char partial_no, ┃ ┃ char *adrs, int devID, int size ); ┃ ┃ /* size=58 */ ┃ ┃ ┃ ┃int mt32_print( char *message, int devID ); ┃ ┃ /* size=20 */ ┃ ┃ ┃ ┃int m_print( char *message ); ┃ ┃ /* size=96 */ ┃ ┃ ┃ ┃int u220_setup( char *adrs, int devID ); ┃ ┃ /* size=7 */ ┃ ┃ ┃ ┃int u220_common( char *adrs, int devID ); ┃ ┃ /* size=17 */ ┃ ┃ ┃ ┃int u220_drum_setup( char *adrs, int devID ); ┃ ┃ /* size=7 */ ┃ ┃ ┃ ┃int u220_part_setup( char part_no, char *adrs, int devID ); ┃ ┃ /* size=13 */ ┃ ┃ ┃ ┃int u220_timbre( char timbre_no, char *timbre_name, ┃ ┃ char *adrs, int devID ); ┃ ┃ /* size=26 */ ┃ ┃ ┃ ┃int u220_drum_inst( char note_no, char *adrs, int devID, int size ); ┃ ┃ /* size=20 */ ┃ ┃ ┃ ┃int u220_print( char *message, int devID ); ┃ ┃ /* size=12 */ ┃ ┃ ┃ ┃int m1_midi_ch( char *midi_ch_list ); ┃ ┃ /* size=8 */ ┃ ┃ ┃ ┃int m1_part_setup( char *track_param ); ┃ ┃ /* size=40 */ ┃ ┃ ┃ ┃int m1_effect_setup( char *effect_param ); ┃ ┃ /* size=25 */ ┃ ┃ ┃ ┃int m1_print( char *message ); ┃ ┃ /* size=10 */ ┃ ┃ ┃ ┃int send_to_m1( int devID ); ┃ ┃ ┃ ┃int zmd_play( char *filename ); ┃ ┃ ┃ ┃void m_debug( char mode ); ┃ ┃ ┃ ┃int m_count( char count ); ┃ ┃ ┃ ┃int fm_master( char volume ); ┃ ┃ ┃ ┃int m_mute( int ch_no1, int ch_no2, int ch_no3, int ch_no4, ┃ ┃ int ch_no5, int ch_no6, int ch_no7, int ch_no8, ┃ ┃ int ch_no9, int ch_no10 ); ┃ ┃ /* ch_no1=0 で全トラック演奏継続 */ ┃ ┃ /* ch_no?=0 または 'NASI' 以降を無視する。 */ ┃ ┃ ┃ ┃int m_solo( int ch_no1, int ch_no2, int ch_no3, int ch_no4, ┃ ┃ int ch_no5, int ch_no6, int ch_no7, int ch_no8, ┃ ┃ int ch_no9, int ch_no10 ); ┃ ┃ /* ch_no1=0 で全トラック演奏継続 */ ┃ ┃ /* ch_no?=0 または 'NASI' 以降を無視する。 */ ┃ ┃ ┃ ┃int m_wave_form( char wave_no, char loop_type, int loop_point, ┃ ┃ int *wave_data, int size ); ┃ ┃ ┃ ┃int m_wave_form2( char wave_no, char loop_type, int loop_point, ┃ ┃ short int *wave_data, int size ); ┃ ┃ ┃ ┃int sc55_init( int devID ); ┃ ┃ ┃ ┃int mt32_init( int devID ); ┃ ┃ ┃ ┃void adpcm_to_pcm( char *source, int size, int *destination ); ┃ ┃ /* destinationの配列サイズはsourceの４倍必要 ┃ ┃ また、sizeはADPCMデータの個数 */ ┃ ┃ ┃ ┃void pcm_to_adpcm( int *source, int size, char *destination ); ┃ ┃ /* destinationの配列サイズはsourceの1/4倍必要 ┃ ┃ また、sizeはPCMデータの個数 */ ┃ ┃ ┃ ┃void exec_zms( char *zms_line ); ┃ ┃ ┃ ┃int m_inp( char inp_mode ); /* inp_mode≠0でループモード */ ┃ ┃ ┃ ┃int zm_ver( void ); ┃ ┃ ┃ ┃int m_trk2( char *MML_ptr, ┃ ┃ int track_no1, int track_no2, int track_no3 ,int track_no4, ┃ ┃ int track_no5, int track_no6, int track_no7 ,int track_no8 ); ┃ ┃ /* track_no?=0 または 'NASI' 以降を無視する。 */ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ １６．３．ＺＭＵＳＩＣ．ＤＥＦの利用法 ZMUSICを利用したX-BASICのプログラムをコンパイルする時に使用する。 まず、自分のシステムの、BC.X(X-BASICをＣ言語へコンバートするプログラム、 Ｃ言語PRO68Kに付属)が格納してあるディレクトリにZMUSIC.DEFをコピーする。 例 A>COPY ZMUSIC.DEF A:\BC そのディレクトリ内のBASIC.CNFというファイルを開き FUNC=ZMUSIC の１行を加えてセーブする。BASIC.CNF中に FUNC=MUSIC FUNC=MUSIC2 FUNC=MUSIC3 などが記述してある場合は、それらをすべて削除する(同名の関数が存在しているため 誤動作する可能性がある)。 １６．４．ＺＭＵＳＩＣ．Ｌの利用法 コンパイルする時にライブラリファイルとして利用するには、まず自分のシステムの ライブラリファイルが格納してあるディレクトリにZMUSIC.Lをコピーする。 例 A>COPY ZMUSIC.L A:\LIB コンパイルしてできるオブジェクトにZMUSIC.Lをリンクし実行ファイルを得るには、 例 ZMUSIC.Xを使用したX-BASICのプログラムをコンパイルする場合 A>CC ????.BAS ZMUSIC.L 例 ZMUSIC.Xを使用したＣ言語のプログラムをコンパイルする場合 A>CC ????.C ZMUSIC.L のようにする。 { -- ZM_END.MAN ------------------------------------------------ 　マニュアル、およびＺＭＵＳＩＣシステムに関するお問い合わせは、 MIYA-NET(048-648-9801,24H,6回線) MIYA0212 ＴＥＤ氏まで (MIYA-NETはゲストユーザーでも アップロード/ダウンロードできます。 最新のZMUSIC、曲データ、支援ツールなど がダウンロードできますので、 ぜひ一度遊びにきてみて下さい。 ログイン後、トップメニューで ;D;5 と打ち込むと「ZMUSIC-SIG」に入ることが できます。) または、 〒１０８　東京都港区高輪２−１９−１３ 　ＮＳ高輪ビル　３Ｆ Oh!X編集部｢ZMUSICに不明点あり!?｣係 まで、お寄せください。 { -- 用語解説.MAN ------------------------------------------------ Ａ 　ＡＤＰＣＭ(ADDAPTIVE DIFFERENTIAL PULSE CODED MODULATION) Ｘ６８ｋの内臓音源の一つで、自然音をそのままデジタルレコーディングし、 これを再生することができる。ＺＭＵＳＩＣではひとつの楽器音源として コントロールが可能。 　アフタータッチ(AFTER-TOUCH) 　アフタータッチシーケンス(AFTER-TOUCH SEQUENCE) 鍵盤を押す強さを発音後変化させること。ＭＩＤＩ楽器によっては、音色の ニュアンスの変化を変えたり、ビブラートやトレモロなどの効果を与えたり することができる。ＺＭＵＳＩＣでは発音後、音長の１／８単位で アフタータッチ処理することができる。これをＺＭＵＳＩＣでは アフタータッチシーケンスと呼ぶ。ＺＭＵＳＩＣではＦＭ音源に対しての アフタータッチもサポートしているが、この場合は音量の変化のみを 制御することができる。(MML:@Z) 　アルゴリズム(ALGORITHM) ＦＭ音源は４つのオペレータ（発信器）で構成されているが、 この各オペレータをどのように接続するかを決定するもの。Ｘ６８ｋに 内蔵されているＦＭ音源チップＯＰＭは８つの「アルゴリズム」が プリセットされており、音色作成時にはこの８つから選ぶことになる。 　アンプリチュード・モジュレーション(AMPLITUDE MODULATION) 音量を周期的に変化させる音の表情付けの技法。トレモロともいわれる。 ＺＭＵＳＩＣでは、４つのプリセット波形や、ユーザーが作成した波形に そって変化させたり、発音後、音長の１／８ごとに掛かり具合を変化させたり することができる。ＺＭＵＳＩＣではこの機能はＦＭ音源専用と なっているが、ＭＩＤＩ楽器ではＡＲＣＣをこの機能に使うことで 実現が可能。 (MML:@A) 　ＡＲＣＣ(ASSIGNABLE REALTIME CONTROL CHANGE) ＺＭＵＳＩＣにおけるＭＩＤＩ楽器専用の特殊機能の一つ。 各トラックごとに、コントロールするコントロールチェンジを選択し、 これを音長の１／８ごとや設定した波形などに沿ってこれを コントロールするもの。(MML:@A) 　アルペジオ(ARPPEGGIO) 分散和音。和音を構成する一音一音を少しずつ時間をずらして演奏するもの。 ＺＭＵＳＩＣでは和音コマンドやダンパー・コマンドで表現が可能。 　オート・ベンド(AUTO BEND) 　オート・ピッチ・ベンド(AUTO PITCH BEND) ＺＭＵＳＩＣの特殊機能の一つで、発音後、任意の高さまで音程をなめらかに 変化させることができる機能。(MML:@B) Ｂ 　ベンド(BEND)→ピッチ・ベンド(PITCH BEND) Ｃ 　キャリア(CARRIER) ＦＭ音源のオペレータの名称で、おもにエンベロープ／音量が決定する 働きがある。 チャンネル・プレッシャー(CHANNEL PRESSURE) ＭＩＤＩチャンネル単位のアフタータッチ。 →アフタータッチ チェック・サム(CHECK SUM) ローランド・エクスクルーシブの最後尾につく、データを正確に受信できたか どうかを確かめるために用いられる７ビットデータのこと。 コーラス(CHORUS) エフェクタの一種で微妙に音程の違った音を重ねて音を厚くする。 ローランドＧＳ音源では、このエフェクトがプリセットされている。 クロック(CLOCK) 絶対音長のこと。ＺＭＵＳＩＣはデフォルトでは４分音符＝２４クロックで 処理されている。 コントロール・チェンジ(CONTROL CHANGE) ＭＩＤＩ楽器には特殊な機能を手軽にコントロールするために定められた レジスタ群があり、これをコントロール・チェンジという。(MML:Y,@C) Ｄ ディレイ(DELAY) ピッチモジュレーションをはじめとした、音にたいして特殊な効果を 与える際に、その効果が開始されるまでの遅延時間を決定するパラメータ。 デプス(DEPTH)→振幅 ディチューン(DETUNE) 音程を微調整するパラメータ。本来の音階から決定される周波数とは違った 音程で演奏させて、コーラス効果を得たりする目的でよく用いられる。 (MML:@K,@B) 　デバイスＩＤ(DEVICE ID) ＭＩＤＩ楽器に対してユーザーが設定した識別番号。 ダブル・フラット(DOUBLE FLAT) 一度(２半音)下げる変化記号(MML:--) ダブルシャープ(DOUBLE SHARP) 一度(２半音)上げる変化記号(MML:++) 　ダンパー(DUMPER) ダンパー・ペダル(DUMPER PEDAL) ＭＩＤＩメッセージのひとつ。ダンパー・オンにすると、以後、発音した音は ノート・オフの情報を無視し、発音をダンパー・オフとするまで鳴り続ける。 ダンパーはＭＩＤＩチャンネルごとに指定可能。ＺＭＵＳＩＣではＦＭ音源や ＡＤＰＣＭにおいても使用可能。(MML:@D) Ｅ 　エフェクト(EFFECT) 　エフェクタ(EFFECTOR) 音に特殊な味付けをすること。この装置をエフェクタという。 ＭＩＤＩ楽器には音源の他にエフェクターを持った物が多くある。 ＺＭＵＳＩＣではＧＳ音源とローランドＭＴ３２／ＣＭ系のエフェクタを 手軽に操作する命令が備わっている。(MML:@E) 　エンベロープ(ENVELOPE) 音量の時間的変化のこと。 エクスクルーシブ・メッセージ(EXCLUSIVE MESSAGE) ＭＩＤＩ楽器のメモリーを直接書き換えることのできるＭＩＤＩコントロール コマンドのこと。(MML:@X,X) エクスプレッション(EXPRESSION) そのＭＩＤＩチャンネルの出力音量の割合を決定するコントロールチェンジ 機能の一つ(コントロール番号??)。コントロールチェンジ７番のボリューム とは別管理のため、最終的には ボリューム(0〜127)×エクスプレッション(0〜127) でそのＭＩＤＩチャンネルの出力音量が決定される。 Ｆ 　フラット(FLAT) 半音下げる変化記号。(MML:-) フェード・イン(FADE IN) 通常音量まで音量を徐々に上げていくこと。(MML:\) フェード・アウト(FADE OUT) 無音状態へむかって音量を徐々に下げていくこと。(MML:\) Ｇ ゲートタイム(GATE TIME) １つの音符が実際に発音している時間。 　逆転再生→リバース ＧＭ(GENERAL MIDI) ＭＩＤＩ規格が承認した、統一音色配列規格。ヤマハＴＧ１００、 ローランドＳＣ５５シリーズなどがこの規格の代表的機種。 ＧＳ ローランドが提唱したＭＩＤＩ楽器の統一音色配列規格。ＳＣ５５や ＣＭ３００、ＪＶ３０などがこの規格の代表的機種。 Ｈ 波形(WAVE TYPE) ＺＭＵＳＩＣではピッチ・モジュレーション、アンプリチュード・ モジュレーション、拡張ＡＲＣＣに対して鋸歯状波、矩形波、三角波、 鋸歯波シングル、ユーザーメイドの波形で制御が可能である。(MML:S) 　波形メモリ(WAVE MEMORY) ユーザーが各ポイントの任意の値を設定していき、非線形の波形をつくる事が できる。この機能を波形メモリといい、ＺＭＵＳＩＣではピッチ・ モジュレーション、アンプリチュード・モジュレーション、拡張ＡＲＣＣを この機能でコントロールする事ができる。(ZMS:wave_form, MUSICZ.FNC:m_wave_form) 波長 波形の一周期の長さ。ＺＭＵＳＩＣではモジュレーション波形である プリセット波形の波長を変更可能である。(MML:@S) ホールド(HOLD)→ダンパー(DUMPER) Ｉ インストルメント(INSTRUMENT) 楽器のこと。 　 Ｊ Ｋ 拡張ピッチモジュレーション() 拡張ＡＲＣＣ() ＭＩＤＩトラックに対して有効な機能。ＦＭ音源トラックのように ４つのプリセット波形とユーザー波形を用いたピッチモジュレーションや ＡＲＣＣが可能になる機能。(MML:M) 　キーオン(KEY ON)→NOTE ON 　キーオフ(KEY OFF)→NOTE OFF キートランスポーズ(KEY TRANSPOSE) 音程を規定のものからずらすこと。同じような意味の言葉に 「ディチューン(DETUNE)」がある。 Ｌ Ｍ メーカーＩＤ(MAKER ID) ＭＩＤＩ楽器メーカーの識別番号。 ＭＩＤＩ(MUSICAL INSTRUMENT DIGITAL INTERFACE) デジタル楽器の世界規格。メーカーや機種が違っていても、ＭＩＤＩ対応 ならば同じコマンドメッセージで楽器をコントロールする事ができる。 　モデルＩＤ(MODEL ID) ＭＩＤＩ楽器に対してメーカーが設定した楽器の識別番号。 モノ(MONO) 一つのＭＩＤＩチャンネルで一度に一音しか発音できないモード。 トランペットなどのブラス系の音はこのモードにすると現実的。 モジュレータ(MODULATOR) ＦＭ音源のオペレータの名称で入力された波形を変調し音素を作り出す 働きがある。 モジュール(MODULE)→音源モジュール マルチ・ティンバー(MULTI TIMBRE) 一台の音源で一度に複数の楽器を演奏することが出来る機能のこと。 Ｎ ＮＲＰＮ(NON REGISTERED PARAMETER NUMBER) ＭＩＤＩ規格では定義されていないそのＭＩＤＩ楽器特有の機能パラメータ。 ノートオン(NOTE ON) 発音すること。 ノートオフ(NOTE OFF) 以前発音した音を消音すること。 Ｏ オクターブ(OCTAVE) ある音階から８度離れていることをいう。(MML:O) オムニ(OMNI) その設定された受信チャンネルとは無関係にすべてのチャンネル情報を 認識するモードのこと。 音源モジュール 鍵盤のない音源のみで構成されたＭＩＤＩ楽器のこと。コンピュータや シーケンサ、他のシンセサイザからＭＩＤＩによってコントロールする ことによってのみ演奏を行うことが出来る。 音量→ボリューム(VOLUME) 　音量モジュレーション→アンプリチュードモジュレーション(AMPLITUDE MODULATION) 音程モジュレーション→ピッチモジュレーション(PITCH MODULATION) 　ＯＰＭ Ｘ６８０００に内蔵されているヤマハ製のＦＭ音源チップ。４オペレータ で構成され最大発音数８音。 Ｐ パンポット(PANPOT) 発音する位置を設定するパラメータ。ＦＭ音源やＡＤＰＣＭ音源では １，２，３が左、中央、右に対応する。ＭＩＤＩではコントロールチェンジの １０番がパンポットの機能に相当する。パラメータの範囲は０〜１２７までで ０が最も左、６４が中央、１２７が最も右に対応する。(MML:P,@P) パーシャル(PARTIAL) ローランドのシンセサイザ音源における音色を構成する発信源の名称。 一つの音色が複数のパーシャルで構成されていることもある。 パーシャル・リザーブ(PARTIAL RESERVE) ローランドのマルチティンバー音源において、１パート内で保証される パーシャル数を決定すること。一時的に音源に対して同時発音数を上回る 発音要求があったとしてもパーシャル・リザーブがしてあればその数の パーシャルは確実にそのパートの発音のために保証される。 　ピッチ・モジュレーション(PITCH MODULATION) 音程を周期的に変化させる音の表情付けの技法。ビブラートともいわれる。 ＺＭＵＳＩＣでは、４つのプリセット波形や、ユーザーが作成した波形に そって変化させたり、発音後、音長の１／８ごとに掛かり具合を変化させたり することができる。 (MML:@M) ピッチ・ベンド(PITCH BEND) 音程をなめらかに変化させること。ＺＭＵＳＩＣではパラメータを 与えることでオートマチックにこの処理を行うことができる。(MML:@B) ポリ(POLY) 一つのＭＩＤＩチャンネルで一度に複数の音を発音できるモード。 ポリフォニック・プレッシャー(POLYPHONIC PRESSURE) 鍵盤単位で制御可能なアフタータッチ。 →アフタータッチ ポルタメント(PORTAMENTO) 音程をなめらかに変化させること。(MML:(〜)) プログラム・チェンジ(PROGRAM CHANGE) 音色切り替えのこと。 Ｑ クオンタイズ リアルタイムレコーディングされた演奏情報をある規則にしたがって 整理すること。 Ｒ リバース(REVERSE) ＡＤＰＣＭデータをデータ末尾から先頭へ向かって再生すること ＺＭＵＳＩＣではＡＤＰＣＭコンフィギュレーションでこの指定が可能。 リバーブ(REVERB) ソースの音に対して残響効果を与えて出力するエフェクターの一種。 あたかもコンサートホールで演奏しているような効果を演出することが できる。 ＲＰＮ(REGISTERED PARAMETER NUMBER) ＭＩＤＩ規格で定義されたＭＩＤＩ楽器の拡張機能パラメータ。 ピッチベンドの幅のような楽器の機種によらない一般的なパラメータが 設定されている。 Ｓ 　シャープ(SHARP) 半音上げる変化記号。(MML:#) 振幅 ピッチモジュレーションなど、波形を用いて音に効果を与えるコマンドに おいて、その効果の掛かり具合を決定するパラメータ。(MML:@M,@A) ステップタイム(STEP TIME) 一つの音符が演奏される時間。(MML:L,@L) ソステヌート(SOSTENUTO) 速さを押え気味に、音を一様に持続して演奏する奏法。 Ｔ ティンバー(TIMBRE) 楽器(音色)のこと。 タイマー(TIMER) ＺＭＵＳＩＣが音楽のテンポを管理するために使っているもの。Ｘ６８ｋの ＯＰＭにはタイマーＡとタイマーＢが存在し、ＺＭＵＳＩＣではどちらか 一方のタイマーを用いてテンポを制御可能になっている。タイマーＢより タイマーＡの方がテンポ決定の計算の際の誤差が少ない。(MML:T,@T) 　トレモロ(TREMORO)→アンプリチュード・モジュレーション(AMPLITUDE MODULATION) Ｕ 　ユーザー波形→波形メモリ Ｙ Ｖ ビブラート(VIBRATO)→ピッチ・モジュレーション(PITCH MODULATION) Ｗ 　ウェイト(WAIT) 処理が終わるまで待ち時間をもうけること。ＭＩＤＩ楽器では ＥＯＸ($F7)受信後、受信内容の処理のために多少のウェイトを必要とする。 ＭＭＬのＸコマンドでエクスクルーシブ・メッセージを送信する場合は、 このウェイト期間を考慮して、命令後に休符などのウェイトを設定した方が よい。 Ｘ Ｙ Ｙコマンド 音源のレジスタを直接書き換えるＭＭＬ命令のこと。ＺＭＵＳＩＣでは ＭＩＤＩに対してのＹコマンドはコントロールチェンジとして扱われる。 Ｚ 　絶対音長(ABSOLUTE LENGTH) ＺＭＵＳＩＣが処理する音長カウンタのこと。デフォルトでは４分音符は 絶対音長＝４８となっている。(MML:L,@L)