1,345
edits
Changes
Created page with "==General== At default all instruments are empty (no sound). At first it might be a little confusing but once you are used to it it will take little effort to create your own..."
==General==
At default all instruments are empty (no sound). At first it might be a little confusing but once you are used to it it will take little effort to create your own instruments.
To edit the instruments you have to open the instrument editor using the [F2] key.
There is a total of 31 instruments available. The instruments consist out of several parts:
* A name
* A macro
* A waveform
[[File:Instrument_editor.png]]
==Name==
The name of the instrument is only for helping keep track of what instrument is which. The instruments names are always visible in the instrument menu area (top right) in the pattern and instrument editor.
==Macro==
The macro is the most important part. Without it there is no sound. Each instrument macro has its own length and restart (loop) position. Each [[tic]] a macro step is processed. A macro step is built up like this:
r ss TN fFFF nNN vV
For TTFM
r ss TNL fFFF nNN vV
For TTSMS
r ss TNL fFFF N X vV
{| class="wikitable" width="590px"
|style="width:10%;"| '''Column(s)'''
|style="width:65%;"| '''Description'''
|style="width:25%;"| '''Values'''
|-valign="top"
| r || Restart column. The [R] indicator marks the loop position.||
|-
| ss || Macro step number.|| $00 - $1f (32 steps)
|-
| T || Tone enabled/disabled.|| 'T'(enabled) or 't'
|-
| N || Noise enabled/disabled.|| 'N'(enabled) or 'n'
|-
| L || FM Voice link. (see note below)|| 'L'(enabled) or 'l'.
|-
| f || Tone (frequency) deviation type .|| '+' or '-'
|-
| FFF || Tone change in addition to the previous macro step.|| $000-$fff (4096 steps)
|-
| n || Noise deviation type.|| '_', '+' or '-'
|-
| NN || Noise change in addition to the previous macro step(+/-) or absolute(_).|| $00-$1f (32 steps)
|-
| N || Noise value (absolute) First 4 values sets the periodic noise and next 4 set white noise options. || $0-$7 (8 steps)
|-
| v || Volume deviation type. || '_', '+' or '-'
|-
| V || Volume change in addition to the previous macro step (+/-) or absolute(_).|| $0-$f (16 steps)
|-
| X || Noise volume (absolute).|| $0-$f (16 steps)
|-
|}
{{note|When using the voicelink for FM instruments.<br>Make sure to manual restore the starting voice in the first step using link too.}}
The most simple instrument macro is this (you can test a macro using the [[keyjazz]] mode:
R 00 Tn +000 _00 _F [[File:macroexample1.png]]
The macro will generate a constant sound. As the tone (T) is enabled and the volume is at max. But you can make much nicer instruments using multiple macro steps.
Most common is to only use the volume to set the ADSR (Attack,Decay and Sustain, Release) technique.
The noise columns are only processed when the instrument is used in the three PSG channels. Do remember that there is only 1 noise channel (the 4th PSG channel). When using multiple instruments that produce noise (noise enabled) on the same tic, only the last noise values are used.
==Waveform==
The waveform is only used for the SCC. Without it the SCC will not generate sound (even if the Tone is enabled). A waveform is a 32 byte sample that is played constantly (looped).
Each instrument can be linked to 1 of 32 available waveform slots.
==FM Voice==
The FM Voice is only used for the FM (TTFM and TTSMS versions). Next to the default 15 HW voices there are a set of software voice available. The last voices are customs voices. These voices can be created/edited and will be saved. Note: The default set of custom voices can be edited too but are not saved when changed.
==Loading and Saving==
[[file:instrumentfiledialog.png]]
The [F5] key opens the instrument filedialog from withing the instrument editor.
Use it to load/save:
* instruments
* instrument sets (31 instruments)
* macros
* macro sets (31 macros)
* waveforms
* waveform sets (32 waveforms)
At default all instruments are empty (no sound). At first it might be a little confusing but once you are used to it it will take little effort to create your own instruments.
To edit the instruments you have to open the instrument editor using the [F2] key.
There is a total of 31 instruments available. The instruments consist out of several parts:
* A name
* A macro
* A waveform
[[File:Instrument_editor.png]]
==Name==
The name of the instrument is only for helping keep track of what instrument is which. The instruments names are always visible in the instrument menu area (top right) in the pattern and instrument editor.
==Macro==
The macro is the most important part. Without it there is no sound. Each instrument macro has its own length and restart (loop) position. Each [[tic]] a macro step is processed. A macro step is built up like this:
r ss TN fFFF nNN vV
For TTFM
r ss TNL fFFF nNN vV
For TTSMS
r ss TNL fFFF N X vV
{| class="wikitable" width="590px"
|style="width:10%;"| '''Column(s)'''
|style="width:65%;"| '''Description'''
|style="width:25%;"| '''Values'''
|-valign="top"
| r || Restart column. The [R] indicator marks the loop position.||
|-
| ss || Macro step number.|| $00 - $1f (32 steps)
|-
| T || Tone enabled/disabled.|| 'T'(enabled) or 't'
|-
| N || Noise enabled/disabled.|| 'N'(enabled) or 'n'
|-
| L || FM Voice link. (see note below)|| 'L'(enabled) or 'l'.
|-
| f || Tone (frequency) deviation type .|| '+' or '-'
|-
| FFF || Tone change in addition to the previous macro step.|| $000-$fff (4096 steps)
|-
| n || Noise deviation type.|| '_', '+' or '-'
|-
| NN || Noise change in addition to the previous macro step(+/-) or absolute(_).|| $00-$1f (32 steps)
|-
| N || Noise value (absolute) First 4 values sets the periodic noise and next 4 set white noise options. || $0-$7 (8 steps)
|-
| v || Volume deviation type. || '_', '+' or '-'
|-
| V || Volume change in addition to the previous macro step (+/-) or absolute(_).|| $0-$f (16 steps)
|-
| X || Noise volume (absolute).|| $0-$f (16 steps)
|-
|}
{{note|When using the voicelink for FM instruments.<br>Make sure to manual restore the starting voice in the first step using link too.}}
The most simple instrument macro is this (you can test a macro using the [[keyjazz]] mode:
R 00 Tn +000 _00 _F [[File:macroexample1.png]]
The macro will generate a constant sound. As the tone (T) is enabled and the volume is at max. But you can make much nicer instruments using multiple macro steps.
Most common is to only use the volume to set the ADSR (Attack,Decay and Sustain, Release) technique.
The noise columns are only processed when the instrument is used in the three PSG channels. Do remember that there is only 1 noise channel (the 4th PSG channel). When using multiple instruments that produce noise (noise enabled) on the same tic, only the last noise values are used.
==Waveform==
The waveform is only used for the SCC. Without it the SCC will not generate sound (even if the Tone is enabled). A waveform is a 32 byte sample that is played constantly (looped).
Each instrument can be linked to 1 of 32 available waveform slots.
==FM Voice==
The FM Voice is only used for the FM (TTFM and TTSMS versions). Next to the default 15 HW voices there are a set of software voice available. The last voices are customs voices. These voices can be created/edited and will be saved. Note: The default set of custom voices can be edited too but are not saved when changed.
==Loading and Saving==
[[file:instrumentfiledialog.png]]
The [F5] key opens the instrument filedialog from withing the instrument editor.
Use it to load/save:
* instruments
* instrument sets (31 instruments)
* macros
* macro sets (31 macros)
* waveforms
* waveform sets (32 waveforms)