Other

AffineTransform

AffineTransform は [0 0 1 ] の最終行を暗黙的に示唆する 3x3 行列を使用して、ソース座標(x,y)を宛先座標(x', y')に次のように変換します。

 [ x']   [  scaleX  shearX  translateX  ] [ x ]
 [ y'] = [  shearY  scaleY  translateY  ] [ y ]
 [ 1 ]   [      0       0         1     ] [ 1 ]

変換後、

 x' = scaleX * x + shearX * y + translateX;
 y' = scaleY * y + shearY * x + translateY;

したがって、このメッセージはこれら 6 つの行列要素で構成されます。

JSON 表現
{
  "scaleX": number,
  "scaleY": number,
  "shearX": number,
  "shearY": number,
  "translateX": number,
  "translateY": number,
  "unit": enum (Unit)
}
フィールド
scaleX

number

X 座標のスケーリング要素。

scaleY

number

Y 座標スケーリング要素。

shearX

number

X 座標の傾斜面要素。

shearY

number

Y 座標の傾斜面要素。

translateX

number

X 座標変換要素。

translateY

number

Y 座標変換要素。

unit

enum (Unit)

翻訳要素の単位。

OpaqueColor

テーマ設定可能な単色の値。

JSON 表現
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (RgbColor)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
フィールド
共用体フィールド kind。色の値の種類。kind は次のいずれかになります。
rgbColor

object (RgbColor)

不透明な RGB 色。

themeColor

enum (ThemeColorType)

不透明なテーマカラー。

RGB カラー

RGB カラー。

JSON 表現
{
  "red": number,
  "green": number,
  "blue": number
}
フィールド
red

number

色の赤色要素(0.0 ~ 1.0)。

green

number

色の緑のコンポーネント(0.0 ~ 1.0)。

blue

number

色の青いコンポーネント(0.0 ~ 1.0)。

ThemeColorType

テーマの色タイプ

PageProperties には、これらのテーマカラーの種類から具体的な色へのマッピングを定義する ColorScheme が含まれています。

列挙型
THEME_COLOR_TYPE_UNSPECIFIED テーマの色が未指定です。この値は使用しないでください。
DARK1 最初の暗い色を表します。
LIGHT1 最初のライトの色を表します。
DARK2 2 番目の暗い色を表します。
LIGHT2 2 番目のライトの色を表します。
ACCENT1 最初のアクセント カラーを表します。
ACCENT2 2 つ目のアクセント カラーを表します。
ACCENT3 3 つ目のアクセント カラーを表します。
ACCENT4 4 番目のアクセント カラーを表します。
ACCENT5 5 つ目のアクセント カラーを表します。
ACCENT6 6 番目のアクセント カラーを表します。
TEXT1 最初のテキストの色を表します。
BACKGROUND1 最初の背景色を表します。
TEXT2 2 番目のテキストの色を表します。
BACKGROUND2 2 つ目の背景色を表します。

PropertyState

プロパティが取り得る状態。

列挙型
RENDERED プロパティの状態が RENDERED である場合、要素には、ページ上でレンダリングされるときに対応するプロパティが設定されます。要素が placeholder フィールドによって決定されるプレースホルダ シェイプであり、プレースホルダ シェイプから継承する場合、対応するフィールドの設定を解除できます。つまり、プロパティ値が親プレースホルダから継承されます。要素が継承しない場合は、フィールドにレンダリングされた値が含まれます。これがデフォルト値です。
NOT_RENDERED プロパティの状態が NOT_RENDERED の場合、ページにレンダリングされたとき、要素には対応するプロパティがありません。ただし、子シェイプで継承できるようにフィールドを設定することは可能です。レンダリングされた要素からプロパティを削除するには、その propertyState を NOT_RENDERED に設定します。
INHERIT プロパティの状態が INHERIT の場合、プロパティの状態は親シェイプの対応する propertyState フィールドの値を使用します。継承しない要素に、プロパティが INHERIT になることはありません。

SolidFill

単色塗りつぶし。ページまたはページ要素が、指定された色の値で完全に塗りつぶされています。

フィールドが設定されていない場合、その値が親プレースホルダから継承される場合、継承されます。

JSON 表現
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
フィールド
color

object (OpaqueColor)

塗りつぶしの色の値。

alpha

number

ピクセルに適用する必要があるこの color の割合。つまり、最終的なピクセルの色は、次の式で定義されます。

ピクセルの色 = アルファ *(色)+(1.0 - アルファ)*(背景色)

つまり、値が 1.0 の場合は単色に対応し、0.0 の場合は完全に透明な色に相当します。

アウトライン

PageElement の概要。

これらのフィールドが設定されていない場合、親プレースホルダが存在する場合は継承されます。親が存在しない場合は、スライド エディタで作成された新しいページ要素に使用される値がデフォルトで使用されます(この値は、ページ要素の種類によって異なります)。

JSON 表現
{
  "outlineFill": {
    object (OutlineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
フィールド
outlineFill

object (OutlineFill)

枠線の塗りつぶし。

weight

object (Dimension)

枠線の太さ。

dashStyle

enum (DashStyle)

枠線の破線スタイル。

propertyState

enum (PropertyState)

枠線プロパティの状態。

ページ要素の枠線を更新すると、同じリクエストで別の値が指定されていない限り、このフィールドは暗黙的に RENDERED に更新されます。ページ要素に枠線がない場合、このフィールドは NOT_RENDERED に設定します。この場合、同じリクエストに設定された他の概要フィールドは無視されます。

アウトラインフィル

枠線の塗りつぶし。

JSON 表現
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
フィールド
共用体フィールド kind。枠線の塗りつぶしの種類。 kind は次のいずれかになります。
solidFill

object (SolidFill)

無地一色

DashStyle

線形ジオメトリをレンダリングできるダッシュの種類。これらの値は、ECMA-376 4th Edition のパート 1 の「Office Open XML File Formats - Fundamentals and Markup Language Reference」のセクション 20.1.10.48 に記載されている「ST_PresetLineDashVal」という単純なタイプに基づいています。

列挙型
DASH_STYLE_UNSPECIFIED ダッシュ スタイルが指定されていません。
SOLID 実線ECMA-376 ST_PresetLineDashVal 'solid' に対応します。これはデフォルトの破線スタイルです。
DOT 点線ECMA-376 ST_PresetLineDashVal 'dot' に対応します。
DASH 破線。ECMA-376 ST_PresetLineDashVal 'dash' に対応します。
DASH_DOT ダッシュと点を交互に繰り返します。ECMA-376 ST_PresetLineDashVal 値「dashDot」に対応します。
LONG_DASH 大きな破線。ECMA-376 ST_PresetLineDashVal 'lgDash' に対応します。
LONG_DASH_DOT 大きな破線と点線を交互に繰り返します。ECMA-376 ST_PresetLineDashVal 値「lgDashDot」に対応します。

シャドウ

ページ要素のシャドウ プロパティ。

これらのフィールドが設定されていない場合、親プレースホルダが存在する場合は継承されます。親が存在しない場合は、スライド エディタで作成された新しいページ要素に使用される値がデフォルトで使用されます(この値は、ページ要素の種類によって異なります)。

JSON 表現
{
  "type": enum (Type),
  "transform": {
    object (AffineTransform)
  },
  "alignment": enum (RectanglePosition),
  "blurRadius": {
    object (Dimension)
  },
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "rotateWithShape": boolean,
  "propertyState": enum (PropertyState)
}
フィールド
type

enum (Type)

シャドウのタイプ。このプロパティは読み取り専用です。

transform

object (AffineTransform)

シャドウの平行移動、スケール、スキューを、位置揃えを基準にしてエンコードする変換。

alignment

enum (RectanglePosition)

シャドウの平行化、スケーリング、スキューの原点を設定する、シャドウのアライメント ポイント。このプロパティは読み取り専用です。

blurRadius

object (Dimension)

シャドウぼかしの半径。半径を大きくするほど、シャドウが拡散します。

color

object (OpaqueColor)

シャドウの色の値。

alpha

number

シャドウの色のアルファ(0.0 ~ 1.0)。

rotateWithShape

boolean

シェイプに合わせてシャドウを回転させるかどうかを指定します。このプロパティは読み取り専用です。

propertyState

enum (PropertyState)

シャドウ プロパティの状態。

ページ要素上のシャドウを更新すると、同じリクエストで別の値が指定されていなければ、このフィールドは暗黙的に RENDERED に更新されます。ページ要素にシャドウが表示されないようにするには、このフィールドを NOT_RENDERED に設定します。この場合、同じリクエストに設定された他のシャドウ フィールドは無視されます。

シャドウのタイプ。

列挙型
SHADOW_TYPE_UNSPECIFIED シャドウタイプが指定されていません。
OUTER 外側のシャドウ。

RectanglePosition

基準位置を長方形で定義します。

列挙型
RECTANGLE_POSITION_UNSPECIFIED 指定なし。
TOP_LEFT 左上。
TOP_CENTER 中央上
TOP_RIGHT 右上。
LEFT_CENTER 左中央
CENTER 中央。
RIGHT_CENTER 右中央
BOTTOM_LEFT 左下。
BOTTOM_CENTER 下中央
BOTTOM_RIGHT 右下。

ContentAlignment

コンテンツの配置の種類。

ECMA-376 4th Edition のパート 1 の「Office Open XML File Formats - Fundamentals and Markup Language Reference」のセクション 20.1.10.59 の「ST_TextAnchoringType」単純型の値のサブセットに由来します。

列挙型
CONTENT_ALIGNMENT_UNSPECIFIED 不明なコンテンツの配置。コンテンツの配置は、親が存在する場合は継承します。
CONTENT_ALIGNMENT_UNSUPPORTED コンテンツの調整はサポートされていません。
TOP コンテンツをコンテンツ ホルダーの上部に沿って配置します。ECMA-376 ST_TextAnchoringType(t)に対応します。
MIDDLE コンテンツをコンテンツ所有者の中央に合わせて配置します。ECMA-376 ST_TextAnchoringType「ctr」に対応します。
BOTTOM コンテンツをコンテンツ ホルダーの下部に揃える。ECMA-376 ST_TextAnchoringType(b)に対応します。

プレースホルダ

プレースホルダの形状を一意に識別するプレースホルダ情報。

JSON 表現
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
フィールド
type

enum (Type)

プレースホルダのタイプ。

index

integer

プレースホルダのインデックス。同じページに同じプレースホルダ タイプが存在する場合、インデックス値は異なります。

parentObjectId

string

このシェイプの親プレースホルダのオブジェクト ID。未設定のままにした場合、親のプレースホルダのシェイプが存在しないため、他のシェイプのプロパティは継承されません。

プレースホルダのシェイプのタイプ。

これらのプレースホルダ タイプの多くが、ECMA-376 標準のプレースホルダ ID に対応しています。これらのシェイプについては、ECMA-376 4th Edition パート 1 の「Office Open XML File Formats - Fundamentals and Markup Language Reference」のセクション 19.7.10 で、「ST_PlaceholdType」タイプの説明をご覧ください。

列挙型
NONE デフォルト値。これはプレースホルダではないことを示します。
BODY 本文。
CHART チャートまたはグラフ
CLIP_ART クリップアートの画像。
CENTERED_TITLE タイトルが中央に配置されました。
DIAGRAM 図。
DATE_AND_TIME 日時。
FOOTER フッター。
HEADER ヘッダー テキスト。
MEDIA マルチメディア。
OBJECT すべてのコンテンツ タイプ。
PICTURE 画像。
SLIDE_NUMBER スライドの数。
SUBTITLE サブタイトル。
TABLE
TITLE スライドのタイトル。
SLIDE_IMAGE スライド画像。

ImageProperties

Image のプロパティ。

JSON 表現
{
  "cropProperties": {
    object (CropProperties)
  },
  "transparency": number,
  "brightness": number,
  "contrast": number,
  "recolor": {
    object (Recolor)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  }
}
フィールド
cropProperties

object (CropProperties)

画像の切り抜きプロパティ。設定しない場合、画像はトリミングされません。このプロパティは読み取り専用です。

transparency

number

画像の透明度の効果値は 0.0 ~ 1.0 の範囲内で指定する必要があります。0 は効果がないことを意味し、1 は完全に透明であることを意味します。このプロパティは読み取り専用です。

brightness

number

画像の明るさの効果。値は [-1.0, 1.0] の範囲内で指定する必要があります。0 は効果がないことを意味します。このプロパティは読み取り専用です。

contrast

number

画像のコントラスト効果値は [-1.0, 1.0] の範囲内で指定する必要があります。0 は効果がないことを意味します。このプロパティは読み取り専用です。

recolor

object (Recolor)

画像のリカラー効果。設定されていない場合、画像の色は変更されません。このプロパティは読み取り専用です。

outline

object (Outline)

画像の概要。設定されていない場合、画像に枠線は含まれません。

shadow

object (Shadow)

画像の影設定しない場合、イメージにシャドウは適用されません。このプロパティは読み取り専用です。

CropProperties

コンテナに囲まれているオブジェクトの切り抜きプロパティ。例: Image

切り抜きプロパティは、切り抜き範囲を定義する 4 つのエッジのオフセットで表されます。オフセットは、オブジェクトの元の境界線の対応する端から内側に向かって、オブジェクトの元のサイズに対する割合で測定されます。

  • オフセットが (0, 1) の間隔にある場合、対応する切り抜き矩形のエッジは、オブジェクトの元の境界四角形の内側に配置されます。
  • オフセットが負または 1 より大きい場合、対応する切り抜き矩形のエッジは、オブジェクトの元の境界四角形の外側に配置されます。
  • 切り抜き矩形の左端が右端の右端にある場合、オブジェクトは水平方向に反転します。
  • 切り抜き矩形の上端が下端より下にある場合、オブジェクトは垂直方向に反転します。
  • オフセットと回転角がすべて 0 の場合、そのオブジェクトは切り抜かれません。

切り抜き後、切り抜き長方形のコンテンツは、そのコンテナに合うように引き伸ばされます。

JSON 表現
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
フィールド
leftOffset

number

オフセットは、切り抜き範囲の左端と、元の境界四角形の右端との間の位置を、オブジェクトの元の幅に対して相対的に指定します。

rightOffset

number

このオフセットは、切り抜き領域の右端と、元の境界四角形の左端との間のオフセットを、オブジェクトの元の幅に対して相対的に指定します。

topOffset

number

このオフセットでは、オブジェクトの元の高さと相対して、元の境界四角形の上端の下端にある切り抜き矩形の上端を指定します。

bottomOffset

number

このオフセットでは、切り抜き領域の下端を、オブジェクトの元の高さに対して相対的に元の境界四角形の下端より上まで指定します。

angle

number

切り抜きウィンドウの中心の回転角度(ラジアン)。回転角度はオフセットの後に適用されます。

色の変更

画像にリカラー効果を適用します。

JSON 表現
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
フィールド
recolorStops[]

object (ColorStop)

リカラー効果は、カラーストップのリストであるグラデーションで表されます。

グラデーション カラーは、カラーパレット内の同じ位置に対応する色に置き換わり、画像に適用されます。このプロパティは読み取り専用です。

name

enum (Name)

リカラー エフェクトの名前。

この名前は、グラデーションをページの現在の color scheme の色と照合することで recolorStops から決定されます。このプロパティは読み取り専用です。

ColorStop

グラデーション バンドの色と位置。

JSON 表現
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
フィールド
color

object (OpaqueColor)

グラデーションの停止色。

alpha

number

グラデーション バンドにおけるこの色のアルファ値。デフォルトは 1.0 で、完全に不透明です。

position

number

グラデーション バンドにおけるカラーストップの相対位置をパーセンテージで表したものです。値の範囲は [0.0, 1.0] にします。

名前

リカラー効果の名前。

列挙型
NONE 色の変更効果はありません。デフォルト値。
LIGHT1 カラーパターンからページで最初に利用可能な色を使用して画像を明るくする再カラー効果。
LIGHT2 カラーパターンから 2 種類目のカラーを使用して画像を明るくする再カラー効果。
LIGHT3 カラーパターンから 3 種類目のカラーを使用して画像を明るくする再カラー効果。
LIGHT4 カラーパターンから 4 番目に利用できる色を使用して画像を明るくする再カラー効果。
LIGHT5 カラーパターンからページの 5 番目の色を使用して画像を明るくするリカラー効果。
LIGHT6 カラーパターンから 6 つ目のカラーを使用して画像を明るくする再カラー効果。
LIGHT7 カラーパターンからページの 7 番目の色を使用して画像を明るくするリカラー効果。
LIGHT8 カラーパターンから 8 色目を使用して画像を明るくする再カラー効果。
LIGHT9 カラーパターンの 9 番目の色を使用して画像を明るくするリカラー効果。
LIGHT10 カラーパターンから 10 番目に使用可能な色を使用して画像を明るくするリカラー エフェクト。
DARK1 カラーパターンからページで最初に使用可能な色を使用して画像を暗くするリカラー効果。
DARK2 カラーパターンから 2 種類目のカラーを使用して画像を暗くする再カラー効果。
DARK3 カラーパターンから 3 種類目のカラーを使用して画像を暗くするリカラー効果。
DARK4 カラーパターンから 4 種類目のカラーを使用して画像を暗くするリカラー効果。
DARK5 カラーパターンからページの 5 番目の色を使用して画像を暗くするリカラー効果。
DARK6 カラーパターンから 6 つ目のカラーを使用して画像を暗くするリカラー効果。
DARK7 カラーパターンから 7 番目に利用できる色で画像を暗くするリカラー効果。
DARK8 カラーパターンから 8 色目を使用して画像を暗くする再カラー効果。
DARK9 カラーパターンから 9 番目の色を使用して画像を暗くするリカラー効果。
DARK10 カラーパターンから 10 番目に使用可能な色を使用して画像を暗くするリカラー エフェクト。
GRAYSCALE 画像のカラースケールをグレースケールに変更します。
NEGATIVE 画像の色をネガティブ グレースケールに変色させるリカラー エフェクト。
SEPIA セピア色を使用して画像の色を変更するリカラー効果。
CUSTOM カスタムの色の変更効果。具体的なグラデーションについては、recolorStops をご覧ください。