MAX/MSP SDK学习02：普通入口、出口、代理入口的创建和使用

1. 普通入口、出口的创建和使用

#include "ext.h"			
#include "ext_obex.h"		

typedef struct _plussz {	
	t_object p_ob;			
	long p_value0;		// 存储入口0的值
	long p_value1;		// 存储入口1的值
	long p_value2;			// 存储入口2的值

	void* p_outlet0;	// 定义出口0的指针
	void* p_outlet1;	// 定义出口1的指针
} t_plussz;

void plussz_bang(t_plussz* x);
void plussz_int(t_plussz* x, long n);
void plussz_in1(t_plussz* x, long n);
void plussz_in2(t_plussz* x, long n);
void plussz_assist(t_plussz* x, void* b, long m, long a, char* s);
void* plussz_new(long n);

t_class* plussz_class;		

void ext_main(void* r) {
	t_class* c;

	c = class_new("plussz", (method)plussz_new, (method)NULL, sizeof(t_plussz), 0L, A_DEFLONG, 0);

	class_addmethod(c, (method)plussz_bang, "bang", 0);			// the method it uses when it gets a bang in the left inlet
	class_addmethod(c, (method)plussz_int, "int", A_LONG, 0);	// 若最左入口传递long（double）数据，其消息必须为"int"（"float"）. 其余入口依次为"in1"（"ft1"）、"in2"（"ft2"）... 
	class_addmethod(c, (method)plussz_in1, "in1", A_LONG, 0);	// 中间入口
	class_addmethod(c, (method)plussz_in2, "in2", A_LONG, 0);	// 最右入口
	// "ft1" is the special message for floats
	class_addmethod(c, (method)plussz_assist, "assist", A_CANT, 0);	// (optional) assistance method needs to be declared like this

	class_register(CLASS_BOX, c);
	plussz_class = c;

}

void* plussz_new(long n) {		// n = int argument typed into object box (A_DEFLONG) -- defaults to 0 if no args are typed

	t_plussz* x;				// local variable (pointer to a t_plussz data structure)

	x = (t_plussz*)object_alloc(plussz_class); // create a new instance of this object

	// 入口创建顺序：从右向左. 入口0默认存在
	intin(x, 2);					// 创建入口2
	intin(x, 1);					// 创建入口1

	// 出口创建顺序：从右向左. 默认无出口，需自己创建
	x->p_outlet1 = bangout(x);  // 创建出口1，发送bang消息
	x->p_outlet0 = intout(x);	// 创建出口0，发送int消息

	x->p_value0 = n;			
	x->p_value1 = n;		
	x->p_value2 = n;			

	return(x);					// return a reference to the object instance
}

void plussz_assist(t_plussz* x, void* b, long m, long a, char* s) { // 4 final arguments are always the same for the assistance method
	if (m == ASSIST_OUTLET)
		sprintf(s, "Sum of Left and Right Inlets");
	else {
		switch (a) {
		case 0:
			sprintf(s, "Inlet %ld: Left Operand (Causes Output)", a);
			break;
		case 1:
			sprintf(s, "Inlet %ld: Right Operand (Added to Left)", a);
			break;
		}
	}
}

void plussz_bang(t_plussz* x) {		// x = reference to this instance of the object
	long sum;							// local variable for this method

	sum = x->p_value0 + x->p_value1;		// add left and right operands
	outlet_int(x->p_outlet0, sum);		// 求和结果从出口0发出
	outlet_bang(x->p_outlet1);			// bang消息从出口1发出
	post("int: %d, in1: %d, in2: %d", x->p_value0, x->p_value1, x->p_value2);
}

void plussz_int(t_plussz* x, long n) {  // x = the instance of the object; n = the int received in the left inlet
	x->p_value0 = n;					
	plussz_bang(x);						// call the bang method to sum and send out our outlet
}

void plussz_in1(t_plussz* x, long n) {	// x = the instance of the object, n = the int received in the right inlet
	x->p_value1 = n;					
}

void plussz_in2(t_plussz* x, long n) {
	x->p_value2 = n;
}

2. 代理入口的创建和使用

#include "ext.h"				// you must include this - it contains the external object's link to available Max functions
#include "ext_obex.h"			// this is required for all objects using the newer style for writing objects.

typedef struct _proxyTest {
	t_object ob;
	t_atom	l;			// stored value from left inlet
	t_atom	r;			// stored value from right inlet
	void* proxy;		// 代理入口
	void* outlet;		// 出口
	long proxy_inletnum;	// 当前正在使用的入口
} t_proxyTest;

// these are prototypes for the methods that are defined below
void* proxyTest_new(long n);
void proxyTest_free(t_proxyTest* x);
void proxyTest_assist(t_proxyTest* x, void* b, long m, long a, char* s);
void proxyTest_bang(t_proxyTest* x);
void proxyTest_int(t_proxyTest* x, long n);
void proxyTest_float(t_proxyTest* x, double f);

t_class* proxyTest_class;		// global pointer to the object class - so max can reference the object

void ext_main(void* r) {
	t_class* c;

	c = class_new("proxyTest", (method)proxyTest_new, (method)proxyTest_free, sizeof(t_proxyTest), 0L, A_DEFLONG, 0);

	class_addmethod(c, (method)proxyTest_bang, "bang", 0);			 // the method it uses when it gets a bang in the left inlet
	class_addmethod(c, (method)proxyTest_int, "int", A_LONG, 0);		 // the method for ints in any inlet
	class_addmethod(c, (method)proxyTest_float, "float", A_FLOAT, 0);	 // the method for floats in any inlet
	class_addmethod(c, (method)proxyTest_assist, "assist", A_CANT, 0); // (optional) assistance method needs to be declared like this

	class_register(CLASS_BOX, c);
	proxyTest_class = c;
}

void* proxyTest_new(long n) {  	// n = int argument typed into object box (A_DEFLONG) -- defaults to 0 if no args are typed
	t_proxyTest* x;				// local variable (pointer to a t_proxyTest data structure)

	x = (t_proxyTest*)object_alloc(proxyTest_class); // create a new instance of this object
	if (x) {
		x->proxy = proxy_new(x, 1, &x->proxy_inletnum);	// 创建代理入口
		x->outlet = outlet_new(x, NULL);				// fully-flexible outlet for any type

		// 赋初值
		atom_setlong(&x->l, 0);
		atom_setlong(&x->r, 0);
	}
	return(x);					
}

void proxyTest_free(t_proxyTest* x) {
	object_free(x->proxy);		// frees all resources associated with the proxy
}

void proxyTest_assist(t_proxyTest* x, void* b, long m, long a, char* s) { // 4 final arguments are always the same for the assistance method
	if (m == ASSIST_INLET) {
		switch (a) {
		case 0:
			sprintf(s, "Inlet %ld: Left Operand (Causes Output)", a);
			break;
		case 1:
			sprintf(s, "Inlet %ld: Right Operand (Added to Left)", a);
			break;
		}
	} else
		sprintf(s, "Sum of Left and Right Inlets");
}

void proxyTest_bang(t_proxyTest* x) {
	long lop;
	float fop;

	if (x->l.a_type == A_LONG && x->r.a_type == A_LONG) {
		lop = atom_getlong(&x->l) + atom_getlong(&x->r);
		outlet_int(x->outlet, lop);  // 输出long
	} else { // OUTPUT A FLOAT
		fop = atom_getfloat(&x->l) + atom_getfloat(&x->r);
		outlet_float(x->outlet, fop);  // 输出double
	}
}

void proxyTest_int(t_proxyTest* x, long n) {  // 有入口收到long型值
	long inlet = proxy_getinlet((t_object*)x); // 用proxy_getinlet函数判断哪个入口接收到值，本质是判断proxy_inletnum的值

	post("int came in via inlet %ld", inlet);

	if (inlet == 1) { // RIGHT INLET
		atom_setlong(&x->r, n); // SET INT VAL
	} else { // LEFT INLET  左入口有值则触发bang
		atom_setlong(&x->l, n);
		proxyTest_bang(x); // bang for left inlet, trigger calculation
	}
}

void proxyTest_float(t_proxyTest* x, double f) { // 有入口收到double型值
	long inlet = proxy_getinlet((t_object*)x); // 用proxy_getinlet函数判断哪个入口接收到值

	post("float came in via inlet %ld", inlet);

	if (inlet == 1) { // RIGHT INLET
		atom_setfloat(&x->r, f); // SET FLOAT VAL
	} else { // LEFT INLET
		atom_setfloat(&x->l, f);
		proxyTest_bang(x); // bang for left inlet, trigger calculation
	}
}