free piano[free piano]
Freepiano中所有的键盘配置都记录在一个文本的配置文件中，扩展名为.map。通过菜单对键盘配置的修改会直接反映在配置脚本中。您可以直接修改对应的配置文件，然后通过点击键盘布局菜单下的相应的文件重新加载它，也可以在 设定-选项-键盘脚本中修改后直接应用。
1. 配置文件格式
配置文件为文本文件，可以使用任何文本编辑器编辑。命令是以行为单位的，不区分大小写。在解析的过程中如果遇到错误， 只会忽略错误的行，文件的其余部分仍然可以被正常解析。
以#开头的行被视为注释，在载入时会被忽略。
键盘脚本中的配置内容是根据配置自动生成的配置文件，与源文件的顺序可能会不同。
2. 配置命令
GroupCount
格式：GroupCount 分组总数
说明：设置键盘分组的数量，这条命令应该出现在切换分组命令之前。
Group
格式：Group 分组ID
说明：切换当前配置分组，切换后下面的配置命令都将配置到新的分组中。
Octshift
格式：Octshift 通道 值
说明：设置键盘的八度音高。
Velocity
格式：Velocity 通道 值
说明：设置键盘的力度，值取值范围是0-127。
Channel
格式：Channel 通道 MIDI通道
说明：设置通道所对应的MIDI输出。
KeySignature
格式：KeySignature 值
说明：设置曲调，值可以为-4到7
DelayKeyup
格式：DelayKeyup 通道 时间
说明：设置模拟延音， 通过在内部控制键盘抬起来模拟延音效果。由于是控制按键抬起的时间，在使用此功能是请松开延音踏板。 时间的取值范围是0-255， 所以单位是100ms， 设置为50则是延时5秒。
Program
格式：Program MIDI通道乐器ID
说明：设置乐器，配合分组可以实现基于分组的乐器切换。音源必须支持多乐器才有效果。
Controller
格式： Controller 通道 MIDI控制器名字或ID 值
说明：设置MIDI控制器，可以在分组切换时改变MIDI控制器。
控制器可以使用名字或ID来设置，具体的含义和作用可以参考MIDI手册，名字如下：
BankSelect
Modulation
BreathControl
FootPedal
Portamento
DataEntry
MainVolume
Balance
Pan
Expression
EffectSelector1
EffectSelector2
GeneralPurpose1
GeneralPurpose2
GeneralPurpose3
GeneralPurpose4
SustainPedal
PortamentoPedal
SostenutoPedal
SoftPedal
LegatoPedal
Hold2
SoundController1 – SoundController10
DataIncrement
DataDecrement
NRPNLSB
NRPNMSB
RPNLSB
RPNMSB
AllSoundsOff
ResetAllControllers
LocalControlOnOff
AllNotesOff
OmniModeOff
OmniModeOn
MonoModeOn
PokyModeOn
Keydown，Key
格式：Keydown 键盘名称或ID 命令 参数…
说明：绑定命令至键盘按下时执行。
Keyup
格式：Keyup 键盘名称或ID 命令 参数…
说明：绑定命令至键盘松开时执行。
Label
格式：Label 键盘名称或ID 说明字符
说明：设置键盘上显示的内容，注意请不要将内容设置过长否则会超出键盘显示的范围。
3. 键盘绑定命令
键盘绑定命令同时适用于 Keydown 和 Keyup 命令，键盘名称一般为键盘上下面一行所写的内容， 如果还是不确定其名称，可以尝试使用菜单先配置一下然后从自动生成的配置中找到键位名称。以下说明中将使用Keydown作为格式范例。
KeySignature
格式：Keydown 键盘名称 KeySignature Set/Inc/Dec/Flip 值
说明：改变当前的曲调， 可以进行设置/增加/减少/反转操作。
例：Keydown Esc KeySignature Inc 1 在按下Esc键时曲调+1
例：Keydown Esc KeySignature Set 0 在按下Esc时将曲调设为0(C调)
OctShift
格式：Keydown 键盘名称 OctShift 通道 Set/Inc/Dec/Flip 值
说明：改变键盘的八度音高。
Velocity
格式：Keydown 键盘名称 Velocity 通道 Set/Inc/Dec/Flip 值
说明：改变通道的力度。
Channel
格式：Keydown 键盘名称 Channel 通道 Set/Inc/Dec/Flip 值
说明：改变通道所对应的MIDI通道。
Volume
格式：Keydown 键盘名称 Volume Set/Inc/Dec/Flip 值
说明：改变总输出音量。
Play
格式：Keydown 键盘名称 Play
说明：开始播放。
Record
格式：Keydown 键盘名称 Record
说明：开始录制。
Stop
格式：Keydown 键盘名称 Record
说明：停止播放或录制。
Group
格式：Keydown 键盘名称 Group Set/Inc/Dec/Flip 值
说明：改变当前的分组。
NoteOff
格式：Keydown 键盘名称 NoteOff 通道 音符名 [力度]
说明：发送松开MIDI键的命令，音符名为（C,C#,D,D#,E,F,F#,G,G#,A,A#,B） 与音高（0-7）的组合， 如C4。
NoteOn
格式：Keydown 键盘名称 NoteOn 通道 音符名 [力度]
说明：发送按下MIDI键的命令。
KeyPressure
格式：Keydown 键盘名称 KeyPressure 通道 音符名 [力度]
说明：发送MIDI力度修改命令。
Controller
格式：Keydown 键盘名称 Controller 通道 控制器名称或ID 值 [Set/Inc/Dec/Flip]
说明：发送MIDI控制器命令，请参考全局Controller配置。最后一个参数为可选，默认是Set。放在最后是为了兼容MIDI。
Program
格式：Keydown 键盘名称 Program 通道 值 [Set/Inc/Dec/Flip]
说明：改变通道对应的乐器（音色）。
ChannelPressure
格式：Keydown 键盘名称 Program 通道 值
说明：改变当前频道所有音符的播放力度
PitchBend
格式：Keydown 键盘名称 PitchBend 通道 值
说明：滑音效果
赞 (0)