Merge branch 'master' of https://github.com/tildearrow/furnace into x1_010

# Conflicts:
#	CMakeLists.txt
#	papers/doc/7-systems/README.md
#	src/engine/dispatch.h
#	src/engine/dispatchContainer.cpp
#	src/engine/playback.cpp
#	src/engine/sysDef.cpp
#	src/gui/gui.cpp

papers/doc/4-instrument/README.md

@@ -10,12 +10,13 @@ double-click to open the instrument editor.
 
 every instrument can be renamed and have its type changed.
 
-depending on the instrument type, there are currently 10 different types of an instrument editor:
+depending on the instrument type, there are currently 12 different types of an instrument editor:
 
 - [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.
+- [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.

papers/doc/4-instrument/wonderswan.md

@@ -0,0 +1,8 @@
+# WonderSwan instrument editor
+
+WS instrument editor consists of only four macros, similar to PCE but with different volume and noise range:
+
+- [Volume] - volume sequence
+- [Arpeggio] - pitch sequencr
+- [Noise] - noise LFSR tap sequence
+- [Waveform] - spicifies wavetables sequence

papers/doc/5-wave/README.md

@@ -1,5 +1,5 @@
 # wavetable editor
 
-Wavetable synthizers, in context of Furnace, are sound sources that operate on extremely short n-bit PCM streams. By extremely short, no more than 256 bytes. This amount of space is nowhere near enough to store an actual sampled sound, it allows certain amount of freedom to define a waveform shape. As of Furnace 0.5.5, wavetable editor affects PC Engine  and channel 3 of Game Boy.
+Wavetable synthizers, in context of Furnace, are sound sources that operate on extremely short n-bit PCM streams. By extremely short, no more than 256 bytes. This amount of space is nowhere near enough to store an actual sampled sound, it allows certain amount of freedom to define a waveform shape. As of Furnace 0.5.8, wavetable editor affects PC Engine, WonderSwan and channel 3 of Game Boy.
 
-Furnace's wavetable editor is rather simple, you can draw the waveform using mouse or by pasting an MML bit stream in the input field. Maximum wave width (length) is 256 bytes, and maximum wave height (depth) is 256. NOTE: both Game Boy and PCE can handle max 32 byte waveforms as of now, width 16-level height for GB and 32-level height for PCE. If larger wave will be defined for these two systems, it will be squashed to fit in the constrains of the system.  
+Furnace's wavetable editor is rather simple, you can draw the waveform using mouse or by pasting an MML bit stream in the input field. Maximum wave width (length) is 256 bytes, and maximum wave height (depth) is 256. NOTE: Game Boy, PCE and WonderSwan can handle max 32 byte waveforms as of now, with 16-level height for GB and WS, and 32-level height for PCE. If larger wave will be defined for these two systems, it will be squashed to fit within the constraints of the system.  

papers/doc/7-systems/README.md

@@ -19,5 +19,6 @@ this is a list of systems that Furnace supports, including each system's effects
 - [Philips SAA1099](saa1099.md)
 - [Microchip AY8930](ay8930.md)
 - [Seta/Allumer X1-010](x1_010.md)
+- [WonderSwan](wonderswan.md)
 
 Furnace also reads .dmf files with the [Yamaha YMU759](ymu759.md) system, but does not emulate the chip at all.

papers/doc/7-systems/wonderswan.md

@@ -0,0 +1,20 @@
+# WonderSwan
+
+A handheld console released only in Japan by Bandai. Designed by the same
+people behind Game Boy and Virtual Boy, it has lots of similar elements from
+those two systems in the sound department.
+
+It has 4 wavetable channels, one channel could play PCM, the other has hardware
+sweep and the other could play noise.
+
+# effects
+
+- `10xx`: change wave.
+- `11xx`: setup noise mode (channel 4 only).
+  - 0: disable.
+  - 1-8: enable and set tap preset.
+- `12xx`: setup sweep period (channel 3 only).
+  - 0: disable.
+  - 1-32: enable and set period.
+- `13xx`: setup sweep amount (channel 3 only).
+- `17xx`: toggle PCM mode (channel 2 only).

papers/format.md

@@ -248,7 +248,9 @@ size | description
   1  | feedback
   1  | fms
   1  | ams
-  1  | operator count (always 4)
+  1  | operator count
+     | - this is either 2 or 4, and is ignored on non-OPL systems.
+     | - always read 4 ops regardless of this value.
   1  | OPLL preset (>=60) or reserved
      | - 0: custom
      | - 1-15: pre-defined patches