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

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

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)

Outline 属性状态。

更新页面元素上的概览会将此字段隐式更新为 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

可渲染线性几何图形的短划线的类型。这些值基于“ST_PresetLineDashVal”“Office Open XML 文件格式 - 基础知识和标记语言参考”第 20.1.10.48 节(第 1 部分) ECMA-376 第 4 版

枚举
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”。

阴影

页面元素的阴影属性。

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

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

内容对齐方式的类型。

派生自“ST_TextAnchoringType”的一个值子集“Office Open XML 文件格式 - 基础知识和标记语言参考”的第 20.1.10.59 部分(第 1 部分) ECMA-376 第 4 版

枚举
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。有关这些形状的更多信息,请参阅“ST_PlaceholderType”说明请在“Office Open XML 文件格式 - 基础知识和标记语言参考”的第 19.7.10 部分( ECMA-376 第 4 版

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

剪裁窗口围绕其中心的旋转角度(以弧度为单位)。旋转角度在偏移之后应用。

Recolor

应用于图片的改色效果。

JSON 表示法
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
田野
recolorStops[]

object (ColorStop)

改色效果以渐变形式表示,渐变色是一个颜色停止点列表。

渐变中的颜色将替换调色板中同一位置的相应颜色,并应用于图片。此属性为只读属性。

name

enum (Name)

改色效果的名称。

名称由 recolorStops 将渐变效果与页面当前颜色 color scheme。此属性为只读属性。

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 一种改色效果,可使用网页配色方案中的第十种可用颜色使图片变亮。
DARK1 一种改色效果,可使用页面中从其配色方案中选出的第一个可用颜色使图片变暗。
DARK2 一种改色效果,可使用相应页面配色方案中的第二种可用颜色使图片变暗。
DARK3 一种改色效果,会使用页面中第三种配色方案中的可用颜色使图片变暗。
DARK4 一种改色效果,可使用相应页面配色方案中的第四种可用颜色使图片变暗。
DARK5 一种改色效果,会使用网页配色方案中的第五种可用颜色使图片变暗。
DARK6 一种改色效果,会使用网页配色方案中的第六种可用颜色使图片变暗。
DARK7 一种改色效果,会使用网页配色方案中的第七种可用颜色使图片变暗。
DARK8 一种改色效果,可使用页面配色方案中的第八种可用颜色使图片变暗。
DARK9 一种改色效果,会使用网页配色方案中的第九种可用颜色使图片变暗。
DARK10 一种改色效果,会使用网页配色方案中的第十种可用颜色使图片变暗。
GRAYSCALE 一种将图片重新着色为灰度的改色效果。
NEGATIVE 一种改色效果,可将图片重新着色为负灰度模式。
SEPIA 一种改色效果,可使用深褐色为图片改色。
CUSTOM 自定义改色效果。请参阅 recolorStops 用于设置具体的渐变效果