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 如果屬性的狀態為「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 時，顏色完全透明。

Outline

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 File Formats - Fundamentals and Markup Language Reference」第 1 部分 (ECMA-376 第 5 版) 第 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」。

陰影

頁面元素的陰影屬性。

如果未設定這些欄位，系統可能會沿用父項預留位置 (如有) 的值。如果沒有上層元素，這些欄位會預設為在 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 File Formats - Fundamentals and Markup Language Reference」第 1 部分 ECMA-376 第 5 版第 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。

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

  • 如果偏移量位於 (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

漸層帶中這個顏色的 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。