This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
api:note:zh [2023/10/16 11:35] hfsr [Available notes] |
api:note:zh [2023/11/29 14:25] hfsr [Note(音符) API] |
||
---|---|---|---|
Line 1: | Line 1: | ||
Note(音符) API | Note(音符) API | ||
======= | ======= | ||
- | Note(音符) API提供了将音符转换为它们各自的MIDI编码和/或频率(单位为赫兹)的功能,以及一些其他东西。此API常与computer.beep和音符方块(来自OpenComponents模组)配合使用。 | + | Note(音符) API提供了将音符转换为它们各自的MIDI编码和/或频率(单位为赫兹)的功能,以及一些其他功能。此API常与`computer.beep`以及原版的音符盒(需安装OpenComponents模组)配合使用。 |
- `note.midi(n: number or string): number` | - `note.midi(n: number or string): number` | ||
- | 将字符串格式的音符(如 A#4 或 Gb3,查看下表)或给出的频率转换为MIDI编码。 | + | 将字符串格式的音符(如 A#4 或 Gb3,查看下表)或给出的频率转换为MIDI编码。 |
+ | \\ | ||
- `note.freq(n: number or string): number` | - `note.freq(n: number or string): number` | ||
- | 将字符串格式的音符(如 A#4)或给出的MIDI编码转换为频率。 | + | 将字符串格式的音符(如 A#4)或给出的MIDI编码转换为频率。 |
+ | \\ | ||
- `note.name(n: number): string` | - `note.name(n: number): string` | ||
- | 将MIDI编码转换回字符串。如果你需要转换频率,请用`note.name(note.midi(frequency))`。 | + | 将MIDI编码转换回字符串。如果你需要转换频率,请用`note.name(note.midi(frequency))`。 |
+ | \\ | ||
- `note.ticks(n: number): number` | - `note.ticks(n: number): number` | ||
- | 将音符方块的记号(0-24)转换为MIDI编码(分别对应34-58),或者反过来。在与音符方块和OpenComponents配合使用时很有帮助。 | + | 将音符盒的音高(0-24)转换为MIDI编码(分别对应34-58),或者反过来。在与音符盒以及OpenComponents配合使用时很有帮助。 |
+ | \\ | ||
- `note.play(tone: string or number,duration: number)` | - `note.play(tone: string or number,duration: number)` | ||
- | 通过computer.beep演奏字符串或MIDI编码对应的音符,时长为duration参数。 | + | 通过`computer.beep`演奏字符串或MIDI编码对应的音符,时长为`duration`参数。 |
###可用音符 | ###可用音符 |