mml2vgmIDEについて

 mml2vgmIDEはmml2vgmの統合環境アプリケーションです。
 エディターやコンパイラー、プレイヤーを
 ひとまとめに、簡単、お手軽に使用できるようにしたものです。

 mml2vgmIDEはmucom88 Windowsやmuap98をお手本に作られています。
 また、テキストエディターのエンジンにazukiを使用しております。
 どれもすばらしいプログラムです。
 ご興味を持たれましたら是非使用してみることをお勧めします。
 そのほかにもmml2vgmは様々なプログラムを利用したり色々な方のご協力をいただいております。
 本当にありがとうございます。


[特徴]
 ・ちょっとだけvisualstudioのような、見た目と操作感。
 ・muap98を連想させる演奏トレース機能。
 ・スクリプトによる柔軟な(?)拡張性。
 ・GIMICとSCCIによる実チップ演奏に対応。
 ・mucomDotNETを使用しmucからmubファイルを作成することが可能。
 ・M98DotNETを使用しmucを乱数変化させることが可能。


[クイックスタート]
  １.mml2vgmIDE.exeをダブルクリックしプログラムを起動する。
  ２.メニューからファイルを選び、新規作成を選ぶ。
  ３.新規ファイルがエディタに表示されたらF5キーを押す。
  ４.ドレミファソラシドが演奏される。
  以上。


[操作全般]
  インストール
    ・インストールは不要です。
    ・圧縮ファイル(bin.zip)を展開したら作成されているmml2vgmIDEフォルダーを開きます。

  事前準備(必須ではありません)
    ・OPNA向けリズム音のファイルをmml2vgmIDE.exeと同じフォルダーにコピーしておきます。
    ・スクリプトファイルはScriptフォルダーにコピーしておきます。
      Git,SoXを利用するスクリプトを同梱しています。
      無くても動作しますが、便利なので予めインストールすることをお勧めします。
      Git : バージョン管理ツール
      SoX : 音声ファイル加工ツール
            SoXは一部のPCMの周波数変換処理が必要な場合も使用します。
    ・各種音色ファイルをinstrumentsフォルダーにコピーしておきます。
      支援機能はこのフォルダーからFM音源などで使用される音色ファイルを参照します。
      使用できる音色ファイルは
        .gwi      (mml2vgmのファイル形式)
        .muc      (mucom88のファイル形式)
        .rym2612  (RYM2612のファイル形式)
      です。

  起動
    ・mml2vgmIDE.exeをダブルクリックしプログラムを起動します。
    ・起動時に前回最後に開いた/保存したファイルをひとつ開きます。

  終了
    ・メインウィンドウの×ボタンを押すか、メニューからファイル>終了の順に選択します。

  アンインストール
    ・展開したときにできたフォルダーを消します。
    ・設定も消してしまいたい場合は以下のフォルダーも削除します。

        (システムのドライブ名):\Users\(使用しているユーザー名)\AppData\Roaming\KumaApp\mml2vgmIDE

        ＊システムのドライブ名は通常はCドライブです。(特殊な環境では異なる場合があります)
        ＊使用しているユーザー名は通常はWindowsにログインするときの名前です。(特殊な環境では異なる場合があります)

  ファイル
    mml2vgmIDEはmmlを記述するテキストファイルとして.gwiファイルを扱います。
    .gwiファイルはUTF8、CRLF、BOM有り形式の.NETアプリケーションでは一般的なテキストファイルです。
    その他、主にPCM系の音声データの元ファイルとして.wavファイルを使用します。
    .wavファイルは様々な形式を取ることが可能で、構成が単純、Windowsでは標準的な音声ファイルです。


[画面]
  メイン
    メニューバーを備えたmml2vgmIDEのメインとなるウィンドウになります。
    各種画面をドッキング・分離することが可能です。

  エディタ
    azukiによるテキストエディタウィンドウです。
    ここにMMLソースを記述します。

    操作
      [F1] key
        ファイルを開きます。
      [F2] key
        編集中のMMLをファイルとして保存します。
      [F3] key
        指定した文字列を検索します。
      [F4] key
        事前コンパイル(TBD)
          再生前に予めコンパイルをさせておく場合に使用します。
          (演奏が即実行されるようにするため。)
      [F5] key
        編集中のMMLをコンパイルして演奏します。
        事前コンパイル済みの場合はコンパイル無しで演奏します。
        [Shift] + スキップ演奏 : 
          キャレットのある場所から演奏を開始します。
          位置が特定できない場合は通常の演奏になります。
          またJコマンドがキャレット位置より後にある場合はそちらが有効になります。
        [Ctrl] +  トレース演奏 :
          トレース表示を有効にし演奏を開始します。
          トレース中はテキストを編集することはできません。
        [Alt] +   Jumpソロ演奏(.mucのみ) :
          基本、スキップ演奏と同じ機能ですが、キャレット位置又はJコマンド位置のパートをソロに切り替えます。
          この切り替えは、通常のソロ操作と同じように次の演奏でも持ち越します。
      [F6] key(.mucのみ)
        編集中のMMLに対してM98DotNETを使用し自動作曲を行います。
        (結果は別タブに出力します)
      [F9] key
        演奏を停止します。
      [Shift]+[F9] key
        演奏をフェードアウトします。
      [F10] key
        スロー演奏します。
      [F11] key
        ４倍速演奏します。
      [F12] key
        MDPlayerが起動している場合は演奏データを送り再生を指示します。
      [HOME] key
        パート情報が入力された行で押下すると、データの開始位置に移動します。
        既に開始位置にある場合は行頭に移動します。
      [Shift]+[Enter] key
        押した行のパート情報を追加した行に挿入します。
      [Ctrl]+[PgUp]/[PgDn] key
        行頭の//をタグとして順番に移動します。
      [Ctrl]+[w] key
        編集中のタブを閉じます。
      [Ctrl]+[Shift]+[w] key
        編集中のタブを強制的に閉じます。
      [Ctrl]+[tab] key
        次のタブに移動します。
      [Ctrl]+[Shift]+[tab] key
        前のタブに移動します。
      [Ctrl]+[/] key
        コメント行にしたり、有効行に切り替えます
      [Ctrl]+[1]～[-] key
        ChannelのSOLOを指定します。
      [Ctrl]+[\] key
        SOLOを解除します。
      [Alt]+[\] key
        MUTEを解除します。
      [Ctrl]+[F] key
        検索ダイアログを表示します。
      [Ctrl]+[R] key
        置換ダイアログを表示します。
      [Ctrl]+[S] key
        上書き保存します。

  フォルダー
    編集中のソースが存在する位置のフォルダーをツリー形式で表示するウィンドウです。
    (mml2vgmはソースがある場所を基準として他のファイルを参照する動作が多いため。)
    いくつかの決まった拡張子を持つファイルはダブルクリックすることで既定の動作を行います
      gwi  新たなソースウィンドウに内容を表示します。
      wav  プレビューできます。(今のところ最後まで再生します。止める操作がありませんので長い音声の場合は注意。)
    ファイルを右クリックすることにより削除(操作ミス注意)やスクリプト実行などの操作ができます

  ログ
    コンパイル時などのメッセージをログとして表示するウィンドウです。

  エラーリスト
    コンパイル時に発生した警告とエラーをリスト表示するウィンドウです。
    選択するとそのエラーが発生した行に移動します。(可能な場合のみ)

  パートカウンター
    パートごとの情報を表示するウィンドウです。
    列に対して幅の調整、順番の入れ替え、表示や非表示を設定可能です。
    ソロ演奏やミュートの設定も可能です。
    .mucの場合
    「KBD」をクリックするとAssignと表示されMIDIキーボードによる演奏が可能になります。

  歌詞
    歌詞情報をもつソースを演奏した場合にそれを表示するウィンドウです。
    ウィンドウの縦幅に合わせて文字の大きさが変わります。

  支援機能
    音色やスニペットを一覧から選択して入力できます。

  音源ミキサー
    音源chip毎の音量バランスを設定するためのウィンドウです。
    このウィンドウはドッキングできません。

  MIDIキーボード
    鍵盤を弾くことによってその音程がエディタに入力することが出来ます。
    初期状態ではプレビューモードになっているので、
    切り替えに割り当てられている鍵盤又はコントロールボタンを押し、入力モードに切り替えます。
    モードは左下のステータスバーに表示されます。
       [Prv] プレビューモード
       [Ins] 入力モード
  　アンドゥ、空白、改行(パート情報補完付き)の入力も可能です。
    割り当ては設定画面で変更が可能です。
    初期割り当ては
      　プレビューモード切り替え　鍵盤48 (o3c)
      　アンドゥ                　鍵盤50 (o3d)
      　空白                    　鍵盤52 (o3e)
      　改行                    　鍵盤53 (o3f)
    です。
    相対オクターブコマンドを逆転させることも可能です。

  デバッグ
    デバッグ向けの情報を表示するウィンドウです。
    通常は必要ありません。
    このウィンドウはドッキングできません。


