SarEngine2D

Document

SarEngine2D ImageAnimation

ImageAnimation

可渲染的贴图动画，将一张图片上面平铺的一系列动画帧渲染为动画。

Syntax

//from global
var imageAnimation = new ImageAnimation();
//from SarEngine
var imageAnimation = new SarEngine.ImageAnimation();

Classes

Loop
贴图动画的循环参数类。

Properties

center
Point 该贴图动画的中心坐标。
clipX
Number 从素材图片上裁剪动画帧的起始左上角横坐标。
clipY
Number 从素材图片上裁剪动画帧的起始左上角纵坐标。
coordinate
Coordinate 该贴图动画所在的坐标系。
fCount
Number 该贴图动画的帧的总数。
fHeight
Number 素材图片上的动画帧的高度。
fps
Number 渲染该贴图动画时的帧速率。
frame
Number 该贴图动画当前播放到的动画帧的序号。
fWidth
Number 素材图片上的动画帧的高度。
height
Number 该贴图动画的最终呈现高度。
img
Image 素材图片的HTML Image对象，渲染时将从该图片上裁剪出动画帧进行渲染。
loop
ImageAnimation.Loop 表示该贴图动画将如何循环播放。
playing
Boolean 表示该贴图动画是否处于播放状态。
position
Point 描述该贴图动画的位置坐标。
reverse
Boolean 表示该贴图动画是否为倒序播放。
time
Number 表示该贴图动画自开始播放以来经过的世界， 单位为秒。
width
Number 该贴图动画的最终呈现宽度。

Methods

create(width, height, fCount, fps)
静态函数。通过指定最终呈现尺寸、帧数目和帧速率，创建一个贴图动画。
loadFromUrl(url, clipX, clipY, fWidth, fHeight, width, height, fCount, fps, callback)
静态函数。通过指定素材图片的url、动画帧的源裁剪位置、裁剪尺寸、最终呈现尺寸、帧数目创建一个贴图动画实例，并在图片加载完成后调用回掉函数。
begin()
从头开始播放该贴图动画。
changeCoordinate(coordinate)
改变该贴图动画所在的坐标系，并将相关数值映射到新的坐标系。
clipFrame(clipX, clipY, fWidth, fHeight, fCount)
通过指定裁剪位置、裁剪尺寸和动画帧数目裁剪动画帧。
copy()
复制一个相同的动画帧实例。
end()
结束该贴图动画的播放。
moveTo(x, y)
将该贴图动画移动到指定的位置。
play()
播放该贴图动画。
preload(graphics)
预加载贴图动画，需要提供一个绘图接口。由于部分设备在初次渲染时才正式载入图片数据，故通过该方式实现预加载，避免卡顿。
render(graphics, x, y, r, dy)
以指定的曝光时间将该贴图动画渲染到指定的绘图接口。
setCenter(x, y, align)
重设该贴图动画中心的坐标。
setCoordinate(coordinate)
在保持各种数值不变的前提下，设置该贴图动画所在的坐标系。

Events

onBegine
在该贴图动画开始播放时触发。
onEnd
在该贴图动画结束播放时触发。
onFrameUpdate
在该贴图动画的动画帧改变时触发。