Read this manual in English

Sprites

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

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

Sprite 属性

除了 Id, Position 和 Rotation 还有如下属性:

Image

sprite所使用的图集或者瓷砖图源资源.

DefaultAnimation

sprite的默认动画.

Material

sprite的渲染材质.

Blend Mode

组件渲染时使用的混合模式.

混合模式

The Blend Mode property defines how the component graphics should be blended with the graphics behind it. These are the available blend modes and how they are calculated:

Alpha

Normal blending: a~0~ * rgb~0~ + (1 - a~0~) * rgb~1~

Add

Brighten the background with the color values of the corresponding pixels of the component: rgb~0~ + rgb~1~

Multiply

Darken the background with values of the the corresponding pixels of the component: rgb~0~ * rgb~1~

运行时操作

运行时可以使用各种各样的函数和属性 (参见 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的默认材质属性可以用 sprite.set_constant() 和 sprite.reset_constant() 方法来设置和重置. (详情参见 材质教程):

tint

sprite染色 (vector4). 四元数 x, y, z, 和 w 代表染色的红, 绿, 蓝 和不透明度. 参见 这个例子的 API 用法.