Google スライド API を使用すると、線をまっすぐに、点と平行な線を維持したまま、ページ上の PageElement
(テキスト ボックス、画像、表、基本的な図形)の位置、サイズ、向きを調整できます。これらはアフィン変換と呼ばれます。以下の例は、presentations.batchUpdate
メソッドを使用した一般的なページ要素変換オペレーションを示しています。
これらの例では、次の変数を使用します。
- PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値はプレゼンテーションの URL で確認できます。
- PAGE_ID - ページ オブジェクト ID を指定する場所を示します。この値は、URL から、または 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 座標を計算する必要があります。
最初のリクエストでは、矢印の形状の左枠線に沿って配置され、矢印の上端から 50 pt(50 × 12,700 = 635,000 EMU)に配置された 100 x 50 pt の長方形が作成されます。新しい長方形の 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 座標と矢印の高さの 1/2 から円の高さの 2 分の 1 を掛けた値です。どちらの場合も、矢印のレンダリングされた幅と高さに影響するため、矢印のスケーリング ファクタも考慮する必要があります。したがって、円の座標は次のようになります。
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 が右に移動します。また、相対サイズ 1 の変換を使用しています。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 つのリクエストとして適用する方が効率的です。
変換変換では、矢印シェイプの中心が原点との間で移動されます。パラメータ値は、わかりやすくするために計算として表されています。
要素を反映するためのリクエスト プロトコルは次のとおりです。
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 つのリクエストとして適用する方が効率的です。
変換変換では、矢印シェイプの中心が原点との間で移動されます。パラメータ値は、わかりやすくするために計算として表されています。
要素のサイズを変更するためのリクエスト プロトコルは次のとおりです。
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 つのリクエストとして適用する方が効率的です。
変換変換では、矢印シェイプの中心が原点との間で移動されます。パラメータ値は、わかりやすくするために計算として表されています。
中心を中心に要素を回転させるリクエスト プロトコルは次のとおりです。
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" } } } ] }