Note(音符) API
Note(音符) API提供了将音符转换为它们各自的MIDI编码和/或频率(单位为赫兹)的功能,以及一些其他功能。此API常与computer.beep以及原版的音符盒(需安装OpenComponents模组)配合使用。
note.midi(n: number or string): number 将字符串格式的音符(如 A#4 或 Gb3,查看下表)或给出的频率转换为MIDI编码。
note.freq(n: number or string): number 将字符串格式的音符(如 A#4)或给出的MIDI编码转换为频率。
note.name(n: number): string 将MIDI编码转换回字符串。如果你需要转换频率,请用note.name(note.midi(frequency))。
note.ticks(n: number): number 将音符盒的音高(0-24)转换为MIDI编码(分别对应34-58),或者反过来。在与音符盒以及OpenComponents配合使用时很有帮助。
note.play(tone: string or number,duration: number) 通过computer.beep演奏字符串或MIDI编码对应的音符,时长为duration参数。
- 可用音符 可用的字符串名称、它们对应的MIDI编码和频率如下表所示:
| 名称
|
MIDI编码
|
频率
|
| A0
|
21
|
27.5000
|
| A#0/Bb0
|
22
|
29.1352
|
| B0
|
23
|
30.8677
|
| C1
|
24
|
32.7032
|
| C#1/Db1
|
25
|
34.6478
|
| D1
|
26
|
36.7081
|
| D#1/Eb1
|
27
|
38.8909
|
| E1
|
28
|
41.2034
|
| F1
|
29
|
43.6535
|
| F#1/Gb1
|
30
|
46.2493
|
| G1
|
31
|
48.9994
|
| G#1/Ab1
|
32
|
51.9131
|
| A1
|
33
|
55.0000
|
| A#1/Bb1
|
34
|
58.2705
|
| B1
|
35
|
61.7354
|
| C2
|
36
|
65.4064
|
| C#2/Db2
|
37
|
69.2957
|
| D2
|
38
|
73.4162
|
| D#2/Eb2
|
39
|
77.7817
|
| E2
|
40
|
82.4069
|
| F2
|
41
|
87.3071
|
| F#2/Gb2
|
42
|
92.4986
|
| G2
|
43
|
97.9989
|
| G#2/Ab2
|
44
|
103.826
|
| A2
|
45
|
110.000
|
| A#2/Bb2
|
46
|
116.541
|
| B2
|
47
|
123.471
|
| C3
|
48
|
130.813
|
| C#3/Db3
|
49
|
138.591
|
| D3
|
50
|
146.832
|
| D#3/Eb3
|
51
|
155.563
|
| E3
|
52
|
164.814
|
| F3
|
53
|
174.614
|
| F#3/Gb3
|
54
|
184.997
|
| G3
|
55
|
195.998
|
| G#3/Ab3
|
56
|
207.652
|
| A3
|
57
|
220.000
|
| A#3/Bb3
|
58
|
233.082
|
| B3
|
59
|
246.942
|
| C4
|
60
|
261.626
|
| C#4/Db4
|
61
|
277.183
|
| D4
|
62
|
293.665
|
| D#4/Eb4
|
63
|
311.127
|
| E4
|
64
|
329.628
|
| F4
|
65
|
349.228
|
| F#4/Gb4
|
66
|
369.994
|
| G4
|
67
|
391.995
|
| G#4/Ab4
|
68
|
415.305
|
| A4
|
69
|
440.000
|
| A#4/Bb4
|
70
|
466.164
|
| B4
|
71
|
493.883
|
| C5
|
72
|
523.251
|
| C#5/Db5
|
73
|
554.365
|
| D5
|
74
|
587.330
|
| D#5/Eb5
|
75
|
622.254
|
| E5
|
76
|
659.255
|
| F5
|
77
|
698.456
|
| F#5/Gb5
|
78
|
739.989
|
| G5
|
79
|
783.991
|
| G#5/Ab5
|
80
|
830.609
|
| A5
|
81
|
880.000
|
| A#5/Bb5
|
82
|
932.328
|
| B5
|
83
|
987.767
|
| C6
|
84
|
1046.50
|
| C#6/Db6
|
85
|
1108.73
|
| D6
|
86
|
1174.66
|
| D#6/Eb6
|
87
|
1244.51
|
| E6
|
88
|
1318.51
|
| F6
|
89
|
1396.91
|
| F#6/Gb6
|
90
|
1479.98
|
| G6
|
91
|
1567.98
|
| G#6/Ab6
|
92
|
1661.22
|
| A6
|
93
|
1760.00
|
| A#6/Bb6
|
94
|
1864.66
|
| B6
|
95
|
1975.53
|
目录