Read this manual in English

Sprites

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

sprite

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

Sprite 属性

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

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 用法.

Did you spot an error or do you have a suggestion? Please let us know on GitHub!

GITHUB