Update the video settings documentation.

docs/interface/higan-config.md

@@ -17,66 +17,100 @@ This tab contains options that affect
 how higan displays
 the emulated console's video output.
 
-  - **Saturation**: adjusts the vibrancy of colours displayed,
+**Color Adjustment**
+settings adjust the colour and brightness
+of the emulated console's video output:
+
+  - **Saturation** adjusts the vibrancy of colours displayed,
     where 0% makes things pure grey,
     100% is normal,
     and 200% is garishly brightly coloured.
-  - **Gamma**: adjusts how bright mid-range colours are
+  - **Gamma** adjusts how bright mid-range colours are
     compared to the brightest colours,
     where 100% is normal,
     and 200% makes mid-range colours much darker.
-  - **Luminance**: adjusts the overall brightness,
+  - **Luminance** adjusts the overall brightness,
     where 100% is normal,
     and 0% is totally black.
-  - **Overscan Mask**: hides parts of
+
-    the video output that would have been hidden
+**Overscan Mask**
-    by the bezel around the edge of
+removes parts of
-    a standard-definition television screen.
+the video output that would have been hidden
-    Some games (particularly on the Famicom)
+by the bezel around the edge of
-    displayed random glitchy output in this area,
+a standard-definition television screen.
-    which can be distracting.
+
-    The units are "pixels in the emulated console's standard video-mode".
+  - **Horizontal**
-    For example, setting "Horizontal" to 8
+    removes pixels from the left and right of the video output.
-    will clip 8/256ths from the left and right sides
+  - **Vertical**
-    of the Super Famicom's video output,
+    removes pixels from the top and bottom of the video output.
-    whether the Super Famicom is in
+
-    lo-res (256px) or hi-res (512px)
+Some games (particularly on the Famicom)
-    mode.
+displayed random glitchy output in this area,
-  - **Aspect Correction**:
+which can be distracting.
-    (in both Windowed Mode and Fullscreen Mode)
+The units are "pixels in the emulated console's standard video-mode".
+For example, setting "Horizontal" to 8
+will clip 8/256ths from the left and right sides
+of the Super Famicom's video output,
+whether the Super Famicom is in
+lo-res (256px) or hi-res (512px)
+mode.
+
+**Windowed Mode**
+settings apply when higan is running
+in a normal window.
+
+  - **Aspect Correction**
     stretches the image to match the aspect ratio
     produced by the original console hardware,
-    but can cause a "ripple" effect,
+    but can cause a "ripple" effect
+    during horizontal scrolling,
     due to rounding errors.
-  - **Resize Window to Viewport**:
+    [Video shaders](../guides/shaders.md)
-    (under "Windowed mode")
+    can reduce this effect.
-    causes higan to resize its window
+  - **Integral Scaling**
-    to fit snugly around the emulated console's video
+    makes higan draw the emulated video output
-    whenever it changes size:
+    at a whole-number multiple of the original size,
-    because a game was loaded for a different console
+    rather than completely filling the available space.
-    with a different display size or aspect ratio,
+    This means that every game pixel
-    because the "Overscan Mask" controls were adjusted,
+    uses the same number of computer pixels,
-    because the game switched to a different video mode,
+    and avoids graphics looking chunky and uneven.
-    because the user pressed the "Rotate Display" hotkey,
+    Note that Aspect Correction
-    etc.
+    is applied after integral scaling,
-    When this option is disabled,
+    so some unevenness may be visible
-    the higan window stays at a fixed size,
+    even with this option enabled.
-    large enough to contain the video for any supported console,
+  - **Adaptive Sizing**
-    padded with black borders for all smaller video modes.
+    automatically resizes the higan window
-  - **Resize Viewport to Window**:
+    to fit snugly around the emulated video output
-    (under "Fullscreen mode")
+    whenever it changes size
-    causes higan to stretch the emulated console's video output
+    (because the user loaded a game for a different console,
-    to touch the edges of the screen.
+    chose a different option from
-    Since most screens are not an exact multiple
+    the [Video Scale submenu](higan.md#the-settings-menu),
-    of the size of all emulated consoles,
+    toggled Aspect Correction, etc.)
-    this may cause a "ripple" effect,
+    When disabled,
-    due to rounding errors.
+    higan generally respects manual resizing.
-    When this option is disabled,
+
-    higan stretches the emulated console's video output
+**Fullscreen Mode**
-    to the largest exact multiple
+settings apply
-    of the emulated console's video output
+when higan was started with the `--fullscreen`
-    that is smaller than or equal to the screen size.
+[command-line option](higan-cli.md)
-  - TODO: Update this to match 103r11, or whatever the latest version is.
+or when the user pressed
+the Toggle Fullscreen [hotkey](higan-config.md#hotkeys).
+
+  - **Aspect Correction**
+    behaves the same way as in Windowed mode above.
+  - **Integral Scaling**
+    behaves the same way as in Windowed mode above.
+  - **Exclusive Mode**
+    requests exclusive access
+    to the computer's video output
+    when higan enters fullscreen mode.
+    This prevents other applications
+    or the operating system itself
+    from drawing anything,
+    and may also temporarily disable any kind of compositing.
+    As of v104,
+    only the Direct3D driver is capable of exclusive mode;
+    with other drivers this option does nothing.
 
 Audio
 =====