Home | Forum | User Documentation | Developer Documentation

Machine View

The machine view helps creating and structuring plugins in a graph.

Working with plugins

Working with plugin groups

Creating plugins

There are several ways to add new plugins to a song.

  1. Go to the All Machines view by pressing shift+F3, or from the main menu, View -> All Machines. Plugins listed in this hierarchy can be dragged into the machine view.
  2. Right click in the machine view background and select a plugin from "New" in the popup menu.
  3. Right click an existing effect plugin and select a plugin from either the "Replace", "Insert Before" or "Insert After" popup menus.
  4. Right click in a connection triangle and select a plugin from "Insert" in the popup menu.
  5. Click somewhere in the background and start typing, or click on a connection and start typing to insert.

Connecting plugins

To connect any two plugins, hold down shift and click and drag from the plugin you want to create a connection. While dragging and holding the mouse over a plugin, a popup menu shows which types of connections can be created.

The types of connections are:

Connection type Connection data Connection requirements
Audio connection Multi-channel, 32-bit floating point audio data Source plugin has zzub_plugin_flag_has_audio_output.

Target plugin has zzub_plugin_flag_has_audio_input.

Click and drag on the connection triangle to adjust the volume on all channels.
MIDI connection MIDI messages Source plugin has zzub_plugin_flag_has_midi_output.

Target plugin has zzub_plugin_flag_has_midi_input and exposes at least one virtual MIDI device.

Event connection Parameter values mapped 1:1 from a list of parameter bindings Source plugin has zzub_plugin_flag_has_event_output and at least one controller output parameter.

Target plugin needs no special flags. Only one or more parameters.

Click on the connection triangle to edit the current event parameter bindings.
Note connection Note messages consisting of note, wave index and amp Source plugin has zzub_plugin_flag_has_note_output.

Target plugin needs no special flags. Only one or more note parameter.

Background context menu

Right+click somewhere in the background to bring up a context menu:

New...: Creates a new plugin or plugins from a template. The plugin and template hierarchy displayed in the "New"-submenu is parsed from Gear/Templates/*.armz and Gear/index.txt. Plugins not listed in index.txt are placed in separate menus for "Unsorted Generators", "Unsorted Effects", "Unsorted Controllers", "Unsorted MIDI Effects", "Unsorted MIDI Generators" and "Unsorted Other Plugins".

Cut/Copy/Paste: Works with plugin selections on the clipboard.

Create new group: Creates a plugin group with stereo input/output.

Import song...: Import an existing .ARMZ from disk into the current project.

Unmute all machines: Yes.

Plugin context menu

Right+click a plugin or plugin selection to bring up its context menu:

Mute/Solo/Bypass: Toggles muting options.

Minimize/Unminimuze: Toggles plugin display size.

Hide Incoming: Toggles whether to hide incoming connection wires. Can help keeping the graph more tidy.

Parameters: Shows the plugin parameter view.

Properties: Shows plugin properties.

Cut/Copy: Works with plugin selections on the clipboard.

Delete: Deletes the plugin.

Smart Delete: Deletes the plugin and keeps existing connections between plugins before and after the deleted plugin.

Replace: Replaces the machine with another machine

Insert Before/Insert After: Creates a new machine on the connection before or after the selected plugin.

Render Output: Render the output of the selected plugin to disk or wavetable as fast as possible. Fails if the song has looping patterns causing the song to run infinitely.

Save Selection To File: Saves the selected plugins to an .ARMZ on disk. Similar to "Copy", but saves to disk instead of the clipboard.

Time Source: Sets the source of BPM/TPB and other timing info for the selected plugin. This is useful when a project plays patterns in different tempos at the same time. Plugins know only about a single tempo, so this setting decides what tempo a plugin should track for its internal calculations.

Create Full Pattern Format: Creates a new pattern format with all parameters from the selected plugin.

Create Simple Pattern Format: Creates a new pattern format with only note and velocity parameters from the selected plugin.

Connection context menu

Right+click on a connection triangle to bring up a context menu:

Disconnect <type>.: Disconnects the specific connection type.

Copy/Paste: Works with the audio connections volumes.

Insert...: Inserts a plugin here.

Properties: Shows connection properties. For setting up the range of audio channels transfered between the source and target plugins.