Other

AffineTransform

AffineTransform は、3x3 行列(最後の行は [ 0 0 1 ] と暗黙的に指定)を使用して、次のようにソース座標(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)

不透明なテーマカラー。

RgbColor

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 に設定します。この場合、同じリクエストで設定された他のアウトライン フィールドは無視されます。

OutlineFill

輪郭線の塗りつぶし。

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 第 5 版のパート 1「Office Open XML ファイル形式 - 基礎とマークアップ言語リファレンス」の 20.1.10.49 セクションで説明されている「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 第 5 版のパート 1「Office Open XML ファイル形式 - 基礎とマークアップ言語リファレンス」の 20.1.10.60 セクションの「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 第 5 版のパート 1「Office Open XML ファイル形式 - 基礎とマークアップ言語リファレンス」の「ST_PlaceholderType」型の説明をご覧ください。

列挙型
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 をご覧ください。