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;

因此，這則訊息由以下六個矩陣元素組成。

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 代表第二個深色。
LIGHT2 代表第二個淺色。
ACCENT1 代表第一個強調色。
ACCENT2 代表第二個強調色。
ACCENT3 代表第三個重點顏色。
ACCENT4 代表第四個重點顏色。
ACCENT5 代表第五個強調色。
ACCENT6 代表第六個重點顏色。
TEXT1 代表第一個文字顏色。
BACKGROUND1 代表第一個背景顏色。
TEXT2 代表第二個文字顏色。
BACKGROUND2 代表第二個背景顏色。

PropertyState

房源的可能狀態。

列舉
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 值。也就是說，最終像素顏色是由以下等式定義：

像素顏色 = alpha * (顏色) + (1.0 - alpha) * (背景顏色)

也就是說，值為 1.0 對應於純色，而值為 0.0 則對應於完全透明的顏色。

大綱

PageElement 的輪廓。

如果未設定這些欄位，則會從父項預留位置 (如果有的話) 繼承這些欄位。如果沒有父項，這些欄位預設會採用在 Google 簡報編輯器中建立的新頁面元素所用的值，這可能會視頁面元素類型而定。

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

可用於算繪線性幾何圖形的虛線類型。這些值是根據「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」(「Office Open XML File Formats - Fundamentals and Markup Language Reference」) 的 第 5 版 ECMA-376 的 1 部分中所述的「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」。

Shadow

頁面元素的陰影屬性。

如果未設定這些欄位，則會從父項預留位置 (如果有的話) 繼承這些欄位。如果沒有父項，這些欄位預設會採用在 Google 簡報編輯器中建立的新頁面元素所用的值，這可能會視頁面元素類型而定。

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

陰影顏色的 Alpha 值，範圍為 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

內容對齊類型。

源自「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」(「Office Open XML File Formats - Fundamentals and Markup Language Reference」) 的第 20.1.10.60 節，以及 ECMA-376 第 5 版的第 1 部分。

列舉
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 檔案格式 - 基礎知識和標記語言參考資料」一節，第 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。

裁剪屬性會以四個邊緣的偏移量表示，這些邊緣定義了裁剪矩形。偏移量以百分比表示，從物件原始邊界矩形的相應邊緣向內，相對於物件原始尺寸。

  • 如果偏移值介於 (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)

重新著色效果的名稱。

系統會根據 recolorStops 中的漸層與網頁目前 color scheme 中的顏色比對，判斷名稱。這是唯讀屬性。

ColorStop

漸層色帶中的顏色和位置。

JSON 表示法 
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
欄位
color

object (OpaqueColor)

漸層停頓點的顏色。
alpha

number

這個顏色在漸層頻帶中的 Alpha 值。預設值為 1.0，完全不透明。

position

number

漸層帶中色彩停頓點的相對位置，以百分比為單位。這個值應介於 [0.0, 1.0] 之間。

名稱

重新著色效果名稱。

列舉
NONE 不套用重新著色效果。預設值。
LIGHT1 重新著色效果，會使用網頁色彩配置中第一個可用的顏色，將圖片調亮。
LIGHT2 重新著色效果，會使用頁面色彩配置中可用的第二個顏色，將圖片調亮。
LIGHT3 重新著色效果，使用頁面色彩配置中的第三個可用顏色，將圖片調亮。
LIGHT4 重新著色效果，使用頁面色彩配置中可用的第四個顏色，將圖片調亮。
LIGHT5 重新著色效果，使用頁面色彩配置中第五個可用的顏色，將圖片調亮。
LIGHT6 重新著色效果，會使用頁面色彩配置中可用的第六種顏色，將圖片調亮。
LIGHT7 重新著色效果，使用頁面色彩配置中可用的第七種顏色，將圖片調亮。
LIGHT8 重新著色效果，使用網頁色彩配置中的第八個可用顏色，將圖片調亮。
LIGHT9 重新著色效果，使用網頁色彩配置中的第九個可用顏色，將圖片調亮。
LIGHT10 重新著色效果，使用網頁色彩配置中第十個可用的顏色，將圖片調亮。
DARK1 重新著色效果，會使用網頁色彩配置中第一個可用的顏色，將圖片調暗。
DARK2 重新著色效果，使用網頁色彩配置中可用的第二個顏色，將圖片調暗。
DARK3 重新著色效果，使用網頁色彩配置中的第三個可用顏色來使圖片變暗。
DARK4 重新著色效果，使用頁面色彩配置中可用的第四個顏色來使圖片變暗。
DARK5 重新著色效果，使用頁面色彩配置中第五個可用的顏色來使圖片變暗。
DARK6 重新著色效果，使用頁面色彩配置中可用的第六種顏色，將圖片調暗。
DARK7 重新著色效果，使用頁面色彩配置中可用的第七種顏色，將圖片調暗。
DARK8 重新著色效果，使用頁面色彩配置中可用的第八種顏色，將圖片調暗。
DARK9 重新著色效果，使用網頁色彩配置中第九個可用的顏色來使圖片變暗。
DARK10 重新著色效果，使用網頁色彩配置中第十個可用顏色來使圖片變暗。
GRAYSCALE 重新著色效果，可將圖片重新著色為灰階。
NEGATIVE 重新著色效果，可將圖片重新著色為負片灰階。
SEPIA 重新著色效果，可使用棕褐色重新著色圖片。
CUSTOM 自訂重新著色效果。如要瞭解具體的漸層效果，請參閱 recolorStops。