Differences

This shows you the differences between two versions of the page.

--- ai:customising_modules [2018/10/13 20:07] – icke_siegen
+++ ai:customising_modules [2018/12/18 11:25] (current) – external edit 127.0.0.1
@@ Line 10: / Line 10: @@
   * ''Insert Empty Patch'' adds an empty patch, represented by a small grey rectangle. Doubble-click it to open it, or to 'fly' down into it.
   * ''Insert Patch File'' opens a file explorer in order to navigate to another patchfile which can be inserted here
-  * ''Insert Patch IO'' (subpatches only) inserts the module [[ai:modules:patch_io|]] which allows to route ports between patches.
+  * ''Insert Patch IO'' (subpatches only) inserts the module [[ai:modules:patch:patch_io]] which allows to route ports between patches.
   * ''Hide All Connections'' hides all already patched 'wires'. This is useful for patches with many connections. Even with the connections hidden, hovering the mouse over a port temporarily shows its connection(s).
   * ''Show All Connections'' makes all connections visible again.
@@ Line 23: / Line 23: @@
   * In order to select a group of modules/patches, draw a selection box around them (click in one corner, hold the mouse button, move diagonally for a reactangle, release mouse button)
   * In order to move the entire viewport of the patch window hold the spacebar pressed and drag the contents with the mouse, or - with nothing selected - repeatedly hit the arrow keys (up/down/left/right)
+  * ''Ctrl'' + ''A'' selects all items in this window
+  * ''Ctrl'' + ''D'' deselects all items
+  * ''Ctrl'' + ''G'' groups selected items into a subpatch, see [[#subpatches]] for details
 ==== Move ====
@@ Line 75: / Line 77: @@
   * some operations on control/port level cannot be made undone. The way back in that case is: left-click the module and select 'Load Default Skin' - but this really resets the entire thing. Hence be careful when adjusting/deleting controls and ports. Another - more subtle - way is left-click and 'Show Port' resp. 'Show Parameter' - but you need to know the name of the item you have deleted.
   * to change a label of a port or control, hold down ''Ctrl'' and double-click the label
-  * my absolute favourite: in order to resize a control (e.g. buttons, faders, text areas, dropdown lists) hold down ''Ctrl'', place the mouse close to the bottom or right edge of the control (close means: a few pixels away from it), and press the left mouse button. If you hit the right spot the cursor will show arrows and you can drag the edge in order to resize the control.
+  * my absolute favourite: in order to resize a control (e.g. buttons, faders, text areas, dropdown lists) hold down ''Ctrl'', place the mouse close to the bottom or right edge of the control (**close means: a few pixels away from it**), and press the left mouse button. If you hit the right spot the cursor will show arrows and you can drag the edge in order to resize the control.
 ===== The Control Context Menu =====
@@ Line 100: / Line 102: @@
   * ''Delete Control'' is another way to delete this control
+===== Subpatches =====
+Patches can be nested - a patch can contain any number of modules and other patches, which in turn may contain other modules and patches, and so forth. (I think I already made patches with 4 or 5 layers of nested patches). In such situations you need a way to route signals (ports) and commands (controls/parameters) from one patch to another. Of course Ai offers a neat way for this: [[ai:modules:patch:patch_io|Patch IO]].
+  * in the subpatch, insert ONE Patch IO module (each patch can contain only one such module). You can do this by right-click, ''Insert Module'', selecting it from the Patch section, or by right-click, ''Insert Patch IO''
+  * if you need to patch one port to the parent patch simply start to patch this port and drop the other end onto the Patch IO module. The port will immediately appear on the rectangle representing this patch in the parent patch. From there, you may patch as usual.
+  * if you need to patch a port in the parent patch to the nested patch simply start to patch this port and drop the other end onto the patch rectangle representing the subpatch. This port will subsequently appear in the Patch IO within the subpatch.
+  * in order to make controls (faders, buttons, dropdown lists, text areas etc.) available on the surface of this patch/in the parent patch, right-click the control and select ''Add to Parent Panel'' whereupon the control will magically appear on the rectangle representing the patch in the parent patch.
+There is a quick way to group modules and patches into a subpatch: ''Ctrl'' + ''G'' does this for you, and even adds a Patch IO and wires it if needed. Thus, simply select the modules and patches you want to be moved into a subpatch, and hit ''Ctrl'' + ''G''.