diff --git a/doc/2-interface/asset-add.png b/doc/2-interface/asset-add.png new file mode 100644 index 000000000..f6ef5b73b Binary files /dev/null and b/doc/2-interface/asset-add.png differ diff --git a/doc/2-interface/asset-delete.png b/doc/2-interface/asset-delete.png new file mode 100644 index 000000000..d0eb8dd97 Binary files /dev/null and b/doc/2-interface/asset-delete.png differ diff --git a/doc/2-interface/asset-duplicate.png b/doc/2-interface/asset-duplicate.png new file mode 100644 index 000000000..caa740fb1 Binary files /dev/null and b/doc/2-interface/asset-duplicate.png differ diff --git a/doc/2-interface/asset-folderview.png b/doc/2-interface/asset-folderview.png new file mode 100644 index 000000000..8d693e0fe Binary files /dev/null and b/doc/2-interface/asset-folderview.png differ diff --git a/doc/2-interface/asset-list.md b/doc/2-interface/asset-list.md index 36c147278..936c4a32f 100644 --- a/doc/2-interface/asset-list.md +++ b/doc/2-interface/asset-list.md @@ -17,7 +17,7 @@ Buttons from left to right: ![instruments window in folder view](instruments-folder.png) In folder view, the "Move up" and "Move down buttons disappear and a new one appears: -- **New Folder**: Creates a new folder. +- **New folder**: Creates a new folder. Instruments may be dragged from folder to folder and even rearranged within folders without changing their associated numbers. diff --git a/doc/2-interface/asset-move.png b/doc/2-interface/asset-move.png new file mode 100644 index 000000000..fdcbca6a9 Binary files /dev/null and b/doc/2-interface/asset-move.png differ diff --git a/doc/2-interface/asset-newfolder.png b/doc/2-interface/asset-newfolder.png new file mode 100644 index 000000000..01540abd9 Binary files /dev/null and b/doc/2-interface/asset-newfolder.png differ diff --git a/doc/2-interface/asset-open.png b/doc/2-interface/asset-open.png new file mode 100644 index 000000000..eea985143 Binary files /dev/null and b/doc/2-interface/asset-open.png differ diff --git a/doc/2-interface/asset-preview.png b/doc/2-interface/asset-preview.png new file mode 100644 index 000000000..8636285c4 Binary files /dev/null and b/doc/2-interface/asset-preview.png differ diff --git a/doc/2-interface/asset-previewstop.png b/doc/2-interface/asset-previewstop.png new file mode 100644 index 000000000..02fe6498e Binary files /dev/null and b/doc/2-interface/asset-previewstop.png differ diff --git a/doc/2-interface/asset-save.png b/doc/2-interface/asset-save.png new file mode 100644 index 000000000..19dd03e9a Binary files /dev/null and b/doc/2-interface/asset-save.png differ diff --git a/doc/2-interface/control-edit.png b/doc/2-interface/control-edit.png index 35fce78c7..e3e2d177a 100644 Binary files a/doc/2-interface/control-edit.png and b/doc/2-interface/control-edit.png differ diff --git a/doc/2-interface/control-metronome.png b/doc/2-interface/control-metronome.png index 0c6672565..51822c0e4 100644 Binary files a/doc/2-interface/control-metronome.png and b/doc/2-interface/control-metronome.png differ diff --git a/doc/2-interface/control-play-pattern.png b/doc/2-interface/control-play-pattern.png index a6eb5d01e..a11f0aab2 100644 Binary files a/doc/2-interface/control-play-pattern.png and b/doc/2-interface/control-play-pattern.png differ diff --git a/doc/2-interface/control-play-repeat.png b/doc/2-interface/control-play-repeat.png index 853cdcffe..fc2865902 100644 Binary files a/doc/2-interface/control-play-repeat.png and b/doc/2-interface/control-play-repeat.png differ diff --git a/doc/2-interface/control-play.png b/doc/2-interface/control-play.png index feafe1681..c258b5fd8 100644 Binary files a/doc/2-interface/control-play.png and b/doc/2-interface/control-play.png differ diff --git a/doc/2-interface/control-repeat.png b/doc/2-interface/control-repeat.png index c905e64ae..2a6a96add 100644 Binary files a/doc/2-interface/control-repeat.png and b/doc/2-interface/control-repeat.png differ diff --git a/doc/2-interface/control-step.png b/doc/2-interface/control-step.png index fd6262da7..e2d86be34 100644 Binary files a/doc/2-interface/control-step.png and b/doc/2-interface/control-step.png differ diff --git a/doc/2-interface/control-stop.png b/doc/2-interface/control-stop.png index f1fc9e4a7..e124c60d2 100644 Binary files a/doc/2-interface/control-stop.png and b/doc/2-interface/control-stop.png differ diff --git a/doc/2-interface/controls-classic.png b/doc/2-interface/controls-classic.png index a8a093fa9..37295e0df 100644 Binary files a/doc/2-interface/controls-classic.png and b/doc/2-interface/controls-classic.png differ diff --git a/doc/2-interface/controls-compact.png b/doc/2-interface/controls-compact.png index b0d1b0d40..7d9c7cca2 100644 Binary files a/doc/2-interface/controls-compact.png and b/doc/2-interface/controls-compact.png differ diff --git a/doc/2-interface/controls-split.png b/doc/2-interface/controls-split.png index 235ea2ce3..2b3fab407 100644 Binary files a/doc/2-interface/controls-split.png and b/doc/2-interface/controls-split.png differ diff --git a/doc/2-interface/controls-vertical.png b/doc/2-interface/controls-vertical.png index 98a89cc4e..6dfd57706 100644 Binary files a/doc/2-interface/controls-vertical.png and b/doc/2-interface/controls-vertical.png differ diff --git a/doc/2-interface/docking.png b/doc/2-interface/docking.png index 7a4eaa775..bc8eb1415 100644 Binary files a/doc/2-interface/docking.png and b/doc/2-interface/docking.png differ diff --git a/doc/2-interface/instruments-folder.png b/doc/2-interface/instruments-folder.png index 18e4ae630..a2fbb5ab2 100644 Binary files a/doc/2-interface/instruments-folder.png and b/doc/2-interface/instruments-folder.png differ diff --git a/doc/2-interface/instruments.png b/doc/2-interface/instruments.png index 33487de68..00102e543 100644 Binary files a/doc/2-interface/instruments.png and b/doc/2-interface/instruments.png differ diff --git a/doc/2-interface/interface1.png b/doc/2-interface/interface1.png index ae9950139..1c2abf07d 100644 Binary files a/doc/2-interface/interface1.png and b/doc/2-interface/interface1.png differ diff --git a/doc/2-interface/samples.png b/doc/2-interface/samples.png index 816512fbb..2be62a9ba 100644 Binary files a/doc/2-interface/samples.png and b/doc/2-interface/samples.png differ diff --git a/doc/2-interface/tab1.png b/doc/2-interface/tab1.png index 2c63a7d91..156532c5b 100644 Binary files a/doc/2-interface/tab1.png and b/doc/2-interface/tab1.png differ diff --git a/doc/2-interface/tab2.png b/doc/2-interface/tab2.png index 645f55a54..18bc6b2d1 100644 Binary files a/doc/2-interface/tab2.png and b/doc/2-interface/tab2.png differ diff --git a/doc/2-interface/tab3.png b/doc/2-interface/tab3.png index 4ebc1077a..c59d973ea 100644 Binary files a/doc/2-interface/tab3.png and b/doc/2-interface/tab3.png differ diff --git a/doc/2-interface/wavetables.png b/doc/2-interface/wavetables.png index ad7ea8808..4ac45f2c8 100644 Binary files a/doc/2-interface/wavetables.png and b/doc/2-interface/wavetables.png differ diff --git a/doc/2-interface/window.png b/doc/2-interface/window.png index 5d7b32f32..a812b7a89 100644 Binary files a/doc/2-interface/window.png and b/doc/2-interface/window.png differ diff --git a/doc/3-pattern/channelbar.png b/doc/3-pattern/channelbar.png index 61a62133f..6ef20cb43 100644 Binary files a/doc/3-pattern/channelbar.png and b/doc/3-pattern/channelbar.png differ diff --git a/doc/3-pattern/channels.png b/doc/3-pattern/channels.png index 6f9f04f23..ab4c985f2 100644 Binary files a/doc/3-pattern/channels.png and b/doc/3-pattern/channels.png differ diff --git a/doc/3-pattern/keyboard.png b/doc/3-pattern/keyboard.png index 67f0b78d8..7042af1c1 100644 Binary files a/doc/3-pattern/keyboard.png and b/doc/3-pattern/keyboard.png differ diff --git a/doc/3-pattern/pattern.png b/doc/3-pattern/pattern.png index e6abde48d..ca059faa8 100644 Binary files a/doc/3-pattern/pattern.png and b/doc/3-pattern/pattern.png differ diff --git a/doc/4-instrument/README.md b/doc/4-instrument/README.md index d359441ee..8857cf2ec 100644 --- a/doc/4-instrument/README.md +++ b/doc/4-instrument/README.md @@ -15,18 +15,18 @@ depending on the instrument type, there are currently 13 different types of an i - [FM synthesis](fm.md) - for use with YM2612, YM2151 and FM block portion of YM2610. - [Standard](standard.md) - for use with NES and Sega Master System's PSG sound source and its derivatives. - [Game Boy](game-boy.md) - for use with Game Boy APU. -- [PC Engine/TurboGrafx-16](pce.md) - for use with PC Engine's wavetable synthesizer. +- [PC Engine / TurboGrafx-16](pce.md) - for use with PC Engine's wavetable synthesizer. - [WonderSwan](wonderswan.md) - for use with WonderSwan's wavetable synthesizer. - [AY8930](8930.md) - for use with Microchip AY8930 E-PSG sound source. - [Commodore 64](c64.md) - for use with Commodore 64 SID. - [SAA1099](saa.md) - for use with Philips SAA1099 PSG sound source. - [TIA](tia.md) - for use with Atari 2600 chip. - [AY-3-8910](ay8910.md) - for use with AY-3-8910 PSG sound source and SSG portion in YM2610. -- [Amiga/sample](amiga.md) for controlling Amiga and other sample based synthsizers like YM2612's Channel 6 PCM mode, NES channel 5, Sega PCM, X1-010 and PC Engine's sample playback mode. +- [Amiga / sample](amiga.md) for controlling Amiga and other sample based synthsizers like YM2612's Channel 6 PCM mode, NES channel 5, Sega PCM, X1-010 and PC Engine's sample playback mode. - [Atari Lynx](lynx.md) - for use with Atari Lynx handheld console. - [VERA](vera.md) - for use with Commander X16 VERA. - [Seta/Allumer X1-010](x1_010.md) - for use with Wavetable portion in Seta/Allumer X1-010. -- [Konami SCC/Bubble System WSG](scc.md) - for use with Konami SCC and Wavetable portion in Bubble System's sound hardware. +- [Konami SCC / Bubble System WSG](scc.md) - for use with Konami SCC and Wavetable portion in Bubble System's sound hardware. - [Namco 163](n163.md) - for use with Namco 163. - [Konami VRC6](vrc6.md) - for use with VRC6's PSG sound source. @@ -77,14 +77,15 @@ Finally, the sequence of values can be directly edited in the text box at the bo ![ADSR macro editor](macro-ADSR.png) -- **Bottom** and **Top** determine the range of values generated by the macro. (Bottom can be larger than Top to invert the envelope!) All generated values will fall between these two points. -- **Attack** is how quickly the value goes from Bottom to Top. A 0 means nothing will change; a 255 instantly jumps to the Top value. -- **Hold** sets how many ticks the note will wait at Top before decay. -- **Decay** is how quickly the value moves to the Sustain level. -- **Sustain** is the where the value will stay while the note is held until SusTime has passed. -- **SusTime** is how many ticks until SusDecay. -- **SusDecay** is the rate at which the value moves toward Bottom while the note is held. -- **Release** is the rate at which the value moves toward Bottom after the note is released. +- **Bottom** and **Top** determine the range of outputs generated by the macro. (Bottom can be larger than Top to invert the envelope!) All outputs will be between these two values. +- Attack, Decay, Sustain, SusDecay, and Release accept inputs between 0 to 255. These are scaled to the distance between Bottom and Top. +- **Attack** is how much the value moves toward Top with each tick. +- **Hold** sets how many ticks to stay at Top before Decay. +- **Decay** is how much the value moves to the Sustain level. +- **Sustain** is how far from Bottom the value stays while the note is held. +- **SusTime** is how many ticks to stay at Sustain until SusDecay. +- **SusDecay** is how much the value moves toward Bottom with each tick while the note is held. +- **Release** is how much the value moves toward Bottom with each tick after the note is released. ![macro ADSR chart](macro-ADSRchart.png) diff --git a/doc/4-instrument/list.png b/doc/4-instrument/list.png index d85cea628..e8af84a83 100644 Binary files a/doc/4-instrument/list.png and b/doc/4-instrument/list.png differ diff --git a/doc/4-instrument/macro-ADSR.png b/doc/4-instrument/macro-ADSR.png index e514a85bb..f38d14329 100644 Binary files a/doc/4-instrument/macro-ADSR.png and b/doc/4-instrument/macro-ADSR.png differ diff --git a/doc/4-instrument/macro-ADSRchart.png b/doc/4-instrument/macro-ADSRchart.png index 4e3f409b2..2580426f4 100644 Binary files a/doc/4-instrument/macro-ADSRchart.png and b/doc/4-instrument/macro-ADSRchart.png differ diff --git a/doc/4-instrument/macro-LFO.png b/doc/4-instrument/macro-LFO.png index c79bce9f1..90cb5c088 100644 Binary files a/doc/4-instrument/macro-LFO.png and b/doc/4-instrument/macro-LFO.png differ diff --git a/doc/4-instrument/macro-button-ADSR.png b/doc/4-instrument/macro-button-ADSR.png index 438dbd66c..6529a72ca 100644 Binary files a/doc/4-instrument/macro-button-ADSR.png and b/doc/4-instrument/macro-button-ADSR.png differ diff --git a/doc/4-instrument/macro-button-LFO.png b/doc/4-instrument/macro-button-LFO.png index e02e94f93..8ad9c24b3 100644 Binary files a/doc/4-instrument/macro-button-LFO.png and b/doc/4-instrument/macro-button-LFO.png differ diff --git a/doc/4-instrument/macro-button-seq.png b/doc/4-instrument/macro-button-seq.png index 916153d5c..dd316c205 100644 Binary files a/doc/4-instrument/macro-button-seq.png and b/doc/4-instrument/macro-button-seq.png differ diff --git a/doc/4-instrument/macro-seq.png b/doc/4-instrument/macro-seq.png index bd6cebe24..6ea2050b4 100644 Binary files a/doc/4-instrument/macro-seq.png and b/doc/4-instrument/macro-seq.png differ diff --git a/doc/4-instrument/macro.png b/doc/4-instrument/macro.png index 42a2a635e..4e03bad92 100644 Binary files a/doc/4-instrument/macro.png and b/doc/4-instrument/macro.png differ diff --git a/doc/4-instrument/macroview.png b/doc/4-instrument/macroview.png index d2bd59718..faadedb2e 100644 Binary files a/doc/4-instrument/macroview.png and b/doc/4-instrument/macroview.png differ diff --git a/doc/8-advanced/channels.png b/doc/8-advanced/channels.png index 69fa2e995..e51815ebd 100644 Binary files a/doc/8-advanced/channels.png and b/doc/8-advanced/channels.png differ diff --git a/doc/8-advanced/chanosc.png b/doc/8-advanced/chanosc.png index f7a75ae91..42c6be295 100644 Binary files a/doc/8-advanced/chanosc.png and b/doc/8-advanced/chanosc.png differ diff --git a/doc/8-advanced/chip-manager-change.png b/doc/8-advanced/chip-manager-change.png index dc1561155..0def9180b 100644 Binary files a/doc/8-advanced/chip-manager-change.png and b/doc/8-advanced/chip-manager-change.png differ diff --git a/doc/8-advanced/chip-manager-move.png b/doc/8-advanced/chip-manager-move.png index 6d59cbf43..022eae230 100644 Binary files a/doc/8-advanced/chip-manager-move.png and b/doc/8-advanced/chip-manager-move.png differ diff --git a/doc/8-advanced/chip-manager-remove.png b/doc/8-advanced/chip-manager-remove.png index 6ea5c5f04..aea34d9c4 100644 Binary files a/doc/8-advanced/chip-manager-remove.png and b/doc/8-advanced/chip-manager-remove.png differ diff --git a/doc/8-advanced/chip-manager.png b/doc/8-advanced/chip-manager.png index 3f86f3a67..690777795 100644 Binary files a/doc/8-advanced/chip-manager.png and b/doc/8-advanced/chip-manager.png differ diff --git a/doc/8-advanced/clock.png b/doc/8-advanced/clock.png index 834eacaa0..c051c5fd1 100644 Binary files a/doc/8-advanced/clock.png and b/doc/8-advanced/clock.png differ diff --git a/doc/8-advanced/comments.png b/doc/8-advanced/comments.png index 0559c6ba4..dec7c26a0 100644 Binary files a/doc/8-advanced/comments.png and b/doc/8-advanced/comments.png differ diff --git a/doc/8-advanced/groove.png b/doc/8-advanced/groove.png index bc4031b08..ee0877c66 100644 Binary files a/doc/8-advanced/groove.png and b/doc/8-advanced/groove.png differ diff --git a/doc/8-advanced/grooves.png b/doc/8-advanced/grooves.png index 4b8489a7d..2130dad39 100644 Binary files a/doc/8-advanced/grooves.png and b/doc/8-advanced/grooves.png differ diff --git a/doc/8-advanced/log-viewer.png b/doc/8-advanced/log-viewer.png index 711205704..aa0076508 100644 Binary files a/doc/8-advanced/log-viewer.png and b/doc/8-advanced/log-viewer.png differ diff --git a/doc/8-advanced/mixer-mixer.png b/doc/8-advanced/mixer-mixer.png index 27574804c..249c6fbed 100644 Binary files a/doc/8-advanced/mixer-mixer.png and b/doc/8-advanced/mixer-mixer.png differ diff --git a/doc/8-advanced/mixer-patchbay.png b/doc/8-advanced/mixer-patchbay.png index bd73cd832..52ca7ab3e 100644 Binary files a/doc/8-advanced/mixer-patchbay.png and b/doc/8-advanced/mixer-patchbay.png differ diff --git a/doc/8-advanced/osc.png b/doc/8-advanced/osc.png index dbf485075..4a9b728c5 100644 Binary files a/doc/8-advanced/osc.png and b/doc/8-advanced/osc.png differ diff --git a/doc/8-advanced/pattern-manager.png b/doc/8-advanced/pattern-manager.png index 4df068111..b64b9d291 100644 Binary files a/doc/8-advanced/pattern-manager.png and b/doc/8-advanced/pattern-manager.png differ diff --git a/doc/8-advanced/piano.png b/doc/8-advanced/piano.png index d905dd74b..9bf53cf60 100644 Binary files a/doc/8-advanced/piano.png and b/doc/8-advanced/piano.png differ diff --git a/doc/8-advanced/register.png b/doc/8-advanced/register.png index df68b667e..76ec9894f 100644 Binary files a/doc/8-advanced/register.png and b/doc/8-advanced/register.png differ diff --git a/doc/8-advanced/stats.png b/doc/8-advanced/stats.png index 9c11db264..920654e6e 100644 Binary files a/doc/8-advanced/stats.png and b/doc/8-advanced/stats.png differ