coll
Description
Allows for the storage, organization, editing, and retrieval of different messages.
Examples
Arguments
name [symbol]
Determines the named context of the coll object. All coll objects that share the same name share their contents. When a patch containing a named coll is loaded, Max will search for a file that matches the name; if found, the file is automatically loaded.
no-search [any]
An optional nonzero value as a second argument will prevent the coll object from searching for a file with the named symbol.
Attributes
embed [int]
Toggles the ability to embed the contents of the coll as part of the main. This value can only be set using the Save Data with Patcher setting in the Object Inspector. The default behavior is 0 (don't save the data with the patch).
precision [int]
The number of decimal places for converted floating point values (default = 6).
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.
adds the object to the background layer, 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.
jspainterfile [symbol]
JS Painter File
patching_rect [4 floats] (default: 0. 0. 100. 0.)
Sets the position and size of the object in the patcher window.
position [2 floats]
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]
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]
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 [4 floats]
Sets the color for the object's text in RGBA format.
textjustification [int]
Sets the justification for the object's text.
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
bang
int
Arguments
float
Arguments
list
Arguments
data [list]
anything
Arguments
assoc
Arguments
data index [int]
clear
(mouse)
deassoc
Arguments
data index [int]
delete
Arguments
dump
end
filetype
Arguments
flags
Arguments
unused [int]
goto
Arguments
insert
Arguments
data [list]
insert2
Arguments
data [list]
length
max
Arguments
merge
Arguments
data [list]
min
Arguments
next
nstore
Arguments
association [symbol]
data [list]
nsub
Arguments
position [int]
data [any]
nth
Arguments
position [int]
open
prev
read
Arguments
readagain
refer
Arguments
remove
Arguments
renumber
Arguments
renumber2
Arguments
separate
Arguments
sort
Arguments
entry (-1, 0, or 1) [int]
The second argument specifies what data is used to sort the contents. If the second argument is , the index (either number or symbol) associated with the data is used. If the second argument is not present or is , the first item in the data is used. If the second argument is or greater, that data elements is used for the sorting order.
start
store
Arguments
data [list]
sub
Arguments
position [int]
data [list]
subsym
Arguments
old name [symbol]
swap
Arguments
index [int]
symbol
Arguments
wclose
write
Arguments
writeagain
Output
anything
Messages stored in coll are sent out the 1st outlet. If the message consists of only a single symbol, it will be preceded by the word when it is sent out.
bang
Out 3rd outlet: Sent out when coll has finished reading in a file of data.
Out 4th outlet: Sent out when coll has finished sending all of the stored addresses and messages in order out the 1st and 2nd outlets in response to a message.
int
Out 1st outlet: The number of messages contained in coll is sent out in response to the message.
int or symbol
Out 2nd outlet: The address is sent out whenever a message out the 1st outlet is triggered by
, , , , or .See Also
Name | Description |
---|---|
bag | Store a collection of numbers |
itable | Data table editor |
jit.cellblock | Edit rows and columns of data |
table | Store and edit an array of numbers |
funbuff | Store pairs of numbers |
Max Basic Tutorial 18: Data Collections | Max Basic Tutorial 18: Data Collections |
Max Data Tutorial 3: Gesture Capture | Max Data Tutorial 3: Gesture Capture |
External Text Editor | External Text Editor |