Overview Clamps Packages CM Dictionary Clamps Dictionary Fomus
Next: play-buffer-stretch-out* , Previous: play-buffer-stretch-env-pan-out* , Up: P , Home: Overview

Clamps Dictionary

play-buffer-stretch-env-vbap-bus-out

Function

(play-buffer-stretch-env-vbap-bus-out &rest optional-keywords &aux (#:lambda-list '((buffer (incudine-missing-arg "buffer") (amp 0) (transp 0) (start 0) (end 0) (onset-stretch 1) (stretch 1) (wwidth 137) (attack 0) (release 0.01) (azi 0.5) (ele 0) (spread 0) (dur nil) (busnum 0) (vbap *vbap*) (done-action #'free) (gate 1) id head tail before after replace action stop-hook free-hook fade-time fade-curve))))

Play buffer to a multichannel bus, using 2 window overlap add granular stretching/transposition with env between start and end, amp in dB, transposition transp, stretch and grain window size wwidth, attack and release. Output will be distributed to the channels of the bus starting at busnum using vbap/mdap with azi, ele and spread. The number of channels is the number of speakers of vbap. All other keywords of incudine dsps also apply. Works with any block size.

The speaker gains are calculated in the rt-thread at the start of the note and whenever azi, ele or spread change, using vbap as scratch space. Don't use the same vbap struct in dsps calculating their gains in the nrt-thread (like vbap-bus).

Arguments

buffer Incudine Buffer.
amp Positive Number denoting amplitude in dB. The dB range [-100..0] is mapped to the linear range [0..1].
transp Number denoting transposition in Midicents.
start Number denoting the start in seconds into the buffer (at buffer rate).
end Number denoting the end in seconds into the buffer (at buffer rate). Zero denotes end of buffer.
onset-stretch Positive Number denoting the (frozen-at-onset) time stretching factor used to compute the note's total duration.
stretch Positive Number denoting the live, settable time stretching factor of playback (may change while the note plays).
wwidth Positive Number denoting granular window width in msecs.
attack Non negative Number denoting the attack time in seconds.
release Non negative Number denoting the release time in seconds. The release starts at the end of the duration minus release or when gate is set to 0.
azi Number denoting the azimuth. 0.5 is front (0 degrees), 0.25 is -90 degrees, 0 and 1 are back (180 degrees). Values outside [0..1] wrap around.
ele Number denoting the elevation, clipped to [0..1] and mapped to [0..90] degrees (3D setups only).
spread Number denoting the spread, clipped to [0..1] and mapped to [0..100] degrees.
dur Duration in seconds overriding start/end, resulting in a looping playback between start and end for the duration.
busnum Non Negative Integer denoting the first channel of the bus.
vbap Initialized Vbap Struct. Defaults to *​​vbap​​*.
done-action Function to be called with the node as argument at the end.
gate 1 = playing, 0 = stop.

Author: Orm Finnendahl

Created: 2026-11-14 Sa 14:46

Validate