fuchsia.ui.observation.geometry

视图边界框的最小位置。

视图边界框的最大位置。

视图边界框的最小和最大点（在该视图的坐标系中）。

从物理像素（屏幕）到逻辑像素（视图坐标系）的转换比率。

视图边界框的偏移量数据（在该视图的坐标系中）。

V 边界框的起点（采用 W 坐标系）。

V 的边界框的宽度（沿 V 的 x 轴增加的方向），在 W 的坐标系中。

V 的边界框的高度（沿 V 的 y 轴增加的方向），在 W 的坐标系中。

围绕原点顺时针旋转的角度（以度为单位）。

1

此视图的 fuchsia.ui.views.ViewRef koid。

2

该视图的原点、逻辑大小、像素比例和边衬区数据（采用视图自身坐标系）。

限制。服务器和客户端之间的数据一致性取决于特定的图形 API。一些 API 提供弱一致性，在这种情况下，服务器端数据（此类数据）和客户端数据（在视图的界面客户端中）可以在一段时间内不同的。

3

该视图在上下文视图坐标系中的范围。它不描述子视图的逻辑大小。

此属性描述此视图在上下文视图中的“标准答案”位置，而不考虑视图树深度或中间视图的特定布局状态。

限制。它不说明视图是否“可见”（例如，视图是应用了不透明度，还是未被其他视图遮挡），也无法说明视图是否“可命中”（例如，视图是否完全放置在每个祖先视图的边界框内）。

4

父视图坐标系中占用的空间。它不描述子视图的逻辑大小。

5

子视图的列表，按照图形 API 已知的顺序排列。

此矢量中的每个整数都是指父级在 |views| 或 |incomplete| 矢量中的位置。

每个子视图的身份、位置和尺寸。位置和大小由子视图在父视图坐标系中的范围描述。

视图树拓扑是可靠的。放置在此处的子视图相当于父视图收到了“子视图已连接”信号。

限制。子级视图边界通过父视图的坐标系进行描述，这会受到弱一致性（具体取决于图形 API）。也就是说，当父视图的大小或指标发生变化时，上下文视图可能会观察到“跳跃”，因为父视图会纳入这些数据。在这种情况下，系统会发出新的 ViewTreeSnapshot 来说明相对于上下文视图的位置变化。

1

快照的截取时间。时基是单调时间。

2

上下文视图（位于元素 0 处）及其后代视图的完整列表。

如果超出 MAX_VIEW_COUNT，则不会设置此字段，并且 Error 中会报告错误。

1

发送响应的时间。时基是单调时间。

2

特定视图的最近更新列表。

3

仅在检测到错误情况时设置。如果未设置，客户端可能会假定更新在其周期内具有完整信息。

CHANNEL_OVERFLOW

如果在 WatchResponse.updates 中附加 ViewTreeSnapshot 会超出 FIDL 通道的限制，请将此属性设为 true。该快照以及较早的快照都会被丢弃。

BUFFER_OVERFLOW

如果在 WatchResponse.updates 中附加 ViewTreeSnapshot 会超过 BUFFER_SIZE，则设为 true。该快照以及较早的快照都会被丢弃。

VIEWS_OVERFLOW

当 ViewTreeSnapshot 中的 views 大小超过 MAX_VIEW_COUNT 时，设置为 true。我们使用未设置的 views 字段在 ViewTreeSnapshot 中表示这种情况。

客户端可以在 Watch 调用的响应中收到的 ViewTreeSnapshot 数量上限。当 Watch 调用的响应大小超过 FIDL 通道的限制时，ViewTreeSnapshot 的数量可以小于 BUFFER_SIZE。

由于 FIDL 通道的大小限制，因此 Watch 调用的响应中可包含的 ViewTreeSnapshot 数量存在限制。通过确定当 MAX_VIEW_COUNT 为 1 时，Watch 调用的响应中可以包含的 ViewTreeSnapshot 数量上限计算得出。

注意：修改 ViewTreeSnapshot 或 ViewDescriptor 时必须调整此值。

客户端可以在 ViewTreeSnapshot 中的 ViewDescriptor 数量上限。

由于 FIDL 通道的大小限制，ViewTreeSnapshot 中可包含的 ViewDescriptor 的数量是有限制的。此限制的计算方法是找出当 BUFFER_SIZE 为 1 时，ViewTreeSnapshot 中可包含的 ViewDescriptor 数上限。

注意：修改 ViewDescriptor 时必须调整此值。

（屏幕的）物理像素与（视图的坐标系）的逻辑像素的比率。

• 这些值将按 (x, y) 顺序排列。