MAX/MSP SDK学习01：Object的基本构成、创建&销毁&行为函数的定义、属性的赋值、以及相关注意事项

Object的基本构成、创建&销毁&行为函数的定义、属性的赋值、以及相关注意事项。

#include "ext.h"			// standard Max include, always required
#include "ext_obex.h"		// required for new style Max object
 
// object struct，定义属性
typedef struct _simplemaxDiffTypes {
	t_object	ob;			// the object itself (must be first)
	/* 自定义属性 */
	long value_long;
	double value_float;
} t_simplemaxDiffTypes;
 
// 必备函数
void* simplemaxDiffTypes_new(t_symbol* s, long argc, t_atom* argv);
void simplemaxDiffTypes_free(t_simplemaxDiffTypes* x);
void simplemaxDiffTypes_assist(t_simplemaxDiffTypes* x, void* b, long m, long a, char* s);
// 自定义函数
void simplemaxDiffTypes_int(t_simplemaxDiffTypes* x, long l);
void simplemaxDiffTypes_double(t_simplemaxDiffTypes* x, double f);
void simplemaxDiffTypes_bang(t_simplemaxDiffTypes* x);
 
// global class pointer variable
void* simplemaxDiffTypes_class;
 
void ext_main(void* r) {
	t_class* c;
 
	// "simplemaxDiffTypes" 建议和项目名一样，否则在max/msp中创建自定义组件会出问题。
	c = class_new("simplemaxDiffTypes", (method)simplemaxDiffTypes_new, (method)simplemaxDiffTypes_free,
		(long)sizeof(t_simplemaxDiffTypes), 0L /* leave NULL!! */, A_GIMME, 0);
 
	/* you CAN'T call this from the patcher */
	class_addmethod(c, (method)simplemaxDiffTypes_assist, "assist", A_CANT, 0);
 
	// 自定义方法
	class_addmethod(c, (method)simplemaxDiffTypes_int, "int", A_LONG, 0); // 接收入口传入的long型数据，引号中必须写int
	class_addmethod(c, (method)simplemaxDiffTypes_double, "float", A_FLOAT, 0); // 接收入口传入的double型数据
	class_addmethod(c, (method)simplemaxDiffTypes_bang, "bang", 0);  // 接收入口传入的bang消息
 
	class_register(CLASS_BOX, c); /* CLASS_NOBOX */
	simplemaxDiffTypes_class = c;
 
	post("I am the simplemaxDiffTypes object");
}
 
void simplemaxDiffTypes_assist(t_simplemaxDiffTypes* x, void* b, long m, long a, char* s) {
	if (m == ASSIST_INLET) { // inlet
		sprintf(s, "I am inlet %ld", a);
	} else {	// outlet
		sprintf(s, "I am outlet %ld", a);
	}
}
 
void simplemaxDiffTypes_free(t_simplemaxDiffTypes* x) {
	;
}
 
// 要操作Object中的属性，第一个形参通常为Object的指针
void simplemaxDiffTypes_int(t_simplemaxDiffTypes* x, long l) { // 接收入口传入的long型数据，为value_long赋值
	x->value_long = l;
}
 
void simplemaxDiffTypes_double(t_simplemaxDiffTypes* x, double f) { // 注意，形参类型绝不能写错. 比如这里不能用float接受object中定义的double，否则无法传参.
	x->value_float = f;
}
 
void simplemaxDiffTypes_bang(t_simplemaxDiffTypes* x) {
	post("value_long: %d, value_float: %lf", x->value_long, x->value_float);
}
 
/* argc指在创建组件时，直接跟在组件后面的参数个数；argv存储参数具体值*/
void* simplemaxDiffTypes_new(t_symbol* s, long argc, t_atom* argv) {  // 分配内存创建object，初始化属性，创建入口和出口（默认一个入口，无出口）
	t_simplemaxDiffTypes* x = NULL;
	long i;
 
	if ((x = (t_simplemaxDiffTypes*)object_alloc(simplemaxDiffTypes_class))) {  // 使用全局指针创建新实例
		object_post((t_object*)x, "a new %s object was instantiated: %p", s->s_name, x);
		object_post((t_object*)x, "it has %ld arguments", argc);
 
		// 属性赋初值
		x->value_long = 1;
		x->value_float = 2.2;
 
		for (i = 0; i < argc; i++) { // 打印出创建object时跟在Object名后的参数的详细信息
			if ((argv + i)->a_type == A_LONG) {
				object_post((t_object*)x, "arg %ld: long (%ld)", i, atom_getlong(argv + i));
			} else if ((argv + i)->a_type == A_FLOAT) {
				object_post((t_object*)x, "arg %ld: float (%f)", i, atom_getfloat(argv + i));
			} else if ((argv + i)->a_type == A_SYM) {
				object_post((t_object*)x, "arg %ld: symbol (%s)", i, atom_getsym(argv + i)->s_name);
			} else {
				object_error((t_object*)x, "forbidden argument");
			}
		}
	}
	return (x);
}

运行结果：

1. 创建Object时，打印出创建object时跟在Object名后的参数的详细信息。

2. 传参测试：