Other

AffineTransform

AffineTransform usa uma matriz 3x3 com uma última linha implícita de [ 0 0 1 ] para transformar as 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, a mensagem é composta por estes seis elementos matriciais.

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

number

O elemento de dimensionamento de coordenada X.

scaleY

number

O elemento de dimensionamento da coordenada Y.

shearX

number

O elemento de distorção de coordenada X.

shearY

number

O elemento de distorção de coordenada Y.

translateX

number

O elemento de conversão da coordenada X.

translateY

number

O elemento de conversão da coordenada Y.

unit

enum (Unit)

As unidades para elementos de tradução.

OpaqueColor

Um valor de cor sólida com tema.

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 uma das seguintes opções:
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 cor do tema.

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

Enums
THEME_COLOR_TYPE_UNSPECIFIED Cor de tema não especificada. Esse valor não deve ser usado.
DARK1 Representa a primeira cor escura.
LIGHT1 Representa a primeira cor da luz.
DARK2 Representa a segunda cor escura.
LIGHT2 Representa a segunda cor da 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 do plano de fundo.
TEXT2 Representa a segunda cor do texto.
BACKGROUND2 Representa a segunda cor de plano de fundo.

PropertyState

Os possíveis estados de uma propriedade.

Enums
RENDERED Se o estado de uma propriedade for RENDERED, o elemento terá a propriedade correspondente quando for renderizado em uma página. Se o elemento for uma forma de marcador de posição, conforme determinado pelo placeholder campo e for herdado de uma forma de marcador, o campo correspondente poderá não ser definido, o que significa que o valor da propriedade é herdado de um marcador de posição pai. Se o elemento não for herdado, o campo 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 for renderizado em uma página. No entanto, o campo ainda pode ser definido para ser herdado por formas secundárias. Para remover uma propriedade de um elemento renderizado, defina o "PropertyState" como "NOT_RENDERED".
INHERIT Se o estado de uma propriedade for INHERIT, ele usará o valor do estado da propriedade propertyState na forma principal. Elementos não herdados nunca terão um estado de propriedade INHERIT.

SolidFill

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

Se algum campo não for definido, o valor dele poderá ser herdado de um marcador pai, 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 desse valor 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 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 esboço de um PageElement:

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

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 "outline".

Atualizar o contorno de um elemento de página atualiza esse campo implicitamente para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para não ter contorno em um elemento de página, defina esse campo como NOT_RENDERED: Nesse caso, todos os outros campos de estrutura de tópicos 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 do contorno. kind pode ser apenas uma das seguintes opções:
solidFill

object (SolidFill)

Preenchimento com cor sólida.

DashStyle

Os tipos de traços com os quais a geometria linear pode ser renderizada. Esses valores são baseados em "ST_PresetLineDashVal" tipo simples descrito na seção 20.1.10.48 de "Formatos de arquivos XML do Office Open – Fundamentos e referência de linguagem de marcação", parte 1 de ECMA-376 4a edição.

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

Sombra

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

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

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. Esta propriedade é somente leitura.

transform

object (AffineTransform)

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

alignment

enum (RectanglePosition)

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

blurRadius

object (Dimension)

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

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. Esta propriedade é somente leitura.

propertyState

enum (PropertyState)

O estado da propriedade de sombra.

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

Tipo

Os tipos de sombra.

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

RectanglePosition

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

Enums
RECTANGLE_POSITION_UNSPECIFIED Não especificado.
TOP_LEFT Canto superior esquerdo.
TOP_CENTER Parte superior central.
TOP_RIGHT Canto superior direito.
LEFT_CENTER Parte central esquerda.
CENTER Center.
RIGHT_CENTER Lado direito, centralizado.
BOTTOM_LEFT Canto inferior esquerdo.
BOTTOM_CENTER Parte inferior central.
BOTTOM_RIGHT Parte inferior direita.

ContentAlignment

Os tipos de alinhamento de conteúdo.

Derivado de um subconjunto dos valores do "ST_TextAnchoringType" tipo simples na seção 20.1.10.59 de "Formatos de arquivos XML abertos do Office – Fundamentos e referência de linguagem de marcação", parte 1 de ECMA-376 4a edição.

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Um alinhamento de conteúdo não especificado. O alinhamento do conteúdo é herdado do pai, se ele existir.
CONTENT_ALIGNMENT_UNSUPPORTED Alinhamento de conteúdo incompatível.
TOP Um alinhamento que alinha o conteúdo à parte superior do armazenador de conteúdo. Corresponde a ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Um alinhamento que alinha o conteúdo ao meio do detentor de conteúdo. Corresponde a ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Um alinhamento que alinha o conteúdo à parte inferior do armazenador de conteúdo. Corresponde a ECMA-376 ST_TextAnchoringType 'b'.

Placeholder

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

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

enum (Type)

O tipo de marcador de posição.

index

integer

O índice do marcador. Se os mesmos tipos de marcador 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 for definido, a forma de marcador de posição mãe não existirá e, por isso, não herdará propriedades de nenhuma outra forma.

Tipo

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

Muitos desses tipos de marcadores de posição correspondem aos IDs do padrão ECMA-376. Mais informações sobre essas formas podem ser encontradas na descrição de "ST_PlaceholderType" digite na seção 19.7.10 de "Formatos de arquivos XML abertos do Office – Fundamentos e referência de linguagem de marcação", parte 1 de ECMA-376 4a edição.

Enums
NONE Valor padrão, significa que ele não é um marcador.
BODY Texto do corpo.
CHART Gráfico.
CLIP_ART Imagem de clipe de arte.
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 elemento 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 ela não for definida, a imagem não será cortada. Esta propriedade é somente leitura.

transparency

number

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

brightness

number

O efeito de brilho da imagem. O valor deve estar no intervalo [-1,0, 1,0], em que 0 significa que não há efeito. Esta propriedade é somente leitura.

contrast

number

É o efeito de contraste da imagem. O valor deve estar no intervalo [-1,0, 1,0], em que 0 significa que não há efeito. Esta propriedade é somente leitura.

recolor

object (Recolor)

O efeito de nova cor da imagem. Se a política não for definida, a imagem não sofrerá novas cores. Esta propriedade é somente leitura.

outline

object (Outline)

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

shadow

object (Shadow)

A sombra da imagem. Se a política não for definida, a imagem não terá sombras. Esta propriedade é somente leitura.

CropProperties

As propriedades de corte de um objeto incluído em um contêiner. Por exemplo, uma 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 a partir 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 à direita 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 ângulos de rotação forem 0, o objeto não será cortado.

Após o corte, o conteúdo do 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 localizado à 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 localizado à 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 localizada 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 em torno do centro, em radianos. O ângulo de rotação é aplicado após o deslocamento.

Recolor

Efeito de nova cor aplicado em uma imagem.

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

object (ColorStop)

O efeito de nova cor é representado por um gradiente, que é uma lista de paradas de cor.

As cores do gradiente substituem as cores correspondentes na mesma posição na paleta e são aplicadas à imagem. Esta propriedade é somente leitura.

name

enum (Name)

É o nome do efeito de nova cor.

O nome é determinado a partir do recolorStops combinando o gradiente com as cores do plano color scheme. Esta propriedade é somente leitura.

ColorStop

Uma cor e 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 do gradiente.

alpha

number

O valor alfa desta cor na faixa do 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 deve estar no intervalo [0,0, 1,0].

Nome

Os nomes dos efeitos de nova cor.

Enums
NONE Nenhum efeito de nova cor. O valor padrão.
LIGHT1 Um efeito de nova cor que clareia a imagem usando a primeira cor disponível da página a partir do esquema de cores.
LIGHT2 Um efeito de nova cor que clareia a imagem usando a segunda cor disponível no esquema de cores da página.
LIGHT3 Um efeito de nova cor que clareia a imagem usando a terceira cor disponível da página no esquema de cores.
LIGHT4 Um efeito de nova cor que clareia a imagem usando a quarta cor disponível da página no esquema de cores.
LIGHT5 Um efeito de nova cor que clareia a imagem usando a quinta cor disponível na página a partir do esquema de cores.
LIGHT6 Um efeito de nova cor que clareia a imagem usando a sexta cor disponível da página no esquema de cores.
LIGHT7 Um efeito de nova cor que clareia a imagem usando a sétima cor disponível da página a partir do esquema de cores.
LIGHT8 Um efeito de nova cor que clareia a imagem usando a oitava cor disponível da página no esquema de cores.
LIGHT9 Um efeito de nova cor que clareia a imagem usando a nona cor disponível da página no esquema de cores.
LIGHT10 Um efeito de nova cor que clareia a imagem usando a décima cor disponível da página no esquema de cores.
DARK1 Um efeito de nova cor que escurece a imagem usando a primeira cor disponível da página no esquema de cores.
DARK2 Um efeito de nova cor que escurece a imagem usando a segunda cor disponível na página no esquema de cores.
DARK3 Um efeito de nova cor que escurece a imagem usando a terceira cor disponível da página no esquema de cores.
DARK4 Um efeito de nova cor que escurece a imagem usando a quarta cor disponível da página no esquema de cores.
DARK5 Um efeito de nova cor que escurece a imagem usando a quinta cor disponível da página no esquema de cores.
DARK6 Um efeito de nova cor que escurece a imagem usando a sexta cor disponível da página no esquema de cores.
DARK7 Um efeito de nova cor que escurece a imagem usando a sétima cor disponível da página no esquema de cores.
DARK8 Um efeito de nova cor que escurece a imagem usando a oitava cor disponível da página no esquema de cores.
DARK9 Um efeito de nova cor que escurece a imagem usando a nona cor disponível da página no esquema de cores.
DARK10 Um efeito de nova 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 nova cor que muda a cor da imagem para escala de cinza negativa.
SEPIA Um efeito de nova cor que recolore a imagem usando a cor sépia.
CUSTOM Efeito de nova cor personalizado. Consulte recolorStops do gradiente concreto.