A newer version of Max is available. Click here to access the latest version of the Max documentation

record~ Reference

Record audio into a buffer.

record~

Examples

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.