GoogleSlide API を使用すると、線を直線に保ち、点と平行線を維持したまま、ページ上の PageElement（テキスト ボックス、画像、表、基本的な図形）の位置、サイズ、向きを操作できます。これらはアフィン変換と呼ばれます。以下の例は、presentations.batchUpdate メソッドを使用した一般的なページ要素変換オペレーションを示しています。
これらの例では、次の変数を使用します。
- PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値はプレゼンテーションの URL から確認できます。
- PAGE_ID - ページ オブジェクト ID を指定する場所を示します。この値は、URL から、または API 読み取りリクエストを使用して取得できます。
- PAGE_ELEMENT_ID - ページ要素オブジェクト ID を指定する場所を示します。作成する要素にこの ID を指定するか（いくつかの制限があります）、Slides API で自動的に ID を作成することもできます。要素 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 座標を計算する必要があります。
1 つ目のリクエストでは、100×50 pt の長方形を矢印の形の左境界に揃え、矢印の上端から 50 pt（50 × 12,700 = 635,000 EMU）の位置に配置します。新しい長方形の X 座標は、矢印の X 座標と同じにして、左枠線を揃えます。距離は矢印の上部から測定されるため、Y 座標は矢印の Y 座標に 50 pt を足した値になります。そのため、長方形の座標は次のようになります。
x" = 2000000 EMU y" = 550000 + (50 * 12700) = 1185000 EMU
2 番目のリクエストでは、幅 40 pt の円を作成します。この円の中心線はサンプルの矢印と同じですが、矢印の右端から 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 メソッドを使用して、矢印の形状の例のページ要素を 2 つの異なる方法で変換する方法を示しています。
バッチの最初のリクエストは、矢印を (X,Y) = (2000000, 150000) EMU 座標に移動します（絶対移動
applyMode を使用）。このバッチの 2 番目のリクエストはそこから矢印を右に動かし、今回は 40, 000 EMU を右に、35,000 EMU を相対的に上向きに変え、35,000 EMU を上方向に移動します。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 メソッドの 3 つの個別の呼び出しで示されていますが、これらの変換行列の積を事前に計算してから、その積を 1 つのリクエストとして適用する方が効率的です。
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 メソッドの 3 つの個別の呼び出しで示されていますが、これらの変換行列の積を事前に計算してから、その積を 1 つのリクエストとして適用する方が効率的です。
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 メソッドの 3 つの個別の呼び出しで示されていますが、これらの変換行列の積を事前に計算してから、その積を 1 つのリクエストとして適用する方が効率的です。
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"
}
}
}
]
}