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;

因此,此消息由这六个矩阵元素组成。

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 如果某个属性的状态为 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 的轮廓。

如果未设置这些字段,则可能会从父占位符(如果存在)继承这些字段。如果没有父元素,这些字段将默认采用在 Google 幻灯片编辑器中创建新页面元素时使用的值,该值可能取决于页面元素类型。

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

页面元素的阴影属性。

如果未设置这些字段,则可能会从父占位符(如果存在)继承这些字段。如果没有父元素,这些字段将默认采用在 Google 幻灯片编辑器中创建新页面元素时使用的值,该值可能取决于页面元素类型。

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 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