Zynthian UI User Guide (oldstable-2109) - Revision history

Wyleu: /* MIDI-learning */

2024-09-27T11:29:19Z

MIDI-learning

Wyleu: /* MIDI-learning */

2024-09-27T11:28:39Z

MIDI-learning

Jofemodo: Jofemodo moved page Zynthian UI Users Guide (oldstable-2109) to Zynthian UI User Guide (oldstable-2109)

2023-07-26T10:22:22Z

Jofemodo moved page Zynthian UI Users Guide (oldstable-2109) to Zynthian UI User Guide (oldstable-2109)

Jofemodo: Jofemodo moved page Zynthian UI Users Guide to Zynthian UI Users Guide (oldstable-2109): Bump to stable-2210

2022-11-01T18:45:36Z

Jofemodo moved page Zynthian UI Users Guide to Zynthian UI Users Guide (oldstable-2109): Bump to stable-2210

Riban: /* XY-Controller */

2022-08-26T17:39:36Z

XY-Controller

Riban: Update ZS3 learn instructions.

2022-06-06T08:10:32Z

Update ZS3 learn instructions.

Jofemodo: /* General Concepts */

2022-01-28T11:12:09Z

General Concepts

Jofemodo: /* Touchscreen Calibration */

2022-01-13T09:33:58Z

Touchscreen Calibration

Jofemodo: /* Touchscreen Calibration */

2022-01-13T09:32:59Z

Touchscreen Calibration

Riban: /* MIDI Program Change & ZS3 (SubSnapShots) */

2021-12-20T10:24:21Z

MIDI Program Change & ZS3 (SubSnapShots)

@@ Line 329: / Line 329: @@
 MIDI-learning allows you to easily bind specific MIDI events with Zynthian-UI actions. There are 2 types of MIDI events you can learn:
-Please bear in mind that in the case of USB connected MIDI devices the learnt settings will apply only to the specific USB Configuration in place at the time of learning. So if you add a USB hub to the rig the ZS3 subsnapshots won't act.
 ====MIDI CC====

← Older revision		Revision as of 11:28, 27 September 2024
Line 329:		Line 329:

	MIDI-learning allows you to easily bind specific MIDI events with Zynthian-UI actions. There are 2 types of MIDI events you can learn:		MIDI-learning allows you to easily bind specific MIDI events with Zynthian-UI actions. There are 2 types of MIDI events you can learn:
		+	Please bear in mind that in the case of USB connected MIDI devices the learnt settings will apply only to the specific USB Configuration in place at the time of learning. So if you add a USB hub to the rig the ZS3 subsnapshots won't act.

	====MIDI CC====		====MIDI CC====

@@ Line 295: / Line 295: @@
 From the instrument control screen, if you bold-press two knobs at once, you should enter the XY-select mode.
-The 2 controllers you pushed will be green, indicating they are pre-selected for XY-control. You can change the pre-selection by rotating any knob, navigating through the controller pages if needed.
+The 2 controllers you pushed will be green, indicating they are pre-selected for XY-control. You can change the pre-selection by rotating any knob. (The knob must be rotated through several values before it will be detected.) Use the ''select'' switch to navigate through the controller pages to select different controllers if needed.
 <br clear=all>

@@ Line 366: / Line 366: @@
 Learning to create a SubSnapShot is obscenely easy:
-'''1.''' From the Control screen, bold click the snapshot button to enter MIDI control learn mode then short click the snapshot button. You will see the current list of ZS3s (initially empty) and a message: “Waiting for Program Change…”
+'''0.''' Ensure "Program Change ZS3" is enabled in the admin menu.
 '''2.''' Push a “Program Change” button in your keyboard/controller and the ZS3 will be stored in memory, associated with the Program Number you pushed on your keyboard/controller.

@@ Line 2: / Line 2: @@
 =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]]
@@ Line 19: / Line 19: @@
 * '''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.
-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

← Older revision		Revision as of 09:33, 13 January 2022
Line 533:		Line 533:


−	{{NoteBox\| The resistive touchscreen works better with a stylus. Finger is too ~~“coarse”~~. It's strongly recommended to run the calibration using a stylus. }}	+	{{NoteBox\| The resistive touchscreen works better with a stylus. Finger is too coarse. It's strongly recommended to run the calibration using a stylus. }}

	<br clear=all>		<br clear=all>

← Older revision		Revision as of 09:32, 13 January 2022
Line 531:		Line 531:

	Use BACK button or wait for timeout to cancel calibration. Timer is reset to 15s when screen is touched and paused until released. The purpose of the timeout is to avoid users of Zynthians without back button being stuck in calibration screen view.		Use BACK button or wait for timeout to cancel calibration. Timer is reset to 15s when screen is touched and paused until released. The purpose of the timeout is to avoid users of Zynthians without back button being stuck in calibration screen view.
		+
		+
		+	{{NoteBox\| The resistive touchscreen works better with a stylus. Finger is too “coarse”. It's strongly recommended to run the calibration using a stylus. }}

	<br clear=all>		<br clear=all>