Subsystem

Subsample configuration: transform

The 5 settings under transform, each with the type, default and limits its schema declares.

Derived versions of samples that playback uses: pitch-shifted variants of tonal samples and time-stretched variants for quantise steps, held in memory and cached on disk.

max_memory_mb in transform

Type
number
Limits
above 0

Memory, in MB, for derived variants. When a new variant would go over it, Subsample drops every variant of the oldest sample together. When absent, it is a share of max_memory_mb.

auto_pitch in transform

Type
boolean
Default
true

Renders pitch-shifted variants of each tonal sample for every note in its assigned range ahead of time, with Rubber Band. Set false when rubberband-cli is not installed, or to render pitch when a note plays instead, at a higher CPU cost.

quantize_resolution in transform

Type
integer
Default
16
Limits
one of 1, 2, 4, 8, 16

Grid that stretch_quantize and pad_quantize snap onsets to when an assignment gives no grid:, as a note division: 1 for whole notes, 2 halves, 4 quarters, 8 eighths, and 16 sixteenths.

variant_cache_dir in transform

Type
string or null
Default
samples/variant-cache

Directory for the disk cache of derived variants, so they survive a restart. An empty value or null turns the disk cache off.

max_disk_mb in transform

Type
number

Disk space, in MB, for cached variant files. When the cache is full, Subsample deletes the least recently used files. 0 turns the disk cache off. When absent, it is sized from max_memory_mb.