SarEngine2D

Document

SarEngine2D Combination

Combination

将多个可渲染对象单体组合成一个可渲染单体。由于一个GameObject只能有一个可渲染对象作为其图像，使用Combination可以将多个可渲染对象组合。

Syntax

//from global
var combination = new Combination();
//from SarEngine
var combination = new SarEngine.Combination();

Properties

center
Point 该组合体的几何中心坐标。
coordinate
Coordinate 该组合体所在的坐标系。
objectList
Array 该组合体内单体的集合。
position
Point 该组合体的位置坐标。
rotation
Number 该组合体的旋转弧度。

Methods

addObject(renderableObject)
向该组合体内添加对象，该对象可以是任意一个可渲染对象，这意味可以向组合体内添加组合体。渲染时将按照添加的顺序进行渲染，故后添加的将可能覆盖住早前添加的对象。
changeCoordinate(coordinate)
改变该组合体所在的坐标系，并将相关数值映射到新的坐标系。
copy()
复制一个相同的组合体实例，新的组合体实例中也包含和该组合体相同的组合成员。
move(dx, dy)
将该组合体平移指定的x,y偏移量。
moveTo(x, y)
将该组合体移动至指定的位置。
removeObject(obj)
从该组合体中将指定的对象移除。
removeObjectAt(index)
移除该组合体内指定序号的对象，取值范围0~x，x为该组合体内成员数目-1.
render(graphics, x, y, r, dt, camera, output)
将该组合体渲染到指定的绘图接口，渲染成员时将按objectList从序号低到高的顺序渲染，这意味后添加的将可能覆盖早前添加的对象。
rotate(rad, x, y)
将该组合体绕定点旋转指定的弧度，若未指定x和y，将默认绕center旋转。
setCenterPoint(x, y)
重设该组合体的几何中心坐标，该组合体的实际位置不改变。
setCoordinate(coordinate)
在保持相关数值不变的前提下，设置该组合体所在的坐标系。
setPositionPoint(x, y)
设置该组合体的位置描述坐标，该组合体的实际位置不改变，若要改变该组合体的实际位置，请使用move或moveTo成员函数。