NsfPlay 是一款可以让 Gamemaker 8 来播放 NSF 格式音乐的扩展。
NSF 简介
NSF（全称 NES Sound Format, 扩展名为. nsf ，是 FC/NES(或 Family Computer,Famicom, 任天堂, 红白机……)的音乐（含效果音）格式。它是一种工作方式类似于 midi 的特殊音频序列, 由 6502 汇编指令组成, 通过 2A03 芯片 (PSG 音源, 包括 2 个矩形波通道，1 个三角波通道，1 个杂声通道，1 个 1-bit 采样的 DPCM 通道) 实现播放。现在还有很多 chiptune 或者说是 mod 音乐爱好者用 MCK/MML,FamiTracker,NT2 等声音驱动 / 工具制作 NSF 格式的音乐。
函数列表
nsf_play()
nsf_play(string fname)
打开并播放一个 NSF 文件
| 参数 | 说明 |
|---|---|
| fname | string 型，nsf 文件路径。 |
nsf_stop()
nsf_stop()
停止播放。
nsf_pause()
nsf_pause()
暂停或恢复播放。
nsf_is_playing()
nsf_is_playing() : bool isPlaying
| 返回值 | 说明 |
|---|---|
| isPlaying | bool 型，返回 NSF 音乐是否正在播放。 |
nsf_next()
nsf_next()
切换到下一音轨。
nsf_prev()
nsf_prev()
切换到上一音轨。
nsf_get_position()
nsf_get_position() : real playPosition
| 返回值 | 说明 |
|---|---|
| playPosition | real 型，返回当前所播放音轨的播放时间，单位毫秒。 |
nsf_set_position()
nsf_set_position(real position)
| 参数 | 说明 |
|---|---|
| position | real 型，设置当前音轨的播放时间，单位毫秒。 |
nsf_set_volume()
nsf_set_volume(real volume)
| 参数 | 说明 |
|---|---|
| volume | real 型，设置播放音量，范围在 0~1 之间，0 为静音，1 为最大音量。 |
