Line 266:
Line 266:
<br clear=all>
<br clear=all>
−
====Tips====
−
You can press the Layer switch to step over the layer list. If you bold-press, the layer list screen will be shown.
−
Press the Back switch to return to previous screen. If you press bold-Back, you will go 2 screens backwards.
+
==MIDI-learning==
+
+
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 CC====
+
[[File:Zynthian_ui_midi_cc_learn_01.png|400px|right]]
+
[[File:Zynthian_ui_midi_cc_learn_02.png|400px|right]]
+
You can map any parameter in the Zynthian UI to a CC knob/slider on your external MIDI controller. I intend to extend this feature to other MIDI messages, but currently only CC messages are supported. Until then, MIDI-filter rules can be used instead.
+
+
Learning a MIDI-CC is quite easy:
+
+
'''1.''' From the control screen, you click the snapshot button. You will be in CC MIDI-learn screen. It’s identical to the Control screen except that all the controllers have a tiny yellow “???” in the bottom.
+
+
'''2.''' Move a zynthian controller. Its tiny “???” will change to green while the other 3 will go back to normal state.
+
+
'''3.''' Finally, move a knob/fader in your MIDI keyboard/controller and the binding is done. The new CC number should appear in the bottom of the learned controller, replacing the tiny "???".
+
+
Of course, MIDI-learning configuration, including CC mappings, is stored and restored with snapshots.
+
+
'''Technical Note:''' MIDI-CC learning works with all the engines. It uses the engine’s native MIDI-learning capabilities when available. Zynthian’s MIDI-filter mappings are used for the rest. To be more explicit, native MIDI-learning is used for MOD-UI and ZynAddSubFX OSC parameters. All the other parameters are managed by Zynthian’s MIDI-filter mapping.
+
+
<br clear=all>
+
+
====MIDI Program Change====
+
[[File:Zynthian_ui_midi_zs3_learn.png|400px|right]]
+
You can map "SubSnapshots" (ZS3) to MIDI programs. The idea behind this feature is to have a fast preset-change mechanism that can be used on stage. In combination with the “Single Layer” feature, it turns Zynthian in a “Stage-Beast”. You can prepare a snapshot for the full performance, and use ZS3 for fast changing from a song to another, or between parts inside the same song.
+
+
Learning a SubSnapShot is obscenely easy:
+
+
'''1.''' From the control screen, you click the snapshot button '''twice'''. You will see the current list of ZS3s and a message: “Waiting for Program Change…”
+
+
'''2.''' Simply push a “Program Change” button in your keyboard/controller and the ZS3 will be stored in memory, associated with the Program number you send.
+
+
After that, you can recall any stored ZS3 by simply pushing the same PC button again. Of course, the memory-stored zs3s will be saved with your snapshot and restored when loaded again.
+
+
Every zs3 includes:
+
+
- Layer ID
+
- Bank
+
- Preset
+
- Controller values
+
+
As you can see, it has sense in a SnapShot context, where a set of layers are defined. Zs3 changing is very fast, as no engine have to be started.
<br clear=all>
<br clear=all>
Line 382:
Line 422:
= Touch Screen UI=
= Touch Screen UI=
[[File:Zynthian_ui_top_bar.png|400px|right]]
[[File:Zynthian_ui_top_bar.png|400px|right]]
−
You can navigate and control the Zynthian UI without knobs/encoders/switches at all, using only the touchscreen.
+
You can navigate and control the Zynthian UI without knobs/encoders/switches at all, using only the touchscreen (or mouse).
You can "emulate" the switches by tapping the controller widgets (squares in the 4 corners of the screen). There are short, bold and long actions, same behaviour than rotary encoders work-flow. The only screen having the 4 controller widgets is the "Instrument Control" screen. Most of screens are selectors, which only have 1 controller widget. On those screens you can click the '''zynthian logo''' (top-right) to emulate the "snapshot" switch, and you can go back by tapping the '''top-bar''' area.
You can "emulate" the switches by tapping the controller widgets (squares in the 4 corners of the screen). There are short, bold and long actions, same behaviour than rotary encoders work-flow. The only screen having the 4 controller widgets is the "Instrument Control" screen. Most of screens are selectors, which only have 1 controller widget. On those screens you can click the '''zynthian logo''' (top-right) to emulate the "snapshot" switch, and you can go back by tapping the '''top-bar''' area.
Line 388:
Line 428:
You can change the controller values by "sliding" up/down over the widgets. (see the green arrow in the figure) This is the same as turning the knob. If you are using a mouse, the mouse wheel also can be used to change the controller value.
You can change the controller values by "sliding" up/down over the widgets. (see the green arrow in the figure) This is the same as turning the knob. If you are using a mouse, the mouse wheel also can be used to change the controller value.
−
<br clear=all>
−
−
=MIDI-learning=
−
−
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 CC====
−
[[File:Zynthian_ui_midi_cc_learn_01.png|400px|right]]
−
[[File:Zynthian_ui_midi_cc_learn_02.png|400px|right]]
−
You can map any parameter in the Zynthian UI to a CC knob/slider on your external MIDI controller. I intend to extend this feature to other MIDI messages, but currently only CC messages are supported. Until then, MIDI-filter rules can be used instead.
−
−
Learning a MIDI-CC is quite easy:
−
−
'''1.''' From the control screen, you click the snapshot button. You will be in CC MIDI-learn screen. It’s identical to the Control screen except that all the controllers have a tiny yellow “???” in the bottom.
−
−
'''2.''' Move a zynthian controller. Its tiny “???” will change to green while the other 3 will go back to normal state.
−
−
'''3.''' Finally, move a knob/fader in your MIDI keyboard/controller and the binding is done. The new CC number should appear in the bottom of the learned controller, replacing the tiny "???".
−
−
Of course, MIDI-learning configuration, including CC mappings, is stored and restored with snapshots.
−
−
'''Technical Note:''' MIDI-CC learning works with all the engines. It uses the engine’s native MIDI-learning capabilities when available. Zynthian’s MIDI-filter mappings are used for the rest. To be more explicit, native MIDI-learning is used for MOD-UI and ZynAddSubFX OSC parameters. All the other parameters are managed by Zynthian’s MIDI-filter mapping.
−
−
<br clear=all>
−
−
====MIDI Program Change====
−
[[File:Zynthian_ui_midi_zs3_learn.png|400px|right]]
−
You can map "SubSnapshots" (ZS3) to MIDI programs. The idea behind this feature is to have a fast preset-change mechanism that can be used on stage. In combination with the “Single Layer” feature, it turns Zynthian in a “Stage-Beast”. You can prepare a snapshot for the full performance, and use ZS3 for fast changing from a song to another, or between parts inside the same song.
−
−
Learning a SubSnapShot is obscenely easy:
−
−
'''1.''' From the control screen, you click the snapshot button '''twice'''. You will see the current list of ZS3s and a message: “Waiting for Program Change…”
−
−
'''2.''' Simply push a “Program Change” button in your keyboard/controller and the ZS3 will be stored in memory, associated with the Program number you send.
−
−
After that, you can recall any stored ZS3 by simply pushing the same PC button again. Of course, the memory-stored zs3s will be saved with your snapshot and restored when loaded again.
−
−
Every zs3 includes:
−
−
- Layer ID
−
- Bank
−
- Preset
−
- Controller values
−
−
As you can see, it has sense in a SnapShot context, where a set of layers are defined. Zs3 changing is very fast, as no engine have to be started.
<br clear=all>
<br clear=all>
====MIDI-CC Learning with a touch interface====
====MIDI-CC Learning with a touch interface====
−
−
First, you need a working touch interface in your display. If you don't have a touchscreen, you could use a mouse.
[[File:Zynthian_ui_midi_learning.png|400px|right]]
[[File:Zynthian_ui_midi_learning.png|400px|right]]