obex メンバはあなたの Max オブジェクトに、アトリビュート管理などの追加機能を提供し、これは void * （void へのポインタ）として定義されます。従来、obex はオブジェクト構造体の２番目のアイテムとして追加されましたが、この位置に関しては義務づけられてはいません。

typedef struct _myobex { t_object ob; void *obex; ... } t_myobex;

obex API を使用するためのクラス定義では、従来の関数setup() を class_new()で置き換えなければなりません。class_new() は次のようにプロトタイプ宣言されます：

t_class *class_new(char *name, method mnew, method mfree, long size, method mmenu, short type, ...);

class_new() はsetup()と同じですが、次の点に注意して下さい：

• class_new() はt_class *を返します。これは登録されなければなりません（下記を参照）。
• class_new()は 最初の引数として、t_messlist **ではなく、C文字列の 'name' を取ります。

例えば、新しい obex クラスとして A_GIMME 引数リストを取る myobex を作る場合、次のような class_new() 関数が使われます。

t_class *c = class_new("myobex",(method)myobex_new, (method)myobex_free,sizeof(t_myobex), (method)0L,A_GIMME, 0);

obex クラスメンバのバイトオフセットは、class_obexoffset_set() 関数を使って、クラスとともに登録されなければなりません。通常は、ヘルパーマクロ calcoffset() が使われます。　

class_obexoffset_set(c, calcoffset(t_myobex, obex));

プロジェクトに、ソースコードファイルcommonsyms.c（c74support/max-includes/common/ 内にあります）を加え、main() に次の呼出しを追加して下さい。これは、多くの有用なシンボル（このリストを見るためには、ヘッダファイルcommonsyms.h を参照して下さい）を初期化します。このドキュメントでは、コモンシンボル が利用できるものと仮定しています。 　

common_symbols_init();

obex を使用するクラスでは、メソッドの定義で addmess()、addint()、addfloat() などを使う代わりに、関数 class_addmethod() を使って従来型の Max メソッドの定義、登録を行わなければなりません：

t_max_err class_addmethod(t_class *x, method m, char *name, ...);

開発者が今までのオブジェクトを移植するためには、addmess() の呼出しは簡単に変更できます。例えば：

addmess((method)myobj_test, "test", A_GIMME, 0);

は、obex インターフェイスを使うと次のようになります：

class_addmethod(c, (method)myobex_test, "test", A_GIMME, 0);

最初の引数（この例では c ）は、上のように class_new() によって返される t_class * になります。

addmess() によってサポートされる全ての型、 A_LONG、 A_FLOAT、 A_SYM、 A_DEFLONG、 A_DEFFLOAT、A_DEFSYM、A_GIMME、A_CANT は、class_addmethod() によってもサポートされます。

注: addint()、addfloat()、addbang() は、同様に次のような class_addmethod() 呼出しで置き換える必要があります：

class_addmethod(c, (method)myobex_bang, "bang", 0L); class_addmethod(c, (method)myobex_int, "int", A_LONG, 0L); class_addmethod(c, (method)myobex_float, "float", A_FLOAT, 0L);

技術的な注：同様にaddinx() およびaddftx() 関数はclass_addmethod()で置き換えられます。特別なメソッドの名前 “in1”、”in2”、... はintにバインドされるメソッドに使用され、”ft1”、”ft2”、 ...はfloat の場合に用いられます。例えば：

// 2番目のインレットへのintにmyobex_in1メソッドをバインドする
class_addmethod(c,(method)myobex_in1,"in1", A_LONG, 0L);
// 3番目のインレットへのfloatにmyobex_ft1メソッドをバインドする
class_addmethod(c,(method)myobex_ft1,"ft2",A_FLOAT,0L);

新しいオブジェクトを作る開発者には、Max のプロキシインレットを使うことを推奨します。

アトリビュートの定義はメソッドの定義に比べてやや複雑です。実際、アトリビュートには３つの異なる型（attribute、attr_offset、attr_offset_array）が存在します。ほとんどの場合、attr_offset または、attr_offset_array 型を使います。アトリビュートは、実際にはオブジェクトで、および様々な関数やメソッドに応答するものです。より詳しくは、後述の API リファレンスを参照して下さい。

attribute 型は自分自身のデータを格納するアトリビュートのために用いられます。このデータはサポートされるどのような型、長さでもかまいません。attr_offset と attr_offset_array 型は、それ自身のデータを格納しませんが、その代わりに他のデータを参照します。これは、通常、値、あるいはオブジェクト構造体の中の値で、オブジェクト構造体の中でのオフセットによって定義されるものです。attr_offset　型は、サポートされる型のどれか１つによる値を返すオフセット・アトリビュートのために用いられます。attr_offset_array 型は複数の値（リストまたはベクタ）を返すオフセット・アトリビュートのために用いられます。

重要：アトリビュート・アーギュメント（@アトリビュート構文を使用したインスタンス生成に用いられる、オブジェクトの「コマンドライン」上でのアトリビュート設定）をサポートするために、アトリビュートを使用するオブジェクトは、class_new() で A_GIMMEとして定義されなければなりません。

attribute オブジェクトのインスタンス生成には、関数 attribute_new() を使用します。

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

attr_offset オブジェクトのインスタンス生成には、関数attr_offset_new() を使用します。

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

attr_offset_array オブジェクトのインスタンス生成には、関数 attr_offset_array_new() を使用します。

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

引数 mget または mset が NULLの場合、デフォルトの get および set メソッドが用いられます。attr_offset および attr_offset_array アトリビュートの場合には、引数 offset はオブジェクト構造体の中でのデータの開始位置からのバイト単位で表されるオフセットになります。attr_offset_array 型の中では、引数 offsetcount が、データベクタのメンバの数（同様に、あなたはこの数をオブジェクトの構造体に格納します）のバイト単位でのオフセットになります。マクロ　calcoffset()　はこれらのオフセットの計算を容易にするために用いられます。

アトリビュートの型に関わらず、新しく作られたアトリビュートはオブジェクトクラスと共に登録しなければなりません。また、これを行わないと使用することができません。

class_addattr(c, the_new_attr);

例えば、私たちの myobex オブジェクトが次のように定義されると仮定します。

typedef struct _myobex { t_object ob; void *obex; long ldata; // １つのlongの値 float fdata[4]; // ４つのfloatの値のベクタ long fdatacnt; // fdata の値の数(== 4) t_object *attr; // アトリビュート、自分自身のデータを管理します } t_myobex;

私たちは３つの異なるアトリビュートを、次の例のように準備できます。

t_object *attr; long attrflags = 0;
attr = attr_offset_array_new( "float_data", // attrの名前 _sym_float32, // attrの型 (32-bit float) 4, // 配列の最大値 attrflags, // フラグ (method)0L, // デフォルトのgetメソッド (method)0L, // デフォルトのsetメソッド calcoffset(t_myobex, fdatacnt),// カウント calcoffset(t_myobex, fdata)// データ );
class_addattr(c, attr);
attr = attr_offset_new ("long_data", //attrの名前 _sym_long,// attrの型(long) attrflags,// フラグ (method)0L, // デフォルトのgetメソッド (method)0L, // デフォルトのsetメソッド calcoffset(t_myobex, ldata));// データ
class_addattr(c, attr);
attr = attribute_new ("atom_data", // attrの名前 _sym_atom, //attrの型(atom) attrflags, // フラグ (method)0L, // デフォルトのgetメソッド (method)0L); // デフォルトのsetメソッド
class_addattr(c, attr);

アトリビュートの値は attribute_new() の呼出しによって作られ、そして、 class_addattr() によってクラスに追加され、完全なクラスとしてグローバルに使用できるようになる点に注意して下さい。この値を、あなたのクラスの、どのインスタンス化されたオブジェクトからセットしても、クラスの全てのメンバの値を変更します。アトリビュートの他の２つの型は、単に（オブジェクトの構造体の中での、データのオフセットに基づいて）データを参照するだけなので、この動作を行ないません。attribute_new() 関数によってオブジェクトに特有のアトリビュートを作るためには、クラスの代わりに、このアトリビュートをオブジェクトと共に登録する必要があります。詳しくは、後述する obex API リファレンスを参照して下さい。

アトリビュートフラグについては、後で、より詳しく説明します。

あなたのオブジェクトが、ダンプアウト・アウトレットを使用し、quickref ポップアップメニューでのアトリビュートの表示を行うためには、これら２つのメソッドを定義する必要があります。

class_addmethod(c,(method)object_obex_dumpout, "dumpout",A_CANT,0);

class_addmethod(c,(method)object_obex_quickref, "quickref",A_CANT,0);

開発者がobject_obex_dumpout() およびobject_obex_quickref() 関数を定義する必要がない点に注意して下さい。これらは Max カーネルからエクスポートされます。

最終的に、Max があなたのクラスを認識することができるように、class_register() 関数を使ってこれを登録します。

t_max_err class_register(t_symbol *name_space, t_class *x);

引数 name_space は、Max パッチャーの中でインスタンス化される obex クラス（すなわち、box、UI オブジェクトなど） の場合には、定数 CLASS_BOXでなければなりません。また、内部的に使用されるだけのクラスの場合には、定数 CLASS_NOBOX でなければなりません。通常、name_spaceには CLASS_BOX が使用されます。

重要：すべてのメソッドとアトリビュートの定義を行なった後、main() の最後で class_register() 関数を呼び出されなければなりません。

このため、上の myobex クラスのケースでは、次の行が main() の最後で呼び出されます。

class_register(CLASS_BOX, c);

古いクラスモデルの場合と同様、あなたのオブジェクトのクラスをグローバル変数に保存する必要があります。

obex API 関数 class_new() によるクラス定義のために、従来オブジェクトクラスのインスタンス生成に用いられていた関数 newobject() を、object_alloc() に置き換えなければなりません。

void *object_alloc(t_class *c);

使い方は同じです。

ダンプアウト・アウトレットは、アトリビュートを持つオブジェクトが‘get’という問い合わせに対する応答を出力するために用いられます。実際には、これは通常のアウトレットですが、obex オブジェクトと共に登録する必要があります。これを作る最良の方法は次のようなものです。

object_obex_store(x, _sym_dumpout, outlet_new(x, NULL));

最初の引数（ここでは x ）は object_alloc()によって返されるオブジェクトポインタです。ダンプアウト・アウトレットは、オブジェクトの右端に置くという仕様になっているため、通常、他のアウトレットを作成する前に、まずダンプアウト・アウトレットを最初に作ります。

アトリビュートは、通常、オブジェクトボックスの中で、@attrname 構文を使うことによって、直接指定されます。アトリビュートが正しく読み取られるように、次の関数を呼び出さなければなりません。

attr_args_process(x, ac, av);

最初の引数（x）は object_alloc() によって返されるオブジェクトポインタです。２番目と３番目の引数 （ac, av）はあなたの new() メソッドのためのアーギュメントで、 atom のリストによって構成されるものです。main() の中の class_new()　呼出しの中で、あなたのオブジェクトのメッセージリストが、 A_GIMMEとして定義されていたのを思い出して下さい。