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 A (left) and B (right) which can be combined via various ways of cross-modulation (Xmod). If cross-modulation (ring modulation, phase modulation, frequency modulation) is engaged, Osc A acts as the carrier whereas Osc B takes the role of the modulator.

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.

Waveforms can be copied between oscillators by clicking on a waveform display and dragging it onto another Osc. By holding the Ctrl key while dragging, waveforms are swapped between both oscillators.

"Ratio" sets the tuning of an oscillator relative to the voice's base pitch. In Osc A, you can lower the ratio to 0.000, meaning that it won't play a sound on its own, but rather acts as a wave shaper / wave folder with the input signal based on the phase. Hence, ratio zero only makes sense if also activating PM or FM cross-modulation. The phase offset parameter of Osc A then defines the center point of the wave shaping transfer function. Note that inappropriate choice of Osc A waveform / phase offset may lead to a large d.c. offset in the output signal.

The Filter switch button (on the left below Amp pot) allows to route the oscillator signal directly to the master FX section, thereby bypassing the filters.
The 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.
Click-drag on background while holding Shift key to select multiple breakpoints.
Hit Delete or Backspace key to delete selected breakpoints.
