fuchsia.ui.observation.幾何圖形

檢視邊框的最小位置。

檢視定界框的最大位置。

檢視畫面定界框的最小和最大點 (位於該檢視畫面的座標系統中)。

從螢幕的實際像素 (螢幕) 到邏輯像素 (檢視畫面的座標系統) 的轉換比率。

檢視畫面定界框的偏移資料位於該檢視畫面的座標系統中。

V 定界框的起點，位於 W 座標系統中。

V 定界框的寬度 (以及 V x 軸增加的方向) 在 W 座標系統中。

V 定界框的高度 (與 V 軸 y 軸上升的方向) 在 W 座標系統中。

以度為單位的順時針旋轉原點。

1

這個檢視畫面的 fuchsia.ui.views.ViewRef 目錄。

2

此檢視畫面的起點、邏輯大小、像素比例和插邊資料 (位於檢視畫面自己的座標系統中)。

限制。伺服器和用戶端之間的資料一致性取決於特定的圖形 API。部分 API 提供弱式一致性，在某些情況下，伺服器端資料 (這項資料) 和用戶端資料 (在檢視畫面的 UI 用戶端中) 可以有一段時間的落差。

3

此檢視畫面的程度 (在內容檢視畫面的座標系統中)。但「不會」描述子項檢視畫面的邏輯大小。

這說明此檢視畫面在內容檢視畫面中的「實際」位置，不受檢視區塊樹狀結構深度或中繼檢視畫面的特定版面配置狀態影響。

限制。未說明檢視畫面是否「可見」(例如檢視區塊已套用不透明度，或未由其他檢視區塊遮蔽)，而且「不會」描述檢視區塊是否「可命中」(例如檢視畫面是否完全放置在每個祖系檢視畫面的定界框中)。

4

父項檢視畫面座標系統內佔用的空間。但「不會」描述子項檢視畫面的邏輯大小。

5

子檢視畫面的清單，依圖形 API 已知的順序排列。

這個向量中的每個整數都代表父項在 | 檢視區塊| 或 |incomplete| 向量中的子項位置。

每個子檢視畫面的身分、位置和大小。位置和大小由父項檢視畫面座標系統中子項檢視畫面的範圍描述。

檢視表樹狀結構拓撲可靠，在這裡放置的子項，相當於父項檢視區塊接收「已連接子檢視」信號。

限制。父項檢視畫面的座標系統中描述了子項的檢視邊界，這有低一致性的低強度 (視圖形 API 而定)。也就是說，當父項檢視畫面的大小或指標發生變化時，上層檢視畫面會納入這些資料，因此背景檢視畫面可能會觀測到「跳躍」。在這種情況下，系統會發出新的 ViewTreeSnapshot，以描述相對於情境檢視畫面的位置變更。

1

拍攝快照的時間。時間基群為單調時間。

2

結構定義檢視畫面 (位於元素 0) 及其子系檢視畫面的完整清單。

如果超過 MAX_VIEW_COUNT，則未設定這個欄位，且 Error 中會回報錯誤。

1

傳送回應時。時間基群為單調時間。

2

特定檢視畫面的最新更新清單。

3

只有在偵測到錯誤狀況時才設定。如未設定，用戶端可能會假設更新在週期內具備完整資訊。

CHANNEL_OVERFLOW

在 WatchResponse.updates 中附加 ViewTreeSnapshot 時，設為 true 超過 FIDL 管道的數量上限。系統會捨棄該快照與較舊的快照。

BUFFER_OVERFLOW

在 WatchResponse.updates 中附加 ViewTreeSnapshot 時，設為 true 值超過 BUFFER_SIZE。系統會捨棄該快照及較舊的快照。

VIEWS_OVERFLOW

如果 ViewTreeSnapshot 中的 views 大小超過 MAX_VIEW_COUNT，請設為 true。我們會在 ViewTreeSnapshot 中使用未設定的 views 欄位代表這個情況。

用戶端在 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)。