轉換和網頁元素

本指南說明轉換 (即移動、旋轉、縮放和剪刀) 頁面元素的基礎概念，尤其是基礎仿造轉換及其作業。

如要進一步瞭解如何使用擬真轉換達成特定結果，請參閱「大小和位置形狀」指南。

頁面元素的視覺大小和位置是由兩種屬性控制：size 和 transform。此大小代表要建立頁面元素的最佳大小或內建大小。此轉換會指定二維仿射轉換矩陣，此矩陣可指定如何轉換其內建大小的物件以產生最終的視覺外觀。

在簡報 UI 中選取網頁元素，並使用調整控點變更其視覺大小時，實際上會更新這個轉換矩陣。在頁面上移動元素或旋轉元素也會更新元素的轉換矩陣。

透過簡報使用者介面踏出第一步

您用來轉換及調整頁面元素大小的矩陣算術功能非常強大，但可能一開始可能非常困難，本頁大部分都會說明相關計算。不過，您可以使用下列方法簡化轉換規格和大小：

1. 使用簡報使用者介面建立頁面元素。
2. 視需要使用 Google 簡報使用者介面調整頁面元素的位置。
3. 使用 get 方法讀取這些元素的大小和轉換方式。

這已足以讓您踏出第一步；本指南的其餘部分將詳細說明您可以進一步操控頁面元素的轉換計算。

非凡變形矩陣

圖形程式庫經常使用二維仿造轉換矩陣，控制元素的比例、旋轉、剪刀、反射和轉譯。在 Google 簡報 API 中，頁面元素的轉換會以 3x3 矩陣表示：

$$A=\begin{bmatrix} scale\_x & shear\_x & translate\_x\\ shear\_y & scale\_y & translate\_y\\ 0 & 0 & 1 \end{bmatrix}$$

轉換中使用的參數如下：

translate_x	翻譯參數會指定頁面元素左上角相對於頁面左上角的位置 (X,Y)。您可以使用點 (pt) 或英文指標單位 (EMU) 的單位來指定相對位置。
translate_y
scale_x	縮放參數可控制網頁元素算繪時的尺寸。這些是無單位乘法係數。舉例來說，scale_x 值 1.5 會將元素的寬度放大 50%。
scale_y
shear_x	剪刀參數也無單位，且可控制網頁元素的傾斜度。縮放和建構參數可以搭配使用，來旋轉網頁元素。
shear_y

您可以在網路上找到許多範例，說明 2-D 轉換矩陣如何影響圖形物件轉譯。

轉換矩陣相對於包含的元素群組或頁面，舉例來說，如果您旋轉含有矩形的群組，該群組的 transform 欄位值會反映旋轉角度，但矩形的 transform 欄位值不會顯示。

正在計算視覺大小

如要判斷頁面元素的視覺 (算繪) 大小，必須同時考慮大小和轉換屬性。您無法只藉由比較兩個頁面元素的大小屬性，判斷哪一個頁面元素的外觀比較大：必須使用轉換矩陣對應元素的邊界，並計算轉譯的大小。

對應點

如要使用轉換矩陣對應特定點，請將點 (x, y) 轉換為向量 [x, y, 1]，然後執行矩陣乘法。請考慮點 p 的對應：

\[p' = Ap\]

這會變成：

$$\begin{bmatrix} x'\\ y'\\ 1 \end{bmatrix} =\begin{bmatrix} scale\_x & shear\_x & translate\_x\\ shear\_y & scale\_y & translate\_y\\ 0 & 0 & 1 \end{bmatrix} \begin{bmatrix} x\\ y\\ 1 \end{bmatrix}$$

因此，新點 p' 的座標為：

$$x' = (scale\_x \times x) + (shear\_x \times y) + translate\_x\\ y' = (scale\_y \times y) + (shear\_y \times x) + translate\_y$$

正在計算界線

在剪裁及縮放轉換後，如要判斷元素的定界框轉譯大小，請使用：

$$width' = (scale\_x \times width) + (shear\_x \times height)\\ height' = (scale\_y \times height) + (shear\_y \times width)$$

如要進一步瞭解如何使用擬真轉換達成特定結果，請參閱「大小和位置形狀」指南。

限制

部分大小和位置欄位與某些類型的頁面元素不相容。下表摘要列出特定頁面元素大小和位置欄位的相容性。

欄位	形狀	影片	資料表
Translation	✔	✔	✔
擴充規模	✔	✔	否**
保護耳朵	✔	否	否

** 如要更新表格列和欄維度，請使用 UpdateTableRowPropertiesRequest 和 UpdateTableColumnPropertiesRequest。

如果網頁元素含有分散效果，所有大小和位置欄位都可能造成非預期的結果。所有限制隨時可能變動。如需最新資訊，請參閱 Google 簡報 API。