2021-05-13 08:22:57 +00:00
|
|
|
# Furnace
|
2021-05-11 20:08:08 +00:00
|
|
|
|
2021-12-19 08:36:42 +00:00
|
|
|
|
|
|
|
|
|
2022-01-11 08:52:26 +00:00
|
|
|
this is a work-in-progress chiptune tracker compatible with DefleMask modules (.dmf).
|
2021-05-28 19:15:27 +00:00
|
|
|
|
|
|
|
|
## features
|
|
|
|
|
|
2021-12-09 08:37:31 +00:00
|
|
|
- supports Sega Genesis, Master System, Game Boy, PC Engine, NES, C64, YM2151/PCM and Neo Geo!
|
2022-01-11 08:52:26 +00:00
|
|
|
- multiple sound chips in a single song!
|
2021-05-28 19:15:27 +00:00
|
|
|
- clean-room design (zero reverse-engineered code and zero decompilation; using official DMF specs, guesswork and ABX tests only)
|
|
|
|
|
- bug/quirk implementation for increased playback accuracy
|
2021-12-11 09:55:31 +00:00
|
|
|
- accurate emulation cores whether possible (Nuked, MAME, SameBoy, Mednafen PCE, puNES, reSID and ymfm)
|
2022-01-11 09:55:52 +00:00
|
|
|
- additional features on top:
|
2022-01-11 08:52:26 +00:00
|
|
|
- SSG envelopes in Neo Geo
|
|
|
|
|
- full duty/cutoff range in C64
|
2021-05-28 19:15:27 +00:00
|
|
|
- open-source. GPLv2.
|
|
|
|
|
|
2021-12-19 18:05:09 +00:00
|
|
|
## downloads
|
|
|
|
|
|
2021-12-30 23:58:51 +00:00
|
|
|
check out the Releases page. available for Windows, macOS and Linux (AppImage).
|
2021-12-19 18:05:09 +00:00
|
|
|
|
|
|
|
|
# developer info
|
|
|
|
|
|
2021-05-28 19:15:27 +00:00
|
|
|
## dependencies
|
|
|
|
|
|
2021-05-28 20:31:35 +00:00
|
|
|
- CMake
|
|
|
|
|
- SDL2
|
|
|
|
|
- zlib
|
2021-06-09 08:33:03 +00:00
|
|
|
- JACK (optional)
|
2021-05-28 20:31:35 +00:00
|
|
|
|
2021-12-14 19:33:24 +00:00
|
|
|
SDL2 and zlib are included as submodules.
|
2021-05-28 19:15:27 +00:00
|
|
|
|
|
|
|
|
## compilation
|
|
|
|
|
|
2021-05-28 19:44:02 +00:00
|
|
|
your typical CMake project. clone (including submodules) and:
|
2021-05-28 19:15:27 +00:00
|
|
|
|
2021-05-28 20:31:35 +00:00
|
|
|
### Windows using MSVC
|
|
|
|
|
|
2021-12-19 08:37:42 +00:00
|
|
|
**no longer tested!** as of now tildearrow uses MinGW for Windows builds...
|
|
|
|
|
|
2021-05-28 20:31:35 +00:00
|
|
|
from the developer tools command prompt:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake ..
|
|
|
|
|
msbuild ALL_BUILD.vcxproj
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### macOS and Linux
|
|
|
|
|
|
2021-05-28 19:15:27 +00:00
|
|
|
```
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake ..
|
|
|
|
|
make
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## usage
|
|
|
|
|
|
|
|
|
|
```
|
2021-12-19 18:05:09 +00:00
|
|
|
./furnace
|
2021-05-28 19:15:27 +00:00
|
|
|
```
|
|
|
|
|
|
2021-12-19 18:05:09 +00:00
|
|
|
this opens the program.
|
2021-12-07 18:08:48 +00:00
|
|
|
|
|
|
|
|
```
|
2021-12-19 18:05:09 +00:00
|
|
|
./furnace -console <file>
|
2021-12-07 18:08:48 +00:00
|
|
|
```
|
|
|
|
|
|
2021-12-19 18:05:09 +00:00
|
|
|
this will play a .dmf file.
|
2021-12-07 18:08:48 +00:00
|
|
|
|
|
|
|
|
```
|
2021-12-19 18:05:09 +00:00
|
|
|
./furnace -console -view commands <file>
|
2021-12-07 18:08:48 +00:00
|
|
|
```
|
|
|
|
|
|
2021-12-19 18:05:09 +00:00
|
|
|
this will play a .dmf file and enable the commands view.
|
2021-12-07 18:08:48 +00:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
./furnace -output audio.wav <file>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
this will render a .dmf file to .wav.
|
2021-12-11 18:30:06 +00:00
|
|
|
|
|
|
|
|
# notes
|
|
|
|
|
|
2022-01-11 08:52:26 +00:00
|
|
|
> how do I use Neo Geo SSG envelopes?
|
|
|
|
|
|
|
|
|
|
the following effects are provided:
|
|
|
|
|
|
|
|
|
|
- `22xy`: set envelope mode.
|
|
|
|
|
- `x` sets the envelope shape, which may be one of the following:
|
|
|
|
|
- `0: \___` decay
|
|
|
|
|
- `4: /___` attack once
|
|
|
|
|
- `8: \\\\` saw
|
|
|
|
|
- `9: \___` decay
|
|
|
|
|
- `A: \/\/` inverse obelisco
|
|
|
|
|
- `B: \¯¯¯` decay once
|
|
|
|
|
- `C: ////` inverse saw
|
|
|
|
|
- `D: /¯¯¯` attack
|
|
|
|
|
- `E: /\/\` obelisco
|
|
|
|
|
- `F: /___` attack once
|
|
|
|
|
- if `y` is 1 then the envelope will affect this channel.
|
|
|
|
|
- `23xx`: set envelope period low byte.
|
|
|
|
|
- `24xx`: set envelope period high byte.
|
2022-01-11 23:38:26 +00:00
|
|
|
- `25xx`: slide envelope period up.
|
|
|
|
|
- `26xx`: slide envelope period down.
|
2022-01-11 08:52:26 +00:00
|
|
|
|
|
|
|
|
a lower envelope period will make the envelope run faster.
|
|
|
|
|
|
2021-12-11 18:30:06 +00:00
|
|
|
> my song sounds very odd at a certain point
|
|
|
|
|
|
|
|
|
|
file a bug report. use the Issues page.
|
|
|
|
|
|
|
|
|
|
it's probably another playback inaccuracy.
|
2021-12-11 18:41:37 +00:00
|
|
|
|
2021-12-19 18:05:09 +00:00
|
|
|
> my song sounds correct, but it doesn't in DefleMask
|
2021-12-11 18:41:37 +00:00
|
|
|
|
2021-12-19 18:05:09 +00:00
|
|
|
file a bug report **here**. it still is a playback inaccuracy.
|
2022-01-11 08:52:26 +00:00
|
|
|
|
|
|
|
|
> my C64 song sounds terrible after saving as .dmf!
|
|
|
|
|
|
|
|
|
|
that's a limitation of the DefleMask format. save in Furnace song format instead (.fur).
|
