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,那麼在網頁上顯示的元素時,就不會有對應的屬性。不過,這個欄位可能還是可以設定,因此子項形狀可以沿用這個欄位。如要從算繪的元素中移除屬性,請將屬性 State 設為 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

如未設定這些欄位,系統可能會從父項預留位置沿用這些欄位 (如有)。如果沒有父項,欄位會預設為在簡報編輯器中建立的新頁面元素所使用的值,這可能會因網頁元素種類而異。

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

可轉譯線性幾何圖形的破折號。這些值是以「ST_PresetLineDashVal」為基礎「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」第 20.1.10.48 節所述簡單型別,第 1 部分 ECMA-376 第 4 版

列舉
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

陰影色彩的 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

內容對齊的類型。

衍生自「ST_TextAnchoringType」的值子集「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」第 20.1.10.59 節的簡單型別 ECMA-376 第 4 版

列舉
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 相對應。如需這些形狀的詳細資訊,請參閱「ST_PlaceholderType」的說明輸入「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」第 19.7.10 節,第 1 部分 ECMA-376 第 4 版

列舉
NONE 預設值,表示不是預留位置。
BODY 內文。
CHART 圖表或圖形。
CLIP_ART 插圖。
CENTERED_TITLE 標題已置中。
DIAGRAM 圖表。
DATE_AND_TIME 日期和時間。
FOOTER 頁尾文字。
HEADER 標題文字。
MEDIA 多媒體。
OBJECT 任何內容類型。
PICTURE 圖片。
SLIDE_NUMBER 投影片數量。
SUBTITLE 字幕。
TABLE 表.
TITLE 投影片標題。
SLIDE_IMAGE 投影片圖片。

ImageProperties

如果 Pod 的屬性 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

裁剪視窗的中心周圍的旋轉角度,以弧度為單位。系統會在偏移值之後套用旋轉角度。

Recolor

已為圖片套用重新上色效果。

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 重新著色效果,運用網頁第 10 個色彩配置提供圖片的亮度。
DARK1 重新著色效果,使用網頁第一個可用的色彩配置調整圖片的色調。
DARK2 重新著色效果,使用網頁第二種可用的色彩配置調整圖片的色彩。
DARK3 重新著色效果,使用網頁第三個可用的色彩配置調整圖片的色彩。
DARK4 重新著色效果,使用網頁第四個可用色彩配置頁面中的色彩配置,讓圖片變暗。
DARK5 重新調色效果,會使用網頁第五個色彩配置,將圖片調暗。
DARK6 重新著色效果,使用網頁第六個色彩配置中可用的色彩,將圖片變暗。
DARK7 重新調色效果,會使用網頁第七種顏色配置的色彩配置,讓圖片變暗。
DARK8 重新調色效果,會使用網頁第八個色彩配置中可用的色彩,讓圖片變暗。
DARK9 重新調色效果,會使用網頁第九種色彩配置來調暗圖片。
DARK10 重新著色效果,使用網頁第 10 個色彩配置中可用的色彩,將圖片變暗。
GRAYSCALE 將圖片重新上色的灰階效果。
NEGATIVE 將圖片重新上色的灰階效果。
SEPIA 使用深褐色為圖片重新上色的重新著色效果。
CUSTOM 自訂重新色彩效果。詳情請參閱 recolorStops 產生混凝土漸層