跳到主要内容

画板（Artboard）

表示一个 Rive 画板实例（Artboard Instance），提供绘制、推进、交互处理以及按名称访问节点与数据的能力。

字段（Fields）​

frameOrigin​

若为 true，画板原点（origin）按帧原点处理。

data​

与画板关联的类型化数据（typed data）。

width​

画板宽度（width）。

self.artboardInstance = self.myArtboard:instance()
if self.artboardInstance then
   self.artboardInstance.width = 20
end

height​

画板高度（height）。

self.artboardInstance = self.myArtboard:instance()
if self.artboardInstance then
   self.artboardInstance.height = 20
end

方法（Methods）​

draw​

使用提供的渲染器（Renderer）绘制画板。

advance​

按给定秒数推进画板。若应继续接收 advance 调用则返回 true。

instance​

创建具有独立状态的新画板实例。

animation​

创建与该画板实例关联的动画实例（Animation Instance）。

bounds​

返回画板包围盒（bounding box），由两个 Vector 组成：最小点与最大点。

local minPt, maxPt = self.myArtboard:bounds()
print("Bounds width", maxPt.x - minPt.x)
print("Bounds height", maxPt.y - minPt.y)

node​

返回给定名称的节点；若不存在返回 nil。

pointerDown​

指针按下（Pointer Down）处理。返回命中测试结果（hit-test），0 为未命中，非零为命中。

pointerUp​

指针抬起（Pointer Up）处理。返回命中测试结果。

pointerMove​

指针移动（Pointer Move）处理。返回命中测试结果。

pointerExit​

指针离开（Pointer Exit）处理。返回命中测试结果。

addToPath​

将画板几何添加到给定路径（Path），可选应用变换矩阵（matrix）。