Read this manual in English

Sprites

Sprite 组件可以是屏幕上显示的简单图片或者逐帧动画.

sprite

Sprite 组件使用 图集 或者 瓷砖图源 进行图像显示.

Sprite 属性

除了 Id, PositionRotation 还有如下属性:

Image
sprite所使用的图集或者瓷砖图源资源.
DefaultAnimation
sprite的默认动画.
Material
sprite的渲染材质.
Blend Mode
组件渲染时使用的混合模式.

混合模式

Blend Mode 属性定义了可视组件如何与其后面的图像混合. 以下列举了支持的混合模式及其混合算法:

Alpha
普通混合: src.a * src.rgb + (1 - src.a) * dst.rgb
Add
使用相应的 sprite 像素颜色值提亮背景: src.rgb + dst.rgb
Multiply
使用相应的 sprite 像素颜色值调暗背景: src.rgb * dst.rgb

运行时操作

运行时可以使用各种各样的函数和属性 (参见 API 文档)来控制Sprite. 函数:

  • sprite.play_flipbook() - 在sprite组件上播放动画.
  • sprite.set_hflip()sprite.set_vflip() - 翻转Sprite动画.

还可以使用 go.get()go.set() 来控制Sprite:

cursor
初始化动画播放头 (number).
image
sprite图 (hash). 可以通过 go.set() 方法使用图集或者瓷砖图集资源来修改此属性. 请参考 这个例子的 API 文档.
material
sprite材质 (hash). 可以通过 go.set() 方法使用材质资源来修改此属性. 请参考 这个例子的 API 文档.
playback_rate
动画播放速率 (number).
scale
Sprite缩放 (vector3).
size
Sprite大小 (vector3) (只读).

材质常量

默认 sprite 材质常量可以使用 go.set()go.animate() 来修改 (参考 材质教程). 例如:

go.set("#sprite", "tint", vmath.vector4(1,0,0,1))
go.animate("#sprite", "tint", go.PLAYBACK_LOOP_PINGPONG, vmath.vector4(1,0,0,1), go.EASING_LINEAR, 2)
tint
3D网格颜色 (vector4). 四元数 x, y, z, 和 w 分别对应红, 绿, 蓝和不透明度.

相关项目配置

game.project 文件里有些关于Sprite的 设置项目.