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 )

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

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 , которая должна быть применена к пикселю. То есть, окончательный цвет пикселя определяется уравнением:

цвет пикселя = альфа * (цвет) + (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.49 книги "Office Open XML File Formats - Fundamentals and Markup Language Reference", часть 1, 5-е издание ECMA-376 .

Перечисления
DASH_STYLE_UNSPECIFIED Неуказанный стиль оформления.
SOLID Сплошная линия. Соответствует значению 'solid' в ECMA-376 ST_PresetLineDashVal. Это стиль пунктирной линии по умолчанию.
DOT Пунктирная линия. Соответствует значению 'dot' в ECMA-376 ST_PresetLineDashVal.
DASH Пунктирная линия. Соответствует значению 'dash' в ECMA-376 ST_PresetLineDashVal.
DASH_DOT Чередование штрихов и точек. Соответствует значению 'dashDot' в ECMA-376 ST_PresetLineDashVal.
LONG_DASH Линия с крупными пунктирными линиями. Соответствует значению 'lgDash' в ECMA-376 ST_PresetLineDashVal.
LONG_DASH_DOT Чередование больших штрихов и точек. Соответствует значению 'lgDashDot' в ECMA-376 ST_PresetLineDashVal.

Тень

Свойства тени элемента страницы.

Если эти поля не заданы, они могут быть унаследованы от родительского заполнителя, если таковой существует. Если родительского элемента нет, поля будут по умолчанию принимать значения, используемые для новых элементов страницы, создаваемых в редакторе слайдов, которые могут зависеть от типа элемента страницы.

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 Внизу справа.

ContentAlignment

Типы согласования контента.

Получено из подмножества значений простого типа "ST_TextAnchoringType" в разделе 20.1.10.60 книги "Office Open XML File Formats - Fundamentals and Markup Language Reference", часть 1 стандарта ECMA-376 5-го издания .

Перечисления
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 File Formats - Fundamentals and Markup Language Reference", часть 1 5-го издания ECMA-376 .

Перечисления
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 )

Тень изображения. Если не задано, у изображения нет тени. Это свойство доступно только для чтения.

Свойства урожая

Свойства кадрирования объекта, заключенного в контейнер. Например, Image .

Свойства обрезки представлены смещениями четырех ребер, определяющих прямоугольник обрезки. Смещения измеряются в процентах от соответствующих ребер исходного ограничивающего прямоугольника объекта внутрь, относительно исходных размеров объекта.

  • Если смещение находится в интервале (0, 1), соответствующий край прямоугольника обрезки располагается внутри исходного ограничивающего прямоугольника объекта.
  • Если смещение отрицательное или больше 1, соответствующий край прямоугольника обрезки располагается за пределами исходного ограничивающего прямоугольника объекта.
  • Если левый край прямоугольника обрезки находится справа от его правого края, объект будет перевернут по горизонтали.
  • Если верхний край прямоугольника обрезки находится ниже его нижнего края, объект будет перевернут по вертикали.
  • Если все смещения и угол поворота равны 0, объект не обрезается.

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

JSON-представление
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
Поля
leftOffset

number

Параметр offset определяет левую границу прямоугольника обрезки, расположенную справа от левой границы исходного ограничивающего прямоугольника, относительно исходной ширины объекта.

rightOffset

number

Параметр offset определяет правый край прямоугольника обрезки, расположенный слева от правого края исходного ограничивающего прямоугольника, относительно исходной ширины объекта.

topOffset

number

Параметр offset определяет верхний край прямоугольника обрезки, расположенный ниже верхнего края исходного ограничивающего прямоугольника, относительно исходной высоты объекта.

bottomOffset

number

Параметр offset определяет нижний край прямоугольника обрезки, расположенный выше нижнего края исходного ограничивающего прямоугольника относительно исходной высоты объекта.

angle

number

Угол поворота окна кадрирования вокруг его центра, в радианах. Угол поворота применяется после смещения.

Перекрасить

Эффект перекрашивания, применяемый к изображению.

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

Значение альфа-канала этого цвета в градиентной полосе. По умолчанию — 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 .