chucker~
Max for Live Reference
Open Help

chucker~

Segment audio and reorder it on looped playback

Description

chucker~ takes a specified amount of audio data, stores the data in an internal buffer, divides the buffered data into equal sections, and allows the sections to be reordered on playback.

Examples

Arguments

buffer-size-in-ms [int]

An optional integer argument can be used to set the number of milliseconds to allocate for the recorded sound. (e.g. an argument of 8000 will allocate enough memory for a stereo output of 8 seconds)
Note: The actual allocation will be larger than what is specified by the argument, since the chucker~ object supports two buffers and provides for double-buffering.

Attributes

Common Box Attributes

annotation [symbol]

Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.

background [int] (default: 0)

Adds or removes the object from the patcher's background layer. background 1 adds the object to the background layer, background 0 removes it. Objects in the background layer are shown behind all objects in the default foreground layer.

color [4 floats]

Sets the color for the object box outline.

fontface [int]

Sets the type style used by the object. The options are:

plain
bold
italic
bold italic

Possible values:

0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'

fontname [symbol]

Sets the object's font.

fontsize [float]

Sets the object's font size (in points).

Possible values:

'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'

hidden [int] (default: 0)

Toggles whether an object is hidden when the patcher is locked.

hint [symbol]

Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.

ignoreclick [int] (default: 0)

Toggles whether an object ignores mouse clicks in a locked patcher.

patching_rect [4 floats] (default: 0. 0. 100. 0.)

Sets the position and size of the object in the patcher window.

position [2 floats]

g/s(set)

Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.

presentation [int] (default: 0)

Sets whether an object belongs to the patcher's presentation.

presentation_rect [4 floats] (default: 0. 0. 0. 0.)

Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.

rect [4 floats]

g/s(set)

Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).

size [2 floats]

g/s(set)

Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.

textcolor [float]

Sets the color for the object's text in RGBA format.

textjustification [int]

Text Justification

Possible values:

0 = 'left'
1 = 'center'
2 = 'right'

varname [symbol]

Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.

Messages

directions

Arguments

direction-specifier [list]
The word directions , followed by a 1 or 2 to indicate left or right channel and a list of integer values whose length is equal to the number of steps, sets the direction of playback for the sections. Playback direction is specified as follows:

1: forward (the default)
0: mute
-1: reverse

fademode

Arguments

mode [int]
Sets the fade method for segment smoothing. Modes include:
0: Classic (same as Max 5)
1: Pre-fade (fades use buffered audio, fade executes prior to segment transition)
2: Post-fade (fades use buffered audio, fade executes after segment transition)

freeze

Arguments

buffer-segment [int]
The message freeze 1 causes the current buffer segment to loop on playback. Sending the message freeze 0 resumes normal playback.

nstep

Arguments

number-of-steps [int]
The word nsteps , followed by an integer in the range 1 - 64, sets the number of equal portions into which the chucker~ object's internal buffer is segmented for playback.

signal

In left inlet: Left channel audio input.
In middle inlet: Right channel audio input.
In right inlet: An audio signal in the range 0. - 1.0 provides the audio sync input. This task is typically done using a phasor~ object's output as input.

smooth

Arguments

smooth-amount [float]
The word smooth , followed by a floating point number in the range 0. - 1.0, sets an amount of smoothing (crossfading) between the individual segments being reordered for playback.

steps

Arguments

channel and range [list]
The word steps , followed by a 1 or 2 to indicate left or right channel and a list of integer values whose range is between 1 and the number of steps and whose length is equal to the number of steps, sets the order of playback for the sections.
e.g. the message steps 1 4 3 2 1, steps 2 1 2 3 4 , when sent to a chucker~ object whose number of steps is set to 4, will play the four left channel segments in reverse order, and the right channel in regular order. order

See Also

Name Description
buffer~ Store audio samples
groove~ Variable-rate looping sample playback