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 (
|
欄位 | |
---|---|
scaleX
|
X 座標縮放元素。 |
scaleY
|
Y 座標縮放元素。 |
shearX
|
X 座標軸。 |
shearY
|
Y 座標軸。 |
translateX
|
X 座標轉譯元素。 |
translateY
|
Y 座標轉譯元素。 |
unit
|
翻譯元素的單位。 |
不透明顏色
可設定主題的純色值。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 kind 。色彩值的種類。
kind 只能是下列其中一個值: |
|
rgbColor
|
不透明 RGB 顏色。 |
themeColor
|
不透明主題顏色。 |
RgbColor
RGB 顏色。
JSON 表示法 |
---|
{ "red": number, "green": number, "blue": number } |
欄位 | |
---|---|
red
|
顏色的紅色元件,從 0.0 到 1.0。 |
green
|
顏色的綠色元件,從 0.0 到 1.0。 |
blue
|
顏色的藍色元件,從 0.0 到 1.0。 |
ThemeColorType
主題顏色類型。
PageProperties
包含 ColorScheme
,用於定義這些主題顏色類型的對應具體顏色。
列舉 | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
未指定主題顏色。這個值不可使用。 |
DARK1
|
代表第一個深色。 |
LIGHT1
|
代表第一個淺色顏色。 |
DARK2
|
代表第二個深色。 |
LIGHT2
|
代表第二個淺色顏色。 |
ACCENT1
|
代表第一個強調顏色。 |
ACCENT2
|
代表第二個強調色。 |
ACCENT3
|
代表第三個強調色。 |
ACCENT4
|
代表第四個強調色。 |
ACCENT5
|
代表第五種強調色。 |
ACCENT6
|
代表第六種強調色。 |
HYPERLINK
|
代表超連結使用的顏色。 |
FOLLOWED_HYPERLINK
|
代表造訪超連結使用的顏色。 |
TEXT1
|
代表第一個文字顏色。 |
BACKGROUND1
|
代表第一個背景顏色。 |
TEXT2
|
代表第二個文字顏色。 |
BACKGROUND2
|
代表第二個背景顏色。 |
連結
超文字連結。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 kind 。連結種類。
kind 只能是下列其中一個值: |
|
url
|
設定後,就表示這個網址指向外部網頁的連結。 |
relativeLink
|
如有設定,則表示此為此簡報中的投影片連結,且會依位置定位。 |
pageObjectId
|
如已設定,則表示此為此簡報中特定 ID 的網頁連結。使用這個 ID 的網頁可能不存在。 |
slideIndex
|
設定後,表示這是簡報中這個從 0 開始索引的投影片連結。此索引可能沒有投影片。 |
RelativeSlideLink
相對連結的種類。
列舉 | |
---|---|
RELATIVE_SLIDE_LINK_UNSPECIFIED
|
未指定的相對投影片連結。 |
NEXT_SLIDE
|
前往下一張投影片的連結。 |
PREVIOUS_SLIDE
|
連結至上一張投影片的連結。 |
FIRST_SLIDE
|
簡報中第一張投影片的連結。 |
LAST_SLIDE
|
簡報中最後一張投影片的連結。 |
PropertyState
屬性的可能狀態。
列舉 | |
---|---|
RENDERED
|
如果資源的狀態是 RENDERED,當元素在網頁上顯示時,就會有對應的屬性。如果元素根據 placeholder 欄位決定的預留位置形狀,且繼承了預留位置形狀,則對應欄位可能會未設定,這表示屬性值繼承自父項預留位置。如果元素未沿用,欄位就會提供算繪的值。此為預設值。 |
NOT_RENDERED
|
如果房源的狀態「NOT_RENDERED」,當網頁上轉譯時,該元素沒有對應的屬性。不過,這個欄位仍可設定,因此子元件可沿用這個欄位。如要從算繪元素中移除屬性,請將其 PropertyState 設為 NOT_RENDERED。 |
INHERIT
|
如果屬性的狀態是 INHERIT,屬性狀態就會使用父項形狀中對應的 propertyState 欄位值。未沿用的元素不會有 INHERIT 屬性狀態。 |
SolidFill
純色填滿。網頁或元素元素會填入指定的顏色值。
如未設定任何欄位,則會沿用父項預留位置的值。
JSON 表示法 |
---|
{
"color": {
object (
|
欄位 | |
---|---|
color
|
實心填滿的顏色值。 |
alpha
|
此 Pixel color = alpha * (顏色) + (1.0 - alpha) * (背景顏色) 也就是說,1.0 的值代表純色,而 0.0 值則對應至完全透明的顏色。 |
大綱
PageElement
的大綱。
如果不設定這些欄位,這些欄位可能會沿用父項預留位置 (如果有的話)。如果沒有任何父項,這些欄位會預設為在簡報編輯器中建立的新網頁元素中使用的值,這個值取決於網頁元素種類。
JSON 表示法 |
---|
{ "outlineFill": { object ( |
欄位 | |
---|---|
outlineFill
|
外框的填滿區域。 |
weight
|
外框的粗細。 |
dashStyle
|
外框的破折號樣式。 |
propertyState
|
外框屬性狀態。
更新網頁元素中的大綱時,如果以其他要求指定其他值,就會默示將這個欄位更新為 |
OutlineFill
外框的填滿區域。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 kind 。輪廓填滿種類。kind 只能是下列其中一個值: |
|
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
|
根據陰影位置對陰影平移、縮放和偏差進行編碼。 |
alignment
|
陰影的對齊點,可設定陰影的轉譯、縮放和偏差。此屬性處於唯讀狀態。 |
blurRadius
|
陰影模糊處理的半徑。半徑範圍越大,陰影的差異越大。 |
color
|
陰影顏色值。 |
alpha
|
陰影色彩的 Alpha 值,從 0.0 到 1.0。 |
rotateWithShape
|
陰影是否應隨著形狀旋轉。此屬性處於唯讀狀態。 |
propertyState
|
陰影屬性狀態。
更新網頁元素上的陰影時,除非在相同要求中指定其他值,否則默示將這個欄位更新為 |
類型
陰影類型。
列舉 | |
---|---|
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
|
預留位置的索引。如果網頁上有相同的預留位置類型,那索引值會有所不同。 |
parentObjectId
|
這個形狀的父項預留位置的物件 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
|
圖片的透明度。這個值應與間隔 [0.0, 1.0] 相同,其中 0 表示沒有效果,1 表示完全透明。此屬性處於唯讀狀態。 |
brightness
|
圖片的亮度效果。這個值應落在間隔 [-1.0, 1.0],其中 0 表示無效。此屬性處於唯讀狀態。 |
contrast
|
圖片的對比效果。這個值應落在間隔 [-1.0, 1.0],其中 0 表示無效。此屬性處於唯讀狀態。 |
recolor
|
圖片的重新上色效果。如果未設定,圖片不會重新設定顏色。此屬性處於唯讀狀態。 |
outline
|
圖片外框。如果未設定,圖片就不會有外框。 |
shadow
|
圖片的陰影。如果未設定,圖片就不會顯示陰影。此屬性處於唯讀狀態。 |
link
|
圖片的超連結目的地。如果未設定,系統不會提供任何連結。 |
CropProperties
容器內物件的裁剪屬性。例如 Image
。
裁剪屬性則由定義裁剪矩形的四個邊緣的偏移所代表。系統會測量物件相對於原始原始矩形邊緣的相對邊緣,相對於物件的原始尺寸。
- 如果偏移量落在間隔 (0, 1),則裁剪矩形的對應邊緣會位於物件的原始定界矩形內。
- 如果偏移值為負數或大於 1,則對應的裁剪矩形位置會落在物件原始定界框外。
- 如果裁剪矩形的左側邊緣位於右側邊緣,該物件就會水平翻轉。
- 如果裁剪矩形的上緣位於其下下方,則系統會垂直翻轉物件。
- 如果所有偏移和旋轉角度為 0,則不會裁剪物件。
裁剪完畢後,裁剪矩形的內容會縮放至其容器。
JSON 表示法 |
---|
{ "leftOffset": number, "rightOffset": number, "topOffset": number, "bottomOffset": number, "angle": number } |
欄位 | |
---|---|
leftOffset
|
偏移值會指定裁剪矩形左方的左側邊緣,相對於物件的原始寬度。 |
rightOffset
|
偏移值會指定裁剪矩形右側右側邊緣,相對於物件的原始寬度。 |
topOffset
|
偏移值會指定裁剪框上方邊緣,相對於物件的原始高度。 |
bottomOffset
|
偏移值會指定裁剪矩形外的底部邊緣,相對於物件的原始高度。 |
angle
|
裁剪中心周圍的旋轉角度 (以弧度為單位)。偏移值會在偏移後套用。 |
重新設定顏色
為圖片套用重新上色效果。
JSON 表示法 |
---|
{ "recolorStops": [ { object ( |
欄位 | |
---|---|
recolorStops[]
|
重色效果會以漸層呈現,也就是色彩停止清單。 漸層中的顏色會取代調色盤中相同位置的對應顏色,並套用至圖片。此屬性處於唯讀狀態。 |
name
|
重新上色效果的名稱。
從比對目前頁面 |
ColorStop
漸層錶帶中的色彩和位置。
JSON 表示法 |
---|
{
"color": {
object (
|
欄位 | |
---|---|
color
|
漸層停止的顏色。 |
alpha
|
此色彩在漸層錶帶中的 Alpha 值。預設值為 1.0,完全不透明。 |
position
|
漸層錶帶的色彩停止位置 (以百分比為單位)。這個值應為間隔 [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 。 |