AffineTransform
AffineTransform 使用隐含的最后一行 [ 0 0 1 ] 的 3x3 矩阵,根据以下各项将源坐标 (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;
因此,此消息由这 6 个矩阵元素组成。
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
|
如果设置此标记,则表示这是指向演示文稿中此零索引索引处的幻灯片链接。此索引可能不包含幻灯片。 |
相对幻灯片链接
相对链接的种类。
枚举 | |
---|---|
RELATIVE_SLIDE_LINK_UNSPECIFIED
|
未指定的相对幻灯片链接。 |
NEXT_SLIDE
|
指向下一张幻灯片的链接。 |
PREVIOUS_SLIDE
|
指向上一张幻灯片的链接。 |
FIRST_SLIDE
|
指向演示文稿第一张幻灯片的链接。 |
LAST_SLIDE
|
指向演示文稿中最后一张幻灯片的链接。 |
PropertyState
属性的可能状态。
枚举 | |
---|---|
RENDERED
|
如果房源的状态为 RENDERED,在页面上呈现时,元素就具有相应的属性。如果该元素是由 placeholder 字段确定的占位符形状,并且它从占位符形状继承而来,那么相应的字段可以取消设置,也就是说,属性值会从父占位符继承。如果该元素未继承,该字段将包含所呈现的值。这是默认值。
|
NOT_RENDERED
|
如果资源的状态为 NOT_RENDERED,当元素在页面上呈现时,它就没有相应的属性。不过,您仍然可以设置该字段,使其可以通过子形状继承。若要从呈现的元素中移除属性,请将其 attributeState 设为 NOT_RENDERED。 |
INHERIT
|
如果属性的状态为 INHERIT,则属性状态会在父形状上使用相应 propertyState 字段的值。未继承的元素绝不会具有 INHERIT 属性状态。 |
单色填充
纯色填充。页面或页面元素会完全填充指定的颜色值。
如果任何字段未设置,其值可能会从父占位符(如果存在)继承。
JSON 表示法 |
---|
{
"color": {
object (
|
字段 | |
---|---|
color
|
纯色的颜色值。 |
alpha
|
应应用于像素的 像素颜色 = Alpha 值*(颜色)+(1.0-Alpha 版)*(背景颜色) 这意味着,值 1.0 对应于纯色,而值 0.0 则对应于完全透明的颜色。 |
轮廓
PageElement
的轮廓。
如果这些字段未设置,它们可能会从父占位符(如果存在)继承而来。如果没有父元素,这些字段将默认用于幻灯片编辑器中创建的新页面元素的值,这可能取决于页面元素种类。
JSON 表示法 |
---|
{ "outlineFill": { object ( |
字段 | |
---|---|
outlineFill
|
大纲的填充。 |
weight
|
轮廓的粗细。 |
dashStyle
|
轮廓的短划线样式。 |
propertyState
|
大纲属性状态。
更新页面元素的大纲会将此字段隐式更新为 |
Outline 填充
大纲的填充。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 kind 。轮廓填充的类型。
kind 只能是下列其中一项:
|
|
solidFill
|
纯色填充。 |
DashStyle
枚举 | |
---|---|
DASH_STYLE_UNSPECIFIED
|
未指定短划线样式。 |
SOLID
|
实线。对应于 ECMA-376 ST_PresetLineDashVal 值“期望”。这是默认的短划线样式。 |
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 版的第 1 部分。
枚举 | |
---|---|
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 第 4 版第 19.7.10 节的“Office Open XML 文件格式 - 基础知识和标记语言参考文档”中“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
|
图片的透明度效果。该值应介于 [0.0, 1.0] 之间,其中 0 表示没有任何影响,1 表示完全透明。此属性为只读属性。 |
brightness
|
图片的亮度效果。该值应介于 [-1.0, 1.0] 之间,其中 0 表示没有任何影响。此属性为只读属性。 |
contrast
|
图片的对比度。该值应介于 [-1.0, 1.0] 之间,其中 0 表示没有任何影响。此属性为只读属性。 |
recolor
|
图片的改色效果。如果未设置,则不会重新为图片着色。此属性为只读属性。 |
outline
|
图片的轮廓。如果未设置,则图像没有轮廓。 |
shadow
|
图片的阴影。如果未设置,图片将没有阴影。此属性为只读属性。 |
link
|
图片的超链接目的地。如果未设置,则不会提供任何链接。 |
剪裁属性
容器内所含对象的剪裁属性。例如,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
|
一种改色效果,使用网页的第 3 种配色方案提供的浅色调亮图片。 |
LIGHT4
|
一种改色效果,能够从网页的配色方案的第 4 种可用颜色调亮图片。 |
LIGHT5
|
一种改色效果,使用网页的第五种配色方案提供的第五个可用颜色来调亮图片。 |
LIGHT6
|
一种改色效果,使用页面提供的配色方案中的第六种可用颜色来调亮图片。 |
LIGHT7
|
一种改色效果,使用页面的第 7 种配色方案,让图片变亮。 |
LIGHT8
|
一种改色效果,使用页面提供的第 8 种可用配色方案,让图片变亮。 |
LIGHT9
|
一种改色效果,使用页面的第 9 个配色方案提供的浅色调亮图片。 |
LIGHT10
|
一种改色效果,通过使用网页的配色方案中的第 10 种可用颜色来调亮图片。 |
DARK1
|
一种改色效果,使用页面的第一种可用配色方案提供的颜色调暗图片。 |
DARK2
|
一种改色效果,使用网页的配色方案中的第二种可用颜色来调暗图片。 |
DARK3
|
一种改色效果,使用页面在其配色方案中的第三种可用颜色调暗图片。 |
DARK4
|
一种改色效果,使用网页的第 4 种配色方案提供的颜色调暗图片。 |
DARK5
|
一种改色效果,使用页面的第 5 种配色方案,将图片调暗。 |
DARK6
|
一种改色效果,通过使用网页的配色方案中的第六个可用颜色将图片调暗。 |
DARK7
|
一种改色效果,通过使用页面的配色方案中的第七种可用颜色来使图片变暗。 |
DARK8
|
一种改色效果,通过使用网页的配色方案中的第八个可用颜色将图片调暗。 |
DARK9
|
一种改色效果,通过使用页面的第 9 个配色方案,使图片变暗。 |
DARK10
|
一种改色效果,使用网页的十种配色方案中第 10 种可用颜色将图片调暗。 |
GRAYSCALE
|
将此图片改色为灰度的重新着色效果。 |
NEGATIVE
|
将此图片改色为负灰度的改色效果。 |
SEPIA
|
使用色深色重新给图片着色的改色效果。 |
CUSTOM
|
自定义改色效果。有关具体渐变,请参阅 recolorStops 。 |