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;

因此，此消息由这 6 个矩阵元素组成。

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)

平移元素的单位。

OpaqueColor

可设置主题的纯色值。

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 如果某个属性的状态为“已呈现”，则该元素在网页上呈现时具有相应的属性。如果元素是占位符形状（由 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 在像素中的应用比例。也就是说，最终像素颜色由以下等式定义：

像素颜色 = 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

可用于渲染线性几何图形的虚线类型。这些值基于 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": {
    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

内容对齐方式。

派生自 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": integer,
  "parentObjectId": string
}
字段
type

enum (Type)

占位符的类型。

index

integer

占位符的索引。如果同一页面中存在相同的占位符类型，则它们的编号值会不同。

parentObjectId

string

此形状的父级占位符的对象 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": 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 一种重新着色效果，使用页面配色方案中的第五种可用颜色来使图片变亮。
LIGHT6 一种重新着色效果，使用页面配色方案中的第六种可用颜色来使图片变亮。
LIGHT7 一种重新着色效果，使用页面配色方案中的第七种可用颜色来使图片变亮。
LIGHT8 一种重新着色效果，使用页面配色方案中的第八种可用颜色来使图片变亮。
LIGHT9 一种重新着色效果，使用页面配色方案中的第九种可用颜色来使图片变亮。
LIGHT10 一种重新着色效果，使用页面配色方案中的第 10 种可用颜色来使图片变亮。
DARK1 一种重新着色效果，用于使用网页配色方案中第一个可用的颜色来使图片变暗。
DARK2 一种重新着色效果，用于使用页面配色方案中的第二种可用颜色使图片变暗。
DARK3 一种重新着色效果，用于使用网页配色方案中的第三种可用颜色使图片变暗。
DARK4 一种重新着色效果，使用页面配色方案中的第四种可用颜色来使图片变暗。
DARK5 一种重新着色效果，使用页面配色方案中的第五种可用颜色使图片变暗。
DARK6 一种重新着色效果，用于使用页面配色方案中的第六种可用颜色使图片变暗。
DARK7 一种重新着色效果，使用页面配色方案中的第七种可用颜色来使图片变暗。
DARK8 一种重新着色效果，用于使用页面配色方案中的第八种可用颜色使图片变暗。
DARK9 一种重新着色效果，用于使用页面配色方案中的第九种可用颜色使图片变暗。
DARK10 一种重新着色效果，使用页面配色方案中的第 10 种可用颜色来使图片变暗。
GRAYSCALE 一种改色效果，用于将图片改为灰度图片。
NEGATIVE 一种重新着色效果，用于将图片重新着色为负片灰度。
SEPIA 一种重新着色效果，用于使用深褐色重新着色图片。
CUSTOM 自定义改色效果。如需了解具体梯度，请参阅 recolorStops。