このページは Cloud Translation API によって翻訳されました。

ページ要素のサイズと配置

このガイドでは、アフィンを使用してページ要素のサイズと配置を行う方法について説明します学びますアフィン変換の概念については変換のコンセプトガイドをご覧ください。

要素の変換

スライド API を使用すると、ページ上の要素の位置やサイズを変更できます。そのためには、適用する変換の種類を決定してから使用して、 presentations.batchUpdate メソッドに 1 つ以上 UpdatePageElementTransformRequest あります。

変換は、次の 2 つのいずれかで実行できます。 applyModes:

ABSOLUTE 変換は、要素の既存の変換を置き換えます。表します。変換更新リクエストから除外したパラメータは、すべて「あります。
RELATIVE 変換は、要素の既存の値と乗算されます。（乗算の順序が重要）

$$A' = BA$$

相対変換は、ページ要素を現在の場所から移動またはスケーリングします。たとえば、シェイプを左に 100 ポイント移動したり、40 度回転したりします。絶対変換は、既存の位置とスケールの情報を破棄します。たとえば、シェイプをページの中央に移動したり、指定します。

通常、複雑な変換は単純な変換のシーケンスとして表現できます。変換の事前計算（オーバーヘッドを削減できることがよくあります。

オペレーションによっては、要素の既存の変換が何であるかを知っておく必要がある定義できます。これらの値がない場合は、次のコマンドで取得できます。 presentations.pages.get リクエストできます。

翻訳

翻訳とは、単にページ要素を画面上の新しい位置に移動させること表示されます。絶対的翻訳では要素を特定のポイントに移動します。相対的翻訳では要素を特定の距離だけ移動します。

基本的な翻訳変換行列の形式は次のとおりです。

$$T=\begin{bmatrix} 1 & 0 & translate\_x\\ 0 & 1 & translate\_y\\ 0 & 0 & 1 \end{bmatrix}$$

UpdatePageElementTransformRequest を使用する場合要素を（サイズ、傾斜、向きを変えずに）平行移動するには、次のいずれかを使用できます AffineTransform 構造:

// Absolute translation:
{
  'transform': {
    'scaleX':  current scaleX value,
    'scaleY':  current scaleY value,
    'shearX':  current shearX value,
    'shearY':  current shearY value,
    'translateX': X coordinate to move to,
    'translateY': Y coordinate to move to,
    'unit': 'EMU' // or 'PT'
  }
}

// Relative translation (scaling must also be provided to avoid a matrix multiplication error):
{
  'transform': {
    'scaleX':  1,
    'scaleY':  1,
    'translateX': X coordinate to move by,
    'translateY': Y coordinate to move by,
    'unit': 'EMU' // or 'PT'
  }
}

スケーリング

スケーリングとは、X 軸または X 軸に沿って要素を伸縮させたり、サイズを変更します。基本的なスケーリング変換行列の形式は次のとおりです。

$$S=\begin{bmatrix} scale\_x & 0 & 0\\ 0 & scale\_y & 0\\ 0 & 0 & 1 \end{bmatrix}$$

この行列形式を、サイズを変更するための RELATIVE 変換として直接使用できます。これは要素のレンダリングされた傾斜と移動にも影響します。傾斜や移動に影響を与えずに要素を拡大縮小するには、参照フレーム。

回転

回転変換では、スケーリングとせん断パラメータ。基本的な回転変換行列の形式は次のとおりです。回転角（ラジアン）は X 軸を基準として測定され、反時計回り:

$$R=\begin{bmatrix} cos(\theta) & sin(\theta) & 0\\ -sin(\theta) & cos(\theta) & 0\\ 0 & 0 & 1 \end{bmatrix}$$

スケーリングと同様に、この行列形式を RELATIVE として直接使用できます。要素が回転しますが、その場合、要素が回転します。 ページのオリジンに関する情報。中心または異なる点です。その基準フレームにシフトします。

リフレクション

鏡像は、特定の線または軸に沿って要素をミラーリングします。基本 x 軸と y 軸の反射変換行列の形式は次のとおりです。

$$F_x=\begin{bmatrix} 1 & 0 & 0\\ 0 & -1 & 0\\ 0 & 0 & 1\\ \end{bmatrix}\qquad\qquad F_y=\begin{bmatrix} -1 & 0 & 0\\ 0 & 1 & 0\\ 0 & 0 & 1\\ \end{bmatrix}$$

スケーリングと同様に、この行列形式を RELATIVE として直接使用できます。要素は移動しますが要素は平行移動になりますあります翻訳せずに要素を反映するには、シフトします。

要素の基準フレーム

基本的な尺度を適用するリフレクション rotation 変換をページに直接変換する要素がページの参照フレームで変換を生成します。たとえば基本回転では、要素がページの原点（）。ただし、Terraform の参照フレームで操作はたとえば、中心点を中心にして要素を回転させる場合などです。

要素を自身の参照フレーム内で変換するには、2 つのフレームで囲みますその他の翻訳: 要素の中心を移動する前の翻訳 T1 ページのオリジンに移動し、次の翻訳 T2 で要素を移動します。元の位置に戻せます完全な演算は行列として表現できる product:

$$A' = T2 \times B \times T1 \times A$$

異なる点を変換して、他の基準系に切り替えることもできますオリジンにルーティングしますこれらのポイントが、新しいリファレンスクリックします。

これらの変換は、それぞれ個別に連続した RELATIVE 変換リクエスト。事前にコンピューティング能力を A'（上記の行列を乗算して）に変換し、結果を単一の ABSOLUTE 変換。または、T2 * B * T1 の積を事前に計算するそれを単一の RELATIVE 変換として適用します。どちらも効率的です変換リクエストを個別に送信できます

制限事項

一部のサイズフィールドと配置フィールドは、一部のタイプのページに対応していませんあります。次の表は、特定のページ要素とサイズフィールドと配置フィールドの互換性をまとめたものです。

項目	図形	動画	表
翻訳	✔	✔	✔
スケーリング	✔	✔	×**
シェア	✔	いいえ	いいえ

** 表の行と列のディメンションを更新するには、 UpdateTableRowPropertiesRequest および UpdateTableColumnPropertiesRequest。

ページ要素に傾斜がある場合、すべてのサイズ設定と配置フィールドで予期しない結果が生じる可能性があります。すべての制限は変更される場合があります。最新情報については、Google スライド API をご覧ください。

スライド API は値をリファクタリングする場合があります。

ページ要素を作成する際は、ページ要素のサイズと変換を結果を提示します。ただし、API は提供された値を比較することで、見た目は同じになる場合があります。一般的に API を使用してサイズを記述した場合、同じ値が返される保証はありません。指定します。ただし、この変換をあります。