DualMusik: DUMC/DUMCW

Yggdrasil Seeds : Software Works : DualMusik : DUMC/DUMCW
PV[990117]

DUMC/DUMCW

DMS形式のソースをDUM形式にコンパイルするものです。
CUIでの使用に適したDUMC.EXE(メッセージをコンソールに出力)と、GUIでの使用に適したDUMCW.EXE(メッセージをダイアログに出力)の2ヴァージョンを用意しました。

使い方

一番手っ取り早いのは、DUMCW.EXEのアイコンにDMSファイルのアイコン(複数可)をドロップすることです。この方法はDUMC.EXEでも不可能ではないですが、一度に指定できるファイル数に制限(確か15個ぐらい)があります。
ただし、この方法ではオプションが全てディフォルトとなります。オプションを変更する場合は、コンソールから起動する必要があります。

DOSプロンプトを起動し、

> DUMC ファイル名 [ファイル名] [...]

…という具合にコマンドを書いて実行させます。
例えば、SEQ.DMSをコンパイルしたい場合はこんな感じ。

DUMC SEQ.DMS

ファイルに半角スペースが含まれる場合や、先頭の文字が - である場合は、ファイル名を "" で括っておかないと誤動作します。(DOSでは、半角スペースをパラメータの区切りとして解釈する, - はオプション指定と誤認識するため)

DUMC "-SEQ 1.DMS"

オプションを指定する場合は、コマンド名やファイル名の区切りの部分に突っ込んでおくべし。もちろん、オプション部分も半角スペースで区切っておくこと。

DUMC /F&0001 SEQ.DMS
DUMC SEQ.DMS /F&0001

オプション

コマンドラインのパラメータで、/ か - を先頭に書くとオプションとして解釈します。
これにより、以下の機能が設定できます。
(% の部分には整数,$ の部分には文字列を書く
なお、整数はMMLでの表記と同じように2進数(. を前置),16進数(& を前置)での指定でも可)

/F%	スウィッチングフラグの初期設定(=268,% と同等)をします。詳細は \ コマンドを参照。
/S$	出力するファイル名のサフィックスを変更します。ディフォルトでは .DUM となっており、入力ファイル名の拡張子を DUM に変更したものが出力ファイル名となっています。これを変更することで、拡張子を変えたりベースファイル名に文字列を付加したりできます。

エラーメッセージ

正常に処理がなされればDUMを出力して無事終了しますが、不具合がある場合はエラーメッセージを出力して処理を中断します。
エラーメッセージの末尾に in 数字と出る場合は、ソースの記述に不具合があります。
末尾の数字は行番号ですが、必ずしもその位置が不具合とは限りませんので、参考程度に。

Checksum cannot calculate
$ コマンドで、チェックサムの計算ができない位置に ** を書いている。
Chord operation impossible
和音が配置できない位置にある。
Chord unclosed
和音指定の '' が閉じられていない。
CON\CON-Proof affected
ファイル名にシステムクラッシュを引き起こす畏れのある文字列が含まれている。
Deltatime too long
累積されたウェイトが長すぎる。
間にダミーコマンド( $1 など)を挟むことにより回避可能。
DWP-info too many
DWPファイル名の指定が複数ある。
Empty effective track
ディヴァイスに対して効果をもつトラックが一つもない。
File cannot read
ファイルから読み出せない。
File cannot write
ファイルに書き込めない。
File not found
ファイルが見つからない。
Illegal option
オプションの指定が間違っている。
Illegal parameter
パラメータの内容が間違っている。
Loop infinitly
無限ループに対して | コマンドが記述された。
Loop still open
ループが閉じられていない。
Loop too deep
ループのネスト数が限界を超えた。
Meta too long
; コマンドの文字列が長すぎる。
Missing parameter
パラメータの数が足りない。
Missing track
W コマンドで指定したトラックが存在しない。
Not have enough size
コマンドの途中でファイルの終端に達した。
Note too many on chord
和音中のノートが多すぎる。
Out of loop
ループ外で | ] コマンドが記述された。
Parameter too many
パラメータの数が多すぎる。
Portament unclosed
ポルタメント指定の () が閉じられていない。
Slur cannot continue
スラーの継続が不可能になるコマンドが記述された。
Slur operation impossible
スラーが配置できない位置にある。
Syntax error
コマンドの書式が間違っている。
SysEx too long
SysExが長すぎる。
System critical
"不正な処理を行ったため強制終了しました"と同等。
DUMCがタコか、Windowsがタコかのどっちか。
Undefined command
未定義のコマンドが記述された。
~~Zero length in loop~~(V0.20 rel.2 以降廃止)
~~ループ中にウェイトがない。~~

[表紙]