otomatalabs/furnace
7
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

Docs for new PC Speaker exports.

Browse source
This commit is contained in:
Electric Keet 2025-06-18 16:03:46 -07:00 committed by tildearrow
parent 67a176aa9a
commit 1bd2ea3a6b
2 changed files with 18 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
doc/2-interface/export.md
View file

@ -53,6 +53,9 @@ the following settings exist:
- **chips to export**: select which chips are going to be exported. - **chips to export**: select which chips are going to be exported.
- due to VGM format limitations, you can only select up to two of each chip type. - due to VGM format limitations, you can only select up to two of each chip type.
- some chips will not be available, either because VGM doesn't support these yet, or because you selected an old format version. - some chips will not be available, either because VGM doesn't support these yet, or because you selected an old format version.
- **speed drift compensation**:
- **none**: normal export.
- **DeadFish VgmPlay (1.02×)**: adjusts speed to account for inaccuracy in [VgmPlay](https://www.mjsstuf.x10host.com/pages/vgmPlay/vgmPlay.htm), the Sega Genesis VGM player by DeadFish.
## ZSM ## ZSM
@ -72,8 +75,10 @@ the following settings are available:
depending on the system, this option may appear to allow you to export your song to a working ROM image or code that can be built into one. export options are explained in the system's accompanying documentation. depending on the system, this option may appear to allow you to export your song to a working ROM image or code that can be built into one. export options are explained in the system's accompanying documentation.
currently, only one system can be exported this way: the following formats and systems are supported:
- [Atari 2600 (TIunA)](../7-systems/tia.md) - TIunA assembly, using [Atari 2600 (with software pitch driver)](../7-systems/tia.md).
- iPod .tone alarm, using [PC Speaker](../7-systems/pcspkr.md).
- GRUB_INIT_TUNE, using [PC Speaker](../7-systems/pcspkr.md).
## text ## text

11
doc/7-systems/pcspkr.md
View file

@ -34,6 +34,17 @@ ha! effects...
this chip uses the [Beeper](../4-instrument/beeper.md) instrument editor. this chip uses the [Beeper](../4-instrument/beeper.md) instrument editor.
## ROM export
two ROM export options exist:
- **iPod .tone alarm**: with the iPod _in disk mode,_ drag the export file into the `iPod_Control/Tones` folder.
- **GRUB_INIT_TUNE**: use with the GRUB bootloader.
- into the file `etc/default/grub` add the following line with the text output copied and pasted where `text` is:\
`GRUB_INIT_TUNE="text"`\
then run `sudo update-grub2`.
- **export binary file**: creates a binary file instead of text. in either the GRUB shell or the GRUB config file, use the `play` command followed by the filename of the export.
## chip config ## chip config
the following options are available in the Chip Manager window: the following options are available in the Chip Manager window: