tolua++需要将 c/c++ 中的类型,变量,函数,对象导出到lua
-
通过 tolua_reg_types(lua_State* tolua_S) 将类型导出,作用是为每一个需要导出到 lua 中的 c++ 类型创建元表,比如 CCNode 这种类型,就会在注册表中创建一个元表 CCNode_mt。( 之后会用 _R 代表注册表 , _G 代表全局表 , type_mt 代表类型为type的元表。 )
-
通过 tolua_cclass (lua_State* L, const char* lname, const char* name, const char* base, lua_CFunction col) 把基类设为子类的元表;同时在 _R.tolua_super 中以子类的元表为键,创建一张表作为值,而这张表会以基类,基类的基类(递归下去)为键,true/false 为值 ; 还会让基类和子类共同享有同一张tolua_ubox表(以c++指针为键 , fulluserdata为值)。 最后让 _G 持有 name_mt,即:_G.lname = name_mt。所以对于一个 c++ 类型,tolua++ 为其创建的元表最终会让全局表和注册表共同持有。
-
通过 tolua_function (lua_State* L, const char* name, lua_CFunction func) 将成员方法导出到 步骤1 创建的元表中;即:_G.type_mt.name = func
-
通过 tolua_variable(lua_State* L, const char* name, lua_CFunction get, lua_CFunction set) 在c++类型对象的元表中准备两张表_G.type_mt.get = {} , _G.type_mt.set = {} ; 两张表以变量名为键,get/set方法为值。
上面c++数据的导出步骤就是 tolua_Cocos2d_open(lua_State* tolua_S) 的实现,在CCLuaStack 初始化的时候完成。
tolua_Cocos2d_open (lua_State* tolua_S)内容分析
1: tolua_open(tolua_S) 创建一系列全局的table
-
_R.tolua_opened = true
-
_R.tolua_value_root = { }
-
_R.tolua_ubox = { }
-
setmetatable(_R.tolua_ubox,{__mode = v })
-
_R.tolua_super = { }
-
_R.tolua_gc = { }
-
_R.tolua_gc_event = class_gc_event(_R.tolua_gc , _R.tolua_super)
-
_R.tolua_commonclass = { }
-
_G.tolua = { type = tolua_bnd_type , takeownership = tolua_bnd_takeownership , releaseownership = tolua_bnd_releaseownership , cast = tolua_bnd_cast ,isnull = tolua_bnd_isnulluserdata , inherit = tolua_bnd_inherit }
-
如果lua版本是5.1: _G.tolua.setpeer = tolua_bnd_setpeer ; _G.tolua.getpeer = tolua_bnd_getpeer ;
2: tolua_reg_types (lua_State* tolua_S) 为需要导出到lua中的c++类型注册元表
3 tolua_cclass( L , lname , name , base ,col ) 实现类之间的关联,让子类能够继承父类
-
mapinheritance(L,derived,base) 将base设为derived的元表,这样就可以认为derived派生于base.
1: 内部会调用 set_ubox(L) 实现基类与派生类共享同一份tolua_ubox表
2: 然后将基类设置为子类的metatable,如果基类为nil , 就将 _R.tolua_commonclass 设置为子类的元表。
-
mapsuper(L,derived,base)这个方法在上面提到了,就是在 _R.tolua_super 表中创建一个索引表可以用来判断两个类之间是否有继承关系。
tolua_super.derived_mt = { base_type = true , base_type_B = true , base_type_C = true}
-
push_collector(L,type,col) 这个地方的col是个lua_CFunction类型;type_mt.collector = col 将col函数设为type的元表collector字段所对应的元方法。c++ 对象释放的时候会要触发这个函数。
-
_G.lname = name_mt 最后这个步骤就是把之前c++类型在注册表中创建的元表让全局表也持有一份。
4 接下来就是c++类中的方法和成员变量的导出,就以导出 ccColor3B类中的成员方法和变量 为例子
-
tolua_cclass(tolua_S,"ccColor3B","ccColor3B","",tolua_collect_ccColor3B) 先将类导出到_G中,并且设置好继承关系.
-
tolua_beginmodule(tolua_S,"ccColor3B"); 将 _G.ccColor3B 压入栈中(此时lua栈负1位置是ccColor3B_mt,负2位置是_G).
-
tolua_function(tolua_S,"new",tolua_Cocos2d_ccColor3B_new00); 将方法导出到c++类型所对应的元表中即:
_G.ccColor3B.new = tolua_Cocos2d_ccColor3B_new00
-
tolua_function(tolua_S,"new_local",tolua_Cocos2d_ccColor3B_new00_local);
_G.ccColor3B.new_local = tolua_Cocos2d_ccColor3B_new00_local 同理下面的一系列tolua_function都会将c++方法注册到对应类型的元表中。
-
tolua_variable(tolua_S,"r",tolua_get_ccColor3B_unsigned_r,tolua_set_ccColor3B_unsigned_r)
tolua_variable(tolua_S,"g",tolua_get_ccColor3B_unsigned_g,tolua_set_ccColor3B_unsigned_g);
tolua_variable(tolua_S,"b",tolua_get_ccColor3B_unsigned_b,tolua_set_ccColor3B_unsigned_b);
tolua_variable 的逻辑是为每一个类型创建一张get表,一张set表,然后将变量对应的 get / set 方法放到 get表 / set表中;这样在lua层访问成员变量最终就会索引到对应的存取方法。 即:_G.ccColor3B.get = { "r" = tolua_get_ccColor3B_unsigned_r , "g" = tolua_get_ccColor3B_unsigned_g , "b" = tolua_get_ccColor3B_unsigned_b }
_G.ccColor3B.set = { "r" = tolua_set_ccColor3B_unsigned_r , "g" = tolua_set_ccColor3B_unsigned_g , "b" = tolua_set_ccColor3B_unsigned_b }
tolua++ 胶水函数分析 , 还是以ccColor3B为例
1. tolua_Cocos2d_ccColor3B_new00(lua_State* tolua_S) 将C++对象的指针以full userdata 的形式传入到 lua 层
- ccColor3B* tolua_ret = (ccColor3B*) Mtolua_new((ccColor3B)())先创建一个c++对象,获取到指针。
-
tolua_pushusertype(tolua_S,(void*)tolua_ret,"ccColor3B") 函数在 c++ 层创建对象,然后创建full userdata压入栈中,函数最后会把 userdata 地址返回到lua层,lua 要想操作c++对象就得操作 fulluserdata, 又因为fulluserdata 的元表是 c++对象在lua中的元表,所以最终 lua 就是通过操作c++类型对应的元表来控制c++对象。这也是前面一系列步骤的意义。
压入c++对象时候,以 light userdata 为键,full userdata 为值把这一对key-value存入tolua_ubox中。 即:
ccColor3B_mt.tolua_ubox.tolua_ret = userdata
setmetatable(userdata,ccColor3B_mt)
2. tolua_Cocos2d_ccColor3B_new00_local 与前者相比多了一个tolua_register_gc方法,其他的都一样
- tolua_register_gc : 以c++指针为键,c++类型对应的元表为值,将这对key-value放于_R.tolua_gc中。
3. tolua_get_ccColor3B_unsigned_r(lua_State* tolua_S) 获取ccColor3B类中的r值
- 首先通过 tolua_tousertype 从栈顶拿到userdata中的指针ptr, 把 ptr 转型为(ccColor3B*)
- 然后将 (lua_Number)ptr->r 压入栈中,最后返回给lua层。
总结
-
tolua++ 为需要导出到lua中的 c++类型 创建元表,这个元表由 注册表 和 全局表共同持有,同时在元表中注册了一系列元方法。
-
tolua++ 将父类型设为子类型的元表;父子类共同持有同一份tolua_ubox;同时在tolua_super中为c++类型准备了一张类型映射表,可以通过该表来查询自身有哪些父类。 这样就可以在lua层实现类的继承。
- 通过调用 tolua_register_gc 方法,以c++类型的指针为键,c++类型对应的元表为值 作为key-value插入到_R.tolua_gc中 来管理创建c++对象的内存。
-
tolua++ 对 c++ 对象内存的管理,以及 c++对象在lua层的扩展准备放下一篇文章再写!
再添加一张图,这样更加清晰
|
请发表评论