借助 Google Slides API,您可以操控页面上PageElement
(文本框、图片、表格和基本形状)的位置、大小和方向,同时保持直线笔直并保留点和平行线。这些称为仿射转换。以下示例展示了如何使用 presentations.batchUpdate
方法执行一些常见的网页元素转换操作。
这些示例使用以下变量:
- PRESENTATION_ID - 表示您提供演示文稿 ID 的位置。您可以通过演示网址发现此 ID 的值。
- PAGE_ID - 指示您提供网页对象 ID 的位置。您可以通过网址或使用 API 读取请求来检索此值。
- PAGE_ELEMENT_ID - 表示您提供网页元素对象 ID 的位置。您可以为创建的元素指定此 ID(但有一些限制),也可以让 Slides API 自动创建一个。元素 ID 可通过 API 读取请求检索。
这些示例以 HTTP 请求的形式呈现,不涉及具体语言。如需了解如何使用 Google API 客户端库以不同语言实现批量更新,请参阅添加形状和文字。
箭头形状示例
对于以下示例,假设存在一个示例箭头形状页面元素,其大小和转换数据如下(可通过 presentations.pages.get
方法请求找到)。示例形状使用 unit
EMU(英制单位)和 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 坐标。
第一个请求创建了一个 100 x 50 pt 的矩形,该矩形与箭头形状的左边框对齐,但位于箭头顶部边缘下方 50 pt(50 * 12,700 = 635,000 EMU)处。新矩形的 X 坐标应与箭头的 X 坐标相同,以保持其左边框对齐。Y 坐标与箭头的 Y 坐标相同,因为距离是从箭头的顶部开始测量的。因此,矩形的坐标为:
x" = 2000000 EMU y" = 550000 + (50 * 12700) = 1185000 EMU
第二个请求创建了一个宽度为 40 磅的圆,该圆与示例箭头的水平中心线相同,但位于箭头右边缘右侧 100 磅(1,270,000 EMU)处。圆圈的 X 坐标是箭头 X 坐标、箭头宽度和 100 点的总和。为了强制实现新圆形的中心线对齐,需要同时考虑箭头和圆形的高度。圆圈的 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
)。批处理中的第二个请求会将箭头从该位置移动,这次是向右移动 40,000 EMU,向上移动 35,000 EMU(使用相对平移 applyMode
)。所使用的转换 1 矩阵旨在避免更改元素的大小和方向。
执行这两个请求后,箭头的左上角位于 (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
方法的三次单独调用来显示,但更高效的做法是预先计算这些转换矩阵的乘积,然后将该乘积作为单个请求应用。
对于平移转换,箭头形状的中心会移至原点,然后再从原点移开。为清楚起见,参数值以计算结果的形式表示。
以下是反映元素的请求协议:
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
方法将示例箭头形状页面元素的宽度调整为原来的 150%,高度调整为原来的 80%,同时保持箭头的中心位置不变,并保持其方向不变。
为此,您可以在元素的参考框架中使用基本缩放转换。为清楚起见,参考帧平移和缩放是通过对 UpdatePageElementTransformRequest
方法的三次单独调用来显示的,但更高效的做法是预先计算这些转换矩阵的乘积,然后将该乘积作为单个请求应用。
对于平移转换,箭头形状的中心会移至原点,然后再从原点移开。为清楚起见,参数值以计算结果的形式表示。
以下是调整元素大小的请求协议:
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
方法的三次单独调用来显示,但更高效的做法是预先计算这些转换矩阵的乘积,然后将该乘积作为单个请求应用
对于平移转换,箭头形状的中心会移至原点,然后再从原点移开。为清楚起见,参数值以计算结果的形式表示。
以下是用于围绕元素中心旋转元素的请求协议:
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" } } } ] }