Attributes

An attribute of an object is a setting or property that tells the object how to do its job. More...

Data Structures
struct	t_attr
	Common attr struct. More...
Defines
#define	CLASS_ATTR_CHAR(c, attrname, flags, structname, structmember)   class_addattr((c),attr_offset_new(attrname,USESYM(char),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))
	Create a char attribute and add it to a Max class.
#define	CLASS_ATTR_LONG(c, attrname, flags, structname, structmember)   class_addattr((c),attr_offset_new(attrname,USESYM(long),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))
	Create a long integer attribute and add it to a Max class.
#define	CLASS_ATTR_FLOAT(c, attrname, flags, structname, structmember)   class_addattr((c),attr_offset_new(attrname,USESYM(float32),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))
	Create a 32-bit float attribute and add it to a Max class.
#define	CLASS_ATTR_DOUBLE(c, attrname, flags, structname, structmember)   class_addattr((c),attr_offset_new(attrname,USESYM(float64),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))
	Create a 64-bit float attribute and add it to a Max class.
#define	CLASS_ATTR_SYM(c, attrname, flags, structname, structmember)   class_addattr((c),attr_offset_new(attrname,USESYM(symbol),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))
	Create a t_symbol* attribute and add it to a Max class.
#define	CLASS_ATTR_ATOM(c, attrname, flags, structname, structmember)   class_addattr((c),attr_offset_new(attrname,USESYM(atom),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))
	Create a t_atom attribute and add it to a Max class.
#define	CLASS_ATTR_OBJ(c, attrname, flags, structname, structmember)   class_addattr((c),attr_offset_new(attrname,USESYM(object),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))
	Create a t_object* attribute and add it to a Max class.
#define	CLASS_ATTR_CHAR_ARRAY(c, attrname, flags, structname, structmember, size)   class_addattr((c),attr_offset_array_new(attrname,USESYM(char),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))
	Create an array-of-chars attribute of fixed length, and add it to a Max class.
#define	CLASS_ATTR_LONG_ARRAY(c, attrname, flags, structname, structmember, size)   class_addattr((c),attr_offset_array_new(attrname,USESYM(long),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))
	Create an array-of-long-integers attribute of fixed length, and add it to a Max class.
#define	CLASS_ATTR_FLOAT_ARRAY(c, attrname, flags, structname, structmember, size)   class_addattr((c),attr_offset_array_new(attrname,USESYM(float32),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))
	Create an array-of-32bit-floats attribute of fixed length, and add it to a Max class.
#define	CLASS_ATTR_DOUBLE_ARRAY(c, attrname, flags, structname, structmember, size)   class_addattr((c),attr_offset_array_new(attrname,USESYM(float64),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))
	Create an array-of-64bit-floats attribute of fixed length, and add it to a Max class.
#define	CLASS_ATTR_SYM_ARRAY(c, attrname, flags, structname, structmember, size)   class_addattr((c),attr_offset_array_new(attrname,USESYM(symbol),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))
	Create an array-of-symbols attribute of fixed length, and add it to a Max class.
#define	CLASS_ATTR_ATOM_ARRAY(c, attrname, flags, structname, structmember, size)   class_addattr((c),attr_offset_array_new(attrname,USESYM(atom),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))
	Create an array-of-atoms attribute of fixed length, and add it to a Max class.
#define	CLASS_ATTR_OBJ_ARRAY(c, attrname, flags, structname, structmember, size)   class_addattr((c),attr_offset_array_new(attrname,USESYM(object),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))
	Create an array-of-objects attribute of fixed length, and add it to a Max class.
#define	CLASS_ATTR_CHAR_VARSIZE(c, attrname, flags, structname, structmember, sizemember, maxsize)   class_addattr((c),attr_offset_array_new(attrname,USESYM(char),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))
	Create an array-of-chars attribute of variable length, and add it to a Max class.
#define	CLASS_ATTR_LONG_VARSIZE(c, attrname, flags, structname, structmember, sizemember, maxsize)   class_addattr((c),attr_offset_array_new(attrname,USESYM(long),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))
	Create an array-of-long-integers attribute of variable length, and add it to a Max class.
#define	CLASS_ATTR_FLOAT_VARSIZE(c, attrname, flags, structname, structmember, sizemember, maxsize)   class_addattr((c),attr_offset_array_new(attrname,USESYM(float32),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))
	Create an array-of-32bit-floats attribute of variable length, and add it to a Max class.
#define	CLASS_ATTR_DOUBLE_VARSIZE(c, attrname, flags, structname, structmember, sizemember, maxsize)   class_addattr((c),attr_offset_array_new(attrname,USESYM(float64),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))
	Create an array-of-64bit-floats attribute of variable length, and add it to a Max class.
#define	CLASS_ATTR_SYM_VARSIZE(c, attrname, flags, structname, structmember, sizemember, maxsize)   class_addattr((c),attr_offset_array_new(attrname,USESYM(symbol),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))
	Create an array-of-symbols attribute of variable length, and add it to a Max class.
#define	CLASS_ATTR_ATOM_VARSIZE(c, attrname, flags, structname, structmember, sizemember, maxsize)   class_addattr((c),attr_offset_array_new(attrname,USESYM(atom),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))
	Create an array-of-atoms attribute of variable length, and add it to a Max class.
#define	CLASS_ATTR_OBJ_VARSIZE(c, attrname, flags, structname, structmember, sizemember, maxsize)   class_addattr((c),attr_offset_array_new(attrname,USESYM(object),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))
	Create an array-of-objects attribute of variable length, and add it to a Max class.
#define	STRUCT_ATTR_CHAR(c, flags, structname, structmember)   CLASS_ATTR_CHAR(c,#structmember,flags,structname,structmember)
	Create a char attribute and add it to a Max class.
#define	STRUCT_ATTR_LONG(c, flags, structname, structmember)   CLASS_ATTR_LONG(c,#structmember,flags,structname,structmember)
	Create a long integer attribute and add it to a Max class.
#define	STRUCT_ATTR_FLOAT(c, flags, structname, structmember)   CLASS_ATTR_FLOAT(c,#structmember,flags,structname,structmember)
	Create a 32bit float attribute and add it to a Max class.
#define	STRUCT_ATTR_DOUBLE(c, flags, structname, structmember)   CLASS_ATTR_DOUBLE(c,#structmember,flags,structname,structmember)
	Create a 64bit float attribute and add it to a Max class.
#define	STRUCT_ATTR_SYM(c, flags, structname, structmember)   CLASS_ATTR_SYM(c,#structmember,flags,structname,structmember)
	Create a t_symbol* attribute and add it to a Max class.
#define	STRUCT_ATTR_ATOM(c, flags, structname, structmember)   CLASS_ATTR_ATOM(c,#structmember,flags,structname,structmember)
	Create a t_atom attribute and add it to a Max class.
#define	STRUCT_ATTR_OBJ(c, flags, structname, structmember)   CLASS_ATTR_OBJ(c,#structmember,flags,structname,structmember)
	Create a t_object* attribute and add it to a Max class.
#define	STRUCT_ATTR_CHAR_ARRAY(c, flags, structname, structmember, size)   CLASS_ATTR_CHAR_ARRAY(c,#structmember,flags,structname,structmember,size)
	Create an array-of-chars attribute of fixed length, and add it to a Max class.
#define	STRUCT_ATTR_LONG_ARRAY(c, flags, structname, structmember, size)   CLASS_ATTR_LONG_ARRAY(c,#structmember,flags,structname,structmember,size)
	Create an array-of-long-integers attribute of fixed length, and add it to a Max class.
#define	STRUCT_ATTR_FLOAT_ARRAY(c, flags, structname, structmember, size)   CLASS_ATTR_FLOAT_ARRAY(c,#structmember,flags,structname,structmember,size)
	Create an array-of-32bit-floats attribute of fixed length, and add it to a Max class.
#define	STRUCT_ATTR_DOUBLE_ARRAY(c, flags, structname, structmember, size)   CLASS_ATTR_DOUBLE_ARRAY(c,#structmember,flags,structname,structmember,size)
	Create an array-of-64bit-floats attribute of fixed length, and add it to a Max class.
#define	STRUCT_ATTR_SYM_ARRAY(c, flags, structname, structmember, size)   CLASS_ATTR_SYM_ARRAY(c,#structmember,flags,structname,structmember,size)
	Create an array-of-symbols attribute of fixed length, and add it to a Max class.
#define	STRUCT_ATTR_ATOM_ARRAY(c, flags, structname, structmember, size)   CLASS_ATTR_ATOM_ARRAY(c,#structmember,flags,structname,structmember,size)
	Create an array-of-atoms attribute of fixed length, and add it to a Max class.
#define	STRUCT_ATTR_OBJ_ARRAY(c, flags, structname, structmember, size)   CLASS_ATTR_OBJ_ARRAY(c,#structmember,flags,structname,structmember,size)
	Create an array-of-objects attribute of fixed length, and add it to a Max class.
#define	STRUCT_ATTR_CHAR_VARSIZE(c, flags, structname, structmember, sizemember, maxsize)   CLASS_ATTR_CHAR_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)
	Create an array-of-chars attribute of variable length, and add it to a Max class.
#define	STRUCT_ATTR_LONG_VARSIZE(c, flags, structname, structmember, sizemember, maxsize)   CLASS_ATTR_LONG_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)
	Create an array-of-long-integers attribute of variable length, and add it to a Max class.
#define	STRUCT_ATTR_FLOAT_VARSIZE(c, flags, structname, structmember, sizemember, maxsize)   CLASS_ATTR_FLOAT_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)
	Create an array-of-32bit-floats attribute of variable length, and add it to a Max class.
#define	STRUCT_ATTR_DOUBLE_VARSIZE(c, flags, structname, structmember, sizemember, maxsize)   CLASS_ATTR_DOUBLE_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)
	Create an array-of-64bit-floats attribute of variable length, and add it to a Max class.
#define	STRUCT_ATTR_SYM_VARSIZE(c, flags, structname, structmember, sizemember, maxsize)   CLASS_ATTR_SYM_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)
	Create an array-of-symbols attribute of variable length, and add it to a Max class.
#define	STRUCT_ATTR_ATOM_VARSIZE(c, flags, structname, structmember, sizemember, maxsize)   CLASS_ATTR_ATOM_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)
	Create an array-of-atoms attribute of variable length, and add it to a Max class.
#define	STRUCT_ATTR_OBJ_VARSIZE(c, flags, structname, structmember, sizemember, maxsize)   CLASS_ATTR_OBJ_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)
	Create an array-of-objects attribute of variable length, and add it to a Max class.
#define	STATIC_ATTR_CHAR(c, attrname, flags, val)   STATIC_ATTR_FORMAT(c,attrname,USESYM(char),flags,"c",val)
	Create a shared (static/global) char attribute and add it to a Max class.
#define	STATIC_ATTR_LONG(c, attrname, flags, val)   STATIC_ATTR_FORMAT(c,attrname,USESYM(long),flags,"l",val)
	Create a shared (static/global) long integer attribute and add it to a Max class.
#define	STATIC_ATTR_FLOAT(c, attrname, flags, val)   STATIC_ATTR_FORMAT(c,attrname,USESYM(float32),flags,"f",val)
	Create a shared (static/global) 32bit float attribute and add it to a Max class.
#define	STATIC_ATTR_DOUBLE(c, attrname, flags, val)   STATIC_ATTR_FORMAT(c,attrname,USESYM(float64),flags,"d",val)
	Create a shared (static/global) 64bit float attribute and add it to a Max class.
#define	STATIC_ATTR_SYM(c, attrname, flags, val)   STATIC_ATTR_FORMAT(c,attrname,USESYM(symbol),flags,"s",val)
	Create a shared (static/global) t_symbol* attribute and add it to a Max class.
#define	STATIC_ATTR_ATOM(c, attrname, flags, val)   STATIC_ATTR_FORMAT(c,attrname,USESYM(atom),flags,"a",val)
	Create a shared (static/global) t_atom attribute and add it to a Max class.
#define	STATIC_ATTR_OBJ(c, attrname, flags, val)   STATIC_ATTR_FORMAT(c,attrname,USESYM(object),flags,"o",val)
	Create a shared (static/global) t_object* attribute and add it to a Max class.
#define	STATIC_ATTR_CHAR_ARRAY(c, attrname, flags, count, vals)   STATIC_ATTR_FORMAT(c,attrname,USESYM(char),flags,"C",count,vals)
	Create a shared (static/global) array-of-chars attribute of fixed length, and add it to a Max class.
#define	STATIC_ATTR_LONG_ARRAY(c, attrname, flags, count, vals)   STATIC_ATTR_FORMAT(c,attrname,USESYM(long),flags,"L",count,vals)
	Create a shared (static/global) array-of-long-integers attribute of fixed length, and add it to a Max class.
#define	STATIC_ATTR_FLOAT_ARRAY(c, attrname, flags, count, vals)   STATIC_ATTR_FORMAT(c,attrname,USESYM(float32),flags,"F",count,vals)
	Create a shared (static/global) array-of-32bit-floats attribute of fixed length, and add it to a Max class.
#define	STATIC_ATTR_DOUBLE_ARRAY(c, attrname, flags, count, vals)   STATIC_ATTR_FORMAT(c,attrname,USESYM(float64),flags,"D",count,vals)
	Create a shared (static/global) array-of-64bit-floats attribute of fixed length, and add it to a Max class.
#define	STATIC_ATTR_SYM_ARRAY(c, attrname, flags, count, vals)   STATIC_ATTR_FORMAT(c,attrname,USESYM(symbol),flags,"S",count,vals)
	Create a shared (static/global) array-of-symbols attribute of fixed length, and add it to a Max class.
#define	STATIC_ATTR_ATOM_ARRAY   STATIC_ATTR_ATOMS
	Create a shared (static/global) array-of-atoms attribute of fixed length, and add it to a Max class.
#define	STATIC_ATTR_OBJ_ARRAY(c, attrname, flags, count, vals)   STATIC_ATTR_FORMAT(c,attrname,USESYM(object),flags,"O",count,vals)
	Create a shared (static/global) array-of-objects attribute of fixed length, and add it to a Max class.
#define	OBJ_ATTR_CHAR(x, attrname, flags, val)   OBJ_ATTR_FORMAT(x,attrname,USESYM(char),flags,"c",val)
	Create an instance-local char attribute and add it to a Max class.
#define	OBJ_ATTR_LONG(x, attrname, flags, val)   OBJ_ATTR_FORMAT(x,attrname,USESYM(long),flags,"l",val)
	Create an instance-local long integer attribute and add it to a Max class.
#define	OBJ_ATTR_FLOAT(x, attrname, flags, val)   OBJ_ATTR_FORMAT(x,attrname,USESYM(float32),flags,"f",val)
	Create an instance-local 32bit float attribute and add it to a Max class.
#define	OBJ_ATTR_DOUBLE(x, attrname, flags, val)   OBJ_ATTR_FORMAT(x,attrname,USESYM(float64),flags,"d",val)
	Create an instance-local 64bit float attribute and add it to a Max class.
#define	OBJ_ATTR_SYM(x, attrname, flags, val)   OBJ_ATTR_FORMAT(x,attrname,USESYM(symbol),flags,"s",val)
	Create an instance-local t_symbol* attribute and add it to a Max class.
#define	OBJ_ATTR_ATOM(x, attrname, flags, val)   OBJ_ATTR_FORMAT(x,attrname,USESYM(atom),flags,"a",val)
	Create an instance-local t_atom attribute and add it to a Max class.
#define	OBJ_ATTR_OBJ(x, attrname, flags, val)   OBJ_ATTR_FORMAT(x,attrname,USESYM(object),flags,"o",val)
	Create an instance-local t_object* attribute and add it to a Max class.
#define	OBJ_ATTR_CHAR_ARRAY(x, attrname, flags, count, vals)   OBJ_ATTR_FORMAT(x,attrname,USESYM(char),flags,"C",count,vals)
	Create an instance-local array-of-chars attribute of fixed length, and add it to the object.
#define	OBJ_ATTR_LONG_ARRAY(x, attrname, flags, count, vals)   OBJ_ATTR_FORMAT(x,attrname,USESYM(long),flags,"L",count,vals)
	Create an instance-local array-of-long-integers attribute of fixed length, and add it to the object.
#define	OBJ_ATTR_FLOAT_ARRAY(x, attrname, flags, count, vals)   OBJ_ATTR_FORMAT(x,attrname,USESYM(float32),flags,"F",count,vals)
	Create an instance-local array-of-32bit-floats attribute of fixed length, and add it to the object.
#define	OBJ_ATTR_DOUBLE_ARRAY(x, attrname, flags, count, vals)   OBJ_ATTR_FORMAT(x,attrname,USESYM(float64),flags,"D",count,vals)
	Create an instance-local array-of-64bit-floats attribute of fixed length, and add it to the object.
#define	OBJ_ATTR_SYM_ARRAY(x, attrname, flags, count, vals)   OBJ_ATTR_FORMAT(x,attrname,USESYM(symbol),flags,"S",count,vals)
	Create an instance-local array-of-symbols attribute of fixed length, and add it to the object.
#define	OBJ_ATTR_ATOM_ARRAY   OBJ_ATTR_ATOMS
	Create an instance-local array-of-atoms attribute of fixed length, and add it to the object.
#define	OBJ_ATTR_OBJ_ARRAY(x, attrname, flags, count, vals)   OBJ_ATTR_FORMAT(x,attrname,USESYM(object),flags,"O",count,vals)
	Create an instance-local array-of-objects attribute of fixed length, and add it to the object.
#define	CLASS_ATTR_ACCESSORS(c, attrname, getter, setter)
	Specify custom accessor methods for an attribute.
#define	CLASS_ATTR_ADD_FLAGS(c, attrname, flags)
	Add flags to an attribute.
#define	CLASS_ATTR_REMOVE_FLAGS(c, attrname, flags)
	Remove flags from an attribute.
#define	CLASS_ATTR_FILTER_MIN(c, attrname, minval)
	Add a filter to the attribute to limit the lower bound of a value.
#define	CLASS_ATTR_FILTER_MAX(c, attrname, maxval)
	Add a filter to the attribute to limit the upper bound of a value.
#define	CLASS_ATTR_FILTER_CLIP(c, attrname, minval, maxval)
	Add a filter to the attribute to limit both the lower and upper bounds of a value.
#define	CLASS_ATTR_ALIAS(c, attrname, aliasname)
	Create a new attribute that is an alias of an existing attribute.
#define	CLASS_ATTR_DEFAULT(c, attrname, flags, parsestr)   { t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"default",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }
	Add a new attribute to the specified attribute to specify a default value.
#define	CLASS_ATTR_SAVE(c, attrname, flags)   CLASS_ATTR_ATTR_PARSE(c,attrname,"save",USESYM(long),flags,"1")
	Add a new attribute to the specified attribute to indicate that the specified attribute should be saved with the patcher.
#define	CLASS_ATTR_DEFAULT_SAVE(c, attrname, flags, parsestr)   { CLASS_ATTR_DEFAULT(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); }
	A convenience wrapper for both CLASS_ATTR_DEFAULT and CLASS_ATTR_SAVE.
#define	CLASS_ATTR_DEFAULTNAME(c, attrname, flags, parsestr)   { t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"defaultname",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }
	Add a new attribute to the specified attribute to specify a default value, based on Max's Object Defaults.
#define	CLASS_ATTR_DEFAULTNAME_SAVE(c, attrname, flags, parsestr)   { CLASS_ATTR_DEFAULTNAME(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); }
	A convenience wrapper for both CLASS_ATTR_DEFAULTNAME and CLASS_ATTR_SAVE.
#define	CLASS_ATTR_MIN(c, attrname, flags, parsestr)   { t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"min",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }
	Add a new attribute to the specified attribute to specify a lower range.
#define	CLASS_ATTR_MAX(c, attrname, flags, parsestr)   { t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"max",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }
	Add a new attribute to the specified attribute to specify an upper range.
#define	CLASS_ATTR_PAINT(c, attrname, flags)   CLASS_ATTR_ATTR_PARSE(c,attrname,"paint",USESYM(long),flags,"1")
	Add a new attribute indicating that any changes to the specified attribute will trigger a call to the object's paint method.
#define	CLASS_ATTR_DEFAULT_PAINT(c, attrname, flags, parsestr)   { CLASS_ATTR_DEFAULT(c,attrname,flags,parsestr); CLASS_ATTR_PAINT(c,attrname,flags); }
	A convenience wrapper for both CLASS_ATTR_DEFAULT and CLASS_ATTR_PAINT.
#define	CLASS_ATTR_DEFAULT_SAVE_PAINT(c, attrname, flags, parsestr)   { CLASS_ATTR_DEFAULT(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); CLASS_ATTR_PAINT(c,attrname,flags); }
	A convenience wrapper for CLASS_ATTR_DEFAULT, CLASS_ATTR_SAVE, and CLASS_ATTR_PAINT.
#define	CLASS_ATTR_DEFAULTNAME_PAINT(c, attrname, flags, parsestr)   { CLASS_ATTR_DEFAULTNAME(c,attrname,flags,parsestr); CLASS_ATTR_PAINT(c,attrname,flags); }
	A convenience wrapper for CLASS_ATTR_DEFAULTNAME, CLASS_ATTR_SAVE, and CLASS_ATTR_PAINT.
#define	CLASS_ATTR_DEFAULTNAME_SAVE_PAINT(c, attrname, flags, parsestr)   { CLASS_ATTR_DEFAULTNAME(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); CLASS_ATTR_PAINT(c,attrname,flags); }
	A convenience wrapper for CLASS_ATTR_DEFAULTNAME, CLASS_ATTR_SAVE, and CLASS_ATTR_PAINT.
#define	CLASS_ATTR_STYLE(c, attrname, flags, parsestr)   CLASS_ATTR_ATTR_PARSE(c,attrname,"style",USESYM(symbol),flags,parsestr)
	Add a new attribute to the specified attribute to specify an editor style for the Max inspector.
#define	CLASS_ATTR_LABEL(c, attrname, flags, labelstr)   CLASS_ATTR_ATTR_FORMAT(c,attrname,"label",USESYM(symbol),flags,"s",gensym(labelstr))
	Add a new attribute to the specified attribute to specify an a human-friendly label for the Max inspector.
#define	CLASS_ATTR_ENUM(c, attrname, flags, parsestr)   { CLASS_ATTR_STYLE(c,attrname,flags,"enum"); CLASS_ATTR_ATTR_PARSE(c,attrname,"enumvals",USESYM(atom),flags,parsestr); }
	Add a new attribute to the specified attribute to specify a list of choices to display in a menu for the Max inspector.
#define	CLASS_ATTR_ENUMINDEX(c, attrname, flags, parsestr)   { CLASS_ATTR_STYLE(c,attrname,flags,"enumindex"); CLASS_ATTR_ATTR_PARSE(c,attrname,"enumvals",USESYM(atom),flags,parsestr); }
	Add a new attribute to the specified attribute to specify a list of choices to display in a menu for the Max inspector.
#define	CLASS_ATTR_CATEGORY(c, attrname, flags, parsestr)   CLASS_ATTR_ATTR_PARSE(c,attrname,"category",USESYM(symbol),flags,parsestr)
	Add a new attribute to the specified attribute to specify a category to which the attribute is assigned in the Max inspector.
#define	CLASS_ATTR_STYLE_LABEL(c, attrname, flags, stylestr, labelstr)   { CLASS_ATTR_ATTR_PARSE(c,attrname,"style",USESYM(symbol),flags,stylestr); CLASS_ATTR_ATTR_FORMAT(c,attrname,"label",USESYM(symbol),flags,"s",gensym(labelstr)); }
	A convenience wrapper for CLASS_ATTR_STYLE, and CLASS_ATTR_LABEL.
#define	CLASS_ATTR_INVISIBLE(c, attrname, flags)   CLASS_ATTR_ATTR_PARSE(c,attrname,"invisible",USESYM(long),flags,"1")
	Add a new attribute to the specified attribute to flag an attribute as invisible to the Max inspector.
#define	CLASS_ATTR_ORDER(c, attrname, flags, parsestr)   CLASS_ATTR_ATTR_PARSE(c,attrname,"order",USESYM(long),flags,parsestr)
	Add a new attribute to the specified attribute to specify a default order in which to list attributes.
#define	CLASS_METHOD_ATTR_PARSE(c, methodname, attrname, type, flags, parsestring)
	Define and add attributes to class methods.
#define	OBJ_ATTR_DEFAULT(x, attrname, flags, parsestr)   { t_object *theattr=(t_object *)object_attr_get(x,gensym(attrname)); OBJ_ATTR_ATTR_PARSE(x,attrname,"default",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }
	An instance-attribute version of CLASS_ATTR_DEFAULT.
#define	OBJ_ATTR_SAVE(x, attrname, flags)   OBJ_ATTR_ATTR_PARSE(x,attrname,"save",USESYM(long),flags,"1")
	An instance-attribute version of CLASS_ATTR_SAVE.
#define	OBJ_ATTR_DEFAULT_SAVE(x, attrname, flags, parsestr)   { OBJ_ATTR_DEFAULT(x,attrname,flags,parsestr); OBJ_ATTR_SAVE(x,attrname,flags); }
	An instance-attribute version of CLASS_ATTR_DEFAULT_SAVE.
#define	CLASS_STICKY_ATTR(c, name, flags, parsestr)   { t_object *attr = attribute_new_parse(name,NULL,flags,parsestr); class_sticky(c,gensym("sticky_attr"),gensym(name),attr); }
	Create an attribute, and add it to all following attribute declarations.
#define	CLASS_STICKY_ATTR_CLEAR(c, name)   class_sticky_clear(c,gensym("sticky_attr"),name?gensym(name):NULL)
	Close a CLASS_STICKY_ATTR block.
#define	CLASS_STICKY_METHOD(c, name, flags, parsestr)   { t_object *attr = attribute_new_parse(name,NULL,flags,parsestr); class_sticky(c,gensym("sticky_method"),gensym(name),attr); }
	Create an attribute, and add it to all following method declarations.
#define	CLASS_STICKY_METHOD_CLEAR(c, name)   class_sticky_clear(c,gensym("sticky_method"),name?gensym(name):clear)
	Close a CLASS_STICKY_METHOD block.
#define	CLASS_ATTR_RGBA(c, attrname, flags, structname, structmember)
	Create a color (t_jrgba) attribute and add it to a Max class.
Enumerations
enum	e_max_attrflags {   ATTR_FLAGS_NONE = 0x0000000,   ATTR_GET_OPAQUE = 0x00000001,   ATTR_SET_OPAQUE = 0x00000002,   ATTR_GET_OPAQUE_USER = 0x00000100,   ATTR_SET_OPAQUE_USER = 0x00000200,   ATTR_GET_DEFER = 0x00010000,   ATTR_GET_USURP = 0x00020000,   ATTR_GET_DEFER_LOW = 0x00040000,   ATTR_GET_USURP_LOW = 0x00080000,   ATTR_SET_DEFER = 0x01000000,   ATTR_SET_USURP = 0x02000000,   ATTR_SET_DEFER_LOW = 0x04000000,   ATTR_SET_USURP_LOW = 0x08000000 }
	Attribute flags. More...
Functions
void *	object_attr_get (void *x, t_symbol *attrname)
	Returns the pointer to an attribute, given its name.
method	object_attr_method (void *x, t_symbol *methodname, void **attr, long *get)
	Returns the method of an attribute's get or set function, as well as a pointer to the attribute itself, from a message name.
long	object_attr_usercanset (void *x, t_symbol *s)
	Determines if an object's attribute can be set from the Max interface (i.e.
long	object_attr_usercanget (void *x, t_symbol *s)
	Determines if the value of an object's attribute can be queried from the Max interface (i.e.
void	object_attr_getdump (void *x, t_symbol *s, long argc, t_atom *argv)
	Forces a specified object's attribute to send its value from the object's dumpout outlet in the Max interface.
t_max_err	object_attr_setvalueof (void *x, t_symbol *s, long argc, t_atom *argv)
	Sets the value of an object's attribute.
t_max_err	object_addattr (void *x, t_object *attr)
	Attaches an attribute directly to an object.
t_max_err	object_deleteattr (void *x, t_symbol *attrsym)
	Detach an attribute from an object that was previously attached with object_addattr().
t_max_err	object_chuckattr (void *x, t_symbol *attrsym)
	Detach an attribute from an object that was previously attached with object_addattr().
long	attr_args_offset (short ac, t_atom *av)
	Determines the point in an atom list where attribute arguments begin.
void	attr_args_process (void *x, short ac, t_atom *av)
	Takes an atom list and properly set any attributes described within.
t_object *	attribute_new (char *name, t_symbol *type, long flags, method mget, method mset)
	Create a new attribute.
t_object *	attr_offset_new (char *name, t_symbol *type, long flags, method mget, method mset, long offset)
	Create a new attribute.
t_object *	attr_offset_array_new (char *name, t_symbol *type, long size, long flags, method mget, method mset, long offsetcount, long offset)
	Create a new attribute.
long	object_attr_getlong (void *x, t_symbol *s)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setlong (void *x, t_symbol *s, long c)
	Sets the value of an attribute, given its parent object and name.
float	object_attr_getfloat (void *x, t_symbol *s)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setfloat (void *x, t_symbol *s, float c)
	Sets the value of an attribute, given its parent object and name.
t_symbol *	object_attr_getsym (void *x, t_symbol *s)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setsym (void *x, t_symbol *s, t_symbol *c)
	Sets the value of an attribute, given its parent object and name.
long	object_attr_getlong_array (void *x, t_symbol *s, long max, long *vals)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setlong_array (void *x, t_symbol *s, long count, long *vals)
	Sets the value of an attribute, given its parent object and name.
long	object_attr_getchar_array (void *x, t_symbol *s, long max, uchar *vals)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setchar_array (void *x, t_symbol *s, long count, uchar *vals)
	Sets the value of an attribute, given its parent object and name.
long	object_attr_getfloat_array (void *x, t_symbol *s, long max, float *vals)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setfloat_array (void *x, t_symbol *s, long count, float *vals)
	Sets the value of an attribute, given its parent object and name.
long	object_attr_getdouble_array (void *x, t_symbol *s, long max, double *vals)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setdouble_array (void *x, t_symbol *s, long count, double *vals)
	Sets the value of an attribute, given its parent object and name.
long	object_attr_getsym_array (void *x, t_symbol *s, long max, t_symbol **vals)
	Retrieves the value of an attribute, given its parent object and name.
t_max_err	object_attr_setsym_array (void *x, t_symbol *s, long count, t_symbol **vals)
	Sets the value of an attribute, given its parent object and name.
t_max_err	attr_addfilterset_clip (void *x, double min, double max, long usemin, long usemax)
	Attaches a clip filter to an attribute.
t_max_err	attr_addfilterset_clip_scale (void *x, double scale, double min, double max, long usemin, long usemax)
	Attaches a clip/scale filter to an attribute.
t_max_err	attr_addfilterget_clip (void *x, double min, double max, long usemin, long usemax)
	Attaches a clip filter to an attribute.
t_max_err	attr_addfilterget_clip_scale (void *x, double scale, double min, double max, long usemin, long usemax)
	Attaches a clip/scale filter to an attribute.
t_max_err	attr_addfilter_clip (void *x, double min, double max, long usemin, long usemax)
	Attaches a clip filter to an attribute.
t_max_err	attr_addfilter_clip_scale (void *x, double scale, double min, double max, long usemin, long usemax)
	Attaches a clip/scale filter to an attribute.
t_max_err	attr_addfilterset_proc (void *x, method proc)
	Attaches a custom filter method to an attribute.
t_max_err	attr_addfilterget_proc (void *x, method proc)
	Attaches a custom filter method to an attribute.
void	attr_args_dictionary (t_dictionary *x, short ac, t_atom *av)
	Create a dictionary of attribute-name, attribute-value pairs from an array of atoms containing an attribute definition list.
void	attr_dictionary_process (void *x, t_dictionary *d)
	Set attributes for an object that are defined in a dictionary.
t_max_err	object_attr_setparse (t_object *x, t_symbol *s, char *parsestr)
	Set an attribute value with one or more atoms parsed from a C-string.
void *	object_new_parse (t_symbol *name_space, t_symbol *classname, char *parsestr)
	Create a new object with one or more atoms parsed from a C-string.
t_max_err	object_attr_getjrgba (void *ob, t_symbol *s, t_jrgba *c)
	Retrieves the value of a color attribute, given its parent object and name.
t_max_err	object_attr_setjrgba (void *ob, t_symbol *s, t_jrgba *c)
	Sets the value of a color attribute, given its parent object and name.
t_max_err	object_attr_get_rect (t_object *o, t_symbol *name, t_rect *rect)
	Gets the value of a t_rect attribute, given its parent object and name.
t_max_err	object_attr_set_rect (t_object *o, t_symbol *name, t_rect *rect)
	Sets the value of a t_rect attribute, given its parent object and name.
t_max_err	object_attr_getpt (t_object *o, t_symbol *name, t_pt *pt)
	Gets the value of a t_pt attribute, given its parent object and name.
t_max_err	object_attr_setpt (t_object *o, t_symbol *name, t_pt *pt)
	Sets the value of a t_pt attribute, given its parent object and name.
t_max_err	object_attr_getsize (t_object *o, t_symbol *name, t_size *size)
	Gets the value of a t_size attribute, given its parent object and name.
t_max_err	object_attr_setsize (t_object *o, t_symbol *name, t_size *size)
	Sets the value of a t_size attribute, given its parent object and name.
t_max_err	object_attr_getcolor (t_object *b, t_symbol *attrname, t_jrgba *prgba)
	Gets the value of a t_jrgba attribute, given its parent object and name.
t_max_err	object_attr_setcolor (t_object *b, t_symbol *attrname, t_jrgba *prgba)
	Sets the value of a t_jrgba attribute, given its parent object and name.

---

Detailed Description

An attribute of an object is a setting or property that tells the object how to do its job.

For example, the metro object has an interval attribute that tells it how fast to run.

Attributes are similar to methods, except that the attributes have a state. Attributes are themselves objects, and they share a common interface for getting and setting values.

An attribute is most typically added to the class definition of another object during it's class initialization or main() function. Most typically, this attribute's value will be stored in an instance's struct, and thus it will serve as a property of that instance of the object.

Attributes can, however, be declared as 'class static'. This means that the property is shared by all instances of the class, and the value is stored as a shared (static) variable.

Additionally, Max 5 has introduced the notion of 'instance attributes' (also called 'object attributes'). Instance attributes are the creation of an attribute object, and then adding it to one specific instance of another class.

Finally, because attributes themselves are Max objects they too can possess attributes. These 'attributes of attributes' are used in Max to do things like specify a range of values for an attribute, give an attribute human friendly caption, or determine to what category an attribute should belong in the inspector.

The easiest and most common way of working with attributes is to use the provided macros. These macros simplify the process of creating a new attribute object, setting any attributes of the attribute, and binding it to an object class or an object instance.

Setting and Getting Attribute Values

By default, Max provides standard attribute accessors. These are the functions the get or set the attribute value in the object's struct. If you need to define a custom accessor, you can specify this information using the CLASS_ATTR_ACCESSORS macro.

Writing a custom Attribute Getter

If you need to define a custom accessor, it should have a prototype and form comparable to the following custom getter:

    t_max_err foo_myval_get(t_foo *x, void *attr, long *ac, t_atom **av) 
    {
       if ((*ac)&&(*av)) {
          //memory passed in, use it
       } else {
          //otherwise allocate memory
          *ac = 1;
          if (!(*av = getbytes(sizeof(t_atom)*(*ac)))) {
             *ac = 0;
             return MAX_ERR_OUT_OF_MEM;
          }
       }
       atom_setfloat(*av,x->myval);

       return MAX_ERR_NONE;
    }

Note that getters require memory to be allocated, if there is not memory passed into the getter. Also the attr argument is the class' attribute object and can be queried using object_method for things like the attribute flags, names, filters, etc..

Writing a custom Attribute Getter

If you need to define a custom accessor, it should have a prototype and form comparable to the following custom setter:

    t_max_err foo_myval_set(t_foo *x, void *attr, long ac, t_atom *av) 
    {
       if (ac&&av) {
          x->myval = atom_getfloat(av);
       } else {
          // no args, set to zero
          x->myval = 0;
       }
       return MAX_ERR_NONE;
    }

Attribute Notificaton

Although the subject of object registration and notification is covered elsewhere, it bears noting that attributes of all types will, if registered, automatically send notifications to all attached client objects each time the attribute's value is set.

---

Define Documentation

#define CLASS_ATTR_ACCESSORS	(	c,
		attrname,
		getter,
		setter		)

Value:

{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); \
        object_method(theattr,gensym("setmethod"),USESYM(get),getter); \
        object_method(theattr,gensym("setmethod"),USESYM(set),setter); }

Specify custom accessor methods for an attribute.

If you specify a non-NULL value for the setter or getter, then the function you specify will be called to set or get the attribute's value rather than using the built-in accessor.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	getter	An appropriate getter method as discussed in Setting and Getting Attribute Values, or NULL to use the default getter.
	setter	An appropriate setter method as discussed in Setting and Getting Attribute Values, or NULL to use the default setter.

Definition at line 1038 of file ext_obex_util.h.

#define CLASS_ATTR_ADD_FLAGS	(	c,
		attrname,
		flags		)

Value:

{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); \
        long oldflags = object_method(theattr,gensym("getflags")); \
        object_method(theattr,gensym("setflags"),oldflags|(flags)); }

Add flags to an attribute.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to add to this attribute, as defined in e_max_attrflags.

Definition at line 1052 of file ext_obex_util.h.

#define CLASS_ATTR_ALIAS	(	c,
		attrname,
		aliasname		)

Value:

{   t_object *thealias; \
        t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); \
        thealias = object_clone(theattr); \
        object_method(thealias,USESYM(setname),gensym(aliasname)); \
        class_addattr(c,thealias); \
        CLASS_ATTR_ATTR_PARSE(c,aliasname,"alias",USESYM(symbol),0,attrname); }

Create a new attribute that is an alias of an existing attribute.

Parameters:

	c	The class pointer.
	attrname	The name of the actual attribute as a C-string.
	aliasname	The name of the new alias attribute.

Definition at line 1130 of file ext_obex_util.h.

#define CLASS_ATTR_ATOM	(	c,
		attrname,
		flags,
		structname,
		structmember		)	class_addattr((c),attr_offset_new(attrname,USESYM(atom),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))

Create a t_atom attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 104 of file ext_obex_util.h.

#define CLASS_ATTR_ATOM_ARRAY	(	c,
		attrname,
		flags,
		structname,
		structmember,
		size		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(atom),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))

Create an array-of-atoms attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the t_atom array.

Definition at line 210 of file ext_obex_util.h.

#define CLASS_ATTR_ATOM_VARSIZE	(	c,
		attrname,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(atom),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))

Create an array-of-atoms attribute of variable length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the t_atom array at any given moment.
	maxsize	The maximum number of items in the t_atom array, i.e. the number of members allocated for the array in the struct.

Definition at line 323 of file ext_obex_util.h.

#define CLASS_ATTR_CATEGORY	(	c,
		attrname,
		flags,
		parsestr		)	CLASS_ATTR_ATTR_PARSE(c,attrname,"category",USESYM(symbol),flags,parsestr)

Add a new attribute to the specified attribute to specify a category to which the attribute is assigned in the Max inspector.

Categories are represented in the inspector as tabs. If the specified category does not exist then it will be created.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Definition at line 1427 of file ext_obex_util.h.

#define CLASS_ATTR_CHAR	(	c,
		attrname,
		flags,
		structname,
		structmember		)	class_addattr((c),attr_offset_new(attrname,USESYM(char),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))

Create a char attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 34 of file ext_obex_util.h.

#define CLASS_ATTR_CHAR_ARRAY	(	c,
		attrname,
		flags,
		structname,
		structmember,
		size		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(char),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))

Create an array-of-chars attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of chars in the array.

Definition at line 135 of file ext_obex_util.h.

#define CLASS_ATTR_CHAR_VARSIZE	(	c,
		attrname,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(char),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))

Create an array-of-chars attribute of variable length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the char array at any given moment.
	maxsize	The maximum number of items in the char array, i.e. the number of members allocated for the array in the struct.

Definition at line 243 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULT	(	c,
		attrname,
		flags,
		parsestr		)	{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"default",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }

Add a new attribute to the specified attribute to specify a default value.

The default value will be automatically set when the object is created only if your object uses a dictionary constructor with the CLASS_FLAG_NEWDICTIONARY flag.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Definition at line 1158 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULT_PAINT	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_DEFAULT(c,attrname,flags,parsestr); CLASS_ATTR_PAINT(c,attrname,flags); }

A convenience wrapper for both CLASS_ATTR_DEFAULT and CLASS_ATTR_PAINT.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULT

CLASS_ATTR_PAINT

Definition at line 1281 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULT_SAVE	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_DEFAULT(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); }

A convenience wrapper for both CLASS_ATTR_DEFAULT and CLASS_ATTR_SAVE.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULT

CLASS_ATTR_SAVE

Definition at line 1185 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULT_SAVE_PAINT	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_DEFAULT(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); CLASS_ATTR_PAINT(c,attrname,flags); }

A convenience wrapper for CLASS_ATTR_DEFAULT, CLASS_ATTR_SAVE, and CLASS_ATTR_PAINT.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULT

CLASS_ATTR_PAINT

CLASS_ATTR_SAVE

Definition at line 1297 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULTNAME	(	c,
		attrname,
		flags,
		parsestr		)	{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"defaultname",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }

Add a new attribute to the specified attribute to specify a default value, based on Max's Object Defaults.

If a value is present in Max's Object Defaults, then that value will be used as the default value. Otherwise, use the default value specified here. The default value will be automatically set when the object is created only if your object uses a dictionary constructor with the CLASS_FLAG_NEWDICTIONARY flag.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Definition at line 1202 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULTNAME_PAINT	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_DEFAULTNAME(c,attrname,flags,parsestr); CLASS_ATTR_PAINT(c,attrname,flags); }

A convenience wrapper for CLASS_ATTR_DEFAULTNAME, CLASS_ATTR_SAVE, and CLASS_ATTR_PAINT.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULTNAME

CLASS_ATTR_PAINT

CLASS_ATTR_SAVE

Definition at line 1313 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULTNAME_SAVE	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_DEFAULTNAME(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); }

A convenience wrapper for both CLASS_ATTR_DEFAULTNAME and CLASS_ATTR_SAVE.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULTNAME

CLASS_ATTR_SAVE

Definition at line 1217 of file ext_obex_util.h.

#define CLASS_ATTR_DEFAULTNAME_SAVE_PAINT	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_DEFAULTNAME(c,attrname,flags,parsestr); CLASS_ATTR_SAVE(c,attrname,flags); CLASS_ATTR_PAINT(c,attrname,flags); }

A convenience wrapper for CLASS_ATTR_DEFAULTNAME, CLASS_ATTR_SAVE, and CLASS_ATTR_PAINT.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULTNAME

CLASS_ATTR_PAINT

CLASS_ATTR_SAVE

Definition at line 1329 of file ext_obex_util.h.

#define CLASS_ATTR_DOUBLE	(	c,
		attrname,
		flags,
		structname,
		structmember		)	class_addattr((c),attr_offset_new(attrname,USESYM(float64),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))

Create a 64-bit float attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 76 of file ext_obex_util.h.

#define CLASS_ATTR_DOUBLE_ARRAY	(	c,
		attrname,
		flags,
		structname,
		structmember,
		size		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(float64),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))

Create an array-of-64bit-floats attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of doubles in the array.

Definition at line 180 of file ext_obex_util.h.

#define CLASS_ATTR_DOUBLE_VARSIZE	(	c,
		attrname,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(float64),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))

Create an array-of-64bit-floats attribute of variable length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the double array at any given moment.
	maxsize	The maximum number of items in the double array, i.e. the number of members allocated for the array in the struct.

Definition at line 291 of file ext_obex_util.h.

#define CLASS_ATTR_ENUM	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_STYLE(c,attrname,flags,"enum"); CLASS_ATTR_ATTR_PARSE(c,attrname,"enumvals",USESYM(atom),flags,parsestr); }

Add a new attribute to the specified attribute to specify a list of choices to display in a menu for the Max inspector.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Remarks:

This macro automatically calls

    CLASS_ATTR_STYLE(c,attrname,flags,"enum").

See also:

CLASS_ATTR_ENUMINDEX

Definition at line 1390 of file ext_obex_util.h.

#define CLASS_ATTR_ENUMINDEX	(	c,
		attrname,
		flags,
		parsestr		)	{ CLASS_ATTR_STYLE(c,attrname,flags,"enumindex"); CLASS_ATTR_ATTR_PARSE(c,attrname,"enumvals",USESYM(atom),flags,parsestr); }

Add a new attribute to the specified attribute to specify a list of choices to display in a menu for the Max inspector.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Remarks:

This macro automatically calls

    CLASS_ATTR_STYLE(c,attrname,flags,"enumindex").

See also:

CLASS_ATTR_ENUM

Definition at line 1411 of file ext_obex_util.h.

#define CLASS_ATTR_FILTER_CLIP	(	c,
		attrname,
		minval,
		maxval		)

Value:

{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); \
        attr_addfilter_clip(theattr,minval,maxval,1,1); }

Add a filter to the attribute to limit both the lower and upper bounds of a value.

The limiting will be performed by the default attribute accessor.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	minval	The maximum acceptable value to which the attribute will be limited.
	maxval	The maximum acceptable value to which the attribute will be limited.

See also:

Definition at line 1117 of file ext_obex_util.h.

#define CLASS_ATTR_FILTER_MAX	(	c,
		attrname,
		maxval		)

Value:

{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); \
        attr_addfilter_clip(theattr,0,maxval,0,1); }

Add a filter to the attribute to limit the upper bound of a value.

The limiting will be performed by the default attribute accessor.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	maxval	The maximum acceptable value to which the attribute will be limited.

See also:

CLASS_ATTR_FILTER_MIN

CLASS_ATTR_FILTER_CLIP

CLASS_ATTR_MAX

Definition at line 1101 of file ext_obex_util.h.

#define CLASS_ATTR_FILTER_MIN	(	c,
		attrname,
		minval		)

Value:

{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); \
        attr_addfilter_clip(theattr,minval,0,1,0); }

Add a filter to the attribute to limit the lower bound of a value.

The limiting will be performed by the default attribute accessor.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	minval	The minimum acceptable value to which the attribute will be limited.

See also:

CLASS_ATTR_FILTER_MAX

CLASS_ATTR_FILTER_CLIP

CLASS_ATTR_MIN

Definition at line 1084 of file ext_obex_util.h.

#define CLASS_ATTR_FLOAT	(	c,
		attrname,
		flags,
		structname,
		structmember		)	class_addattr((c),attr_offset_new(attrname,USESYM(float32),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))

Create a 32-bit float attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 62 of file ext_obex_util.h.

#define CLASS_ATTR_FLOAT_ARRAY	(	c,
		attrname,
		flags,
		structname,
		structmember,
		size		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(float32),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))

Create an array-of-32bit-floats attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of floats in the array.

Definition at line 165 of file ext_obex_util.h.

#define CLASS_ATTR_FLOAT_VARSIZE	(	c,
		attrname,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(float32),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))

Create an array-of-32bit-floats attribute of variable length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the float array at any given moment.
	maxsize	The maximum number of items in the float array, i.e. the number of members allocated for the array in the struct.

Definition at line 275 of file ext_obex_util.h.

#define CLASS_ATTR_INVISIBLE	(	c,
		attrname,
		flags		)	CLASS_ATTR_ATTR_PARSE(c,attrname,"invisible",USESYM(long),flags,"1")

Add a new attribute to the specified attribute to flag an attribute as invisible to the Max inspector.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.

Definition at line 1457 of file ext_obex_util.h.

#define CLASS_ATTR_LABEL	(	c,
		attrname,
		flags,
		labelstr		)	CLASS_ATTR_ATTR_FORMAT(c,attrname,"label",USESYM(symbol),flags,"s",gensym(labelstr))

Add a new attribute to the specified attribute to specify an a human-friendly label for the Max inspector.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	labelstr	A C-string, which will be parsed into an array of atoms to set the initial value.

Definition at line 1369 of file ext_obex_util.h.

#define CLASS_ATTR_LONG	(	c,
		attrname,
		flags,
		structname,
		structmember		)	class_addattr((c),attr_offset_new(attrname,USESYM(long),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))

Create a long integer attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 48 of file ext_obex_util.h.

#define CLASS_ATTR_LONG_ARRAY	(	c,
		attrname,
		flags,
		structname,
		structmember,
		size		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(long),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))

Create an array-of-long-integers attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of longs in the array.

Definition at line 150 of file ext_obex_util.h.

#define CLASS_ATTR_LONG_VARSIZE	(	c,
		attrname,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(long),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))

Create an array-of-long-integers attribute of variable length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the long array at any given moment.
	maxsize	The maximum number of items in the long array, i.e. the number of members allocated for the array in the struct.

Definition at line 259 of file ext_obex_util.h.

#define CLASS_ATTR_MAX	(	c,
		attrname,
		flags,
		parsestr		)	{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"max",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }

Add a new attribute to the specified attribute to specify an upper range.

The values will not be automatically limited.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_MIN

CLASS_ATTR_FILTER_MAX

CLASS_ATTR_FILTER_CLIP

Definition at line 1251 of file ext_obex_util.h.

#define CLASS_ATTR_MIN	(	c,
		attrname,
		flags,
		parsestr		)	{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); CLASS_ATTR_ATTR_PARSE(c,attrname,"min",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }

Add a new attribute to the specified attribute to specify a lower range.

The values will not be automatically limited.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_MAX

CLASS_ATTR_FILTER_MAX

CLASS_ATTR_FILTER_CLIP

Definition at line 1234 of file ext_obex_util.h.

#define CLASS_ATTR_OBJ	(	c,
		attrname,
		flags,
		structname,
		structmember		)	class_addattr((c),attr_offset_new(attrname,USESYM(object),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))

Create a t_object* attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 118 of file ext_obex_util.h.

#define CLASS_ATTR_OBJ_ARRAY	(	c,
		attrname,
		flags,
		structname,
		structmember,
		size		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(object),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))

Create an array-of-objects attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the t_object* array.

Definition at line 225 of file ext_obex_util.h.

#define CLASS_ATTR_OBJ_VARSIZE	(	c,
		attrname,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(object),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))

Create an array-of-objects attribute of variable length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the t_object* array at any given moment.
	maxsize	The maximum number of items in the t_object* array, i.e. the number of members allocated for the array in the struct.

Definition at line 339 of file ext_obex_util.h.

#define CLASS_ATTR_ORDER	(	c,
		attrname,
		flags,
		parsestr		)	CLASS_ATTR_ATTR_PARSE(c,attrname,"order",USESYM(long),flags,parsestr)

Add a new attribute to the specified attribute to specify a default order in which to list attributes.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Remarks:

A value of zero indicates that there is no ordering. Ordering values begin at 1. For example:

    CLASS_ATTR_ORDER(c, "firstattr",    0, "1");
    CLASS_ATTR_ORDER(c, "secondattr",   0, "2");
    CLASS_ATTR_ORDER(c, "thirdattr",    0, "3");

Definition at line 1477 of file ext_obex_util.h.

#define CLASS_ATTR_PAINT	(	c,
		attrname,
		flags		)	CLASS_ATTR_ATTR_PARSE(c,attrname,"paint",USESYM(long),flags,"1")

Add a new attribute indicating that any changes to the specified attribute will trigger a call to the object's paint method.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.

Definition at line 1266 of file ext_obex_util.h.

#define CLASS_ATTR_REMOVE_FLAGS	(	c,
		attrname,
		flags		)

Value:

{ t_object *theattr=(t_object *)class_attr_get(c,gensym(attrname)); \
        long oldflags = object_method(theattr,gensym("getflags")); \
        object_method(theattr,gensym("setflags"),oldflags&(~(flags))); }

Remove flags from an attribute.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to remove from this attribute, as defined in e_max_attrflags.

Definition at line 1066 of file ext_obex_util.h.

#define CLASS_ATTR_RGBA	(	c,
		attrname,
		flags,
		structname,
		structmember		)

Value:

{   CLASS_ATTR_DOUBLE_ARRAY(c,attrname,flags,structname,structmember,4); \
        CLASS_ATTR_ACCESSORS(c,attrname,NULL,jgraphics_attr_setrgba); \
        CLASS_ATTR_PAINT(c,attrname,0); }

Create a color (t_jrgba) attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 1513 of file jgraphics.h.

#define CLASS_ATTR_SAVE	(	c,
		attrname,
		flags		)	CLASS_ATTR_ATTR_PARSE(c,attrname,"save",USESYM(long),flags,"1")

Add a new attribute to the specified attribute to indicate that the specified attribute should be saved with the patcher.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.

Definition at line 1170 of file ext_obex_util.h.

#define CLASS_ATTR_STYLE	(	c,
		attrname,
		flags,
		parsestr		)	CLASS_ATTR_ATTR_PARSE(c,attrname,"style",USESYM(symbol),flags,parsestr)

Add a new attribute to the specified attribute to specify an editor style for the Max inspector.

Available styles include

• "text" : a text editor
• "onoff" : a toggle switch
• "rgba" : a color chooser
• "enum" : a menu of available choices, whose symbol will be passed upon selection
• "enumindex" : a menu of available choices, whose index will be passed upon selection
• "rect" : a style for displaying and editing t_rect values
• "font" : a font chooser
• "file" : a file chooser dialog

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Definition at line 1356 of file ext_obex_util.h.

#define CLASS_ATTR_STYLE_LABEL	(	c,
		attrname,
		flags,
		stylestr,
		labelstr		)	{ CLASS_ATTR_ATTR_PARSE(c,attrname,"style",USESYM(symbol),flags,stylestr); CLASS_ATTR_ATTR_FORMAT(c,attrname,"label",USESYM(symbol),flags,"s",gensym(labelstr)); }

A convenience wrapper for CLASS_ATTR_STYLE, and CLASS_ATTR_LABEL.

Parameters:

	c	The class pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	stylestr	A C-string that names the style for the attribute. See CLASS_ATTR_STYLE for the available styles.
	labelstr	A C-string that names the category to which the attribute is assigned in the inspector.

See also:

CLASS_ATTR_STYLE

CLASS_ATTR_LABEL

Definition at line 1445 of file ext_obex_util.h.

#define CLASS_ATTR_SYM	(	c,
		attrname,
		flags,
		structname,
		structmember		)	class_addattr((c),attr_offset_new(attrname,USESYM(symbol),(flags),(method)0L,(method)0L,calcoffset(structname,structmember)))

Create a t_symbol* attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 90 of file ext_obex_util.h.

#define CLASS_ATTR_SYM_ARRAY	(	c,
		attrname,
		flags,
		structname,
		structmember,
		size		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(symbol),(size),(flags),(method)0L,(method)0L,0/*fix*/,calcoffset(structname,structmember)))

Create an array-of-symbols attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the t_symbol* array.

Definition at line 195 of file ext_obex_util.h.

#define CLASS_ATTR_SYM_VARSIZE	(	c,
		attrname,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	class_addattr((c),attr_offset_array_new(attrname,USESYM(symbol),(maxsize),(flags),(method)0L,(method)0L,calcoffset(structname,sizemember),calcoffset(structname,structmember)))

Create an array-of-symbols attribute of variable length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the t_symbol* array at any given moment.
	maxsize	The maximum number of items in the t_symbol* array, i.e. the number of members allocated for the array in the struct.

Definition at line 307 of file ext_obex_util.h.

#define CLASS_METHOD_ATTR_PARSE	(	c,
		methodname,
		attrname,
		type,
		flags,
		parsestring		)

Value:

{   t_hashtab *methods=NULL; \
        t_object *m=NULL; \
        methods = (t_hashtab *)class_extra_lookup(c,gensym("methods")); \
        if (methods) { \
            hashtab_lookup(methods,gensym((methodname)),&m); \
            if (m) \
                object_addattr_parse(m,attrname,type,flags,parsestring); \
        } \
    }

Define and add attributes to class methods.

Parameters:

	c	The class pointer.
	methodname	The name of the existing method as a C-string.
	attrname	The name of the attribute to add as a C-string.
	type	The datatype of the attribute to be added.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestring	A C-string, which will be parsed into an array of atoms to set the initial value.

Remarks:

An example which makes a method invisible to users:

    class_addmethod(c, (method)my_foo, "foo", 0);
    CLASS_METHOD_ATTR_PARSE(c, "foo", "undocumented", gensym("long"), 0, "1");

Definition at line 1503 of file ext_obex_util.h.

#define CLASS_STICKY_ATTR	(	c,
		name,
		flags,
		parsestr		)	{ t_object *attr = attribute_new_parse(name,NULL,flags,parsestr); class_sticky(c,gensym("sticky_attr"),gensym(name),attr); }

Create an attribute, and add it to all following attribute declarations.

The block is closed by a call to CLASS_STICKY_ATTR_CLEAR.

Parameters:

	c	The class pointer.
	name	The name of the new attribute to create as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Remarks:

The most common use of CLASS_STICKY_ATTR is for creating multiple attributes with the same category, as in this example:

    CLASS_STICKY_ATTR(c, "category", 0, "Foo");
    
    CLASS_ATTR_DOUBLE(c, "bar", 0, t_myobject, x_bar);
    CLASS_ATTR_LABEL(c, "bar", 0, "A Bar");

    CLASS_ATTR_CHAR(c, "switch", 0, t_myobject, x_switch);
    CLASS_ATTR_STYLE_LABEL(c, "switch", 0, "onoff", "Bar Switch");

    CLASS_ATTR_DOUBLE(c, "flow", 0, t_myobject, x_flow);
    CLASS_ATTR_LABEL(c, "flow", 0, "Flow Amount");
    
    CLASS_STICKY_ATTR_CLEAR(c, "category");

See also:

CLASS_STICKY_ATTR_CLEAR

Definition at line 1592 of file ext_obex_util.h.

#define CLASS_STICKY_ATTR_CLEAR	(	c,
		name		)	class_sticky_clear(c,gensym("sticky_attr"),name?gensym(name):NULL)

Close a CLASS_STICKY_ATTR block.

Parameters:

	c	The class pointer.
	name	The name of the sticky attribute as a C-string.

See also:

CLASS_STICKY_ATTR

Definition at line 1604 of file ext_obex_util.h.

#define CLASS_STICKY_METHOD	(	c,
		name,
		flags,
		parsestr		)	{ t_object *attr = attribute_new_parse(name,NULL,flags,parsestr); class_sticky(c,gensym("sticky_method"),gensym(name),attr); }

Create an attribute, and add it to all following method declarations.

The block is closed by a call to CLASS_STICKY_METHOD_CLEAR.

Parameters:

	c	The class pointer.
	name	The name of the new attribute to create as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

Remarks:

The most common use of CLASS_STICKY_ATTR is for creating multiple attributes with the same category, as in this example:

    CLASS_STICKY_METHOD(c, "undocumented", 0, "1");
    
    // add some methods here with class_add_method()
    // the undocumented attribute for methods means that the ref-page 
    // generator will ignore these methods.
    
    CLASS_STICKY_METHOD_CLEAR(c, "undocumented");

See also:

CLASS_STICKY_METHOD_CLEAR

Definition at line 1631 of file ext_obex_util.h.

#define CLASS_STICKY_METHOD_CLEAR	(	c,
		name		)	class_sticky_clear(c,gensym("sticky_method"),name?gensym(name):clear)

Close a CLASS_STICKY_METHOD block.

Parameters:

	c	The class pointer.
	name	The name of the sticky attribute as a C-string.

See also:

CLASS_STICKY_METHOD

Definition at line 1643 of file ext_obex_util.h.

#define OBJ_ATTR_ATOM	(	x,
		attrname,
		flags,
		val		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(atom),flags,"a",val)

Create an instance-local t_atom attribute and add it to a Max class.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 913 of file ext_obex_util.h.

#define OBJ_ATTR_ATOM_ARRAY   OBJ_ATTR_ATOMS

Create an instance-local array-of-atoms attribute of fixed length, and add it to the object.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the t_atom array.
	vals	Pointer to the values.

Definition at line 1005 of file ext_obex_util.h.

#define OBJ_ATTR_CHAR	(	x,
		attrname,
		flags,
		val		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(char),flags,"c",val)

Create an instance-local char attribute and add it to a Max class.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 853 of file ext_obex_util.h.

#define OBJ_ATTR_CHAR_ARRAY	(	x,
		attrname,
		flags,
		count,
		vals		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(char),flags,"C",count,vals)

Create an instance-local array-of-chars attribute of fixed length, and add it to the object.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the char array.
	vals	Pointer to the values.

Definition at line 940 of file ext_obex_util.h.

#define OBJ_ATTR_DEFAULT	(	x,
		attrname,
		flags,
		parsestr		)	{ t_object *theattr=(t_object *)object_attr_get(x,gensym(attrname)); OBJ_ATTR_ATTR_PARSE(x,attrname,"default",(t_symbol *)object_method(theattr,USESYM(gettype)),flags,parsestr); }

An instance-attribute version of CLASS_ATTR_DEFAULT.

Parameters:

	x	The t_object instance pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULT

Definition at line 1530 of file ext_obex_util.h.

#define OBJ_ATTR_DEFAULT_SAVE	(	x,
		attrname,
		flags,
		parsestr		)	{ OBJ_ATTR_DEFAULT(x,attrname,flags,parsestr); OBJ_ATTR_SAVE(x,attrname,flags); }

An instance-attribute version of CLASS_ATTR_DEFAULT_SAVE.

Parameters:

	x	The t_object instance pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.
	parsestr	A C-string, which will be parsed into an array of atoms to set the initial value.

See also:

CLASS_ATTR_DEFAULT_SAVE

Definition at line 1557 of file ext_obex_util.h.

#define OBJ_ATTR_DOUBLE	(	x,
		attrname,
		flags,
		val		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(float64),flags,"d",val)

Create an instance-local 64bit float attribute and add it to a Max class.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 889 of file ext_obex_util.h.

#define OBJ_ATTR_DOUBLE_ARRAY	(	x,
		attrname,
		flags,
		count,
		vals		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(float64),flags,"D",count,vals)

Create an instance-local array-of-64bit-floats attribute of fixed length, and add it to the object.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the double array.
	vals	Pointer to the values.

Definition at line 979 of file ext_obex_util.h.

#define OBJ_ATTR_FLOAT	(	x,
		attrname,
		flags,
		val		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(float32),flags,"f",val)

Create an instance-local 32bit float attribute and add it to a Max class.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 877 of file ext_obex_util.h.

#define OBJ_ATTR_FLOAT_ARRAY	(	x,
		attrname,
		flags,
		count,
		vals		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(float32),flags,"F",count,vals)

Create an instance-local array-of-32bit-floats attribute of fixed length, and add it to the object.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the float array.
	vals	Pointer to the values.

Definition at line 966 of file ext_obex_util.h.

#define OBJ_ATTR_LONG	(	x,
		attrname,
		flags,
		val		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(long),flags,"l",val)

Create an instance-local long integer attribute and add it to a Max class.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 865 of file ext_obex_util.h.

#define OBJ_ATTR_LONG_ARRAY	(	x,
		attrname,
		flags,
		count,
		vals		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(long),flags,"L",count,vals)

Create an instance-local array-of-long-integers attribute of fixed length, and add it to the object.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the long array.
	vals	Pointer to the values.

Definition at line 953 of file ext_obex_util.h.

#define OBJ_ATTR_OBJ	(	x,
		attrname,
		flags,
		val		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(object),flags,"o",val)

Create an instance-local t_object* attribute and add it to a Max class.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 925 of file ext_obex_util.h.

#define OBJ_ATTR_OBJ_ARRAY	(	x,
		attrname,
		flags,
		count,
		vals		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(object),flags,"O",count,vals)

Create an instance-local array-of-objects attribute of fixed length, and add it to the object.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the t_object* array.
	vals	Pointer to the values.

Definition at line 1018 of file ext_obex_util.h.

#define OBJ_ATTR_SAVE	(	x,
		attrname,
		flags		)	OBJ_ATTR_ATTR_PARSE(x,attrname,"save",USESYM(long),flags,"1")

An instance-attribute version of CLASS_ATTR_SAVE.

Parameters:

	x	The t_object instance pointer.
	attrname	The name of the attribute as a C-string.
	flags	Any flags you wish to declare for this new attribute, as defined in e_max_attrflags.

See also:

CLASS_ATTR_SAVE

Definition at line 1543 of file ext_obex_util.h.

#define OBJ_ATTR_SYM	(	x,
		attrname,
		flags,
		val		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(symbol),flags,"s",val)

Create an instance-local t_symbol* attribute and add it to a Max class.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 901 of file ext_obex_util.h.

#define OBJ_ATTR_SYM_ARRAY	(	x,
		attrname,
		flags,
		count,
		vals		)	OBJ_ATTR_FORMAT(x,attrname,USESYM(symbol),flags,"S",count,vals)

Create an instance-local array-of-symbols attribute of fixed length, and add it to the object.

Parameters:

	x	The object pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the t_symbol* array.
	vals	Pointer to the values.

Definition at line 992 of file ext_obex_util.h.

#define STATIC_ATTR_ATOM	(	c,
		attrname,
		flags,
		val		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(atom),flags,"a",val)

Create a shared (static/global) t_atom attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 728 of file ext_obex_util.h.

#define STATIC_ATTR_ATOM_ARRAY   STATIC_ATTR_ATOMS

Create a shared (static/global) array-of-atoms attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the t_atom array.
	vals	Pointer to the values.

Definition at line 820 of file ext_obex_util.h.

#define STATIC_ATTR_CHAR	(	c,
		attrname,
		flags,
		val		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(char),flags,"c",val)

Create a shared (static/global) char attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 668 of file ext_obex_util.h.

#define STATIC_ATTR_CHAR_ARRAY	(	c,
		attrname,
		flags,
		count,
		vals		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(char),flags,"C",count,vals)

Create a shared (static/global) array-of-chars attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the char array.
	vals	Pointer to the values.

Definition at line 755 of file ext_obex_util.h.

#define STATIC_ATTR_DOUBLE	(	c,
		attrname,
		flags,
		val		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(float64),flags,"d",val)

Create a shared (static/global) 64bit float attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 704 of file ext_obex_util.h.

#define STATIC_ATTR_DOUBLE_ARRAY	(	c,
		attrname,
		flags,
		count,
		vals		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(float64),flags,"D",count,vals)

Create a shared (static/global) array-of-64bit-floats attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the double array.
	vals	Pointer to the values.

Definition at line 794 of file ext_obex_util.h.

#define STATIC_ATTR_FLOAT	(	c,
		attrname,
		flags,
		val		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(float32),flags,"f",val)

Create a shared (static/global) 32bit float attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 692 of file ext_obex_util.h.

#define STATIC_ATTR_FLOAT_ARRAY	(	c,
		attrname,
		flags,
		count,
		vals		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(float32),flags,"F",count,vals)

Create a shared (static/global) array-of-32bit-floats attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the float array.
	vals	Pointer to the values.

Definition at line 781 of file ext_obex_util.h.

#define STATIC_ATTR_LONG	(	c,
		attrname,
		flags,
		val		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(long),flags,"l",val)

Create a shared (static/global) long integer attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 680 of file ext_obex_util.h.

#define STATIC_ATTR_LONG_ARRAY	(	c,
		attrname,
		flags,
		count,
		vals		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(long),flags,"L",count,vals)

Create a shared (static/global) array-of-long-integers attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the long array.
	vals	Pointer to the values.

Definition at line 768 of file ext_obex_util.h.

#define STATIC_ATTR_OBJ	(	c,
		attrname,
		flags,
		val		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(object),flags,"o",val)

Create a shared (static/global) t_object* attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 740 of file ext_obex_util.h.

#define STATIC_ATTR_OBJ_ARRAY	(	c,
		attrname,
		flags,
		count,
		vals		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(object),flags,"O",count,vals)

Create a shared (static/global) array-of-objects attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the t_object* array.
	vals	Pointer to the values.

Definition at line 833 of file ext_obex_util.h.

#define STATIC_ATTR_SYM	(	c,
		attrname,
		flags,
		val		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(symbol),flags,"s",val)

Create a shared (static/global) t_symbol* attribute and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	val	Pointer to the value.

Definition at line 716 of file ext_obex_util.h.

#define STATIC_ATTR_SYM_ARRAY	(	c,
		attrname,
		flags,
		count,
		vals		)	STATIC_ATTR_FORMAT(c,attrname,USESYM(symbol),flags,"S",count,vals)

Create a shared (static/global) array-of-symbols attribute of fixed length, and add it to a Max class.

Parameters:

	c	The class pointer.
	attrname	The name of this attribute as a C-string.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	count	The number of items in the t_symbol* array.
	vals	Pointer to the values.

Definition at line 807 of file ext_obex_util.h.

#define STRUCT_ATTR_ATOM	(	c,
		flags,
		structname,
		structmember		)	CLASS_ATTR_ATOM(c,#structmember,flags,structname,structmember)

Create a t_atom attribute and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 425 of file ext_obex_util.h.

#define STRUCT_ATTR_ATOM_ARRAY	(	c,
		flags,
		structname,
		structmember,
		size		)	CLASS_ATTR_ATOM_ARRAY(c,#structmember,flags,structname,structmember,size)

Create an array-of-atoms attribute of fixed length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the t_atom array.

Definition at line 525 of file ext_obex_util.h.

#define STRUCT_ATTR_ATOM_VARSIZE	(	c,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	CLASS_ATTR_ATOM_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)

Create an array-of-atoms attribute of variable length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the t_atom array at any given moment.
	maxsize	The maximum number of items in the t_atom array, i.e. the number of members allocated for the array in the struct.

Definition at line 633 of file ext_obex_util.h.

#define STRUCT_ATTR_CHAR	(	c,
		flags,
		structname,
		structmember		)	CLASS_ATTR_CHAR(c,#structmember,flags,structname,structmember)

Create a char attribute and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 360 of file ext_obex_util.h.

#define STRUCT_ATTR_CHAR_ARRAY	(	c,
		flags,
		structname,
		structmember,
		size		)	CLASS_ATTR_CHAR_ARRAY(c,#structmember,flags,structname,structmember,size)

Create an array-of-chars attribute of fixed length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the char array.

Definition at line 455 of file ext_obex_util.h.

#define STRUCT_ATTR_CHAR_VARSIZE	(	c,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	CLASS_ATTR_CHAR_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)

Create an array-of-chars attribute of variable length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the char array at any given moment.
	maxsize	The maximum number of items in the char array, i.e. the number of members allocated for the array in the struct.

Definition at line 558 of file ext_obex_util.h.

#define STRUCT_ATTR_DOUBLE	(	c,
		flags,
		structname,
		structmember		)	CLASS_ATTR_DOUBLE(c,#structmember,flags,structname,structmember)

Create a 64bit float attribute and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 399 of file ext_obex_util.h.

#define STRUCT_ATTR_DOUBLE_ARRAY	(	c,
		flags,
		structname,
		structmember,
		size		)	CLASS_ATTR_DOUBLE_ARRAY(c,#structmember,flags,structname,structmember,size)

Create an array-of-64bit-floats attribute of fixed length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the double array.

Definition at line 497 of file ext_obex_util.h.

#define STRUCT_ATTR_DOUBLE_VARSIZE	(	c,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	CLASS_ATTR_DOUBLE_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)

Create an array-of-64bit-floats attribute of variable length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the double array at any given moment.
	maxsize	The maximum number of items in the double array, i.e. the number of members allocated for the array in the struct.

Definition at line 603 of file ext_obex_util.h.

#define STRUCT_ATTR_FLOAT	(	c,
		flags,
		structname,
		structmember		)	CLASS_ATTR_FLOAT(c,#structmember,flags,structname,structmember)

Create a 32bit float attribute and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 386 of file ext_obex_util.h.

#define STRUCT_ATTR_FLOAT_ARRAY	(	c,
		flags,
		structname,
		structmember,
		size		)	CLASS_ATTR_FLOAT_ARRAY(c,#structmember,flags,structname,structmember,size)

Create an array-of-32bit-floats attribute of fixed length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the floats array.

Definition at line 483 of file ext_obex_util.h.

#define STRUCT_ATTR_FLOAT_VARSIZE	(	c,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	CLASS_ATTR_FLOAT_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)

Create an array-of-32bit-floats attribute of variable length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the float array at any given moment.
	maxsize	The maximum number of items in the float array, i.e. the number of members allocated for the array in the struct.

Definition at line 588 of file ext_obex_util.h.

#define STRUCT_ATTR_LONG	(	c,
		flags,
		structname,
		structmember		)	CLASS_ATTR_LONG(c,#structmember,flags,structname,structmember)

Create a long integer attribute and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 373 of file ext_obex_util.h.

#define STRUCT_ATTR_LONG_ARRAY	(	c,
		flags,
		structname,
		structmember,
		size		)	CLASS_ATTR_LONG_ARRAY(c,#structmember,flags,structname,structmember,size)

Create an array-of-long-integers attribute of fixed length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the long array.

Definition at line 469 of file ext_obex_util.h.

#define STRUCT_ATTR_LONG_VARSIZE	(	c,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	CLASS_ATTR_LONG_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)

Create an array-of-long-integers attribute of variable length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the long array at any given moment.
	maxsize	The maximum number of items in the long array, i.e. the number of members allocated for the array in the struct.

Definition at line 573 of file ext_obex_util.h.

#define STRUCT_ATTR_OBJ	(	c,
		flags,
		structname,
		structmember		)	CLASS_ATTR_OBJ(c,#structmember,flags,structname,structmember)

Create a t_object* attribute and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 438 of file ext_obex_util.h.

#define STRUCT_ATTR_OBJ_ARRAY	(	c,
		flags,
		structname,
		structmember,
		size		)	CLASS_ATTR_OBJ_ARRAY(c,#structmember,flags,structname,structmember,size)

Create an array-of-objects attribute of fixed length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the t_object* array.

Definition at line 539 of file ext_obex_util.h.

#define STRUCT_ATTR_OBJ_VARSIZE	(	c,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	CLASS_ATTR_OBJ_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)

Create an array-of-objects attribute of variable length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the t_object* array at any given moment.
	maxsize	The maximum number of items in the t_object* array, i.e. the number of members allocated for the array in the struct.

Definition at line 648 of file ext_obex_util.h.

#define STRUCT_ATTR_SYM	(	c,
		flags,
		structname,
		structmember		)	CLASS_ATTR_SYM(c,#structmember,flags,structname,structmember)

Create a t_symbol* attribute and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.

Definition at line 412 of file ext_obex_util.h.

#define STRUCT_ATTR_SYM_ARRAY	(	c,
		flags,
		structname,
		structmember,
		size		)	CLASS_ATTR_SYM_ARRAY(c,#structmember,flags,structname,structmember,size)

Create an array-of-symbols attribute of fixed length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	size	The number of items in the t_symbol* array.

Definition at line 511 of file ext_obex_util.h.

#define STRUCT_ATTR_SYM_VARSIZE	(	c,
		flags,
		structname,
		structmember,
		sizemember,
		maxsize		)	CLASS_ATTR_SYM_VARSIZE(c,#structmember,flags,structname,structmember,sizemember,maxsize)

Create an array-of-symbols attribute of variable length, and add it to a Max class.

The name of the attribute is automatically determined by the name of the struct member.

Parameters:

	c	The class pointer.
	flags	Any flags you wish to declare for this attribute, as defined in e_max_attrflags.
	structname	The C identifier for the struct (containing a valid t_object header) representing an instance of this class.
	structmember	The C identifier of the member in the struct that holds the value of this attribute.
	sizemember	The actual number of items in the t_symbol* array at any given moment.
	maxsize	The maximum number of items in the t_symbol* array, i.e. the number of members allocated for the array in the struct.

Definition at line 618 of file ext_obex_util.h.

---

Enumeration Type Documentation

enum e_max_attrflags

Attribute flags.

Remarks:

To create a readonly attribute, for example, you should pass ATTR_SET_OPAQUE or ATTR_SET_OPAQUE_USER as a flag when you create your attribute.

Enumerator:

ATTR_FLAGS_NONE	No flags.
ATTR_GET_OPAQUE	The attribute cannot be queried by either max message when used inside of a CLASS_BOX object, nor from C code.
ATTR_SET_OPAQUE	The attribute cannot be set by either max message when used inside of a CLASS_BOX object, nor from C code.
ATTR_GET_OPAQUE_USER	The attribute cannot be queried by max message when used inside of a CLASS_BOX object, but can be queried from C code.
ATTR_SET_OPAQUE_USER	The attribute cannot be set by max message when used inside of a CLASS_BOX object, but can be set from C code.
ATTR_GET_DEFER	Any attribute queries will be called through a defer().
ATTR_GET_USURP	Any calls to query the attribute will be called through the equivalent of a defer(), repeated calls will be ignored until the getter is actually run.
ATTR_GET_DEFER_LOW	Any attribute queries will be called through a defer_low().
ATTR_GET_USURP_LOW	Any calls to query the attribute will be called through the equivalent of a defer_low(), repeated calls will be ignored until the getter is actually run.
ATTR_SET_DEFER	The attribute setter will be called through a defer().
ATTR_SET_USURP	Any calls to set the attribute will be called through the equivalent of a defer_low(), repeated calls will be ignored until the setter is actually run.
ATTR_SET_DEFER_LOW	The attribute setter will be called through a defer_low().
ATTR_SET_USURP_LOW	Any calls to set the attribute will be called through the equivalent of a defer_low(), repeated calls will be ignored until the setter is actually run.

Definition at line 33 of file ext_obex.h.

---

Function Documentation

t_max_err attr_addfilter_clip	(	void *	x,
		double	min,
		double	max,
		long	usemin,
		long	usemax
	)

Attaches a clip filter to an attribute.

The filter will clip any values sent to or retrieved from the attribute using the attribute's get and set functions.

Parameters:

	x	Pointer to the attribute to receive the filter
	min	Minimum value for the clip filter
	max	Maximum value for the clip filter
	usemin	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.
	usemax	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err attr_addfilter_clip_scale	(	void *	x,
		double	scale,
		double	min,
		double	max,
		long	usemin,
		long	usemax
	)

Attaches a clip/scale filter to an attribute.

The filter will clip and scale any values sent to or retrieved from the attribute using the attribute's get and set functions.

Parameters:

	x	Pointer to the attribute to receive the filter
	scale	Scale value. Data sent to the attribute will be scaled by this amount. Data retrieved from the attribute will be scaled by its reciprocal. Scaling occurs previous to clipping.
	min	Minimum value for the clip filter
	max	Maximum value for the clip filter
	usemin	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.
	usemax	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err attr_addfilterget_clip	(	void *	x,
		double	min,
		double	max,
		long	usemin,
		long	usemax
	)

Attaches a clip filter to an attribute.

The filter will only clip values retrieved from the attribute using the attribute's get function.

Parameters:

	x	Pointer to the attribute to receive the filter
	min	Minimum value for the clip filter
	max	Maximum value for the clip filter
	usemin	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.
	usemax	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err attr_addfilterget_clip_scale	(	void *	x,
		double	scale,
		double	min,
		double	max,
		long	usemin,
		long	usemax
	)

Attaches a clip/scale filter to an attribute.

The filter will only clip and scale values retrieved from the attribute using the attribute's get function.

Parameters:

	x	Pointer to the attribute to receive the filter
	scale	Scale value. Data retrieved from the attribute will be scaled by this amount. Scaling occurs previous to clipping.
	min	Minimum value for the clip filter
	max	Maximum value for the clip filter
	usemin	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.
	usemax	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err attr_addfilterget_proc	(	void *	x,
		method	proc
	)

Attaches a custom filter method to an attribute.

The filter will only be called for values retrieved from the attribute using the attribute's get function.

Parameters:

	x	Pointer to the attribute to receive the filter
	proc	A filter method

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Remarks:

The filter method should be prototyped and implemented as described above for the attr_addfilterset_proc() function.

t_max_err attr_addfilterset_clip	(	void *	x,
		double	min,
		double	max,
		long	usemin,
		long	usemax
	)

Attaches a clip filter to an attribute.

The filter will only clip values sent to the attribute using the attribute's set function.

Parameters:

	x	Pointer to the attribute to receive the filter
	min	Minimum value for the clip filter
	max	Maximum value for the clip filter
	usemin	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.
	usemax	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err attr_addfilterset_clip_scale	(	void *	x,
		double	scale,
		double	min,
		double	max,
		long	usemin,
		long	usemax
	)

Attaches a clip/scale filter to an attribute.

The filter will only clip and scale values sent to the attribute using the attribute's set function.

Parameters:

	x	Pointer to the attribute to receive the filter
	scale	Scale value. Data sent to the attribute will be scaled by this amount. Scaling occurs previous to clipping.
	min	Minimum value for the clip filter
	max	Maximum value for the clip filter
	usemin	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.
	usemax	Sets this value to 0 if the minimum clip value should not be used. Otherwise, set the value to non-zero.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err attr_addfilterset_proc	(	void *	x,
		method	proc
	)

Attaches a custom filter method to an attribute.

The filter will only be called for values retrieved from the attribute using the attribute's set function.

Parameters:

	x	Pointer to the attribute to receive the filter
	proc	A filter method

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Remarks:

The filter method should be prototyped and implemented as follows:

    t_max_err myfiltermethod(void *parent, void *attr, long ac, t_atom *av);

    t_max_err myfiltermethod(void *parent, void *attr, long ac, t_atom *av)
    {
        long i;
        float temp,

        // this filter rounds off all values
        // assumes that the data is float 
        for (i = 0; i < ac; i++) {
            temp = atom_getfloat(av + i);
            temp = (float)((long)(temp + 0.5));
            atom_setfloat(av + i, temp);
        }
        return MAX_ERR_NONE;
    }

void attr_args_dictionary	(	t_dictionary *	x,
		short	ac,
		t_atom *	av
	)

Create a dictionary of attribute-name, attribute-value pairs from an array of atoms containing an attribute definition list.

Parameters:

	x	A dictionary instance pointer.
	ac	The number of atoms to parse in av.
	av	A pointer to the first of the array of atoms containing the attribute values.

Remarks:

The code example below shows the creation of a list of atoms using atom_setparse(), and then uses that list of atoms to fill the dictionary with attr_args_dictionary().

    long ac = 0;
    t_atom *av = NULL;
    char parsebuf[4096];
    t_dictionary *d = dictionary_new();
    t_atom a;
    
    sprintf(parsebuf,"@defrect %.6f %.6f %.6f %.6f @title Untitled @presentation 0 ", r->x, r->y, r->width, r->height);
    atom_setparse(&ac, &av, parsebuf);
    attr_args_dictionary(d, ac, av);
    atom_setobj(&a, d);

long attr_args_offset	(	short	ac,
		t_atom *	av
	)

Determines the point in an atom list where attribute arguments begin.

Developers can use this function to assist in the manual processing of attribute arguments, when attr_args_process() doesn't provide the correct functionality for a particular purpose.

Parameters:

	ac	The count of t_atoms in av
	av	An atom list

Returns:

This function returns an offset into the atom list, where the first attribute argument occurs. For instance, the atom list foo bar 3.0 @mode 6 would cause attr_args_offset to return 3 (the attribute mode appears at position 3 in the atom list).

void attr_args_process	(	void *	x,
		short	ac,
		t_atom *	av
	)

Takes an atom list and properly set any attributes described within.

This function is typically used in an object's new method to conveniently process attribute arguments.

Parameters:

	x	The object whose attributes will be processed
	ac	The count of t_atoms in av
	av	An atom list

Remarks:

Here is a typical example of usage:

    void *myobject_new(t_symbol *s, long ac, t_atom *av)
    {
        t_myobject *x = NULL;

        if (x=(t_myobject *)object_alloc(myobject_class))
        {
            // initialize any data before processing
            // attributes to avoid overwriting 
            // attribute argument-set values
            x->data = 0; 

            // process attr args, if any
            attr_args_process(x, ac, av);
        }
        return x;
    }

void attr_dictionary_process	(	void *	x,
		t_dictionary *	d
	)

Set attributes for an object that are defined in a dictionary.

Objects with dictionary constructors, such as UI objects, should call this method to set their attributes when an object is created.

Parameters:

	x	The object instance pointer.
	d	The dictionary containing the attributes.

See also:

attr_args_process()

t_object* attr_offset_array_new	(	char *	name,
		t_symbol *	type,
		long	size,
		long	flags,
		method	mget,
		method	mset,
		long	offsetcount,
		long	offset
	)

Create a new attribute.

The attribute references an array of memory stored outside of itself, in the object's data structure. Attributes created using attr_offset_array_new() can be assigned either to classes (using the class_addattr() function) or to objects (using the object_addattr() function).

Parameters:

	name	A name for the attribute, as a C-string
	type	A t_symbol * representing a valid attribute type. At the time of this writing, the valid type-symbols are: _sym_char (char), _sym_long (long), _sym_float32 (32-bit float), _sym_float64 (64-bit float), _sym_atom (Max t_atom pointer), _sym_symbol (Max t_symbol pointer), _sym_pointer (generic pointer) and _sym_object (Max t_object pointer).
	size	Maximum number of items that may be in the array.
	flags	Any attribute flags, expressed as a bitfield. Attribute flags are used to determine if an attribute is accessible for setting or querying. The available accessor flags are defined in e_max_attrflags.
	mget	The method to use for the attribute's get functionality. If mget is NULL, the default method is used. See the discussion under attribute_new(), for more information.
	mset	The method to use for the attribute's set functionality. If mset is NULL, the default method is used. See the discussion under attribute_new(), for more information.
	offsetcount	Byte offset into the object class's data structure of a long variable describing how many array elements (up to size) comprise the data to be referenced by the attribute. Typically, the calcoffset macro is used to calculate this offset.
	offset	Byte offset into the class data structure of the object which will "own" the attribute. The offset should point to the data to be referenced by the attribute. Typically, the calcoffset macro is used to calculate this offset.

Returns:

This function returns the new attribute's object pointer if successful, or NULL if unsuccessful.

Remarks:

For instance, to create a new attribute which references an array of 10 t_atoms (atm; the current number of "active" elements in the array is held in the variable atmcount) in an object class's data structure:

    t_object *attr = attr_offset_array_new("myattrarray", _sym_atom / * matches data size * /, 10 / * max * /, 0 / * no flags * /, (method)0L, (method)0L, calcoffset(t_myobject, atmcount) / * count * /, calcoffset(t_myobject, atm) / * data * /);

t_object* attr_offset_new	(	char *	name,
		t_symbol *	type,
		long	flags,
		method	mget,
		method	mset,
		long	offset
	)

Create a new attribute.

The attribute references memory stored outside of itself, in the object's data structure. Attributes created using attr_offset_new() can be assigned either to classes (using the class_addattr() function) or to objects (using the object_addattr() function).

Parameters:

	name	A name for the attribute, as a C-string
	type	A t_symbol * representing a valid attribute type. At the time of this writing, the valid type-symbols are: _sym_char (char), _sym_long (long), _sym_float32 (32-bit float), _sym_float64 (64-bit float), _sym_atom (Max t_atom pointer), _sym_symbol (Max t_symbol pointer), _sym_pointer (generic pointer) and _sym_object (Max t_object pointer).
	flags	Any attribute flags, expressed as a bitfield. Attribute flags are used to determine if an attribute is accessible for setting or querying. The available accessor flags are defined in e_max_attrflags.
	mget	The method to use for the attribute's get functionality. If mget is NULL, the default method is used. See the discussion under attribute_new(), for more information.
	mset	The method to use for the attribute's set functionality. If mset is NULL, the default method is used. See the discussion under attribute_new(), for more information.
	offset	Byte offset into the class data structure of the object which will "own" the attribute. The offset should point to the data to be referenced by the attribute. Typically, the calcoffset macro (described above) is used to calculate this offset.

Returns:

This function returns the new attribute's object pointer if successful, or NULL if unsuccessful.

Remarks:

For instance, to create a new attribute which references the value of a double variable (val) in an object class's data structure:

    t_object *attr = attr_offset_new("myattr", _sym_float64 / * matches data size * /, 0 / * no flags * /, (method)0L, (method)0L, calcoffset(t_myobject, val));

t_object* attribute_new	(	char *	name,
		t_symbol *	type,
		long	flags,
		method	mget,
		method	mset
	)

Create a new attribute.

The attribute will allocate memory and store its own data. Attributes created using attribute_new() can be assigned either to classes (using the class_addattr() function) or to objects (using the object_addattr() function).

Parameters:

	name	A name for the attribute, as a C-string
	type	A t_symbol * representing a valid attribute type. At the time of this writing, the valid type-symbols are: _sym_char (char), _sym_long (long), _sym_float32 (32-bit float), _sym_float64 (64-bit float), _sym_atom (Max t_atom pointer), _sym_symbol (Max t_symbol pointer), _sym_pointer (generic pointer) and _sym_object (Max t_object pointer).
	flags	Any attribute flags, expressed as a bitfield. Attribute flags are used to determine if an attribute is accessible for setting or querying. The available accessor flags are defined in e_max_attrflags.
	mget	The method to use for the attribute's get functionality. If mget is NULL, the default method is used.
	mset	The method to use for the attribute's set functionality. If mset is NULL, the default method is used.

Returns:

This function returns the new attribute's object pointer if successful, or NULL if unsuccessful.

Remarks:

Developers wishing to define custom methods for get or set functionality need to prototype them as:

    t_max_err myobject_myattr_get(t_myobject *x, void *attr, long *ac, t_atom **av);

    t_max_err myobject_myattr_set(t_myobject *x, void *attr, long ac, t_atom *av);

Implementation will vary, of course, but need to follow the following basic models. Note that, as with custom getvalueof and setvalueof methods for the object, assumptions are made throughout Max that getbytes() has been used for memory allocation. Developers are strongly urged to do the same:

    t_max_err myobject_myattr_get(t_myobject *x, void *attr, long *ac, t_atom **av)
    {
        if (*ac && *av)
            // memory passed in; use it
        else {
            *ac = 1; // size of attr data
            *av = (t_atom *)getbytes(sizeof(t_atom) * (*ac));
            if (!(*av)) {
                *ac = 0;
                return MAX_ERR_OUT_OF_MEM;
            }
        }
        atom_setlong(*av, x->some_value);
        return MAX_ERR_NONE;
    }

    t_max_err myobject_myattr_set(t_myobject *x, void *attr, long ac, t_atom *av)
    {
        if (ac && av) {
            x->some_value = atom_getlong(av);
        }
        return MAX_ERR_NONE;
    }

t_max_err object_addattr	(	void *	x,
		t_object *	attr
	)

Attaches an attribute directly to an object.

Parameters:

	x	An object to which the attribute should be attached
	attr	The attribute's pointer—this should be a pointer returned from attribute_new(), attr_offset_new() or attr_offset_array_new().

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

void* object_attr_get	(	void *	x,
		t_symbol *	attrname
	)

Returns the pointer to an attribute, given its name.

Parameters:

	x	Pointer to the object whose attribute is of interest
	attrname	The attribute's name

Returns:

This function returns a pointer to the attribute, if successful, or NULL, if unsuccessful.

Referenced by jit_attr_getchar_array(), jit_attr_getdouble_array(), jit_attr_getfloat(), jit_attr_getfloat_array(), jit_attr_getlong(), jit_attr_getlong_array(), jit_attr_getsym(), jit_attr_getsym_array(), jit_attr_setchar_array(), jit_attr_setdouble_array(), jit_attr_setfloat(), jit_attr_setfloat_array(), jit_attr_setlong(), jit_attr_setlong_array(), jit_attr_setsym(), jit_attr_setsym_array(), jit_object_attr_get(), jit_object_exportattrs(), and max_jit_attr_set().

t_max_err object_attr_get_rect	(	t_object *	o,
		t_symbol *	name,
		t_rect *	rect
	)

Gets the value of a t_rect attribute, given its parent object and name.

Do not use this on a jbox object -- use jbox_get_rect_for_view() instead!

Parameters:

	o	The attribute's parent object
	name	The attribute's name
	rect	The address of a valid t_rect whose values will be filled-in from the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

long object_attr_getchar_array	(	void *	x,
		t_symbol *	s,
		long	max,
		uchar *	vals
	)

Retrieves the value of an attribute, given its parent object and name.

This function uses a developer-allocated array to copy data to. Developers wishing to retrieve the value of an attribute without pre-allocating memory should refer to the object_attr_getvalueof() function.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	max	The number of array elements in vals. The function will take care not to overwrite the bounds of the array.
	vals	Pointer to the first element of a pre-allocated array of unsigned char data.

Returns:

This function returns the number of elements copied into vals.

Remarks:

If the attribute is not of the type specified by the function, the function will attempt to coerce a valid value from the attribute.

Referenced by jit_attr_getchar_array().

t_max_err object_attr_getcolor	(	t_object *	b,
		t_symbol *	attrname,
		t_jrgba *	prgba
	)

Gets the value of a t_jrgba attribute, given its parent object and name.

Parameters:

	b	The attribute's parent object
	attrname	The attribute's name
	prgba	The address of a valid t_jrgba whose values will be filled-in from the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

long object_attr_getdouble_array	(	void *	x,
		t_symbol *	s,
		long	max,
		double *	vals
	)

Retrieves the value of an attribute, given its parent object and name.

This function uses a developer-allocated array to copy data to. Developers wishing to retrieve the value of an attribute without pre-allocating memory should refer to the object_attr_getvalueof() function.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	max	The number of array elements in vals. The function will take care not to overwrite the bounds of the array.
	vals	Pointer to the first element of a pre-allocated array of double data.

Returns:

This function returns the number of elements copied into vals.

Remarks:

If the attribute is not of the type specified by the function, the function will attempt to coerce a valid value from the attribute.

Referenced by jit_attr_getdouble_array().

void object_attr_getdump	(	void *	x,
		t_symbol *	s,
		long	argc,
		t_atom *	argv
	)

Forces a specified object's attribute to send its value from the object's dumpout outlet in the Max interface.

Parameters:

	x	Pointer to the object whose attribute is of interest
	s	The attribute's name
	argc	Unused
	argv	Unused

float object_attr_getfloat	(	void *	x,
		t_symbol *	s
	)

Retrieves the value of an attribute, given its parent object and name.

Parameters:

	x	The attribute's parent object
	s	The attribute's name

Returns:

This function returns the value of the specified attribute, if successful, or 0, if unsuccessful.

Remarks:

If the attribute is not of the type specified by the function, the function will attempt to coerce a valid value from the attribute.

Referenced by jit_attr_getfloat().

long object_attr_getfloat_array	(	void *	x,
		t_symbol *	s,
		long	max,
		float *	vals
	)

Retrieves the value of an attribute, given its parent object and name.

This function uses a developer-allocated array to copy data to. Developers wishing to retrieve the value of an attribute without pre-allocating memory should refer to the object_attr_getvalueof() function.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	max	The number of array elements in vals. The function will take care not to overwrite the bounds of the array.
	vals	Pointer to the first element of a pre-allocated array of float data.

Returns:

This function returns the number of elements copied into vals.

Remarks:

If the attribute is not of the type specified by the function, the function will attempt to coerce a valid value from the attribute.

Referenced by jit_attr_getfloat_array().

t_max_err object_attr_getjrgba	(	void *	ob,
		t_symbol *	s,
		t_jrgba *	c
	)

Retrieves the value of a color attribute, given its parent object and name.

Parameters:

	ob	The attribute's parent object
	s	The attribute's name
	c	The address of a t_jrgba struct that will be filled with the attribute's color component values.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

long object_attr_getlong	(	void *	x,
		t_symbol *	s
	)

Retrieves the value of an attribute, given its parent object and name.

Parameters:

	x	The attribute's parent object
	s	The attribute's name

Returns:

This function returns the value of the specified attribute, if successful, or 0, if unsuccessful.

Remarks:

If the attribute is not of the type specified by the function, the function will attempt to coerce a valid value from the attribute.

Referenced by db_query_silent(), and jit_attr_getlong().

long object_attr_getlong_array	(	void *	x,
		t_symbol *	s,
		long	max,
		long *	vals
	)

Retrieves the value of an attribute, given its parent object and name.

This function uses a developer-allocated array to copy data to. Developers wishing to retrieve the value of an attribute without pre-allocating memory should refer to the object_attr_getvalueof() function.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	max	The number of array elements in vals. The function will take care not to overwrite the bounds of the array.
	vals	Pointer to the first element of a pre-allocated array of long data.

Returns:

This function returns the number of elements copied into vals.

Remarks:

If the attribute is not of the type specified by the function, the function will attempt to coerce a valid value from the attribute.

Referenced by jit_attr_getlong_array().

t_max_err object_attr_getpt	(	t_object *	o,
		t_symbol *	name,
		t_pt *	pt
	)

Gets the value of a t_pt attribute, given its parent object and name.

Parameters:

	o	The attribute's parent object
	name	The attribute's name
	pt	The address of a valid t_pt whose values will be filled-in from the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err object_attr_getsize	(	t_object *	o,
		t_symbol *	name,
		t_size *	size
	)

Gets the value of a t_size attribute, given its parent object and name.

Parameters:

	o	The attribute's parent object
	name	The attribute's name
	size	The address of a valid t_size whose values will be filled-in from the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_symbol* object_attr_getsym	(	void *	x,
		t_symbol *	s
	)

Retrieves the value of an attribute, given its parent object and name.

Parameters:

	x	The attribute's parent object
	s	The attribute's name

Returns:

This function returns the value of the specified attribute, if successful, or the empty symbol (equivalent to gensym("") or _sym_nothing), if unsuccessful.

Referenced by jit_attr_getsym().

long object_attr_getsym_array	(	void *	x,
		t_symbol *	s,
		long	max,
		t_symbol **	vals
	)

Retrieves the value of an attribute, given its parent object and name.

This function uses a developer-allocated array to copy data to. Developers wishing to retrieve the value of an attribute without pre-allocating memory should refer to the object_attr_getvalueof() function.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	max	The number of array elements in vals. The function will take care not to overwrite the bounds of the array.
	vals	Pointer to the first element of a pre-allocated array of t_symbol *s.

Returns:

This function returns the number of elements copied into vals.

Referenced by jit_attr_getsym_array().

method object_attr_method	(	void *	x,
		t_symbol *	methodname,
		void **	attr,
		long *	get
	)

Returns the method of an attribute's get or set function, as well as a pointer to the attribute itself, from a message name.

Parameters:

	x	Pointer to the object whose attribute is of interest
	methodname	The Max message used to call the attribute's get or set function. For example, gensym("mode") or gensym("getthresh").
	attr	A pointer to a void *, which will be set to the attribute pointer upon successful completion of the function
	get	A pointer to a long variable, which will be set to 1 upon successful completion of the function, if the queried method corresponds to the get function of the attribute.

Returns:

This function returns the requested method, if successful, or NULL, if unsuccessful.

t_max_err object_attr_set_rect	(	t_object *	o,
		t_symbol *	name,
		t_rect *	rect
	)

Sets the value of a t_rect attribute, given its parent object and name.

Do not use this on a jbox object -- use jbox_get_rect_for_view() instead!

Parameters:

	o	The attribute's parent object
	name	The attribute's name
	rect	The address of a valid t_rect whose values will be used to set the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err object_attr_setchar_array	(	void *	x,
		t_symbol *	s,
		long	count,
		uchar *	vals
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	count	The number of array elements in vals
	vals	Pointer to the first element of an array of unsigned char data

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by jit_attr_setchar_array().

t_max_err object_attr_setcolor	(	t_object *	b,
		t_symbol *	attrname,
		t_jrgba *	prgba
	)

Sets the value of a t_jrgba attribute, given its parent object and name.

Parameters:

	b	The attribute's parent object
	attrname	The attribute's name
	prgba	The address of a valid t_jrgba whose values will be used to set the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err object_attr_setdouble_array	(	void *	x,
		t_symbol *	s,
		long	count,
		double *	vals
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	count	The number of array elements in vals
	vals	Pointer to the first element of an array of double data

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by jit_attr_setdouble_array().

t_max_err object_attr_setfloat	(	void *	x,
		t_symbol *	s,
		float	c
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	c	An floating point value; the new value for the attribute

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by jit_attr_setfloat().

t_max_err object_attr_setfloat_array	(	void *	x,
		t_symbol *	s,
		long	count,
		float *	vals
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	count	The number of array elements in vals
	vals	Pointer to the first element of an array of float data

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by jit_attr_setfloat_array().

t_max_err object_attr_setjrgba	(	void *	ob,
		t_symbol *	s,
		t_jrgba *	c
	)

Sets the value of a color attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	ob	The attribute's parent object
	s	The attribute's name
	c	The address of a t_jrgba struct that contains the new color.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err object_attr_setlong	(	void *	x,
		t_symbol *	s,
		long	c
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	c	An integer value; the new value for the attribute

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by db_query_silent(), and jit_attr_setlong().

t_max_err object_attr_setlong_array	(	void *	x,
		t_symbol *	s,
		long	count,
		long *	vals
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	count	The number of array elements in vals
	vals	Pointer to the first element of an array of long data

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by jit_attr_setlong_array().

t_max_err object_attr_setparse	(	t_object *	x,
		t_symbol *	s,
		char *	parsestr
	)

Set an attribute value with one or more atoms parsed from a C-string.

Parameters:

	x	The object whose attribute will be set.
	s	The name of the attribute to set.
	parsestr	A C-string to parse into an array of atoms to set the attribute value.

Returns:

A Max error code.

See also:

atom_setparse()

t_max_err object_attr_setpt	(	t_object *	o,
		t_symbol *	name,
		t_pt *	pt
	)

Sets the value of a t_pt attribute, given its parent object and name.

Parameters:

	o	The attribute's parent object
	name	The attribute's name
	pt	The address of a valid t_pt whose values will be used to set the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err object_attr_setsize	(	t_object *	o,
		t_symbol *	name,
		t_size *	size
	)

Sets the value of a t_size attribute, given its parent object and name.

Parameters:

	o	The attribute's parent object
	name	The attribute's name
	size	The address of a valid t_size whose values will be used to set the attribute.

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err object_attr_setsym	(	void *	x,
		t_symbol *	s,
		t_symbol *	c
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	c	A t_symbol *; the new value for the attribute

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by db_view_setquery(), and jit_attr_setsym().

t_max_err object_attr_setsym_array	(	void *	x,
		t_symbol *	s,
		long	count,
		t_symbol **	vals
	)

Sets the value of an attribute, given its parent object and name.

The function will call the attribute's set method, using the data provided.

Parameters:

	x	The attribute's parent object
	s	The attribute's name
	count	The number of array elements in vals
	vals	Pointer to the first element of an array of t_symbol *s

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by jit_attr_setsym_array().

t_max_err object_attr_setvalueof	(	void *	x,
		t_symbol *	s,
		long	argc,
		t_atom *	argv
	)

Sets the value of an object's attribute.

Parameters:

	x	Pointer to the object whose attribute is of interest
	s	The attribute's name
	argc	The count of arguments in argv
	argv	Array of t_atoms; the new desired data for the attribute

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

Referenced by jit_object_importattrs().

long object_attr_usercanget	(	void *	x,
		t_symbol *	s
	)

Determines if the value of an object's attribute can be queried from the Max interface (i.e.

if its ATTR_GET_OPAQUE_USER flag is set).

Parameters:

	x	Pointer to the object whose attribute is of interest
	s	The attribute's name

Returns:

This function returns 1 if the value of the attribute can be queried from the Max interface. Otherwise, it returns 0.

Referenced by jit_object_attr_usercanget().

long object_attr_usercanset	(	void *	x,
		t_symbol *	s
	)

Determines if an object's attribute can be set from the Max interface (i.e.

if its ATTR_SET_OPAQUE_USER flag is set).

Parameters:

	x	Pointer to the object whose attribute is of interest
	s	The attribute's name

Returns:

This function returns 1 if the attribute can be set from the Max interface. Otherwise, it returns 0.

Referenced by jit_object_attr_usercanset().

t_max_err object_chuckattr	(	void *	x,
		t_symbol *	attrsym
	)

Detach an attribute from an object that was previously attached with object_addattr().

This function will not free the attribute (use object_free() to do this manually).

Parameters:

	x	The object to which the attribute is attached
	attrsym	The attribute's name

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

t_max_err object_deleteattr	(	void *	x,
		t_symbol *	attrsym
	)

Detach an attribute from an object that was previously attached with object_addattr().

The function will also free all memory associated with the attribute. If you only wish to detach the attribute, without freeing it, see the object_chuckattr() function.

Parameters:

	x	The object to which the attribute is attached
	attrsym	The attribute's name

Returns:

This function returns the error code MAX_ERR_NONE if successful, or one of the other error codes defined in e_max_errorcodes if unsuccessful.

void* object_new_parse	(	t_symbol *	name_space,
		t_symbol *	classname,
		char *	parsestr
	)

Create a new object with one or more atoms parsed from a C-string.

The object's new method must have an A_GIMME signature.

Parameters:

	name_space	The namespace in which to create the instance. Typically this is either CLASS_BOX or CLASS_NOBOX.
	classname	The name of the class to instantiate.
	parsestr	A C-string to parse into an array of atoms to set the attribute value.

Returns:

A pointer to the new instance.

See also:

atom_setparse()

object_new_typed()