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. |