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)

不透明なテーマカラー。

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 1 つ目のテキストの色を表します。
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 File Formats - Fundamentals and Markup Language Reference」のセクション 19.7.10 の「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 をご覧ください。