Other

Аффинное преобразование

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 )

Единицы для перевода элементов.

НепрозрачныйЦвет

Тематическое значение сплошного цвета.

Представление 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 )

Непрозрачный цвет темы.

Цвет RGB

Цвет 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.

ТемаЦветТип

Цветовые типы темы.

PageProperties содержит ColorScheme , определяющую сопоставление этих типов цветов темы с конкретными цветами.

перечисления
THEME_COLOR_TYPE_UNSPECIFIED Неопределенный цвет темы. Это значение не следует использовать.
DARK1 Представляет первый темный цвет.
LIGHT1 Представляет собой первый светлый цвет.
DARK2 Представляет собой второй темный цвет.
LIGHT2 Представляет второй светлый цвет.
ACCENT1 Представляет собой первый акцентный цвет.
ACCENT2 Представляет собой второй акцентный цвет.
ACCENT3 Представляет собой третий акцентный цвет.
ACCENT4 Представляет собой четвертый акцентный цвет.
ACCENT5 Представляет пятый акцентный цвет.
ACCENT6 Представляет собой шестой акцентный цвет.
TEXT1 Представляет первый цвет текста.
BACKGROUND1 Представляет первый цвет фона.
TEXT2 Представляет второй цвет текста.
BACKGROUND2 Представляет второй цвет фона.

Состояние свойства

Возможные состояния свойства.

перечисления
RENDERED Если свойство находится в состоянии RENDERED, то элемент имеет соответствующее свойство при отображении на странице. Если элемент является фигурой-заполнителем, как определено полем placeholder , и он наследуется от формы-заполнителя, соответствующее поле может быть не задано, что означает, что значение свойства наследуется от родительского заполнителя. Если элемент не наследуется, то поле будет содержать отображаемое значение. Это значение по умолчанию.
NOT_RENDERED Если состояние свойства — NOT_RENDERED, то элемент не имеет соответствующего свойства при отображении на странице. Однако поле все еще может быть установлено таким образом, чтобы оно могло быть унаследовано дочерними фигурами. Чтобы удалить свойство из отображаемого элемента, установите его свойствоState в значение NOT_RENDERED.
INHERIT Если состояние свойства — INHERIT, то состояние свойства использует значение соответствующего поля propertyState в родительской фигуре. Элементы, которые не наследуются, никогда не будут иметь состояние свойства INHERIT.

сплошная заливка

Заливка сплошным цветом. Страница или элемент страницы полностью заполняется указанным значением цвета.

Если какое-либо поле не задано, его значение может быть унаследовано от родительского заполнителя, если он существует.

Представление JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
Поля
color

object ( OpaqueColor )

Значение цвета сплошной заливки.

alpha

number

Доля этого color , которая должна быть применена к пикселю. То есть конечный цвет пикселя определяется уравнением:

цвет пикселя = альфа * (цвет) + (1,0 - альфа) * ​​(цвет фона)

Это означает, что значение 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

Типы штрихов, с помощью которых можно отобразить линейную геометрию. Эти значения основаны на простом типе ST_PresetLineDashVal, описанном в разделе 20.1.10.48 документа «Форматы файлов Office Open XML — основы и справочник по языку разметки», часть 1 ECMA-376, 4-е издание .

перечисления
DASH_STYLE_UNSPECIFIED Неопределенный стиль тире.
SOLID Сплошная линия. Соответствует «твердому» значению ST_PresetLineDashVal стандарта ECMA-376. Это стиль тире по умолчанию.
DOT Пунктирная линия. Соответствует значению «точка» ST_PresetLineDashVal ECMA-376.
DASH Пунктир. Соответствует значению ECMA-376 ST_PresetLineDashVal «тире».
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

Альфа цвета тени, от 0.0 до 1.0.

rotateWithShape

boolean

Должна ли тень вращаться вместе с фигурой. Это свойство доступно только для чтения.

propertyState

enum ( PropertyState )

Состояние теневого свойства.

Обновление тени элемента страницы неявно обновит это поле до RENDERED , если в том же запросе не указано другое значение. Чтобы не было тени на элементе страницы, установите для этого поля значение NOT_RENDERED . В этом случае любые другие теневые поля, установленные в том же запросе, будут игнорироваться.

Тип

Теневые типы.

перечисления
SHADOW_TYPE_UNSPECIFIED Неопределенный тип тени.
OUTER Внешняя тень.

ПрямоугольникПозиция

Определяет опорные позиции в прямоугольнике.

перечисления
RECTANGLE_POSITION_UNSPECIFIED Неопределенные.
TOP_LEFT Верхний левый.
TOP_CENTER Верхний центр.
TOP_RIGHT В правом верхнем углу.
LEFT_CENTER Левый центр.
CENTER Центр.
RIGHT_CENTER Правый центр.
BOTTOM_LEFT Внизу слева.
BOTTOM_CENTER Нижний центр.
BOTTOM_RIGHT Внизу справа.

Выравнивание содержимого

Типы выравнивания контента.

Получено из подмножества значений простого типа «ST_TextAnchoringType» в разделе 20.1.10.59 документа «Форматы файлов Office Open XML — основы и справочник по языку разметки», часть 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

Идентификатор объекта родительского заполнителя этой фигуры. Если параметр не установлен, родительская фигура-заполнитель не существует, поэтому фигура не наследует свойства какой-либо другой фигуры.

Тип

Тип фигуры-заполнителя.

Многие из этих типов заполнителей соответствуют идентификаторам заполнителей из стандарта ECMA-376. Дополнительные сведения об этих фигурах можно найти в описании типа «ST_PlaceholderType» в разделе 19.7.10 документа «Форматы файлов Office Open XML — основы и справочник по языку разметки», часть 1 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 Слайд-изображение.

Свойства изображения

Свойства 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 )

Название эффекта перекраски.

Имя определяется из recolorStops путем сопоставления градиента с цветами в текущей color scheme страницы. Это свойство доступно только для чтения.

ЦветСтоп

Цвет и положение в полосе градиента.

Представление JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
Поля
color

object ( OpaqueColor )

Цвет остановки градиента.

alpha

number

Альфа-значение этого цвета в полосе градиента. По умолчанию 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 для бетонного градиента.