Other

AffineTransform

AffineTransform utilizza una matrice 3x3 con un'ultima riga implicita di [ 0 0 1 ] per trasformare le coordinate di origine (x,y) in coordinate di destinazione (x', y') secondo:

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

Dopo la trasformazione,

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

Il messaggio è quindi composto da questi sei elementi matriciali.

Rappresentazione JSON
{
  "scaleX": number,
  "scaleY": number,
  "shearX": number,
  "shearY": number,
  "translateX": number,
  "translateY": number,
  "unit": enum (Unit)
}
Campi
scaleX

number

L'elemento di scala della coordinata X.

scaleY

number

L'elemento di scala della coordinata Y.

shearX

number

L'elemento di taglio coordinata X.

shearY

number

L'elemento di taglio coordinata Y.

translateX

number

L'elemento di traduzione della coordinata X.

translateY

number

L'elemento di traduzione della coordinata Y.

unit

enum (Unit)

Le unità per gli elementi di traduzione.

OpaqueColor

Un valore di colore a tinta unita a tema.

Rappresentazione 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.
}
Campi
Campo unione kind. Il tipo di valore del colore. kind può essere solo uno dei seguenti:
rgbColor

object (RgbColor)

Un colore RGB opaco.

themeColor

enum (ThemeColorType)

Un colore opaco del tema.

RgbColor

Un colore RGB.

Rappresentazione JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Campi
red

number

Il componente rosso del colore, compreso tra 0,0 e 1,0.

green

number

Il componente verde del colore, compreso tra 0,0 e 1,0.

blue

number

Il componente blu del colore, compreso tra 0,0 e 1,0.

ThemeColorType

Tipi di colore del tema.

PageProperties contengono un ColorScheme che definisce una mappatura di questi tipi di colore dei temi a colori concreti.

Enum
THEME_COLOR_TYPE_UNSPECIFIED Colore tema non specificato. Questo valore non deve essere utilizzato.
DARK1 Rappresenta il primo colore scuro.
LIGHT1 Rappresenta il primo colore della luce.
DARK2 Rappresenta il secondo colore scuro.
LIGHT2 Rappresenta il secondo colore della luce.
ACCENT1 Rappresenta il primo colore di contrasto.
ACCENT2 Rappresenta il secondo colore di contrasto.
ACCENT3 Rappresenta il terzo colore di contrasto.
ACCENT4 Rappresenta il quarto colore di contrasto.
ACCENT5 Rappresenta il quinto colore di contrasto.
ACCENT6 Rappresenta il sesto colore di contrasto.
TEXT1 Rappresenta il primo colore del testo.
BACKGROUND1 Rappresenta il primo colore di sfondo.
TEXT2 Rappresenta il secondo colore del testo.
BACKGROUND2 Rappresenta il secondo colore di sfondo.

PropertyState

Gli stati possibili di una proprietà.

Enum
RENDERED Se lo stato di una proprietà è RENDERED, l'elemento ha la proprietà corrispondente quando ne viene eseguito il rendering su una pagina. Se l'elemento è una forma segnaposto come stabilito dal placeholder ed eredita da una forma segnaposto, il campo corrispondente potrebbe non essere impostato, il che significa che il valore della proprietà viene ereditato da un segnaposto principale. Se l'elemento non eredita, il campo conterrà il valore visualizzato. Questo è il valore predefinito.
NOT_RENDERED Se lo stato di una proprietà è NOT_RENDERED, l'elemento non ha la proprietà corrispondente quando viene visualizzato su una pagina. Tuttavia, il campo può essere ancora impostato in modo che possa essere ereditato dalle forme figlio. Per rimuovere una proprietà da un elemento sottoposto a rendering, imposta il valore della relativa proprietà su NOT_RENDERED.
INHERIT Se lo stato di una proprietà è INTRATTENIMENTO, lo stato della proprietà utilizza il valore propertyState campo nella forma principale. Gli elementi che non ereditano non avranno mai uno stato di proprietà INHERIT.

SolidFill

Riempimento a tinta unita. La pagina o l'elemento della pagina viene riempito completamente con il valore del colore specificato.

Se un campo non viene configurato, il relativo valore potrebbe essere ereditato da un segnaposto principale, se esistente.

Rappresentazione JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
Campi
color

object (OpaqueColor)

Il valore del colore del riempimento a tinta unita.

alpha

number

La frazione di questo color da applicare al pixel. In altre parole, il colore finale dei pixel è definito dall'equazione:

colore pixel = alpha * (colore) + (1,0 - alfa) * (colore di sfondo)

Ciò significa che un valore pari a 1,0 corrisponde a un colore in tinta unita, mentre un valore pari a 0,0 a un colore completamente trasparente.

Contorno

Il contorno PageElement.

Se questi campi non sono impostati, potrebbero essere ereditati da un segnaposto principale, se esistente. Se non esiste un elemento principale, i campi verranno impostati in modo predefinito sul valore utilizzato per i nuovi elementi della pagina creati nell'editor di Presentazioni, che potrebbe dipendere dal tipo di elemento della pagina.

Rappresentazione JSON
{
  "outlineFill": {
    object (OutlineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Campi
outlineFill

object (OutlineFill)

Il riempimento del contorno.

weight

object (Dimension)

Lo spessore del contorno.

dashStyle

enum (DashStyle)

Lo stile del trattino del contorno.

propertyState

enum (PropertyState)

Lo stato della proprietà della struttura.

L'aggiornamento della struttura in un elemento della pagina comporterà l'aggiornamento implicito di questo campo in RENDERED, a meno che nella stessa richiesta non venga specificato un altro valore. Per non avere contorni su un elemento della pagina, imposta questo campo su NOT_RENDERED. In questo caso, qualsiasi altro campo struttura impostato nella stessa richiesta verrà ignorato.

OutlineFill

Il riempimento del contorno.

Rappresentazione JSON
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
Campi
Campo unione kind. Il tipo di riempimento dei contorni. kind può essere solo uno dei seguenti:
solidFill

object (SolidFill)

Riempimento a tinta unita.

DashStyle

I tipi di trattini con cui è possibile visualizzare la geometria lineare. Questi valori si basano su "ST_PresetLineDashVal" tipo semplice descritto nella sezione 20.1.10.48 del "Formati di file XML aperti in Office - Concetti fondamentali e riferimento per il linguaggio di markup", parte 1 di ECMA-376 quarta edizione.

Enum
DASH_STYLE_UNSPECIFIED Stile del trattino non specificato.
SOLID Linea continua. Corrisponde al valore "solid" di ECMA-376 ST_PresetLineDashVal. Questo è lo stile predefinito del trattino.
DOT Linea punteggiata. Corrisponde al valore "dot" di ECMA-376 ST_PresetLineDashVal.
DASH Linea tratteggiata. Corrisponde al valore "dash" di ECMA-376 ST_PresetLineDashVal.
DASH_DOT Trattini e punti alternati. Corrisponde al valore "dashDot" di ECMA-376 ST_PresetLineDashVal.
LONG_DASH Linea con trattini grandi. Corrisponde al valore "lgDash" di ECMA-376 ST_PresetLineDashVal.
LONG_DASH_DOT Trattini e punti grandi alternati. Corrisponde al valore "lgDashDot" di ECMA-376 ST_PresetLineDashVal.

Ombre

Le proprietà ombra di un elemento della pagina.

Se questi campi non sono impostati, potrebbero essere ereditati da un segnaposto principale, se esistente. Se non esiste un elemento principale, i campi verranno impostati in modo predefinito sul valore utilizzato per i nuovi elementi della pagina creati nell'editor di Presentazioni, che potrebbe dipendere dal tipo di elemento della pagina.

Rappresentazione JSON
{
  "type": enum (Type),
  "transform": {
    object (AffineTransform)
  },
  "alignment": enum (RectanglePosition),
  "blurRadius": {
    object (Dimension)
  },
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "rotateWithShape": boolean,
  "propertyState": enum (PropertyState)
}
Campi
type

enum (Type)

Il tipo di ombra. Questa proprietà è di sola lettura.

transform

object (AffineTransform)

Trasformazione che codifica la traslazione, la scala e l'asimmetria dell'ombra in relazione alla posizione di allineamento.

alignment

enum (RectanglePosition)

Il punto di allineamento dell'ombra, che imposta l'origine per traslazione, scala e disallineamento dell'ombra. Questa proprietà è di sola lettura.

blurRadius

object (Dimension)

Il raggio della sfocatura dell'ombra. Più ampio è il raggio, più diffusa diventa l'ombra.

color

object (OpaqueColor)

Il valore del colore dell'ombra.

alpha

number

L'alfa del colore dell'ombra, compreso tra 0,0 e 1,0.

rotateWithShape

boolean

Indica se l'ombra deve ruotare con la forma. Questa proprietà è di sola lettura.

propertyState

enum (PropertyState)

Lo stato della proprietà shadow.

L'aggiornamento dell'ombra su un elemento della pagina comporterà l'aggiornamento implicito di questo campo in RENDERED, a meno che nella stessa richiesta non venga specificato un altro valore. Per non avere ombreggiatura su un elemento della pagina, imposta questo campo su NOT_RENDERED. In questo caso, qualsiasi altro campo ombra impostato nella stessa richiesta verrà ignorato.

Tipo

I tipi di ombra.

Enum
SHADOW_TYPE_UNSPECIFIED Tipo di ombra non specificato.
OUTER Ombra esterna.

RectanglePosition

Definisce le posizioni di riferimento in un rettangolo.

Enum
RECTANGLE_POSITION_UNSPECIFIED Non specificato.
TOP_LEFT In alto a sinistra.
TOP_CENTER In alto al centro.
TOP_RIGHT In alto a destra.
LEFT_CENTER A sinistra al centro.
CENTER Al centro.
RIGHT_CENTER Al centro a destra.
BOTTOM_LEFT In basso a sinistra.
BOTTOM_CENTER In basso al centro.
BOTTOM_RIGHT In basso a destra.

ContentAlignment

I tipi di allineamento dei contenuti.

Ricavato da un sottoinsieme dei valori di "ST_TextAnchoringType" tipo semplice nella sezione 20.1.10.59 di "Office Open XML Formati di file - Concetti fondamentali e Riferimento al linguaggio di markup", parte 1 di ECMA-376 quarta edizione.

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Un allineamento dei contenuti non specificato. L'allineamento dei contenuti viene ereditato dall'elemento principale, se esistente.
CONTENT_ALIGNMENT_UNSUPPORTED Un allineamento dei contenuti non supportato.
TOP Allineamento che allinea i contenuti alla parte superiore del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "t".
MIDDLE Allineamento che allinea i contenuti al centro del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Allineamento che allinea i contenuti alla parte inferiore del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "b".

Segnaposto

Le informazioni segnaposto che identificano in modo univoco una forma segnaposto.

Rappresentazione JSON
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
Campi
type

enum (Type)

Il tipo di segnaposto.

index

integer

L'indice del segnaposto. Se nella stessa pagina sono presenti gli stessi tipi di segnaposto, avranno valori di indice diversi.

parentObjectId

string

L'ID oggetto del segnaposto principale di questa forma. Se non viene impostata, la forma del segnaposto principale non esiste, quindi la forma non eredita proprietà da nessun'altra forma.

Tipo

Il tipo di forma segnaposto.

Molti di questi tipi di segnaposto corrispondono agli ID segnaposto dello standard ECMA-376. Per ulteriori informazioni su queste forme, consulta la descrizione di "ST_PlaceholderType" digitare nella sezione 19.7.10 di "Formati di file XML aperti in Office - Concetti fondamentali e riferimento al linguaggio di markup", parte 1 di ECMA-376 quarta edizione.

Enum
NONE Valore predefinito, indica che non si tratta di un segnaposto.
BODY Testo del corpo.
CHART Grafico o grafico.
CLIP_ART Immagine clip art.
CENTERED_TITLE Titolo al centro.
DIAGRAM Diagramma.
DATE_AND_TIME Data e ora.
FOOTER Testo a piè di pagina.
HEADER Testo intestazione.
MEDIA Contenuti multimediali.
OBJECT Qualsiasi tipo di contenuti.
PICTURE Immagine.
SLIDE_NUMBER Numero di una slide.
SUBTITLE Sottotitolo.
TABLE Tabella.
TITLE Titolo slide.
SLIDE_IMAGE Immagine slide.

ImageProperties

Le proprietà del Image.

Rappresentazione JSON
{
  "cropProperties": {
    object (CropProperties)
  },
  "transparency": number,
  "brightness": number,
  "contrast": number,
  "recolor": {
    object (Recolor)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  }
}
Campi
cropProperties

object (CropProperties)

Le proprietà di ritaglio dell'immagine. Se non viene configurato, l'immagine non viene ritagliata. Questa proprietà è di sola lettura.

transparency

number

L'effetto di trasparenza dell'immagine. Il valore deve essere nell'intervallo [0,0, 1,0], dove 0 significa nessun effetto e 1 significa completamente trasparente. Questa proprietà è di sola lettura.

brightness

number

L'effetto di luminosità dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0, 1,0], dove 0 indica nessun effetto. Questa proprietà è di sola lettura.

contrast

number

L'effetto di contrasto dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0, 1,0], dove 0 indica nessun effetto. Questa proprietà è di sola lettura.

recolor

object (Recolor)

L'effetto di ricolorazione dell'immagine. Se non viene configurato, l'immagine non viene ricolorata. Questa proprietà è di sola lettura.

outline

object (Outline)

Il contorno dell'immagine. Se non viene configurato, l'immagine non ha contorni.

shadow

object (Shadow)

L'ombra dell'immagine. Se non viene configurato, l'immagine non ha ombra. Questa proprietà è di sola lettura.

CropProperties

Le proprietà di ritaglio di un oggetto racchiuso in un contenitore. Ad esempio, un Image.

Le proprietà di ritaglio sono rappresentate dagli offset di quattro bordi che definiscono un rettangolo di ritaglio. Gli offset vengono misurati in percentuale dai bordi corrispondenti del rettangolo di delimitazione originale dell'oggetto verso l'interno, rispetto alle dimensioni originali dell'oggetto.

  • Se l'offset è nell'intervallo (0, 1), il bordo corrispondente del rettangolo di ritaglio viene posizionato all'interno del rettangolo di delimitazione originale dell'oggetto.
  • Se l'offset è negativo o maggiore di 1, il bordo corrispondente del rettangolo di ritaglio viene posizionato all'esterno del rettangolo di delimitazione originale dell'oggetto.
  • Se il bordo sinistro del rettangolo di ritaglio si trova sul lato destro del bordo destro, l'oggetto verrà capovolto orizzontalmente.
  • Se il bordo superiore del rettangolo di ritaglio si trova sotto il bordo inferiore, l'oggetto verrà capovolto verticalmente.
  • Se tutti gli offset e l'angolo di rotazione sono pari a 0, l'oggetto non viene ritagliato.

Dopo il ritaglio, i contenuti nel rettangolo di ritaglio verranno allungati per adattarsi al contenitore.

Rappresentazione JSON
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
Campi
leftOffset

number

L'offset specifica il bordo sinistro del rettangolo di ritaglio che si trova a destra del bordo sinistro del rettangolo di delimitazione originale, rispetto alla larghezza originale dell'oggetto.

rightOffset

number

L'offset specifica il bordo destro del rettangolo di ritaglio che si trova a sinistra del bordo destro del rettangolo di delimitazione originale, rispetto alla larghezza originale dell'oggetto.

topOffset

number

L'offset specifica il bordo superiore del rettangolo di ritaglio che si trova sotto il bordo superiore del rettangolo di delimitazione originale, rispetto all'altezza originale dell'oggetto.

bottomOffset

number

L'offset specifica il bordo inferiore del rettangolo di ritaglio che si trova sopra il bordo inferiore del rettangolo di delimitazione originale, rispetto all'altezza originale dell'oggetto.

angle

number

L'angolo di rotazione della finestra ritagliata attorno al centro, espresso in radianti. L'angolo di rotazione viene applicato dopo l'offset.

Recolor

Effetto di ricolorazione applicato a un'immagine.

Rappresentazione JSON
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
Campi
recolorStops[]

object (ColorStop)

L'effetto di ricolorazione è rappresentato da un gradiente, ovvero un elenco di interruzioni di colore.

I colori nel gradiente sostituiranno i colori corrispondenti nella stessa posizione nella tavolozza dei colori e verranno applicati all'immagine. Questa proprietà è di sola lettura.

name

enum (Name)

Il nome dell'effetto di ricolorazione.

Il nome è determinato dal recolorStops abbinando il gradiente ai colori dello stile attuale della pagina color scheme. Questa proprietà è di sola lettura.

ColorStop

Un colore e una posizione in una banda sfumata.

Rappresentazione JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
Campi
color

object (OpaqueColor)

Il colore dell'interruzione del gradiente.

alpha

number

Il valore alfa di questo colore nella banda sfumatura. Il valore predefinito è 1,0, completamente opaco.

position

number

La posizione relativa dell'interruzione di colore nella banda dei gradienti misurata in percentuale. Il valore deve essere compreso nell'intervallo [0,0, 1,0].

Nome

I nomi degli effetti di ricolorazione.

Enum
NONE Nessun effetto di ricolorazione. Il valore predefinito.
LIGHT1 Effetto di ricolorazione che schiarisce l'immagine utilizzando il primo colore disponibile della pagina nella sua combinazione di colori.
LIGHT2 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il secondo colore disponibile della pagina nella sua combinazione di colori.
LIGHT3 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il terzo colore disponibile della pagina nella sua combinazione di colori.
LIGHT4 Effetto di ricolorazione che schiarisce l'immagine utilizzando i quattro colori disponibili della pagina nella sua combinazione di colori.
LIGHT5 Effetto di ricolorazione che schiarisce l'immagine utilizzando il quinto colore disponibile della pagina nella sua combinazione di colori.
LIGHT6 Effetto di ricolorazione che schiarisce l'immagine utilizzando il sesto colore disponibile della pagina nella sua combinazione di colori.
LIGHT7 Effetto di ricolorazione che schiarisce l'immagine utilizzando il settimo colore disponibile della pagina nella sua combinazione di colori.
LIGHT8 Effetto di ricolorazione che schiarisce l'immagine utilizzando l'ottavo colore disponibile della pagina nella sua combinazione di colori.
LIGHT9 Un effetto di ricolorazione che illumina l'immagine utilizzando il nono colore disponibile della pagina nella sua combinazione di colori.
LIGHT10 Un effetto di ricolorazione che illumina l'immagine utilizzando il decimo colore disponibile della pagina nella sua combinazione di colori.
DARK1 Un effetto di ricolorazione che scurisce l'immagine utilizzando il primo colore disponibile della pagina nella sua combinazione di colori.
DARK2 Un effetto di ricolorazione che scurisce l'immagine utilizzando il secondo colore disponibile della pagina dalla sua combinazione di colori.
DARK3 Un effetto di ricolorazione che scurisce l'immagine utilizzando il terzo colore disponibile della pagina dalla sua combinazione di colori.
DARK4 Un effetto di ricolorazione che scurisce l'immagine utilizzando il quarto colore disponibile della pagina dalla sua combinazione di colori.
DARK5 Un effetto di ricolorazione che scurisce l'immagine utilizzando il quinto colore disponibile della pagina dalla sua combinazione di colori.
DARK6 Un effetto di ricolorazione che scurisce l'immagine utilizzando il sesto colore disponibile della pagina nella sua combinazione di colori.
DARK7 Effetto di ricolorazione che scurisce l'immagine utilizzando il settimo colore disponibile della pagina nella sua combinazione di colori.
DARK8 Effetto di ricolorazione che scurisce l'immagine utilizzando l'ottavo colore disponibile della pagina nella sua combinazione di colori.
DARK9 Un effetto di ricolorazione che scurisce l'immagine utilizzando il nono colore disponibile della pagina nella sua combinazione di colori.
DARK10 Un effetto di ricolorazione che scurisce l'immagine utilizzando il decimo colore disponibile della pagina dalla sua combinazione di colori.
GRAYSCALE Un effetto di ricolorazione che ricolora l'immagine in scala di grigi.
NEGATIVE Effetto di ricolorazione che ricolora l'immagine in scala di grigi negativa.
SEPIA Un effetto di ricolorazione che ricolora l'immagine utilizzando il colore seppia.
CUSTOM Effetto di ricolorazione personalizzato. Consulta recolorStops per il gradiente di cemento.