Other

AffineTransform

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 por esses seis elementos de 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 de coordenadas X.

scaleY

number

O elemento de escala da coordenada Y.

shearX

number

O elemento de distorção da coordenada X.

shearY

number

O elemento de distorção da coordenada Y.

translateX

number

O elemento de translação de coordenadas X.

translateY

number

O elemento de tradução das coordenadas Y.

unit

enum (Unit)

As unidades para elementos de tradução.

Cor opaca

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.

Cor gb

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.

Tipo de cor do tema

Tipos de cores 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 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 segunda cor clara.
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 do plano de fundo.

Estado da propriedade

Os estados possíveis de uma propriedade.

Enums
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 conforme determinado pelo campo placeholder e herdar de uma forma de marcador, o campo correspondente poderá ser não definido, o que significa que o valor da propriedade é herdado de um marcador de posição pai. Se o elemento não herdar, 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 renderizado em uma página. No entanto, o campo ainda poderá ser definido para que possa ser herdado por formatos derivados. Para remover uma propriedade de um elemento renderizado, defina o propertyState como NOT_RENDERED.
INHERIT Se o estado de uma propriedade for INHERIT, o estado da propriedade usará o valor do campo propertyState correspondente no formato pai. Elementos que não herdam nunca terão um estado de propriedade INHERIT.

Preenchimento sólido

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

Se algum campo não for definido, o valor correspondente poderá ser herdado de um marcador pai, se existir.

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 de color que precisa 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.

Delineado

O contorno de um PageElement.

Se esses campos não estiverem definidos, eles poderão ser herdados de um marcador de posição pai, se houver. Se não houver pai, os campos usarão como padrão o valor usado para novos elementos da página criados no editor do Apresentações, que podem 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 da estrutura de tópicos.

weight

object (Dimension)

A espessura do contorno.

dashStyle

enum (DashStyle)

O estilo de traço do contorno.

propertyState

enum (PropertyState)

O estado da propriedade da estrutura de tópicos.

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

Esboço

O preenchimento da estrutura de tópicos.

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 uma das seguintes opções:
solidFill

object (SolidFill)

Preenchimento de cor sólida.

Traço estilo

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

Enums
DASH_STYLE_UNSPECIFIED Estilo de traço não especificado.
SOLID Linha sólida. Corresponde ao valor ST_PresetLineDashVal ECMA-376 "sólido". Este é 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 "ST" de ECMA-376 ST_PresetLineDashVal.
DASH_DOT Traços e pontos alternados. Corresponde ao valor ST_PresetLineDashVal ECMA-376 "dashDot".
LONG_DASH Linha com traços grandes. Corresponde ao valor ST_PresetLineDashVal do ECMA-376 "lgDash".
LONG_DASH_DOT Traços e pontos grandes alternados. Corresponde ao valor ECMA-376 ST_PresetLineDashVal "lgDashDot".

Sombra

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

Se esses campos não estiverem definidos, eles poderão ser herdados de um marcador de posição pai, se houver. Se não houver pai, os campos usarão como padrão o valor usado para novos elementos da página criados no editor do Apresentações, que podem 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 de 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 da 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 de sombra.

alpha

number

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 sombra.

A atualização da sombra em um elemento de página atualizará implicitamente esse campo para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para que não haja sombra em um elemento de página, defina este campo como NOT_RENDERED. Nesse caso, quaisquer outros campos de 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.

Retângulo

Define as 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 Centro.
RIGHT_CENTER Centro à direita.
BOTTOM_LEFT Canto inferior esquerdo.
BOTTOM_CENTER Parte inferior central.
BOTTOM_RIGHT Parte inferior direita.

Alinhamento de conteúdo

Os tipos de alinhamento de conteúdo.

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

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Um alinhamento de conteúdo não especificado. O alinhamento do conteúdo é herdado do pai, se houver.
CONTENT_ALIGNMENT_UNSUPPORTED Um alinhamento de conteúdo incompatível.
TOP Um alinhamento que alinha o conteúdo à parte superior do detentor 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 detentor de conteúdo. Corresponde a ECMA-376 ST_TextAnchoringType 'b'.

Marcador de posição

As informações do marcador que identificam exclusivamente o formato do marcador.

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

enum (Type)

O tipo do marcador de espaço.

index

integer

O índice do marcador de espaço. 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 pai dessa forma. Se não for definida, a forma do marcador de posição pai não existirá, de modo que a forma não herda propriedades de nenhuma outra forma.

Tipo

É o tipo de uma forma de marcador.

Muitos desses tipos de marcador correspondem a IDs de marcador do padrão ECMA-376. Mais informações sobre esses formatos podem ser encontradas na descrição do tipo "ST_PlaceholderType" na seção 19.7.10 de "Formatos de arquivos do Office Open XML: referência da linguagem de marcação e princípios básicos", parte 1 da 4a edição ECMA-376 (em inglês).

Enums
NONE Valor padrão, significa que ele não é um marcador.
BODY Texto do corpo.
CHART Gráfico ou 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 Legenda.
TABLE Tabela.
TITLE Título do slide.
SLIDE_IMAGE Imagem do slide.

ImageProperties

As propriedades de 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 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 que não há 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 não for definida, a imagem não será colorida novamente. Esta propriedade é somente leitura.

outline

object (Outline)

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

shadow

object (Shadow)

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

CropProperties

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

As propriedades do 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 em direção ao interior, 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 do 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 ângulos de rotação forem 0, o objeto não será cortado.

Após o 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 localizado à direita da borda esquerda original do retângulo delimitador, 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 original do retângulo delimitador, em relação à largura original do objeto.

topOffset

number

O deslocamento especifica a borda superior do retângulo de corte localizado 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 localizado acima da borda inferior original do retângulo delimitador 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 depois do deslocamento.

Recolorir

Efeito de nova cor aplicado a 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 cores.

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

name

enum (Name)

É o nome do efeito de nova cor.

O nome é determinado a partir de recolorStops, por meio da correspondência do gradiente com as cores do color scheme atual da página. 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 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 deve estar no intervalo [0.0, 1.0].

Nome

Os nomes de efeitos de novas cores.

Enums
NONE Nenhum efeito de nova cor. O valor padrão.
LIGHT1 Um efeito de recolorir que clareia a imagem usando a primeira cor disponível no esquema de cores da página.
LIGHT2 Um efeito de recolorir que clareia a imagem usando a segunda cor disponível no esquema de cores da página.
LIGHT3 Um efeito de recolorir que clareia a imagem usando a terceira cor disponível na página do esquema de cores.
LIGHT4 Um efeito de recolorir que clareia a imagem usando a cor disponível na página a partir do esquema de cores.
LIGHT5 Um efeito de nova cor que clareia a imagem usando a quinta cor disponível em seu esquema de cores.
LIGHT6 Um efeito de recolorir que clareia a imagem usando a sexta cor disponível no esquema de cores da página.
LIGHT7 Um efeito de recolorir que clareia a imagem usando a sétima cor disponível da página do esquema de cores.
LIGHT8 Um efeito de recolorir que clareia a imagem usando a oitava cor disponível da página a partir do esquema de cores.
LIGHT9 Um efeito de recolorir que clareia a imagem usando a 9a cor disponível da página do esquema de cores.
LIGHT10 Um efeito de recolorir que clareia a imagem usando a décima cor disponível da página a partir do esquema de cores.
DARK1 Um efeito de recolorir que escurece a imagem usando a primeira cor disponível no esquema de cores da página.
DARK2 Um efeito de recolorir que escurece a imagem usando a segunda cor disponível na página do esquema de cores.
DARK3 Um efeito de recolorir que escurece a imagem usando a terceira cor disponível na página do esquema de cores.
DARK4 Um efeito de recolorir que escurece a imagem usando a quarta cor disponível no esquema de cores da página.
DARK5 Um efeito de recolorir que escurece a imagem usando a quinta cor disponível na página do esquema de cores.
DARK6 Um efeito de recolorir que escurece a imagem usando a sexta cor disponível no esquema de cores da página.
DARK7 Um efeito de recolorir que escurece a imagem usando a sétima cor disponível da página do esquema de cores.
DARK8 Um efeito de recolorir que escurece a imagem usando a oitava cor disponível da página a partir do esquema de cores.
DARK9 Um efeito de recolorir que escurece a imagem usando a 9a cor disponível da página do esquema de cores.
DARK10 Um efeito de recolorir que escurece a imagem usando a décima cor disponível da página do esquema de cores.
GRAYSCALE Um efeito de recolorir que colore a imagem para escala de cinza.
NEGATIVE Um efeito de recolorir que colore a imagem para uma escala de cinza negativa.
SEPIA Um efeito de recolorir que colore a imagem usando a cor sépia.
CUSTOM Efeito de cor personalizado. Consulte recolorStops para ver o gradiente concreto.