Other

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 (Unit)
}
字段
scaleX

number

X 坐标缩放元素。

scaleY

number

Y 坐标缩放元素。

shearX

number

X 坐标剪切元素。

shearY

number

Y 坐标剪切元素。

translateX

number

X 坐标转换元素。

translateY

number

Y 坐标转换元素。

unit

enum (Unit)

转换元素的单位。

不透明颜色

可设置主题的纯色值。

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,当元素在页面上呈现时,它就没有相应的属性。不过,您仍然可以设置该字段,使其可以通过子形状继承。若要从呈现的元素中移除属性,请将其 attributeState 设为 NOT_RENDERED。
INHERIT 如果属性的状态为 INHERIT,则属性状态会在父形状上使用相应 propertyState 字段的值。未继承的元素绝不会具有 INHERIT 属性状态。

单色填充

纯色填充。页面或页面元素会完全填充指定的颜色值。

如果任何字段未设置,其值可能会从父占位符(如果存在)继承。

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。在这种情况下,系统会忽略在同一请求中设置的所有其他大纲字段。

Outline 填充

大纲的填充。

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

能够渲染线性几何图形的短划线的类型。这些值基于“Office_XML.

枚举
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": {
    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

内容对齐类型。

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

enum (Type)

占位符的类型。

index

integer

占位符的索引。如果同一占位符类型出现在同一页面中,则它们会具有不同的索引值。

parentObjectId

string

此形状的父占位符的对象 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": 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)

图片的阴影。如果未设置,图片将没有阴影。此属性为只读属性。

剪裁属性

容器内所含对象的剪裁属性。例如,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 一种改色效果,使用网页的第 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