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;
因此,此消息由这 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 | 
        平移元素的单位。 | 
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 | 如果某个属性的状态为“已呈现”,则该元素在网页上呈现时具有相应的属性。如果元素是占位符形状(由 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 的轮廓。
  
如果未设置这些字段,则可能会从父占位符(如果有)继承这些字段。如果没有父级,这些字段将默认为在幻灯片编辑器中创建的新页面元素所用的值,具体取决于页面元素的类型。
| 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
页面元素的阴影属性。
如果未设置这些字段,则可能会从父占位符(如果有)继承这些字段。如果没有父级,这些字段将默认为在幻灯片编辑器中创建的新页面元素所用的值,具体取决于页面元素的类型。
| 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 | 副标题。 | 
| 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。 |