Docs for Pokémon mini, other bits.

Renamed the Pokémon mini doc to match internal name.

doc/7-systems/README.md

@@ -27,7 +27,7 @@ this is a list of sound chips that Furnace supports, including effects.
 - [PC Engine/TurboGrafx-16](pce.md)
 - [PC Speaker](pcspkr.md)
 - [Philips SAA1099](saa1099.md)
-- [Pokémon mini](pokemon.md)
+- [Pokémon mini](pokemini.md)
 - [Capcom QSound](qsound.md)
 - [Ricoh RF5C68](ricoh.md)
 - [SegaPCM](segapcm.md)

doc/7-systems/game-boy.md

@@ -2,7 +2,7 @@
 
 the Nintendo Game Boy is one of the most successful portable game systems ever made.
 
-with stereo sound, two pulse channels, a wave channel and a noise one it packed some serious punch.
+with stereo sound, two pulse channels, a wave channel and a noise channel, it packed some serious punch.
 
 # effects
 
@@ -20,3 +20,9 @@ with stereo sound, two pulse channels, a wave channel and a noise one it packed
   - `y` is the shift.
   - set to `0` to disable it.
 - `14xx`: **set sweep direction.** `0` is up and `1` is down.
+
+# links
+
+- [Gameboy sound hardware](https://gbdev.gg8.se/wiki/articles/Gameboy_sound_hardware) - detailed technical information
+
+- [GameBoy Sound Table](http://www.devrs.com/gb/files/sndtab.html) - note frequency table

doc/8-advanced/chanosc.md

@@ -1,16 +1,53 @@
 # oscilloscope (per channel)
 
-The "Oscilloscope (per channel)" dialog shows an individual oscilloscope for each channel during playback.
+the "Oscilloscope (per channel)" dialog shows an individual oscilloscope for each channel during playback.
 
 ![oscilloscope per-channel configuration view](chanosc.png)
 
-Right-clicking within the view will change it to the configuration view shown above:
-- **Columns**: Sets the number of columns the view will be split into.
-- **Size (ms)**: Sets what length of audio is visible in each oscilloscope.
-- **Center waveform**: Does its best to latch to the channel's note frequency and centers the display.
-- **Gradient**: (document this)
-- The color selector sets the waveform color. Right-clicking on it pops up an option dialog:
-  - Select between the square selector and the color wheel selector.
-  - **Alpha bar**: Adds a transparency selector.
-- The boxes below that are for selecting colors numerically by red-green-blue-alpha, hue-saturation-value-alpha, and HTML-style RGBA in hex.
-- The OK button returns from options view to regular.
+right-clicking within the view will change it to the configuration view shown above:
+- **Columns**: arranges oscilloscopes into this many columns.
+- **Size (ms)**: sets what length of audio is visible in each oscilloscope.
+- **Center waveform**: does its best to latch the waveform to the channel's note frequency and centers the display.
+- **Gradient**: see below.
+- the color selector sets the waveform color. right-clicking on it pops up an option dialog:
+  - select between the square selector and the color wheel selector.
+  - **Alpha bar**: adds a transparency selector.
+- the boxes below that are for selecting colors numerically by red-green-blue-alpha, hue-saturation-value-alpha, and HTML-style RGBA in hex.
+- **Text format**: this string determins what text is shown in the top-left of each oscilloscope. it can be any text, and the following shortcodes will be replaced with information about the channel:
+  - `%c`: channel name
+  - `%C`: channel short name
+  - `%d`: channel number (starting from 0)
+  - `%D`: channel number (starting from 1)
+  - `%i`: instrument name
+  - `%I`: instrument number (decimal)
+  - `%x`: instrument number (hex)
+  - `%s`: chip name
+  - `%S`: chip ID
+  - `%v`: volume (decimal)
+  - `%V`: volume (percentage)
+  - `%b`: volume (hex)
+  - `%%`: percent sign
+- The OK button returns from options view to the oscilloscopes.
+
+## gradient
+
+![oscilloscope per-channel gradient configuration view](chanosc-gradient.png)
+
+in this mode, the color selector is replaced by a square field onto which circular "stops" can be placed. each stop adds a soft circle of color. the resulting image is used to look up the oscilloscope color as determined by each axis.
+
+- right-click to place a stop.
+- left-click on a stop to change its color. the color selector is the same as above, with two additions:
+  - **Distance**: the size of the circle.
+  - **Spread**: the size of the solid center of the circle. increasing it fills more of the circle with the target color.
+
+- **Background**: sets background color for entire field.
+- **X Axis**: determines what the horizontal maps to, from left to right.\
+  **Y Axis**: determines what the vertical maps to, from bottom to top. these can be set to the following:
+  - **None (0%)**: stays at the left or bottom.
+  - **None (50%)**: stays at the center.
+  - **None (100%)**: stays at the right or top.
+  - **Frequency**: changes color with note frequency.
+  - **Volume**: changes color with volume.
+  - **Channel**: changes color based on channel number.
+  - **Brightness**: {{document this}}
+  - **Note Trigger**: changes color when a new note is played.