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)

翻譯元素的單位。

不透明顏色

可設定主題的純色值。

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 應套用至像素的分數。也就是說，最終像素顏色是由方程式定義：

Pixel 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

可呈現線性幾何圖形的破折號類型。這些值是採用「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」第 20.1.10.48 節所述的「ST_PresetLineDashVal」簡單類型計算，屬於 ECMA-376 4 版的第 1 部分。

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

內容對齊類型。

根據「Office Open XML 檔案格式 - 基礎和標記語言參考資料」一節第 20.1.10.59 節一部分的「ST_TextAnchoringType」簡單類型取得，屬於 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。如要進一步瞭解這些形狀，請參閱「Office Open XML 檔案格式 - 基礎和標記語言參考資料」一節第 19.7.10 節的「ST_PlaceholderType」類型說明 (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

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 重新調整顏色，該顏色會以網頁的色彩配置為第 5 個顏色，可以提高圖片的亮度。
LIGHT6 重新調整顏色，該顏色會以網頁的色彩配置為六次可用的顏色，提高圖片的亮度。
LIGHT7 重新調整顏色，該頁面會以色彩配置的第七種顏色來調暗圖片。
LIGHT8 重新調整顏色，該頁面會以色彩配置的六個可用的色彩配置，提高圖片的亮度。
LIGHT9 重新調整顏色，可使用網頁的色彩第 9 個顏色來調暗圖片。
LIGHT10 重新調整顏色，可使用網頁的色彩配置 (第 10 個顏色) 加強顏色。
DARK1 重新調整顏色時，請使用網頁先前在色彩配置中使用的第一個顏色。
DARK2 重新調整顏色，該頁面可使用色彩配置中網頁的第二個可用顏色調暗圖片。
DARK3 重新調整顏色，該顏色會根據網頁的色彩配置使用第三個第三個顏色來調暗圖片。
DARK4 重新調整顏色時，請使用網頁的色彩配置的第四種色彩，讓圖片變暗。
DARK5 重新調整顏色，讓您使用網頁的色彩配置的第 5 個顏色，讓圖片調暗。
DARK6 重新調整顏色，該顏色會根據網頁的色彩配置的六個可用顏色調暗圖片。
DARK7 重新調整顏色，該顏色會以網頁的色彩配置為第七種顏色來調暗圖片。
DARK8 重新調整顏色，該頁面會以色彩配置的 8 個可用色彩調暗圖片。
DARK9 重新調整顏色時，利用網頁的色彩配置第 9 個顏色來調暗圖片。
DARK10 重新調整顏色，可使用頁面的色彩第 10 種顏色來調暗圖片。
GRAYSCALE 重新將圖片重新調整為灰階效果。
NEGATIVE 重新將圖片重新設定為負值灰階的色彩。
SEPIA 使用乳頭顏色重新調整圖片的顏色。
CUSTOM 自訂重新著色效果。如要瞭解具體的漸層，請參閱 recolorStops。