Sound#

Module: plupy · obtained from plupy.data.sounds[...], .new(name), .import_file(path)

A Sound. Its settings are props (sound.volumeDb, sound.loop, …); keyzones map other Sounds over ranges of notes (a drum kit: one zone per hit with pitch=False; a multisample: zones with pitch on).

class Sound(DataBlock)

Inherits DataBlock: its members are documented there.

Usage and examples

Members: zones · add_zone · set_zone · remove_zone

zones#

zones   # read-only

Each keyzone as a dict: id, sample (a Sound), keyLow, keyHigh, root, pitch, velocityLow, velocityHigh, tuneCents, volumeDb, group.

add_zone#

add_zone(sample=None, *, keys='C-0', to=None, pitch=True, root='', **values)

Add a keyzone playing sample over notes keys..to (just keys when to is omitted; every note by default). values: velocity_low, velocity_high, tune_cents, volume_db, group. Returns its id.

set_zone#

set_zone(zone, name, value)

Change one setting of a keyzone by id (keys as note strings, sample as a Sound).

remove_zone#

remove_zone(zone)

Remove a keyzone by id.

DataBlock

Source#