furnace/doc/4-instrument/ay8910.md

31 lines
1.2 KiB
Markdown
Raw Permalink Normal View History

2022-02-05 14:48:34 +00:00
# AY-3-8910 instrument editor
2022-02-04 21:05:25 +00:00
the AY-3-8910 instrument editor consists of two tabs.
2023-09-10 01:07:05 +00:00
## Sample
for sample settings, see [the Sample instrument editor](sample.md).
the only differences are the lack of an "Use wavetable" option, and the presence of a "Use sample" one.
note that using samples on AY is CPU expensive!
## Macros
- **Volume**: volume sequence.
- **Arpeggio**: pitch sequence.
- **Noise Freq**: noise generator frequency sequence.
- note: global!
- **Waveform**: selector of sound type - square wave tone, noise and/or envelope generator.
- you may select more than one option.
- **Pitch**: fine pitch.
- **Phase Reset**: trigger restart of **envelope**.
- **Envelope**: configures the hardware envelope.
- **enable**: sets whether envelope is enabled.
- **direction**: flips the envelope's direction.
- **alternate**: when enabled, the envelope will change direction once it hits a boundary.
- **hold**: sets whether the envelope should stop when hitting boundary, or loop.
- **AutoEnv Num**: sets the envelope to the channel's frequency multiplied by numerator.
- **AutoEnv Den**: sets the envelope to the channel's frequency multiplied by denominator.
- these two must be set in order for AutoEnv to work!