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

poke~ Reference

Write sample values to a buffer by index

poke~

Description

poke~ allows you to write samples into a buffer~ at sample locations specified by a signal.

Examples

Write into a buffer~ using either signals or numbers

Arguments

buffer-object-name [symbol]

Obligatory. Names the buffer~ where poke~ will write its incoming samples.

channel-number [int]

Optional

Sets the channel number of a multichannel buffer~ where the samples will be written. The default channel is 1.

Attributes

Common Box Attributes

Messages

int

Arguments

value/sample-index [int]
In left inlet: Converted to float.

In middle inlet: Sets the sample index for writing subsequent sample values coming in the left inlet. If there is a signal connected to this inlet, a float is ignored.

float

Arguments

value/sample-index/channel-number [float]
Like the peek~ object, poke~ can write float values into a buffer~. Note, however, that the left two inlets are reversed on the poke~ object compared to the peek~ object.

In left inlet: Sets the value to be written into the buffer~ at the specified sample index. If the sample index is not -1, the value is written.

In middle inlet: Converted to int.

In right inlet: Converted to int.

list

Arguments

value, sample-index, and channel-number [list]
In left inlet: A list of two or more values will write the first value at the sample index specified by the second value. If a third value is present, it specifies the audio channel within the buffer~ for writing the sample value.

(mouse)

Double-clicking on poke~ opens an editing window where you can view the contents of its associated buffer~ object.

set

Arguments

buffer-object-name [symbol]
The word set, followed by the name of a buffer~, changes the buffer~ where poke~ will write its incoming samples.

signal

In left inlet: Signal values you want to write into a buffer~.

In middle inlet: The sample index where values from the signal in the left inlet will be written. If the signal coming into the middle inlet has a value of -1, no samples are written.

See Also

Name Description
Working with Video in Jitter Working with Video in Jitter
buffer~
buffir~
peek~