API/note/zh
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 |
目录
| < 100% 15% 15% > | ||
| API | OpenOS | buffer - colors - component - computer - event - filesystem - uuid - internet - keyboard - note - process - rc - robot - serialization - shell - sides - term - text - thread - transforms - unicode |
| ::: | Lua 库 | coroutine - package - io - os |