Other

AffineTransform

O AffineTransform usa uma matriz 3x3 com uma última linha implícita de [ 0 0 1 ] para transformar coordenadas de origem (x,y) em coordenadas de destino (x', y') de acordo com: 

 [ x']   [  scaleX  shearX  translateX  ] [ x ]
 [ y'] = [  shearY  scaleY  translateY  ] [ y ]
 [ 1 ]   [      0       0         1     ] [ 1 ]

Após a transformação, 

 x' = scaleX * x + shearX * y + translateX;
 y' = scaleY * y + shearY * x + translateY;

Portanto, essa mensagem é composta desses seis elementos da matriz.

Representação JSON 
{
  "scaleX": number,
  "scaleY": number,
  "shearX": number,
  "shearY": number,
  "translateX": number,
  "translateY": number,
  "unit": enum (Unit)
}
Campos
scaleX

number

O elemento de escalonamento da coordenada X.

scaleY

number

O elemento de escalonamento da coordenada Y.

shearX

number

O elemento de corte da coordenada X.

shearY

number

O elemento de corte da coordenada Y.

translateX

number

O elemento de tradução de coordenadas X.

translateY

number

O elemento de translação da coordenada Y.

unit

enum (Unit)

As unidades para traduzir elementos.

OpaqueColor

Um valor de cor sólida que pode ser tematizado.

Representação 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.
}
Campos
Campo de união kind. O tipo de valor de cor. kind pode ser apenas um dos seguintes:
rgbColor

object (RgbColor)

Uma cor RGB opaca.

themeColor

enum (ThemeColorType)

Uma cor de tema opaca.

RgbColor

Uma cor RGB.

Representação JSON 
{
  "red": number,
  "green": number,
  "blue": number
}
Campos
red

number

O componente vermelho da cor, de 0,0 a 1,0.

green

number

O componente verde da cor, de 0,0 a 1,0.

blue

number

O componente azul da cor, de 0,0 a 1,0.

ThemeColorType

Tipos de cores do tema.

PageProperties contém um ColorScheme que define um mapeamento desses tipos de cores de tema para cores concretas.

Tipos enumerados
THEME_COLOR_TYPE_UNSPECIFIED Cor do tema não especificada. Esse valor não deve ser usado.
DARK1 Representa a primeira cor escura.
LIGHT1 Representa a primeira cor clara.
DARK2 Representa a segunda cor escura.
LIGHT2 Representa a cor da segunda luz.
ACCENT1 Representa a primeira cor de destaque.
ACCENT2 Representa a segunda cor de destaque.
ACCENT3 Representa a terceira cor de destaque.
ACCENT4 Representa a quarta cor de destaque.
ACCENT5 Representa a quinta cor de destaque.
ACCENT6 Representa a sexta cor de destaque.
TEXT1 Representa a primeira cor do texto.
BACKGROUND1 Representa a primeira cor de plano de fundo.
TEXT2 Representa a segunda cor do texto.
BACKGROUND2 Representa a segunda cor de plano de fundo.

PropertyState

Os estados possíveis de uma propriedade.

Tipos enumerados
RENDERED Se o estado de uma propriedade for RENDERED, o elemento terá a propriedade correspondente quando renderizado em uma página. Se o elemento for uma forma de marcador de posição, conforme determinado pelo campo placeholder, e herdar de uma forma de marcador de posição, o campo correspondente poderá ser desdefinido, o que significa que o valor da propriedade é herdado de um marcador de posição pai. Se o elemento não herdar, o campo vai conter o valor renderizado. Esse é o valor padrão.
NOT_RENDERED Se o estado de uma propriedade for NOT_RENDERED, o elemento não terá a propriedade correspondente quando renderizado em uma página. No entanto, o campo ainda pode ser definido para que possa ser herdado por formas secundárias. Para remover uma propriedade de um elemento renderizado, defina propertyState como NOT_RENDERED.
INHERIT Se o estado de uma propriedade for INHERIT, ele usará o valor do campo propertyState correspondente na forma principal. Elementos que não herdam nunca terão um estado de propriedade INHERIT.

SolidFill

Um preenchimento de cor sólida. A página ou o elemento de página é preenchido totalmente com o valor de cor especificado.

Se algum campo não estiver definido, o valor dele poderá ser herdado de um marcador de posição principal, se houver.

Representação JSON 
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
Campos
color

object (OpaqueColor)

O valor da cor do preenchimento sólido.

alpha

number

A fração deste color que deve ser aplicada ao pixel. Ou seja, a cor final do pixel é definida pela equação:

cor do pixel = alfa * (cor) + (1,0 - alfa) * (cor do plano de fundo)

Isto significa que um valor de 1,0 corresponde a uma cor sólida, enquanto um valor de 0,0 corresponde a uma cor completamente transparente.

Contorno

O contorno de um PageElement.

Se esses campos não estiverem definidos, eles poderão ser herdados de um marcador de posição principal, se houver. Se não houver um elemento pai, os campos vão usar o valor padrão dos novos elementos de página criados no editor de Apresentações, que pode depender do tipo de elemento.

Representação JSON 
{
  "outlineFill": {
    object (OutlineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Campos
outlineFill

object (OutlineFill)

O preenchimento do contorno.

weight

object (Dimension)

A espessura do contorno.

dashStyle

enum (DashStyle)

O estilo de traço do contorno.

propertyState

enum (PropertyState)

O estado da propriedade de contorno.

Atualizar o contorno em um elemento de página vai atualizar implicitamente esse campo para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para não ter um contorno em um elemento da página, defina esse campo como NOT_RENDERED. Nesse caso, todos os outros campos de contorno definidos na mesma solicitação serão ignorados.

OutlineFill

O preenchimento do contorno.

Representação JSON 
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
Campos
Campo de união kind. O tipo de preenchimento de contorno. kind pode ser apenas um dos seguintes:
solidFill

object (SolidFill)

Preenchimento com cor sólida.

DashStyle

Os tipos de traços com que a geometria linear pode ser renderizada. Esses valores se baseiam no tipo simples "ST_PresetLineDashVal" descrito na seção 20.1.10.49 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 da 5ª edição da ECMA-376.

Tipos enumerados
DASH_STYLE_UNSPECIFIED Estilo de traço não especificado.
SOLID Linha sólida. Corresponde ao valor "solid" de ST_PresetLineDashVal da ECMA-376. Esse é o estilo de traço padrão.
DOT Linha pontilhada. Corresponde ao valor "dot" de ECMA-376 ST_PresetLineDashVal.
DASH Linha tracejada. Corresponde ao valor "dash" de ST_PresetLineDashVal da ECMA-376.
DASH_DOT Alternando traços e pontos. Corresponde ao valor "dashDot" de ECMA-376 ST_PresetLineDashVal.
LONG_DASH Linha com traços grandes. Corresponde ao valor "lgDash" de ST_PresetLineDashVal da ECMA-376.
LONG_DASH_DOT Alternando traços e pontos grandes. Corresponde ao valor "lgDashDot" de ECMA-376 ST_PresetLineDashVal.

Sombra

As propriedades de sombra de um elemento da página.

Se esses campos não estiverem definidos, eles poderão ser herdados de um marcador de posição principal, se houver. Se não houver um elemento pai, os campos vão usar o valor padrão dos novos elementos de página criados no editor de Apresentações, que pode depender do tipo de elemento.

Representação JSON 
{
  "type": enum (Type),
  "transform": {
    object (AffineTransform)
  },
  "alignment": enum (RectanglePosition),
  "blurRadius": {
    object (Dimension)
  },
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "rotateWithShape": boolean,
  "propertyState": enum (PropertyState)
}
Campos
type

enum (Type)

O tipo da sombra. Essa propriedade é somente leitura.

transform

object (AffineTransform)

Transformação que codifica a translação, o escalonamento e o desalinhamento da sombra em relação à posição de alinhamento.

alignment

enum (RectanglePosition)

O ponto de alinhamento da sombra, que define a origem para tradução, escala e distorção da sombra. Essa propriedade é somente leitura.

blurRadius

object (Dimension)

É o raio do desfoque da sombra. Quanto maior o raio, mais difusa a sombra fica.

color

object (OpaqueColor)

O valor da cor da sombra.

alpha

number

O alfa da cor da sombra, de 0,0 a 1,0.

rotateWithShape

boolean

Indica se a sombra deve girar com a forma. Essa propriedade é somente leitura.

propertyState

enum (PropertyState)

O estado da propriedade shadow.

Atualizar a sombra em um elemento da página vai atualizar implicitamente esse campo para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para não ter sombra em um elemento da página, defina esse campo como NOT_RENDERED. Nesse caso, todos os outros campos de sombra definidos na mesma solicitação serão ignorados.

Tipo

Os tipos de sombra.

Tipos enumerados
SHADOW_TYPE_UNSPECIFIED Tipo de sombra não especificado.
OUTER Sombra externa.

RectanglePosition

Define posições de referência em um retângulo.

Tipos enumerados
RECTANGLE_POSITION_UNSPECIFIED Não especificado.
TOP_LEFT Canto superior esquerdo.
TOP_CENTER Centralizado na parte de cima.
TOP_RIGHT Canto superior direito.
LEFT_CENTER Centralizado à esquerda.
CENTER usando o Network Connectivity Center.
RIGHT_CENTER Centralizado à direita.
BOTTOM_LEFT Canto inferior esquerdo.
BOTTOM_CENTER Parte central inferior.
BOTTOM_RIGHT Parte inferior direita.

ContentAlignment

Os tipos de alinhamento de conteúdo.

Derivado de um subconjunto dos valores do tipo simples "ST_TextAnchoringType" na seção 20.1.10.60 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 da 5ª edição da ECMA-376.

Tipos enumerados
CONTENT_ALIGNMENT_UNSPECIFIED Um alinhamento de conteúdo não especificado. O alinhamento de conteúdo é herdado do elemento pai, se ele existir.
CONTENT_ALIGNMENT_UNSUPPORTED Um alinhamento de conteúdo não compatível.
TOP Um alinhamento que alinha o conteúdo à parte de cima do contêiner. Corresponde a ECMA-376 ST_TextAnchoringType "t".
MIDDLE Um alinhamento que alinha o conteúdo ao meio do contêiner. Corresponde a ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Um alinhamento que alinha o conteúdo à parte de baixo do contêiner. Corresponde a ECMA-376 ST_TextAnchoringType "b".

Placeholder

As informações do marcador de posição que identificam de forma exclusiva uma forma de marcador de posição.

Representação JSON 
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
Campos
type

enum (Type)

O tipo do placeholder.

index

integer

O índice do marcador de posição. Se os mesmos tipos de marcador de posição estiverem presentes na mesma página, eles terão valores de índice diferentes.

parentObjectId

string

O ID do objeto do marcador de posição principal desta forma. Se não estiver definido, a forma do marcador de posição principal não vai existir, então ela não vai herdar propriedades de nenhuma outra forma.

Tipo

O tipo de uma forma de marcador de posição.

Muitos desses tipos de marcador de posição correspondem a IDs de marcador de posição do padrão ECMA-376. Para mais informações, consulte a descrição do tipo "ST_PlaceholderType" na seção 19.7.10 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 da 5ª edição da ECMA-376 (em inglês).

Tipos enumerados
NONE Valor padrão, significa que não é um marcador de posição.
BODY Texto do corpo.
CHART Gráfico.
CLIP_ART Imagem de clip art.
CENTERED_TITLE Título centralizado.
DIAGRAM Diagrama.
DATE_AND_TIME Data e hora.
FOOTER Texto do rodapé.
HEADER Texto do cabeçalho.
MEDIA Multimídia.
OBJECT Qualquer tipo de conteúdo.
PICTURE Imagem.
SLIDE_NUMBER Número de um slide.
SUBTITLE Subtítulo.
TABLE Tabela.
TITLE Título do slide.
SLIDE_IMAGE Imagem do slide.

ImageProperties

As propriedades do Image.

Representação JSON 
{
  "cropProperties": {
    object (CropProperties)
  },
  "transparency": number,
  "brightness": number,
  "contrast": number,
  "recolor": {
    object (Recolor)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  }
}
Campos
cropProperties

object (CropProperties)

As propriedades de corte da imagem. Se não estiver definido, a imagem não será cortada. Essa propriedade é somente leitura.

transparency

number

O efeito de transparência da imagem. O valor precisa estar no intervalo [0,0, 1,0], em que 0 significa nenhum efeito e 1 significa completamente transparente. Essa propriedade é somente leitura.

brightness

number

O efeito de brilho da imagem. O valor precisa estar no intervalo [-1,0, 1,0], em que 0 significa nenhum efeito. Essa propriedade é somente leitura.

contrast

number

O efeito de contraste da imagem. O valor precisa estar no intervalo [-1,0, 1,0], em que 0 significa nenhum efeito. Essa propriedade é somente leitura.

recolor

object (Recolor)

O efeito de nova cor da imagem. Se não for definido, a imagem não será recolorida. Essa propriedade é somente leitura.

outline

object (Outline)

O contorno da imagem. Se não for definido, a imagem não terá contorno.

shadow

object (Shadow)

A sombra da imagem. Se não for definido, a imagem não terá sombra. Essa propriedade é somente leitura.

CropProperties

As propriedades de corte de um objeto contido em um contêiner. Por exemplo, um Image.

As propriedades de corte são representadas pelos deslocamentos de quatro bordas que definem um retângulo de corte. Os deslocamentos são medidos em porcentagem das bordas correspondentes do retângulo delimitador original do objeto para dentro, em relação às dimensões originais do objeto.

  • Se o deslocamento estiver no intervalo (0, 1), a borda correspondente do retângulo de corte será posicionada dentro do retângulo delimitador original do objeto.
  • Se o deslocamento for negativo ou maior que 1, a borda correspondente do retângulo de corte será posicionada fora do retângulo delimitador original do objeto.
  • Se a borda esquerda do retângulo de corte estiver no lado direito da borda direita, o objeto será invertido horizontalmente.
  • Se a borda superior do retângulo de corte estiver abaixo da borda inferior, o objeto será invertido verticalmente.
  • Se todos os deslocamentos e o ângulo de rotação forem 0, o objeto não será cortado.

Depois do corte, o conteúdo no retângulo de corte será esticado para caber no contêiner.

Representação JSON 
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
Campos
leftOffset

number

O deslocamento especifica a borda esquerda do retângulo de corte localizada à direita da borda esquerda do retângulo delimitador original, em relação à largura original do objeto.

rightOffset

number

O deslocamento especifica a borda direita do retângulo de corte que está localizada à esquerda da borda direita do retângulo delimitador original, em relação à largura original do objeto.

topOffset

number

O deslocamento especifica a borda superior do retângulo de corte, que fica abaixo da borda superior do retângulo delimitador original, em relação à altura original do objeto.

bottomOffset

number

O deslocamento especifica a borda inferior do retângulo de corte localizada acima da borda inferior do retângulo delimitador original, em relação à altura original do objeto.

angle

number

O ângulo de rotação da janela de corte ao redor do centro, em radianos. O ângulo de rotação é aplicado após o deslocamento.

Recolorir

Um efeito de mudança de cor aplicado a uma imagem.

Representação JSON 
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
Campos
recolorStops[]

object (ColorStop)

O efeito de recolorização é representado por um gradiente, que é uma lista de paradas de cor.

As cores do gradiente vão substituir as cores correspondentes na mesma posição da paleta de cores e serão aplicadas à imagem. Essa propriedade é somente leitura.

name

enum (Name)

O nome do efeito de recolorização.

O nome é determinado pelo recolorStops ao corresponder o gradiente às cores no color scheme atual da página. Essa propriedade é somente leitura.

ColorStop

Uma cor e uma posição em uma faixa de gradiente.

Representação JSON 
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
Campos
color

object (OpaqueColor)

A cor da parada de gradiente.

alpha

number

O valor alfa dessa cor na faixa de gradiente. O padrão é 1,0, totalmente opaco.

position

number

A posição relativa da parada de cor na faixa de gradiente, medida em porcentagem. O valor precisa estar no intervalo [0,0, 1,0].

Nome

Os nomes dos efeitos de recolorização.

Tipos enumerados
NONE Nenhum efeito de mudança de cor. O valor padrão.
LIGHT1 Um efeito de recolorização que clareia a imagem usando a primeira cor disponível da página no esquema de cores.
LIGHT2 Um efeito de mudança de cor que clareia a imagem usando a segunda cor disponível da página no esquema de cores.
LIGHT3 Um efeito de mudança de cor que clareia a imagem usando a terceira cor disponível da página no esquema de cores.
LIGHT4 Um efeito de mudança de cor que clareia a imagem usando a quarta cor disponível da página no esquema de cores.
LIGHT5 Um efeito de mudança de cor que clareia a imagem usando a quinta cor disponível da página no esquema de cores.
LIGHT6 Um efeito de nova coloração que clareia a imagem usando a sexta cor disponível da página no esquema de cores.
LIGHT7 Um efeito de mudança de cor que clareia a imagem usando a sétima cor disponível da página no esquema de cores.
LIGHT8 Um efeito de mudança de cor que clareia a imagem usando a oitava cor disponível da página no esquema de cores.
LIGHT9 Um efeito de mudança de cor que clareia a imagem usando a nona cor disponível da página no esquema de cores.
LIGHT10 Um efeito de mudança de cor que clareia a imagem usando a décima cor disponível da página no esquema de cores.
DARK1 Um efeito de mudança de cor que escurece a imagem usando a primeira cor disponível da página no esquema de cores.
DARK2 Um efeito de mudança de cor que escurece a imagem usando a segunda cor disponível da página no esquema de cores.
DARK3 Um efeito de mudança de cor que escurece a imagem usando a terceira cor disponível da página no esquema de cores.
DARK4 Um efeito de nova coloração que escurece a imagem usando a quarta cor disponível da página no esquema de cores.
DARK5 Um efeito de nova coloração que escurece a imagem usando a quinta cor disponível da página no esquema de cores.
DARK6 Um efeito de nova coloração que escurece a imagem usando a sexta cor disponível da página no esquema de cores.
DARK7 Um efeito de mudança de cor que escurece a imagem usando a sétima cor disponível da página no esquema de cores.
DARK8 Um efeito de mudança de cor que escurece a imagem usando a oitava cor disponível da página no esquema de cores.
DARK9 Um efeito de mudança de cor que escurece a imagem usando a nona cor disponível da página no esquema de cores.
DARK10 Um efeito de mudança de cor que escurece a imagem usando a décima cor disponível da página no esquema de cores.
GRAYSCALE Um efeito que muda a cor da imagem para escala de cinza.
NEGATIVE Um efeito de recoloração que muda a cor da imagem para escala de cinza negativa.
SEPIA Um efeito que muda a cor da imagem usando o tom sépia.
CUSTOM Efeito de nova cor personalizada. Consulte recolorStops para o gradiente concreto.