Single Note Tuning

■概要

この機能は、各ノートについて周波数単位でチューニングを設定します。。
周波数データはプログラム用のメモリに格納され、 Registered Parameter No.3 & 4のTuning Preset & Bankを設定する事で、各チャンネルに適用可能です。


■書式

リアルタイム・メッセージ (Rail Time Message)

RT_NoteTuning(INT iProgramNo, INT szTuning, Array iTuning(szTuning×4));
RT_NoteTuning_Bank(INT iBank, INT iProgramNo, INT szTuning, Array iTuning(szTuning×4));
[備考]
※この命令は、コンパイラ内部で以下のMMLに変換されます。
SysEx = $F0, MakerID_RealTime,idDevice, RT_Tuning, RT_Tuning_SingleNoteTuningChange, iProgramNo, szTuning, iTuning(szTuning×4)[szTuning×4Byte], $F7
SysEx = $F0, MakerID_RealTime,idDevice, RT_Tuning, RT_Tuning_SingleNoteTuningChange_Bank, iBank, iProgramNo, szTuning, iTuning(szTuning×4)[szTuning×4Byte], $F7

ノン・リアルタイム・メッセージ (Rail Time Message)

NRT_NoteTuning(INT iProgramNo, INT szTuning, Array iTuning(szTuning×4));
NRT_NoteTuning_Bank(INT iBank, INT iProgramNo, INT szTuning, Array iTuning(szTuning×4));
[備考]
※この命令は、コンパイラ内部で以下のMMLに変換されます。
SysEx = $F0, MakerID_RealTime,idDevice, NRT_Tuning, NRT_Tuning_SingleNoteTuningChange, iProgramNo, szTuning, iTuning(szTuning×4)[szTuning×4Byte], $F7
SysEx = $F0, MakerID_RealTime,idDevice, NRT_Tuning, NRT_Tuning_SingleNoteTuningChange_Bank, iBank, iProgramNo, szTuning, iTuning(szTuning×4)[szTuning×4Byte], $F7

■引数

引数名 初期値 範囲 機能
INT iProgramNo - 0 〜 127 チューニングを設定するプログラムNo.を設定します。
INT iBank - 0 〜 127 チューニングを設定するバンクNo.を設定します。
INT szTuning - 1 〜 127 チューニングを設定するノートの数を指定します。
ARRAY iTuning(szTuning×4)
4Byteで1setです。
説明の為、先頭からkk,xx,yy,zzとします。		 kk : -
xx : $7F
yy : $7F
zz : $7F		 kk : 0〜127
xx : 0〜127
yy : 0〜127
zz : 0〜127		 各ノートのチューニング量を指定します。
１ノート当り4Byteの配列変数となり、szTuningで指定した量だけ必要となります。
kk : チューニングを設定したいノート番号
xx, yy, zz : ノートの周波数データ(3Byte1組)
INT idDevice $7F $00 〜 $7F MIDIデバイスのDeviceIDを指定します。
MIDI規格では、Bloadcastである$7Fを推奨しています。


■返り値

無し


■説明

各プログラムについて、ノートレベルでチューニングを周波数レベルで行います。
MIDIデバイスの各チャンネルに適用させる為には、Registered Parameter(RPN)を使用します。
RPN : MSB=$00, LSB=$03 … Preset No
RPN : MSB=$00, LSB=$04 … Bank No

■使用例

List.1 

RT_NoteTuning(1,1,NoteNo("o5c"),$3C,$00,$00);	//Preset 1番のo5cを、平均律の周波数にする。
RPN(0,3,1);				//Tuning Presetの1番を選択する。
TR(1)	o4 l4 cdefgabc


■関連項目