Rokon+summary

Rokon引擎主要类介绍com.stickycoding.rokon包：Rokon：提供静态函数和属性属性：circle，Polygon实例，圆形rectangle，Polygon实例，矩形。

Sprite类的polygon属性默认为该矩形函数：getActivity()，获取当前activity实例---------------------------------------------------------------------------------------------------------------------- RokonActivity：Activity子类，提供基本的引擎参数设置和视图转换onCreate()，入口函数，子类须覆写该函数，在该函数中设置全屏，横（竖）屏，界面尺寸，创建引擎，实例化自定义类createEngine()，创建只包含SurfaceView的引擎createEngine(boolean createRelativeLayout)，参数为true创建包含SurfaceView和RelativeLayout的引擎，RalativeLayout可添加其他Android组件。

以下4个函数须在createEngine前调用：forceFullscreen()，全屏forceGameSize(float width, float height)，设置游戏界面尺寸forceLandscape()，横屏，同时须在AndroidManifest.xml中设置属性android:screenOrientation="landscape"forcePortrait()，竖屏，同时须在AndroidManifest.xml中设置属性android:screenOrientation="portrait"onLoadComplete()，引擎创建成功后自动调用，须在子类中覆写，在该函数中初始化要使用到的所有图片Texture，以及调用setScene显示当前的Scenedispose()，退出游戏时自动调用进行垃圾回收，若子类有自定义的类实例，须覆写该函数并在函数体内设置object = nullgetGameHeight()，获取界面高getGameWidth()，获取界面宽getInterface()，获取createEngine中创建的RalativeLayout实例，可向其添加其他组件getScene()，获取当前显示的Scene实例setDrawPriority(int drawPriority)，设置绘图模式，0－VBO模式，1－一般模式，默认为0，一般不需要自己调用setGameSize(float width, float height)，设置游戏界面尺寸，和forceGameSize不同之处在于：若参数宽高与实际手机屏幕尺寸不一致，会根据屏幕宽高比重新设置界面宽，并返回宽度值setGraphicsPath(ng.String path)，设置图片资源根目录路径，游戏图片资源均放在assets/graphics下setScene(Scene scene)，设置当前要显示的Scene实例disableBack()，back键不起作用，若自定义了退出按钮事件，则可调用该函数屏蔽back键的退出功能enableBack()，back键起作用，默认值---------------------------------------------------------------------------------------------------------------------- Scene：场景类，包含若干层（Layer）属性：activity，RokonActivity实例引用构造函数：Scene()，创建默认只有1个层，该层最多包含32个绘制对象的场景Scene(int layerCount)，创建layerCount个层，每个层都最多包含32个绘制对象的场景Scene(int layerCount, int layerObjectCount)，创建layerCount个层，每个层都最多包含layerObjectCount个绘制对象的场景Scene(int layerCount, int[] layerObjectCount)，创建layerCount个层，每个层包含的绘制对象个数由layerObjectCount数组指定抽象函数，须在子类中覆写，覆写的函数体可为空onReady()，在RokonActivity的setScene中自动调用，在该函数中可获取到activity，构造函数中获取activity为空onGameLoop()，游戏逻辑循环，一直都在调用onPause()，游戏暂停时调用，比如来电onResume()，游戏恢复时调用，比如挂断电话重新回到游戏add(GameObject drawableObject)，添加一个GameObject到第一层（索引号为0）add(int layerIndex, GameObject drawableObject)，添加一个GameObject到指定层（索引号）clear()，删除所有绘制对象clearLayer(int index)，删除某层中的所有绘制对象moveLayer(int startIndex, int endIndex)，移动层序switchLayers(int layer1, int layer2)，互换层序例：初始层序〔0,1,2...〕，调用moveLayer(0,2)后，层序变为〔1,2,0...〕；调用switchLayer(0,2)后，层序变为〔2,1,0...〕getLayer(int index)，根据索引号获取某层实例getWindow()，获取窗体实例getWorld()，获取World实例，box2d使用setBackground(Background background)，设置界面背景，参数其实为FixedBackground实例（Background的子类）setLayer(int index, Layer layer)，替换某层setWindow(Window window)，设置游戏窗体setWorld(World world)，设置box2d世界remove(DrawableObject drawableObject)，删除某个绘制对象removeWindow()，删除游戏窗体removeWorld()，删除box2d世界onT ouch(float x, float y, MotionEvent event, int pointerCount, int pointerId)，游戏区域点击onT ouchReal(float x, float y, MotionEvent event, int pointerCount, int pointerId)，实际屏幕点击isPhysicsPaused()，物理引擎是否暂停pausePhysics()，暂停物理引擎resumePhysics()，恢复物理引擎noPhysics()，不使用物理引擎，默认设置usePhysics()，使用物理引擎，setWorld中会调用stopInvoke()，关闭类外函数调用useInvoke()，启动类外函数调用，在Sprite类中某些动作执行开始和结束时会调用Scene类的函数，函数名参看Sprite类源代码toastLong(ng.String message)，显示长消息toastShort(ng.String message)，显示短消息invoke(Callback callback)invoke(ng.String methodName)invoke(ng.String method,ng.Class<?>[] param,ng.Object[] pa ramVal)invoke(ng.String methodName, ng.Object[] paramValues)以上4个函数作用都是调用该类的方法，等同于直接：函数名（参数）的调用方式onFadeEnd(DrawableObject object)，绘制对象渐现（失）完后调用，可在子类覆写onMoveEnd(DimensionalObject object)，画布对象移动完后调用，可在子类覆写，注:只有调用DimensionalObject的move函数来移动对象，最后运动停止才会调用该方法onEndScene()，转换到另一场景时释放当前场景资源，自动调用，需在子类中覆写该函数以释放自定义类实例---------------------------------------------------------------------------------------------------------------------- Layer：层，包含在Scene中，所有绘制对象均添加于层中。

Layer实例已在Scene有初始化，若需要自定义子类继承Layer，则应调用Scene.setLayer函数设置为自定义层显示构造函数：Layer(Scene parentScene, int maximumDrawableObjects)，创建位于父场景parentScene中，最多包含maximumDrawableObjects个绘制对象的层add(GameObject drawableObject)，添加一个Gameobject对象clear()，删除层中的所有对象getGameObject(int index)，获取某个绘制对象setDrawOrder(int type)，设置绘图次序类型，一共6种类型，取值0,1,2,3,4,5，默认为0，详见DrawOrder类ignoreWindow()，忽略窗体绘制useWindow()，依赖窗体绘制，默认使用isUsingWindow()，是否依赖窗体---------------------------------------------------------------------------------------------------------------------- Sprite：精灵类，继承GameObject，该类为一层层继承下来，请熟悉其继承关系！子类包含：LineSprite, PhysicalSprite, PolygonSprite, TextSprite, TiledSprite构造函数：Sprite(float x, float y, float width, float height)，根据坐标和宽高创建精灵onRemove()，精灵被删除时自动调用，子类需覆写该函数，设置类变量为null onUpdate()，状态属性更新函数，在该函数中改变精灵的位移，旋转角度等accelerate(float acceleration, float angle)，沿某一角度（弧度为单位）加速运动，该角度相对于y轴accelerate(float acceleration, float angle, float terminalVelocity)沿某一角度（弧度为单位）加速运动，当线速度大于等于terminalVelocity时，以terminalVelocity值匀速运动accelerateX(float accelerationX)，水平方向加速运动accelerateX(float accelerationX, float terminalSpeedX)，水平方向加速运动，当线速度大于等于terminalSpeedX时，以terminalSpeedX值匀速运动accelerateY(float accelerationY)，垂直方向加速运动accelerateY(float accelerationY, float terminalSpeedY) ，垂直方向加速运动，当线速度大于等于terminalSpeedY时，以terminalSpeedY值匀速运动addModifier(Modifier modifier)，添加一个Modifier实例，最多能同时添加8个modifier。