CCMapper(C#版)

2022/11/7
初版

概要

「openFrameworksでCCMapperを実装する」の続編として、CCMaperをC#(windows版)で実装した。
なお、記事として独立して読めるように前の記事の情報を含めた。

準備

1.以下のC#のMIDIライブラリをダウンロードして解凍する；

http://www.chrofieyue.net/nextmidi.zip

2.VisualStudio

visual studio setup guide

上の説明から以下のurlからダウンロード&インストールする：

https://www.visualstudio.com/thank-you-downloading-visual-studio/?sku=Community&rel=16

今回、使用するのはC#だが、通常(C++)のVisualStudioがインストール済みであれば、必要なときに自動的にC#のツールがインストールされる。

C#プロジェクト作成

VisualStudioを起動する：

1.新しいプロジェクトを作成する
(1)テンプレート選択
そのときのテンプレートは
「コンソールアプリ(.NET Framework)」を選択する。
#「(.NET Framework)」無しの「コンソールアプリ」もあるので
# 間違えて、それを選択しないように！

(2)プロジェクト名を入力する。
任意だが今回は「CCMapper_CS」にする。

(3)場所
デフォルトでかまわない。 C:\Users\＜ユーザー名＞\source\repos

(4)[ソリューションとプロジェクトを同じディレクトリに配置する(D)]にチェックを入れる。

(5)フレームワーク
フレームワークはデフォルトで構わない。
.NET Framewok 4.7.2

(6)[作成]をクリックする

2.プログラムを入力する
上の操作で、雛形のプログラムが出来ているので、それを利用して、新しくプログラムを入力する。
今回は次節にあるものを入力する。

3.参照を追加する
画面の右側のソリューション・エクスプローラーの画面の[参照]を右クリックして
[参照の追加]を選択してダウンロードして解凍した.dllを選択して取り込む。

ダウンロードして、その場で解凍した場合、以下のディレクトリに置いてある：
C:\Users\＜ユーザー名＞\Downloads\nextmidi\Package

3,ビルド
メニューから [ビルド/xxxをビルド]を選択してビルドする。

4.実行
右矢印アイコンをクリックして実行する
または
[デバッグ/デバッグなしで開始]で実行する

CCMapper(source code)

以下が今回のソースコードになる。

CCMapper_CS/Program.cs

// CCMapper_CS 2022/11/7
using System;
using NextMidi.DataElement;
using NextMidi.MidiPort.Output;
using NextMidi.MidiPort.Input.Core;
using NextMidi.MidiPort.Input;
using Avenue;
using NextMidi.MidiPort.Output.Core;

namespace CCMapper_CS
{
    public class Program
    {
        static void EnumInput()
        {
            int count = MidiInPortHandle.PortCount;
            for (int i = 0; i < count; i++)
            {
                Console.WriteLine(MidiInPortHandle.GetPortInformation(i).szPname);
            }
        }

        static void EnumOutput()
        {
            int count = MidiOutPortHandle.PortCount;
            for (int i = 0; i < count; i++)
            {
                Console.WriteLine(MidiOutPortHandle.GetPortInformation(i).szPname);
            }
        }

        static void Main(string[] args)
        {
            // disp MIDI device list
            Console.WriteLine("Input MIDI devices:");
            EnumInput();
            Console.WriteLine();
            Console.WriteLine("Output MIDI devices:");
            EnumOutput();
            Console.WriteLine();
            //-------------------------------------------

            // change device to fit your env.
            var inport = new MidiInPort("WIDI Bud Pro");
            var outport = new MidiOutPort("loopMIDI Port 1");

            void MidiReceived(object sender, DataEventArgs<MidiEvent> e)
            {
                byte[] data = e.Value.ToNativeEvent(); //MIDI data to byte[]

                // output MIDI log
                Console.Write("{0:d} {1:d} {2:d}\n", data[0], data[1], data[2]);

                if (data[0] == 144)
                {
                    outport.Send(new NoteOnEvent(data[1], data[2]));
                    return;
                }
                if (data[0] == 128)
                {
                    outport.Send(new NoteOffEvent(data[1]));
                    return;
                }
                if (data[0] == 176) // ControlChange
                {
                    if (data[1] == 7 || data[1] == 11) // volume, expression
                    {
                        // for Aria
                        outport.Send(new ControlEvent(ControlNumber.BreathControl, data[2]));
                        outport.Send(new ControlEvent(ControlNumber.Volume, data[2]));
                        outport.Send(new ControlEvent(26, data[2]));
                        return;
                    }
                    else if (data[1] == 1) // modulation
                    {
                        outport.Send(new ControlEvent(ControlNumber.Modulation, data[2]));
                        return;
                    }
                    else
                    {
                        outport.Send(new ControlEvent(data[1], data[2]));
                        return;
                    }
                }
            }

            // try input device
            try
            {
                inport.Open();
            }
            catch
            {
                Console.WriteLine("no such INPUT port exists");
                return;
            }

            // set event listener
            inport.Received += MidiReceived;

            // try outout device
            try
            {
                outport.Open();
            }
            catch
            {
                Console.WriteLine("no such OUTPUT port exists");
                return;
            }

            // wait for event
            while (true) { }

        }
    }
}

以下の部分は実行環境に依存しているので
自分の環境に合わせて変更すること：

            // change device to fit your env.
            var inport = new MidiInPort("WIDI Bud Pro");
            var outport = new MidiOutPort("loopMIDI Port 1");

ウィンド・コントローラの入力データをコンソール表示するようになっているので、煩雑であるならば、以下の部分をコメントアウトすること：

                // output MIDI log
                Console.Write("{0:d} {1:d} {2:d}\n", data[0], data[1], data[2]);

実行

VisualStudioから実行するとコンソール画面が現れて以下のような表示になる。

コンソール出力例

Input MIDI devices:
loopMIDI Port 1
WIDI Bud Pro

Output MIDI devices:
CoolSoft MIDIMapper
Microsoft GS Wavetable Synth
VirtualMIDISynth #1
loopMIDI Port 1
WIDI Bud Pro

上のように接続している入力MIDIデバイス、出力MIDIデバイスが表示される。

MIDI接続状況：
MIDIとしての接続は「re.corder/ElefueをCCMapper経由で外部音源(Aria/Windows)と接続する(WIDI_Bud_Pro使用)」と同じ接続にする。

問題点

ウィンド・コントローラを接続して吹いていると、ときどき、「ハンドルされていない例外: System.NullReferenceException: オブジェクト参照がオブジェクトインスタンスに設定されていません。」が出ることがある。
今のところ原因不明。

参考：テストプログラム

MIDIoutTest/Program.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using NextMidi.DataElement;
using NextMidi.MidiPort.Output;

namespace MIDIoutTest
{
    internal class Program
    {
        static void Main(string[] args)
        {
            /*
            // MIDI ポート名を指定して MIDI ポートを開く
            if (args.Length != 1)
            {
                Console.WriteLine("1 port name required");
                return;
            }
            var port = new MidiOutPort(args[0]);
            */
            var port = new MidiOutPort("loopMIDI Port 1");
            try
            {
                port.Open();
            }
            catch
            {
                Console.WriteLine("no such port exists");
                return;
            }

            // Program No.5 に切り替え
            port.Send(new ProgramEvent(4));

            // 500 ミリ秒待つ
            Thread.Sleep(500);

            // ドレミファソラシド
            foreach (byte n in new byte[8] { 60, 62, 64, 65, 67, 69, 71, 72 })
            {
                // ベロシティ 112 でノートオンを送信
                port.Send(new NoteOnEvent(n, 112));
                Thread.Sleep(n != 72 ? 500 : 1500);
                port.Send(new NoteOffEvent(n));
            }
        }
    }
}

CCMapper(C#版)

概要

準備

C#プロジェクト作成

CCMapper(source code)

実行

問題点

参考：テストプログラム

関連情報