Charlatan³ Quick Guide (WIP)
============================

General
=======

Most UI controls support fine adjustment by holding Shift and resetting to default value either via double-click or Ctrl-click.

Oscillators
===========

Each of the two (dual) oscillator blocks consists of two "base" oscillators which can be combined via various ways of cross-modulation (Xmod).

Click on the waveform display to edit the shape. There are two modes: Line editor and Harmonics editor which can be switched via the button at the top left of the waveform editor.

"Ratio" sets the tuning of an oscillator relative to the voice's base pitch.

"D" button bypasses filters and routes the oscillator signal directly to the master FX section.
Unison button on the right side activates unison for that oscillator.

Harmonics Editor
----------------

The vertical bars indicate the amplitude of the first 16 partials (fundamental plus 15 overtones).
The switch below each bar allows you to switch the polarity of the corresponding sine wave.

Filters
=======

There are two filters with three routing configurations:

- Serial: both oscillators are routed to Filter 1, which is fed into Filter 2
- Parallel: both oscillators are routed to both filters, and the mix of both filter outputs is routed to the master
- Dual: Osc 1 is routed to Filter 1, Osc 2 is routed to Filter 2, and the mix of both filter outputs is routed to the master

Modulation
==========

Click any of the eight tab headers in the middle of the UI to show the editor page of one of the 4 modulation generators (top row) and 4 modulation Xformers (bottom row).

After selecting a mod generator tab, click the header label again to select a modulator type from a dropdown menu.

Create a new modulation by dragging the "horseshoe" icon next to a source onto a modulatable parameter. Most, but not all synth parameters can be modulated.

Right-click on a parameter control (modulation target) to open a window with a list of active modulations for that parameter. You can add or delete modulations, or adjust the modulation depth.
Click on a hoershoe icon next to a modulation source to open a window of active modulations for that source.

Oscillator modulation
---------------------

For pitch and phase, the modulation targets "Osc Pitch" and "Osc Phase" are shared across all four base oscillators. The "S"-shaped icon next to the controls allows activating modulation for a particular base oscillator.

MSEG editor
-----------

Double-click on a line segment to create a new breakpoint.
Alternatively, Ctrl-click anywhere besides a breakpoint to create a new breakpoint.
Ctrl-click on a breakpoint to delete it.
Click-drag on line segment to alter its curvature.
Click-drag on background to zoom / pan viewport.
