ys2-intro/loader/samples/minexample/furC64/README.md
2025-11-26 19:42:34 +07:00

43 lines
1.7 KiB
Markdown

# furC64
a C64/SID sound driver for Furnace
### **THIS SOUND DRIVER IS CURRENTLY A WIP**
A SID driver that's easy to make music with? It's more likely than you think.
* You have to have [Python](https://www.python.org/) and the [CC65 toolchain](https://cc65.github.io/) installed
* You **have** to set the pitch linearity option to "None". You can do this by going to `window -> song -> compatability flags -> Pitch/Playback -> Pitch linearity` and then setting the option to "None".
* The driver only supports **arpeggio, waveform, duty and cutoff** macros in each instrument and it DOESN'T support LFO and ADSR macros nor delay and step length, **although you can use LFO macros in the duty and cutoff macros (as in range-sweeping)**
* The furC64 driver only supports these effects:
* 00xx: arpeggio
* 01xx: pitch slide up
* 02xx: pitch slide down
* 03xx: portamento
* 04xx: vibrato
* 09xx: set speed 1
* 0Bxx: jump to pattern
* 0Dxx: jump to next pattern
* 0Fxx: set speed 2
* 1Axx: disable/enable envelope reset
* 1Bxx: reset cutoff
* 1Cxx: reset pulse-width
* 4xxx: set filter cutoff
* E1xx: note slide up
* E2xx: note slide down
* E5xx: note fine-pitch
* EAxx: legato
* ECxx: note cut
when you've finished / want to test out this driver:
* open the terminal/command prompt **to the furC64 directory**
* run `convert.sh your_fur_file.fur` or `convert.bat file.fur` (depending on your OS)
* in the `furC64/asm` directory you'll hopefully see a file called **`furC64-test.prg`**
* that's your .prg file that you can run on hardware or on an emulator like VICE!
Hopefully you'll have fun with this driver alongside [furNES](https://github.com/AnnoyedArt1256/furNES) :D
Libraries used: chipchune