Sampler Node
A sample playback node with pitch shifting, loop controls, and MIDI triggering for incorporating audio files into your plugin.
Overview
| Property | Value |
|---|---|
| Category | Generators |
| Version | 1 |
| Inputs | MIDI |
| Outputs | L, R (audio) |
Parameters
Playback
| Parameter | Range | Default | Description |
|---|---|---|---|
| Volume | -inf - +12dB | 0dB | Output level |
| Pan | -100% - +100% | 0% | Stereo position |
| Pitch | -24 - +24 semitones | 0 | Pitch shift |
Region
| Parameter | Range | Default | Description |
|---|---|---|---|
| Start | 0% - 100% | 0% | Sample start position |
| End | 0% - 100% | 100% | Sample end position |
| Loop | On/Off | Off | Enable looping |
Loading Samples
Samples are loaded through the Content Manager:
- Click the sample slot in the Inspector
- Choose from your content library or import a new file
- Supported formats: WAV, AIFF, MP3, FLAC
Samples are stored with your project and can be synced to the cloud.
MIDI Control
The Sampler responds to MIDI input:
| MIDI Message | Function |
|---|---|
| Note On | Trigger sample playback |
| Note Off | Stop playback (if not looping) |
| Velocity | Controls volume |
| Pitch | Transposes from root note |
Root Note
The sample’s root note determines which MIDI note plays the sample at original pitch. Notes above or below transpose accordingly.
Visualizer
The Audio Level Visualizer shows:
- Output level meters
- Playback position indicator
Tips
- Use Start/End to trim samples without editing the file
- Enable Loop for sustained sounds or textures
- Apply pitch shifting for creative effects
- Connect MIDI from Input node for host-triggered playback
- Use with LFO modifiers for animated playback
Content Persistence
When you load a sample, Plugin Builder stores a Content ID reference. This ensures:
- Samples persist across sessions
- Cloud sync works correctly
- Exported plugins include the sample
See Projects & Sync for more on content management.
Example Uses
One-Shot Sample
- Load a drum hit or sound effect
- Loop: Off
- Trigger via MIDI
Ambient Texture
- Load a long ambient recording
- Loop: On
- Set Start/End to isolate a section
- Automate Pitch with an LFO
Pitched Instrument
- Load a single note recording
- Set correct root note
- Play chromatically via MIDI