Sampler

With the Sampler you can load, record and modify short audio clips (up to 5 seconds) to play live or programmatically with the sequencer.

Play view

The main view contains four buttons, each of which representing one audio clip. The icon inside each button indicates what you can do with the relative clip if you press the button (so it indicates the future state), while its color represents the current state of the clip. There are three possible states, each one matching one shape and one color.

State	Shape	Color
Stopped		GREY
Playing		GREEN
Recording		RED

So for example, if a button's icon is a grey triangle, the relative clip is currently not playing (because it's grey), but it will start if you press the button (because it's a triangle). If a button has a grey square, it means that no clip is assigned to it.

The state of the clip buttons depends on the global mode, selectable through the ARM button in the control view. There are three modes: Play, Arm-Clip and Arm-Sequencer. You can switch between the first and the third modes by tapping the ARM button. While you're holding it, you are in the Arm-Clip mode.

Play (the ARM button is blue). Clips are playable. You'll use this mode most of the time. How to play clips is described below.
Arm-Clip (the ARM button is red). Clips are recordable, that is you can resample the audio coming out from the previous module and store it to a clip. The recording starts when the clip button is pushed and ends when it is released. However, if before releasing the clip button you exit the Arm-Clip mode (i.e. by releasing the ARM button), then the recording will end when the clip button will be pushed again. The maximum length of a recording is 5 seconds. Successive recordings on the same clip will overwrite the last recording.
Arm-Sequencer (the ARM button is orange). Clips are playable just as in Play mode; additionally, the sequence will be automatically quantized and recorded. In order to erase the sequence of a clip, drag and drop the ARM button onto the relative clip button. You can also erase the sequence of multiple clips at once, by dragging the ARM button over them and releasing the finger back onto the ARM button. After erasing a sequence the module will still be in the Arm-Sequencer mode.

While you're holding the ARM button, a popup will appear, allowing you to specify the length of the sequence loop (1, 2, 3 or 4 bars). Drag and drop your finger to the relative button to set the desired length. After specifying the loop length through the popup, the module is always set in the Arm-Sequencer mode.

Every clip can be assigned to one of the following launch modes, which determine the behavior of the clip buttons in Play (and Arm-Sequencer) mode. You can change the launch mode of a clip by touching the relative button with two fingers. Alternatively you can set it from the edit clip panel described below.

Normal (no loop). Pushing the clip button will trigger the sample and it will play until it has been completely executed.
Loop-hold Pushing the clip button (displaying an empty loop icon) will trigger the sample and it will play in loop (when the execution reaches the end of the recording it restarts from the beginning) until you release the button.
Loop-toggle. Pushing the clip button (displaying a full loop icon) will trigger the sample and it will loop until you push it again. In addiction, this launch mode automatically plays a looping clip as soon as a new recording for such clip has ended.

The other button of the control view is the MUTE button, with which you can mute the execution of the sequences of the clips. By pressing it you can toggle the mute temporarily. If you want to make the change persistent, touch the button and drag the finger away.

Back view

By tapping on the top area you can change the label that will appear on the front view. Through the four central buttons you can assign each clip to a choke group represented by a number. Clips sharing the same choke group can't ever be playing simultaneously. When a clip triggers, it will automatically stop all the other clips of the same choke group. The choke group 0 is special because while any clip of this group is playing, the audio input is muted.
The back view contains also two more buttons that open the "edit clip panel" and the "sequencer".

Edit clip panel

Through this panel you can manage various properties of the clips.
At the top, four buttons allow you to manage their source, which can be a file or the pasteboard. In particular, by pressing "Load kit", you can load a set of four audio files, along with other per-clip parameters described below. "Load clip" lets you load a file for the clip that is currently selected with the selection buttons in the center of the panel. The other buttons on the top are to copy and paste an audio file for the currently selected clip.
From the bottom area of this panel you can set various properties of the currently selected clip: gain, pan, launch mode and reverse mode.
Note: while loading a clip, you can preview the audio files in the browser with the effects of the clip properties and the quantization that are currently specified.
To exit from this panel just touch the bottom area.

Sequencer

This panel allows you to program a sequence for triggering the clips.
On the top there are four pattern buttons, each one representing one pattern to be played in exactly one bar, i.e. 16 sixteenths. By default only the first pattern is active (i.e. to be executed), but you can change the number of patterns to be played by double tapping the relative button. For example if you double tap the fourth button, the sequencer will execute all the four patterns in order. The light of each button will turn green when the relative pattern is being played.
When you press a pattern button, the relative sequence pattern is displayed in the step button matrix below. Every row of the matrix corresponds to a clip, and every column corresponds to a step, i.e. one sixteenth. You can drag your finger around the matrix to toggle the triggering of the clips at the various steps.
You can copy a pattern by dragging the source pattern button to the destination pattern button.
You can rotate the active patterns by dragging to the left or to the right the double-arrowed bar on the bottom.
To exit from this panel just touch its bottom right corner.