From 077fae80d6654b216772c474ec2472b79a0befc0 Mon Sep 17 00:00:00 2001 From: freq-mod <32672779+freq-mod@users.noreply.github.com> Date: Mon, 7 Feb 2022 20:13:27 +0100 Subject: [PATCH] Complete the instruments documentation --- papers/doc/4-instrument/amiga.md | 13 +++++++++++++ papers/doc/4-instrument/c64.md | 30 +++++++++++++++++++++++++++++ papers/doc/4-instrument/fm.md | 4 +++- papers/doc/4-instrument/game-boy.md | 3 +++ papers/doc/4-instrument/pce.md | 7 +++++++ papers/doc/4-instrument/standard.md | 7 +++++++ 6 files changed, 63 insertions(+), 1 deletion(-) create mode 100644 papers/doc/4-instrument/amiga.md create mode 100644 papers/doc/4-instrument/c64.md create mode 100644 papers/doc/4-instrument/pce.md create mode 100644 papers/doc/4-instrument/standard.md diff --git a/papers/doc/4-instrument/amiga.md b/papers/doc/4-instrument/amiga.md new file mode 100644 index 000000000..9c9a86ac1 --- /dev/null +++ b/papers/doc/4-instrument/amiga.md @@ -0,0 +1,13 @@ +# Amiga/PCM sound sourceinstrument editor + +PCM instrument editor consists of four macros and sample selector: + +# Amiga/sample + +- [Initial sample] - specifies which sample should be assigned to the instrument, or the first one in the sequence + +# Macros + +- [Volume] - volume sequence WARNING: it works only on Amiga system, as of version 0.5.5!! +- [Arpeggio] - pitch sequence +- [Waveform] - sample sequence diff --git a/papers/doc/4-instrument/c64.md b/papers/doc/4-instrument/c64.md new file mode 100644 index 000000000..93eb261ab --- /dev/null +++ b/papers/doc/4-instrument/c64.md @@ -0,0 +1,30 @@ +# C64 SID instrument editor + +C64 instrument editor consists of two tabs: one controlling various parameters of sound channels and macro tab containing seven macros: + +## C64 +- [Waveform] - allows selecting a waveform. NOTE: more than one waveform can be selected at once, logical AND mix of waves will be produced, with an exception of a noise waveform, it can't be mixed. +- [Attack] - determines the rising time for the sound. The bigger the value, the slower the attack. (0-15 range) +- [Decay]- Determines the diminishing time for the sound. The higher the value, the longer the decay. It's the initial amplitude decay rate. (0-15 range) +- [Sustain] - Determines the diminishing time for the sound. The higher the value, the longer the decay. This is the long "tail" of the sound that continues as long as the key is depressed. (0-15 range) +- [Release] - Determines the rate at which the sound disappears after KEY-OFF. The higher the value, the longer the release. (0-15 range) +- [Ring Modulation] - enables the ring modulation affecting the instrument. +- [Duty] - specifies the width of a pulse wave. (0-4095 range) +- [Oscillator Sync] - enables the oscillator hard sync. As one oscillator finishes a cycle, it resets the period of another oscillator, forcing the latter to have the same base frequency. This can produce a harmonically rich sound, the timbre of which can be altered by varying the synced oscillator's frequency. +- [Enable filter] - enables analogue filter affecting the instrument +- [Initialize filter] - initializes the filter with the specified parameters: +- [Cutoff] - defines the "intensity" of a filter, to put in in layman terms (0-2047 range) +- [Resonance] - defines an additional controlled amplification of that cutoff frequency, creating a secondary peak forms and colors the original pitch. (0-15 range) +- [Filter mode] - determined the filter mode NOTE: SID's filter is muliti-mode, you can mix different modes together (like low and high-pass filters at once) CH3-OFF disables the channel 3, for no reason whatsoever lmao +- [Volume Macrio is a Cutoff macro] - turns a volume macro in a macros tab into a filter cutoff macro. +- [Absolute Cutoff macro] - changes the behaviour of a cutoff macro from the old-style, compatible to much more define-able. +- [Absolute Duty macro] - changes the behaviour of a duty cycle macro from the old-style, compatible to much more define-able. + +## Macros +- [Volume/Cutoff] - volume sequence (WARNING: Volume sequence is global for ALL three channels!!) +- [Arpeggio] - pitch sequence +- [Duty cycle] - pulse duty cycle sequence +- [Waveform] - select the waveform used by instrument +- [Filter mode] - select the filter mode/squence +- [Resonance] - filter resonance sequence +- [Special] - ring and oscillator sync selector diff --git a/papers/doc/4-instrument/fm.md b/papers/doc/4-instrument/fm.md index 0401f4412..aea2bc6b0 100644 --- a/papers/doc/4-instrument/fm.md +++ b/papers/doc/4-instrument/fm.md @@ -28,13 +28,15 @@ FM synthesizers Furnace supports are for-operator, meaning it takes four oscilla - [Algorithm (AL)] - Determines how operators are connected to each other. (0-7 range) - [Feedback (FB)] - Determines the amount of signal whick operator 1 returns to itself. (0-7 range) - [Amplitude Modulation (AM)] - Makes the operator affected by LFO. +- [LFO Frequency Sensitivity] - Determines the amount of LFO frequency changes. (0-7 range) +- [LFO Amplitude Sensitivity (AM)] - Determines the amount of LFO frequency changes. (0-3 range) ## Macros Macros define the squence of values passed to the given parameter. Via macro, aside previously mentioned parameters, the following can be controlled: - LFO Frequency -- Amplitude Modulation Sensitivity +- LFO waveform selection WARNING: this parameter affects only YM2151 sound source!!! - Amplitude Modulation Depth WARNING: this parameter affects only YM2151 sound source!!! - Frequency Modulation Depth WARNING: this parameter affects only YM2151 sound source!!! - Arpeggio Macro: pitch change sequence in semitones. Two modes are available: diff --git a/papers/doc/4-instrument/game-boy.md b/papers/doc/4-instrument/game-boy.md index 957818206..69401cb0e 100644 --- a/papers/doc/4-instrument/game-boy.md +++ b/papers/doc/4-instrument/game-boy.md @@ -6,6 +6,9 @@ GB instrument editor consists of two tabs: one controlling envelope of sound cha - [Volume] - this slider affect the channel volume (range 0-15) - [Envelope length] - this slider specifies the envelope decay/attack (range 0-7) +- [Sound length] - this slider cuts off the sound after specified length, overriding the previous slider's value + +- [UP an DOWN radio buttons] - these buttons alter the behaviour of a second slider. Up makes it specify the envelope attack, down the decay. WARNING: for envelope attack to have any effect, volume should be at the lower rates! ## Macros - [Volume] - volume sequence diff --git a/papers/doc/4-instrument/pce.md b/papers/doc/4-instrument/pce.md new file mode 100644 index 000000000..7bff37c70 --- /dev/null +++ b/papers/doc/4-instrument/pce.md @@ -0,0 +1,7 @@ +# NEC PC Engine instrument editor + +PCE instrument editor consists of only three macros, almost like TIA: + +- [Volume] - volume sequence +- [Arpeggio] - pitch sequencr +- [Waveform] - spicifies wavetables sequence diff --git a/papers/doc/4-instrument/standard.md b/papers/doc/4-instrument/standard.md new file mode 100644 index 000000000..5f116c74f --- /dev/null +++ b/papers/doc/4-instrument/standard.md @@ -0,0 +1,7 @@ +# Standard instrument editor + +SMS and NES instrument editor consists of only three macros: + +- [Volume] - volume sequence +- [Arpeggio] - pitch sequencr +- [Duty cycle] - spicifies duty cycle and noise mode for NES channels NOTE: it obviously has no effect on Sega Master System