共计 1179 个字符，预计需要花费 3 分钟才能阅读完成。

常用表达式

以下是多个插件共有的表达式。

角度

角度

对象当前的角度，以度为单位。0 度表示面向右侧，角度顺时针增加。

外观

颜色值

代表实例颜色属性的数字。可以与设置颜色动作一起使用，将对象的颜色设置为与另一个对象匹配。

透明度

对象当前的透明度（半透明），从 0（透明）到 100（不透明）。

层次结构

这些表达式适用于支持场景图功能的插件，允许对象连接在一起，使它们移动、旋转和缩放就像是一个大型对象一样。

子级数量

返回当前附加到此对象的子级数量（使用添加子级动作）在层次结构中。如果对象没有子级，则为 0。

所有子级数量

返回当前附加到此对象的子级数量（使用添加子级动作）在层次结构中，包括所有后代。如果对象没有子级，则为 0。

杂项

JSON 格式保存

将对象状态保存为 JSON 格式的数据字符串，并返回它。这可以下载或以其他方式存储，稍后可以使用设置自 JSON 动作恢复对象的状态。

计数

对象类型的实例数量。

选择计数

满足事件条件的实例数量。例如，如果事件的条件是“鼠标在精灵上”，则精灵.PickedCount 将返回鼠标所在的精灵实例数量。

对象类型名称

给定对象的对象类型名称。例如，精灵.ObjectTypeName 将返回“精灵”。作为家族表达式使用时，这将返回实际对象类型的名称，而不是家族本身的名称。

IID

返回实例的索引 ID（IID）。参见实例。

UID

返回实例的唯一 ID（UID）。参见实例。

尺寸和位置

BBoxLeft

BBoxRight

BBoxTop

BBoxBottom

返回对象轴对齐边界框的布局坐标。这是完全包围对象的最小未旋转框，考虑到任何旋转或拉伸。

BBoxMidX

BBoxMidY

返回对象轴对齐边界框中点的布局坐标。这不必定与对象原点的位置相同，例如，如果原点不确切在中间。

宽度

高度

返回对象以像素为单位的大小。

ImagePointX(nameOrNumber)

ImagePointY(nameOrNumber)

ImagePointZ(nameOrNumber)

返回对象当前显示动画帧中一个图像点的位置，以布局坐标表示。可以传递图像点的名称或其编号。注意，当使用数字时，0 表示原点，所以第一个图像点是编号 1。

X

Y

以像素为单位返回对象在布局中的位置。原点（0,0）位于布局的左上角，Y 轴向下增加。

时间

dt

根据对象自己的时间尺度返回 delta-time。有关更多信息，请参见 Delta-time 和帧率独立性。

Z 顺序

图层名称

实例当前所在的图层名称。

图层编号

实例当前所在的图层的零基索引。

Z 高程

返回实例相对于其图层的当前 Z 轴高程。这不受图层的 Z 高程影响。

总 Z 高程

返回实例的 Z 高程加上图层的 Z 高程，提供实例出现的总 Z 高程。

Z 索引

获取此实例在其当前图层中的 Z 顺序的零基索引。0 是最底部的实例，向上增加到顶部实例。

模板

TemplateName

用于创建此实例的模板名称。如果没有使用模板，则返回空字符串。