Changes

=General Concepts=

=General Concepts=

The Zynthian UI is displayed on a display and controlled by 4 knobs (rotary-encoders with push-switches). You can also control the UI with a touch-display, a mouse or a keyboard (computer keyboard or MIDI keyboard, both!)

The Zynthian UI is displayed on a display and controlled by 4 knobs with switches. You can also control the UI with a touch-display, a mouse or a keyboard (computer keyboard or MIDI keyboard, both!)

Anyway, the 4 knobs+switches are the primary control mechanism used to navigate the UI: selecting options on menus and adjust the instrument parameters. The knobs can act as assignable MIDI/OSC controllers for the instrument's parameters (frequently lots of them!). You can emulate the knob's behavior using the touch-display, but it's sub-optimal and accessing some features could be tricky.

The 4 knobs+switches are the primary control mechanism to navigate the UI: selecting options on menus and adjusting the instrument parameters. The knobs can act as assignable MIDI/OSC controllers for the instrument's parameters (frequently lots of them!). You can emulate the knob's behaviour using the touch-display, but it's sub-optimal and accessing some features could be tricky.

[[File:Zynthian v4 top legend.png|600px|center]]

[[File:Zynthian v4 top legend.png|600px|center]]

* '''Info Screen''': It displays info about an operation, like "Update Software", or "Network Info".

* '''Info Screen''': It displays info about an operation, like "Update Software", or "Network Info".

* '''Key Range & Transpose Screen''': It allows to choose the key range and transpose notes by octaves or semitones.

* '''Key Range & Transpose Screen''': It allows to choose the key range and transpose notes by octaves or semitones.

There are 3 types of clicks (push actions) that can be performed, depending on how long you hold down the knob (or hold your finger on the touch-display).

There are 3 types of push actions that can be performed, depending on how long you hold down the knob/button (or hold your finger on the touch-display).

* '''Short click:''' Less than 0.3 seconds

* '''Short push:''' Less than 0.3 seconds

* '''Bold click:''' Between 0.3 and 2 seconds

* '''Bold push:''' Between 0.3 and 2 seconds

* '''Long click:''' More than 2 seconds (until the long-action is triggered!)

* '''Long push:''' More than 2 seconds (until the long-action is triggered!)

These timing values are the default ones. You can adjust them to your personal feeling from the UI options on the webconf tool.

These timing values are the default ones. You can adjust them to your personal feeling from the webconf's UI options.

Click actions for each knob are context dependent. The SELECT knob is mainly used to navigate and a short click on it will select an item on a "Selector Screen". Inside a "Controller Screen", short clicks can be used to rotate between layers (LAYER knob) or between controller pages (SELECT knob). "Bold-clicks" are normally intended as shortcuts for jumping to specific screen like "layer options", "main menu", etc. Clicking the BACK knob generally jumps to the previous screen in the workflow sequence.

Some push actions depends of context. The SELECT knob is mainly used to navigate and a short push on it will select an item on a "Selector Screen". Inside a "Controller Screen", short pushes can be used to rotate between layers (LAYER knob) or between controller pages (SELECT knob). "Bold-pushes" are normally intended as shortcuts for jumping to specific screen like "layer options", "main menu", etc. Pushing the BACK knob generally close the current modal-screen or jumps to the previous screen in the workflow sequence.

Many actions depend of context (current screen), but there are some actions that are global and will always work (from any screen):

Although some push actions depend of context (current screen), there are some actions that are global and will work from any screen:

* '''Bold-Back''': Main Menu

* '''Bold-Back''': Main Menu