record~
Record audio into a buffer.
Description
Fill/record to a sized buffer
Arguments
buffername [symbol]
The named buffer~ to lookup sample values from.
Inlets
record [auto]
In left inlet: Any non-zero number starts recording; 0 stops recording. Recording starts at the start point unless append mode is on.
input [signal]
In the inlet right to the leftmost inlet : this is where the signal is received to be recorded to the buffer~ .
begin [auto]
In the inlet left to the rightmost inlet : Begin determines the sample position (in ms) of the buffer~ where recording begins recording (default=0)
end [auto]
In the rightmost inlet : End point determines the sample position (in ms) of buffer~ when recording stops.default=0)
Outlets
sync [signal]
Outputs the current playback location samples, phase (0..1), or milliseconds depending on the syncmode attribute. Location is relative to the synctype attribute, which either scales the sync output to the current loop range or keeps it in the range of the buffer's length.
Fixed Attributes
These attributes must be set in the object box and determine the behavior of the object at runtime.
append [number] (default: 0)
Append to current recording when recording starts {default = 0}. When append is set to 0, A non-zero value in the left inlet of record~ will start recording into the buffer~ at the beginning of the buffer~. When append is set to 1, a non-zero value in the left inlet will start recording from the sample position where recording was previously stopped.
buffername [symbol]
The named buffer~ to lookup sample values from.
channels [number] (default: 1)
Set the number of channels to record into a buffer~ .
offset [number] (default: 0)
Setting an integer value for offset will increment or decrement the output of the channels read from the buffer~ (default = 0). For example, an integer value of 2 to the right inlet of lookup~ will read channel 1 from a buffer~ , and output the signal out the third outlet of channel 3. A negative integer value will decrement the offset value.
syncmode [enum] (default: phase)
Determines if the sync outlet reports phase (0..1), samples or milliseconds.
Possible values:
0 = 'phase'
1 = 'samples'
2 = 'ms'
synctype [enum] (default: relative)
Set the sync signal to be relative to the loop length or absolute to the clip length.
Possible values:
0 = 'relative'
1 = 'absolute'
Dynamic Attributes
These attributes can be modified in the code during execution using the set object
begin [auto]
In the inlet left to the rightmost inlet : Begin determines the sample position (in ms) of the buffer~ where recording begins recording (default=0)
buffer [number] (default: 0)
If multiple buffer names are declared to be used, this sets the currently active buffer using an index [0 based].
end [auto]
In the rightmost inlet : End point determines the sample position (in ms) of buffer~ when recording stops.default=0)
input [signal]
In the inlet right to the leftmost inlet : this is where the signal is received to be recorded to the buffer~ .
loop [number] (default: 0)
loop
record [auto]
In left inlet: Any non-zero number starts recording; 0 stops recording. Recording starts at the start point unless append mode is on.
reset [bang]
reset
See Also
| Name | Description |
|---|---|
| buffer~ | A data buffer for holding audio (or potentially some other) data. |
| splat~ | Mix values into a buffer with linear interpolated overdubbing |
| peek~ | Read values from a buffer object. |
| poke~ | Write a sample into an audio buffer. |