Chipmunk Lua API【DOC精选】.docx

Chipmunk Lua API Version 1.0 2011-11-28 Beijing elooMobile Co., Ltd Revision History No. Date Description Revised by 1 2011-11-28 整理 Shenjf 2 3 目录 1. 引言 3 2. 一级标题 3 2.1. 二级标题 3 2.1.1. 三级标题 3 3. 一级标题 3 3.1. 二级标题 3 3.1.1. 三级标题 3 （注：对于目录是自动生成的，每次更新文档内容后，在目录区右键更新域就可以了，如果大家的目录发现内容比较乱时，可以选择在 视图〉大纲，编辑一下各个标题的级别或者正文，这样目录就会比较整齐了） 1. 引言 本文档说明Chipmunk在Gearbox编程中的Lua 接口。对这些的接口的详细介绍请参考Chipmunk提供的文档，用法和含义完全一样，为了保持一致，本文档中的参数均采用了C 语言的数据类型。实际使用时使用Lua的数据类型即可。 int\float\cpfloat等数字类型直接使用Lua数字，其中float类型可以直接用1而不必须是1.0。 cpvect 使用形如{x=0,y=0}的lua table。 各种instance为调用Chipmunk接口获取的object。比如ChipmunkSpace.New（）得到一个space object的Instance。 各种回调函数为字符串，比如SpaceInstance:EachConstraint(string cpSCIFunc, table data)在Chipmunk的文档中的cpSCIFunc是cpSpaceConstraintIteratorFunc类型，在Lua接口中统一为string类型。 2. 基本数据类型 2.1. cpVect原型 在Lua中使用cpVect对象可以直接使用形如｛x=0,y=0｝的table，而不需要调用cpVect的构造函数，因此不支持cpv()和cpvzero()。 2.1.1. cpVect 数据操作 支持chipmunk中cpVect所有操作函数，在Lua中调用时加上Chipmunk.，形如Chipmunk.cpvadd({x=0,y=0},{x=10,y=10})。 这些函数原型如下： ?cpBool cpveql(const cpVect v1, const cpVect v2) – Check if two vectors are equal. Chipmunk provides an overloaded == operator when used in C++ programs. (Be careful when comparing floating point numbers!) ?cpVect cpvadd(const cpVect v1, const cpVect v2) – Add two vectors. Chipmunk provides an overloaded + operator when used in C++ programs. ?cpVect cpvsub(const cpVect v1, const cpVect v2) – Subtract two vectors. Chipmunk provides an overloaded - operator when used in C++ programs. ?cpVect cpvneg(const cpVect v) – Negate a vector. Chipmunk provides an overloaded unary negation operator - when used in C++ programs. ?cpVect cpvmult(const cpVect v, const cpFloat s) – Scalar multiplication. Chipmunk provides an overloaded * operator when used in C++ programs. ?cpFloat cpvdot(const cpVect v1, const cpVect v2) – Vector dot product. ?cpFloat cpvcross(const cpVect v1, const cpVect v2) – 2D vector cross product analog. The cross product of 2D vectors results in a 3D vector with only a z component. This func