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
|
用于平移元素的单位。 |
OpaqueColor
可设置主题的纯色值。
| 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
|
如果已设置,则表示这是指向演示中相应零基指数处的幻灯片的链接。此索引处可能没有幻灯片。 |
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
|
此 像素颜色 = alpha *(颜色)+ (1.0 - alpha) *(背景颜色) 也就是说,值为 1.0 表示纯色,而值为 0.0 表示完全透明的颜色。 |
大纲
PageElement 的轮廓。
如果未设置这些字段,则可能会从父占位符(如果存在)继承这些字段。如果没有父元素,这些字段将默认采用在 Google 幻灯片编辑器中创建新页面元素时使用的值,该值可能取决于页面元素类型。
| JSON 表示法 |
|---|
{ "outlineFill": { object ( |
| 字段 | |
|---|---|
outlineFill
|
轮廓的填充。 |
weight
|
轮廓的粗细。 |
dashStyle
|
轮廓的虚线样式。 |
propertyState
|
轮廓属性状态。
更新页面元素上的轮廓时,除非在同一请求中指定了其他值,否则系统会隐式将此字段更新为 |
OutlineFill
轮廓的填充。
| JSON 表示法 |
|---|
{ // Union field |
| 字段 | |
|---|---|
联合字段 kind。轮廓填充的类型。
kind 只能是下列其中一项:
|
|
solidFill
|
纯色填充。 |
DashStyle
可用于渲染线性几何图形的短划线类型。这些值基于 ECMA-376 第 5 版第 1 部分“Office Open XML 文件格式 - 基础知识和标记语言参考”的 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”。 |
Shadow
页面元素的阴影属性。
如果未设置这些字段,则可能会从父占位符(如果存在)继承这些字段。如果没有父元素,这些字段将默认采用在 Google 幻灯片编辑器中创建新页面元素时使用的值,该值可能取决于页面元素类型。
| 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
内容对齐类型。
派生自 ECMA-376 第 5 版第 1 部分“Office Open XML 文件格式 - 基础知识和标记语言参考”第 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
|
占位符的索引。如果同一网页中存在相同的占位类型,它们将具有不同的索引值。 |
parentObjectId
|
相应形状的父占位符的对象 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
|
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
|
一种重新着色效果,使用配色方案中页面的第五种可用颜色来提亮图片。 |
LIGHT6
|
一种重新着色效果,使用网页配色方案中的第六种可用颜色来提亮图片。 |
LIGHT7
|
一种重新着色效果,使用配色方案中第七种可用的颜色来提亮图片。 |
LIGHT8
|
一种重新着色效果,使用配色方案中可用的第八种颜色来提亮图片。 |
LIGHT9
|
一种重新着色效果,使用配色方案中第九种可用的颜色来提亮图片。 |
LIGHT10
|
一种重新着色效果,使用配色方案中第 10 种可用的颜色来提亮图片。 |
DARK1
|
一种重新着色效果,使用网页配色方案中的第一个可用颜色使图片变暗。 |
DARK2
|
一种重新着色效果,使用配色方案中页面的第二种可用颜色使图片变暗。 |
DARK3
|
一种重新着色效果,使用网页配色方案中的第三种可用颜色使图片变暗。 |
DARK4
|
一种重新着色效果,使用配色方案中页面的第四种可用颜色使图片变暗。 |
DARK5
|
一种重新着色效果,使用网页配色方案中的第五种可用颜色使图片变暗。 |
DARK6
|
一种重新着色效果,使用网页配色方案中的第六种可用颜色使图片变暗。 |
DARK7
|
一种重新着色效果,使用网页配色方案中的第七种可用颜色使图片变暗。 |
DARK8
|
一种重新着色效果,使用配色方案中页面的第八种可用颜色使图片变暗。 |
DARK9
|
一种重新着色效果,使用配色方案中第九种可用的颜色使图片变暗。 |
DARK10
|
一种重新着色效果,使用配色方案中第 10 种可用的颜色来调暗图片。 |
GRAYSCALE
|
一种将图片改色为灰度的改色效果。 |
NEGATIVE
|
一种重新着色效果,可将图片重新着色为负灰度。 |
SEPIA
|
一种使用深褐色对图片进行改色的改色效果。 |
CUSTOM
|
自定义改色效果。如需了解具体梯度,请参阅 recolorStops。
|