Google Slides API 可讓您處理 PageElement
(文字方塊、圖片、表格和基本形狀) 在網頁上的位置、大小和方向,同時保持線條簡潔的形狀和平行線。這些轉換稱為肯定轉換。以下範例顯示使用 presentations.batchUpdate
方法的一些常見的網頁元素轉換作業。
這些範例使用下列變數:
- PRESENTATION_ID:指示您在提供表示法 ID 的位置。您可以從簡報網址找出這個 ID 的值。
- PAGE_ID:指明您提供頁面物件 ID 的位置。您可以使用網址或 API 讀取要求擷取此值。
- PAGE_ELEMENT_ID:指明您提供網頁元素物件 ID 的位置。您可以為自己建立的元素指定此 ID (須有一些限制),或允許 Slides API 自動建立元素。您可以透過 API 讀取要求擷取元素 ID。
這些範例會顯示為中立語言的 HTTP 要求。如要瞭解如何使用 Google API 用戶端程式庫,以不同語言實作批次更新,請參閱「新增形狀和文字」一文。
箭頭形狀範例
在下列範例中,假設有一個箭頭形狀頁面元素範例,大小和轉換資料 (可透過 presentations.pages.get
方法要求查看)。範例形狀採用 unit
EMU (英文指標單位) 和 pt (pt)。
{ "objectId": PAGE_ELEMENT_ID, "size": { "width": { "magnitude": 3000000, "unit": "EMU" }, "height": { "magnitude": 3000000, "unit": "EMU" } }, "transform": { "scaleX": 0.3, "scaleY": 0.12, "shearX": 0, "shearY": 0, "translateX": 2000000, "translateY": 550000, "unit": "EMU" }, "shape": { "shapeType": "RIGHT_ARROW" } }
將元素與其他元素對齊
以下 presentations.batchUpdate
程式碼範例說明如何使用 CreateShapeRequest
方法,在正確的位置建立新形狀,並與頁面上的範例箭頭形狀保持一致。在這兩種情況下,都必須計算新形狀左上角的 X 和 Y 座標。
第一個要求會建立 100x50 pt 矩形,對齊箭頭形狀的左側邊界,但放置於箭頭頂部下方 50 pt (50 * 12,700 = 635,000 EMU) 的下方。新矩形的 X 座標應與箭頭的 X 座標相同,才能使左框線對齊。Y 座標與箭頭的 Y 座標和 50 pt 相同,因為距離是從箭頭頂端測量而得。因此,矩形的座標包括:
x" = 2000000 EMU y" = 550000 + (50 * 12700) = 1185000 EMU
第二個要求會建立 40pt 寬圓形,這個圓形與範例箭頭的水平中心線相同,但放置了 100 pt (1,270,000 EMU) 至箭頭右側邊緣。圓形的 X 座標為箭頭的 X 座標、箭頭寬度與 100 pt 的總和。為新圓形強制執行中心線對齊時,必須考量箭頭和圓形的高度。圓形的 Y 座標是箭頭的 Y 座標,加上一半箭頭高度減去圓形高度的一半。在這兩種情況下,您也必須將與箭頭相關的縮放比例係數納入考量,因為這兩者會影響箭頭的寬度和高度。因此,圓形的座標為:
x = 2000000 + (0.3 * 3000000) + (100 * 12700) = 4170000 EMU y = 550000 + (0.5 * 0.12 * 3000000) - (0.5 * 40 * 12700) = 476000 EMU
下列是讓元素與其他元素對齊的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createShape": { "shapeType": "RECTANGLE", "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 100, "unit": "PT" }, "height": { "magnitude": 50, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 2000000, "translateY": 1185000, "unit": "EMU" } } } }, { "createShape": { "shapeType": "ELLIPSE", "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 40, "unit": "PT" }, "height": { "magnitude": 40, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 4170000, "translateY": 476000, "unit": "EMU" } } } } ] }
移動元素
以下 presentations.batchUpdate
程式碼範例說明如何使用 UpdatePageElementTransformRequest
方法,以兩種不同方式翻譯範例箭頭形狀網頁元素。
批次中的第一個要求將箭頭移至 (X,Y) = (2000000, 150000) EMU 座標 (使用絕對平移
applyMode
)。批次中的第二個要求會將箭頭從右側移動,這次轉換元素的大小會「以 applyMode
」為單位改變。
執行這兩項要求後,箭頭的左上角位於 (X,Y) = (2040000, 115000) EMU 座標。
以下是移動元素的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "ABSOLUTE", "transform": { "scaleX": 0.3, "scaleY": 0.12, "translateX": 2000000, "translateY": 150000, "unit": "EMU" } } }, { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": 40000, "translateY": -35000, "unit": "EMU" } } } ] }
反映元素
以下 presentations.batchUpdate
程式碼範例說明如何使用 UpdatePageElementTransformRequest
方法,沿著中心的範例箭頭形狀頁面元素水平反映,而不變更其在頁面中的位置或縮放。
方法是在元素的參考架構中使用基本反射轉換。為免疑義,系統會顯示參考影格位移和反射機制,透過三次對 UpdatePageElementTransformRequest
方法分別呼叫的方式顯示。但預先計算這些轉換矩陣的乘積,然後以單一要求套用該產品會較有效率。
在 translation 轉換中,箭頭形狀的中心會移至原點,或從原點移動。為求明確,參數值會以計算方式表示。
以下是要反映元素的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": -2000000 - 0.5 * 0.3 * 3000000, "translateY": -550000 - 0.5 * 0.12 * 3000000, "unit": "EMU" } } }, { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": -1, "scaleY": 1, "unit": "EMU" } } }, { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": 2000000 + 0.5 * 0.3 * 3000000, "translateY": 550000 + 0.5 * 0.12 * 3000000, "unit": "EMU" } } } ] }
調整元素大小
以下 presentations.batchUpdate
程式碼範例說明如何使用 UpdatePageElementTransformRequest
方法,將範例箭頭形狀網頁元素調整為寬 50%,僅佔目前高度的 80%,同時讓箭頭的中心維持在相同位置並保持方向。
方法是在元素的參考架構中使用基本縮放轉換。為免疑義,系統會顯示參考影格位移和縮放比例,透過三次對 UpdatePageElementTransformRequest
方法個別的呼叫,不過預先計算這些轉換矩陣的產品,然後以單一要求套用該產品,會更有效率。
在 translation 轉換中,箭頭形狀的中心會移至原點,或從原點移動。為求明確,參數值會以計算方式表示。
以下是調整元素大小的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": -2000000 - 0.5 * 0.3 * 3000000, "translateY": -550000 - 0.5 * 0.12 * 3000000, "unit": "EMU" } } }, { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1.5, "scaleY": 0.8, "unit": "EMU" } } }, { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": 2000000 + 0.5 * 0.3 * 3000000, "translateY": 550000 + 0.5 * 0.12 * 3000000, "unit": "EMU" } } } ] }
旋轉元素與中心點的距離
以下 presentations.batchUpdate
程式碼範例說明如何使用 UpdatePageElementTransformRequest
方法,將範例箭頭形狀頁面元素逆時針旋轉 35 度,同時將箭頭的中心維持在相同位置並維持大小。
方法是在元素的參考架構中使用基本旋轉轉換。為免疑義,系統會顯示參考影格位移和旋轉角度,並使用三種不同的 UpdatePageElementTransformRequest
方法呼叫。不過,預先計算這些轉換矩陣的乘積,然後以單一要求套用該產品會較有效率
在 translation 轉換中,箭頭形狀的中心會移至原點,或從原點移動。為求明確,參數值會以計算方式表示。
以下是用來旋轉元素中心位置的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": -2000000 - 0.5 * 0.3 * 3000000, "translateY": -550000 - 0.5 * 0.12 * 3000000, "unit": "EMU" } } }, { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": cos(35 * (pi/180)), "scaleY": cos(35 * (pi/180)), "shearX": sin(35 * (pi/180)), "shearY": -sin(35 * (pi/180)), "unit": "EMU" } } }, { "updatePageElementTransform": { "objectId": PAGE_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": 2000000 + 0.5 * 0.3 * 3000000, "translateY": 550000 + 0.5 * 0.12 * 3000000, "unit": "EMU" } } } ] }