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

jit.buffer~

A matrix-friendly MSP buffer~

Description

Use jit.buffer~ to access buffer~ data in matrix form or write matrix data into a buffer~. Audio is represented in a float32 matrix with time across dim[0]. Multi-channel audio uses a separate plane for each channel. The object arguments are the same as those for the buffer~ object. jit.buffer~ responds to all the same messages as buffer~.

Arguments

Name Type Opt Description
buffer_name The name of the buffer~ to access
filename Optional filename to read
length Optional length in milliseconds
channels Optional number of channels (default=1)

Messages

anything Any message not specifically handled by the jit.buffer~ object will be passed along to its child buffer~ object.
(mouse) Double-clicking on a jit.buffer~ object opens a display window where you can view its contents.
getframes Outputs the number of frames.
getlength Outputs the length of the buffer~ in milliseconds.
output A float32 matrix containing the range of the buffer~ specified by the outputstart, outputlength, outputfirst and outputlast attributes will be output out the left outlet.
viz Outputs a visualization matrix from the second outlet. In opaque mode the matrix will be of type char and in statistical mode the matrix will be of type float32. In both modes each channel of audio results is mapped to a separate plane of the matrix.

Attributes

Name Type g/s Description
outputstart float The position in milliseconds to start collecting data from the buffer~ for an output matrix
outputlength float The length in milliseconds of the output matrix collected from the buffer~
outputfirst int Frame at which to start collecting data from the buffer~ for an output matrix
outputlast int Frame at which to finish collecting data from the buffer~ for an output matrix
inputstart float An input matrix will be written to the buffer~ starting at this position in milliseconds
inputfirst int An input matrix will be written to the buffer~ starting at this frame
vizwidth int The width of the visualization output matrix (default=320)
vizheight int The height of the visualization output matrix (default=160)
vizchecktime int How often in milliseconds the visualization engine should check the status of the buffer~ and re-render the cache if necessary (default=250)
vizmode int A value of 1 turns on opaque rendering mode. A value of 2 turns on statistical rendering mode, which has greater detail but is more expensive to render. A value of 0 turns off visualization and all background processing of cached speedup data. (default=0)
vizstart float The position in milliseconds to start the render of the visualization output matrix
vizlength float The length in milliseconds to render for the visualization output matrix
vizfirst int Frame at which to start render of the visualization output matrix
vizlast int Frame at which to end render of the visualization output matrix
vizmemoryratio float Specifies the size of the data cache used to speed up rendering of the visualization matrix as a fraction of the data size of the buffer~ (deault=0.5)

Information for box attributes common to all objects

Examples

See Also

Name Description
jit.catch~ Transforms signal data into matrices
jit.graph Floating-point data visualization
jit.peek~ Read matrix data as an audio signal
jit.poke~ Write an audio signal into a matrix
jit.release~ Transforms matrix data into signals
peek~ Read and write sample values
poke~ Write sample values to a buffer by index
Tutorial 48: Frames of MSP signals Tutorial 48: Frames of MSP signals