RNBO Objects & Operators splat~
Open Help

splat~

Mix values into a buffer with linear interpolated overdubbing

Description

splat~ can write values to buffer~ by overdubbing or mixing incoming samples into the current buffer. Real-time mixing can be achieved by specifying a mix amount into the fourth inlet of splat~ . Mixed inputs can also be accumulated and bounded by setting the overdub mode to accum and changing the boundmode, allowing for various types of waveshaping. These functions are applied to both of the two nearest sample values proportionally, according to which is nearer.

When dealing with a multichannel buffer, splat~ 's write channel can be modularized using its third inlet.

Arguments

buffername [symbol]

Names the buffer~ object containing the sample to be used by splat~ for writing samples.

Inlets

value [auto]

Set the sample value to write at a specified position in the buffer

position [auto]

Set the sample position at which to write a specified value in the buffer

channel [auto]

Set the channel in which values are written in the buffer

overdub [auto]

Set the amount of the original signal to preserve

Fixed Attributes

These attributes must be set in the object box and determine the behavior of the object at runtime.

boundmode [enum] (default: wrap)

Set the bound mode for input sample values Possible values:

0 = 'fold'
1 = 'clamp'
2 = 'clip'
3 = 'wrap'
4 = 'mirror'
5 = 'ignore'

buffername [symbol]

Names the buffer~ object containing the sample to be used by splat~ for writing samples.

channelmode [enum] (default: wrap)

Set the bound mode for input channel values Possible values:

0 = 'fold'
1 = 'clamp'
2 = 'clip'
3 = 'wrap'
4 = 'mirror'
5 = 'ignore'

indexmode [enum] (default: samples)

Set the lookup mode for values in the buffer Possible values:

0 = 'phase'
1 = 'samples'
2 = 'signal'
3 = 'lookup'
4 = 'wave'

overdubmode [enum] (default: mix)

Set the overdub mode for mixing values into the buffer Possible values:

0 = 'mix'
1 = 'accum'

Dynamic Attributes

These attributes can be modified in the code during execution using the set object

buffer [number] (default: 0)

If multiple buffer names are declared to be used, this sets the currently active buffer using an index [0 based].

channel [auto]

Set the channel in which values are written in the buffer

overdub [auto]

Set the amount of the original signal to preserve

position [auto]

Set the sample position at which to write a specified value in the buffer

value [auto]

Set the sample value to write at a specified position in the buffer

See Also

Name Description
buffer~ A data buffer for holding audio (or potentially some other) data.
poke~ Write a sample into an audio buffer.
peek~ Read values from a buffer object.
record~ Record audio into a buffer.