MIDIメッセージクラス [詳解]

#include <TnbMidi.h>

CMidiMessage の継承関係図

公開メンバ関数
bool	BankSelect (BYTE channel, BYTE msb, BYTE lsb)
	[設定] バンクセレクト. [詳解]

bool	ChorusSendLevel (BYTE channel, int level)
	[設定] コーラスセンドレベル. [詳解]

void	Close (void)
	[設定] クローズ. [詳解]

	CMidiMessage (void)
	コンストラクタ [詳解]

bool	ControlSendLevel (BYTE channel, BYTE controlNo, int level)
	[設定] コントロールセンドレベル. [詳解]

bool	Expression (BYTE channel, int volume)
	[設定] エクスプレッション. [詳解]

DWORD	GetLastError (void) const
	[取得] ラストエラーコード取得. [詳解]

bool	IsOpened (void) const
	[確認] オープン確認. [詳解]

bool	Modulation (BYTE channel, BYTE modulation)
	[設定] モジュレーション. [詳解]

bool	NoteOff (BYTE channel, BYTE note, BYTE velocity=0)
	[設定] ノートオフ. [詳解]

bool	NoteOn (BYTE channel, BYTE note, BYTE velocity=0)
	[設定] ノートオン. [詳解]

bool	Open (UINT dev=MIDI_MAPPER)
	[設定] オープン. [詳解]

bool	Panpot (BYTE channel, int pan)
	[設定] パンポット. [詳解]

bool	PitchBendChange (BYTE channel, int pitchBend=0)
	[設定] ピッチベンドチェンジ. [詳解]

bool	PitchBendSensitivity (BYTE channel, BYTE v)
	[設定] ピッチベンドセンシビティ. [詳解]

bool	ProgramChange (BYTE channel, BYTE programNumber)
	[設定] プログラムチェンジ. [詳解]

bool	ReverbSendLevel (BYTE channel, int level)
	[設定] リバーブセンドレベル. [詳解]

void	SetLastError (DWORD e)
	[設定] ラストエラーコード設定. [詳解]

bool	Volume (BYTE channel, int volume)
	[設定] ボリューム. [詳解]

	~CMidiMessage (void)
	デストラクタ [詳解]

静的公開メンバ関数
static UINT	GetDeviceCount (void)
	[取得] デバイス数取得. [詳解]

static CStr	GetErrorString (DWORD e)
	[取得] エラー文字列取得. [詳解]

詳解

MIDIメッセージクラス

必要ファイル: TnbMidi.h

日付: 10/05/25 新規作成

TnbMidi.h の 32 行目に定義があります。

構築子と解体子

◆ CMidiMessage()

CMidiMessage ( void )

コンストラクタ

TnbMidi.h の 37 行目に定義があります。

◆ ~CMidiMessage()

~CMidiMessage ( void )

デストラクタ

TnbMidi.h の 42 行目に定義があります。

関数詳解

◆ BankSelect()

bool BankSelect	(	BYTE	channel,
		BYTE	msb,
		BYTE	lsb
	)

[設定] バンクセレクト.

音色のバンクを切替えます。

覚え書き: 本メソッドだけでは音色は変わりません。本メソッド後 ProgramChange() を使用します。

引数

channel	チャネル 0〜15。
msb	MSB.
lsb	LSB.

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 106 行目に定義があります。

◆ ChorusSendLevel()

bool ChorusSendLevel	(	BYTE	channel,
		int	level
	)

[設定] コーラスセンドレベル.

コーラスレベルを指定する。

覚え書き: 音源によっては、機能しない。

引数

channel	チャネル 0〜15。
level	レベル。 0 が効果なし。 127 が効果最大。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 203 行目に定義があります。

◆ Close()

void Close ( void )

[設定] クローズ.

覚え書き: オープンしていない時は何もしません。

TnbMidi.h の 51 行目に定義があります。

◆ ControlSendLevel()

bool ControlSendLevel	(	BYTE	channel,
		BYTE	controlNo,
		int	level
	)

[設定] コントロールセンドレベル.

指定のコントロール番号のレベルを指定する。

覚え書き: 音源によっては、機能しない。

引数

channel	チャネル 0〜15。
controlNo	コントロール番号。例えばリバーブが 0x5B, コーラスなら 0x5D を指定する。
level	レベル。 0 が効果なし。 127 が効果最大。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 219 行目に定義があります。

◆ Expression()

bool Expression	(	BYTE	channel,
		int	volume
	)

[設定] エクスプレッション.

音量を調節する。

覚え書き: 発音中に変化させることが出来る。

引数

channel	チャネル 0〜15。
volume	音量。 0 が無音。 127 が最大。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 173 行目に定義があります。

◆ GetDeviceCount()

static UINT GetDeviceCount ( void )

static

[取得] デバイス数取得.

接続している MIDIのデバイス数を返します。

戻り値: デバイス数。

TnbMidi.h の 353 行目に定義があります。

◆ GetErrorString()

static CStr GetErrorString ( DWORD e )

static

[取得] エラー文字列取得.

引数

e エラーコード.

戻り値: 文字列。

TnbMidi.h の 363 行目に定義があります。

◆ GetLastError()

DWORD GetLastError ( void ) const

[取得] ラストエラーコード取得.

戻り値: エラーコード. GetErrorString() で文字列に変換することが可能です。

TnbMidi.h の 334 行目に定義があります。

◆ IsOpened()

bool IsOpened ( void ) const

[確認] オープン確認.

戻り値

true	オープン中。
false	クローズ中。

TnbMidi.h の 78 行目に定義があります。

◆ Modulation()

bool Modulation	(	BYTE	channel,
		BYTE	modulation
	)

[設定] モジュレーション.

音にビブラートを加える

引数

channel	チャネル 0〜15。
modulation	ビブラートの強さ。０がなし。127が最大。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 122 行目に定義があります。

◆ NoteOff()

bool NoteOff	(	BYTE	channel,
		BYTE	note,
		BYTE	velocity = `0`
	)

[設定] ノートオフ.

鍵盤を離す動作です。

引数

channel	チャネル 0〜15。
note	ノート番号 0〜127。音階。ピアノの中央のドが 60。
velocity	離す強さ 0〜127。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 250 行目に定義があります。

◆ NoteOn()

bool NoteOn	(	BYTE	channel,
		BYTE	note,
		BYTE	velocity = `0`
	)

[設定] ノートオン.

鍵盤を押す動作です。

引数

channel	チャネル 0〜15。
note	ノート番号 0〜127。音階。ピアノの中央のドが 60。
velocity	押す強さ 0〜127。値の目安 ppp=16, pp=32, p=48, mp=64, mf=80, f=96, ff=112, fff=127

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 235 行目に定義があります。

◆ Open()

bool Open ( UINT dev = MIDI_MAPPER )

[設定] オープン.

引数

dev	デバイス番号。 0〜 GetDeviceCount() - 1 の範囲が指定可能。省略するとデフォルトが選択されます。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 67 行目に定義があります。

◆ Panpot()

bool Panpot	(	BYTE	channel,
		int	pan
	)

[設定] パンポット.

音の出力先を左右に割り振ります。

引数

channel	チャネル 0〜15。
pan	0 が中央。左端が -63。右端が 63。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 151 行目に定義があります。

◆ PitchBendChange()

bool PitchBendChange	(	BYTE	channel,
		int	pitchBend = `0`
	)

[設定] ピッチベンドチェンジ.

鍵盤を離す動作です。

引数

channel	チャネル 0〜15。
pitchBend	ピッチベンド。 -8192 〜 8181 。0がセンター。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 264 行目に定義があります。

◆ PitchBendSensitivity()

bool PitchBendSensitivity	(	BYTE	channel,
		BYTE	v
	)

[設定] ピッチベンドセンシビティ.

ピッチベンドの範囲を設定します。

引数

channel	チャネル 0〜15。
v	範囲。 12 で１オクターブ。値の最大は 127 。しかし通常、最大値は 24。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 288 行目に定義があります。

◆ ProgramChange()

bool ProgramChange	(	BYTE	channel,
		BYTE	programNumber
	)

[設定] プログラムチェンジ.

音色を切替えます。

引数

channel	チャネル 0〜15。
programNumber	音色。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 91 行目に定義があります。

◆ ReverbSendLevel()

bool ReverbSendLevel	(	BYTE	channel,
		int	level
	)

[設定] リバーブセンドレベル.

音響レベルを指定する。

覚え書き: 音源によっては、機能しない。

引数

channel	チャネル 0〜15。
level	レベル。 0 が効果なし。 127 が効果最大。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 188 行目に定義があります。

◆ SetLastError()

void SetLastError ( DWORD e )

[設定] ラストエラーコード設定.

引数

e エラーコード.

TnbMidi.h の 343 行目に定義があります。

◆ Volume()

bool Volume	(	BYTE	channel,
		int	volume
	)

[設定] ボリューム.

音量を調節する。

覚え書き: 慣例で足るなチャンネルの音量制御用に使います。

引数

channel	チャネル 0〜15。
volume	音量。 0 が無音。 127 が最大。

戻り値

true	成功。
false	失敗。詳細は GetLastError() で得られます。

TnbMidi.h の 137 行目に定義があります。

公開メンバ関数

静的公開メンバ関数

詳解

構築子と解体子

◆ CMidiMessage()

◆ ~CMidiMessage()

関数詳解

◆ BankSelect()

◆ ChorusSendLevel()

◆ Close()

◆ ControlSendLevel()

◆ Expression()

◆ GetDeviceCount()

◆ GetErrorString()

◆ GetLastError()

◆ IsOpened()

◆ Modulation()

◆ NoteOff()

◆ NoteOn()

◆ Open()

◆ Panpot()

◆ PitchBendChange()

◆ PitchBendSensitivity()

◆ ProgramChange()

◆ ReverbSendLevel()

◆ SetLastError()

◆ Volume()