//
// SUNVOX
// 2.1
//

=====================
PATTERN DRAWING TOOLS
=====================

Since v2.1, the pattern can be edited using the drawing tools.
To open the corresponding window, go to the pattern editor menu and select the "Draw" item.

The following tools are available:
  * draw with a brush in the specified columns";
  * draw Note OFF commands;
  * draw levels in the VV column; (after selecting this tool, the working column VV is set, but it can be changed to any other);
  * draw levels in the XXYY column; (after selecting this tool, the working column XXYY is set, but it can be changed to any other);
  * erase values in the specified columns;
  * erase values in all columns;
  * play and copy to brush (specified columns only).

All the tools described above work only when the pattern editing mode is active.

LEVELS are a graphical representation of the values in the selected column of the track.
Before v2.1 there was a menu item "XXYY levels drawing" in the pattern editor.
Since v2.1 this function has been moved to the pattern drawing tool window.

BRUSH is a piece of a pattern that can be used to draw on another pattern.
The currently active brush is stored in the on-screen musical keyboard.
In the simplest case, the brush is the last chord played on the keyboard. The notes of the first line of this brush will be highlighted in green on the keyboard.
To play/change/save/load the brush, increase the height of the keyboard and click the "+" button that appears on the left.

========
TOOLBARS
========

Toolbar 1 is the main horizontal divider with STOP and PLAY buttons.
Toolbar 2 is the second horizontal divider above the timeline.
Floating toolbar is the window that can be opened from the Main menu -> Toolbar.

Starting from v2.1 these panels can be customized (add/remove buttons).
To do this, go to the Main menu -> Preferences -> Toolbars.
Each toolbar is described by a string with the names of buttons and commands, separated by commas.
Commands < and > set the direction of adding buttons: from left to right or from right to left.
Available names:
  * < - switch the direction of adding buttons: from left to right (default);
  * > - switch the direction of adding buttons: from right to left;
  * play;
  * play2 - play from the beginning;
  * play3 - play pattern;
  * stop;
  * rec;
  * vol - volume;
  * svol - volume (short version);
  * lev - signal level indicator;
  * undo;
  * redo;
  * cut;
  * copy;
  * paste;
  * dup - duplicate;
  * bpm - BPM;
  * bpmtpl - BPM and TPL;
  * clock - current time;
  * cpu - CPU usage monitor;
  * cpu2 - CPU usage monitor (pressing will open a list of modules).

//
// SUNVOX
// 2.0
//

=======
CONTROL
=======

There are two modes in the main SunVox windows (pattern, modules, timeline): selection and navigation.
Left mouse button = selection or navigation (depending on the mode).
Middle mouse button = navigation.
The default on desktops is selection.
Navigation is the default on mobile devices.
If Main menu -> Preferences -> Interface -> Control type = "Fingers", then SunVox will work like on a mobile device.

What if you need navigation but there is no middle mouse button?
macOS:
  * CMD + left button;
  * or install some application to emulate the middle button, for example Middle.
All systems:
  * there is middle button emulation on some touchpads: using three-finger click or by simultaneously pressing the left and right buttons (see the system touchpad settings);
  * switch between editing modes using the button with a selection rectangle;
  * if there is no such button, uncomment one of the show_sel_btn options in sunvox_config.ini;

General rules for all devices:
  * pressing with the stylus or finger is equivalent to pressing the left mouse button;
  * double click in an empty area - create a new object (if possible);
  * double-clicking on an object opens its properties (if possible);
  * scroll wheel - zoom in or scroll up/down;
  * right mouse button = menu;
  * SHIFT + left button = connect modules or disable snapping to the timeline grid;
  * CTRL + left button = multiple selection mode (previous selection is not cleared);

===========
SUPERTRACKS
===========

Since SunVox 2.0 there are two timeline modes: classic (default) and supertrack mode.
In classic mode, all patterns are independent - each has its own tracks inside.
In supertrack mode, the patterns can complement each other (interact) if they are on the same supertrack. Each supertrack is a set of 32 tracks that can be used by multiple patterns at the same time.
In supertrack mode, you can enable the "don't turn off notes at the end of the pattern" option: one short pattern can turn notes on, and another (on the same supertrack) turn it off.

===============
MAKE METAMODULE
===============

The selected modules can be packed into one MetaModule (see the menu of the module editor).
But the modules must conform to the following topology: TT -> SEL( IN -> ... ) -> R
TT - signal sources (optional) outside the selection;
SEL() - selected modules to be packed;
IN - receiving module (optional) inside the selection; at most one;
... - any modules inside the selection;
R - receiver (optional) that receives signals from modules within the selection; at most one.

=======================
DIALOG WINDOW SHORTCUTS
=======================

Y or ENTER = first button on the left;
N = last button on the right;
ESC = cancel;
1...9 = buttons from left to right;