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;

Questo messaggio è quindi composto da sei elementi a matrice.

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

number

L'elemento di scala delle coordinate X.

scaleY

number

L'elemento di scalabilità delle coordinate Y.

shearX

number

L'elemento di taglio della coordinata X.

shearY

number

L'elemento di taglio della coordinata Y.

translateX

number

L'elemento di traduzione delle coordinate X.

translateY

number

L'elemento di traduzione delle coordinate Y.

unit

enum (Unit)

Le unità degli elementi di traduzione.

Colore opaco

Un valore di colore a tinta unita temabile.

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 Union 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 del tema opaco.

Colore RGB

Un colore RGB.

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

number

La componente rossa del colore, da 0.0 a 1.0.

green

number

Il componente verde del colore, da 0.0 a 1.0.

blue

number

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

Tipo di tema tema

Tipi di colore del tema.

PageProperties contengono un ColorScheme che definisce una mappatura di questi tipi di colore al tema ai colori del calcestruzzo.

Enum
THEME_COLOR_TYPE_UNSPECIFIED Colore del 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 dell'accento.
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.

StatoProprietà

I possibili stati di una proprietà.

Enum
RENDERED Se lo stato di una proprietà è RENDERED, l'elemento ha la proprietà corrispondente quando viene visualizzato in una pagina. Se l'elemento è una forma segnaposto determinata dal campo placeholder ed eredita da una forma segnaposto, il campo corrispondente potrebbe essere annullato, il che significa che il valore della proprietà è 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 in una pagina. Tuttavia, è possibile che il campo sia ancora impostato in modo da ereditarlo dalle forme secondarie. Per rimuovere una proprietà da un elemento visualizzato, imposta il relativo propertyState su NOT_RENDERED.
INHERIT Se lo stato di una proprietà è INHERIT, lo stato della proprietà utilizza il valore del campo propertyState corrispondente sulla forma principale. Gli elementi che non ereditano non avranno mai uno stato di proprietà INHERIT.

Riempimento solido

Un colore a tinta unita. L'elemento della pagina o della pagina è interamente riempito con il valore di colore specificato.

Se un campo non viene configurato, il relativo valore può 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 solido.

alpha

number

La frazione di questo valore color da applicare al pixel. Ciò significa che il colore finale del pixel è definito dall'equazione:

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

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

Panoramica

Il contorno di un 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 sul valore predefinito per i nuovi elementi di pagina creati nell'editor di Presentazioni, che potrebbe dipendere dal tipo di elemento di pagina.

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

object (OutlineFill)

Il riempimento della struttura.

weight

object (Dimension)

Lo spessore del contorno.

dashStyle

enum (DashStyle)

Lo stile trattino del contorno.

propertyState

enum (PropertyState)

Lo stato della proprietà Outline.

L'aggiornamento della struttura su un elemento di pagina comporterà implicitamente l'aggiornamento di questo campo in RENDERED, a meno che non venga specificato un altro valore nella stessa richiesta. Per non disporre di contorni su un elemento di pagina, imposta questo campo su NOT_RENDERED. In questo caso, tutti gli altri campi del contorno impostati nella stessa richiesta verranno ignorati.

Filo

Il riempimento della struttura.

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 Union kind. Il tipo di riempimento dei contorni. kind può essere solo uno dei seguenti:
solidFill

object (SolidFill)

Riempimento a tinta unita.

Stile trattino

I tipi di trattini con cui è possibile eseguire il rendering della geometria lineare. Questi valori si basano sul tipo semplice "ST_PresetLineDashVal" descritto nella sezione 20.1.10.48 di "Office Open XML File Format - Fundamentals and Markup Language Reference", parte 1 della 4a edizione dell'ECMA-376.

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

Ombra

Le proprietà shadow di un elemento di 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 sul valore predefinito per i nuovi elementi di pagina creati nell'editor di Presentazioni, che potrebbe dipendere dal tipo di elemento di 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'inclinazione dell'ombra, rispetto 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 dell'ombra. Più ampio è il raggio, più diffuso sarà l'ombra.

color

object (OpaqueColor)

Il valore del colore dell'ombra.

alpha

number

L'alfa del colore dell'ombra, da 0,0 a 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 dello shadow su un elemento di pagina aggiornerà implicitamente questo campo in RENDERED, a meno che non venga specificato un altro valore nella stessa richiesta. Per non avere ombra su un elemento della pagina, imposta questo campo su NOT_RENDERED. In questo caso, tutti gli altri campi ombra impostati nella stessa richiesta verranno ignorati.

Tipo

I tipi di ombra.

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

RettangoloPosizione

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 Al centro a sinistra.
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.

Allineamento dei contenuti

I tipi di allineamento dei contenuti.

Derivato da un sottoinsieme dei valori del tipo semplice "ST_TextAnchoringType" nella sezione 20.1.10.59 di "Office Open XML File Format - Fundamentals and Markup Language Reference", parte 1 della 4a edizione di ECMA-376.

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Un allineamento dei contenuti non specificato. L'allineamento dei contenuti viene ereditato dalla risorsa principale, se esistente.
CONTENT_ALIGNMENT_UNSUPPORTED 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 Un allineamento che allinea i contenuti al centro del relativo contenitore. Corrisponde a ECMA-376 ST_TextAnchoringType 'ctr'.
BOTTOM Un allineamento che allinea i contenuti alla parte inferiore del relativo contenitore. Corrisponde a ECMA-376 ST_TextAnchoringType 'b'.

Segnaposto

Le informazioni del 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 gli stessi tipi di segnaposto sono presenti nella stessa pagina, avranno valori di indice diversi.

parentObjectId

string

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

Tipo

Il tipo di forma di un segnaposto.

Molti di questi tipi di segnaposto corrispondono a ID segnaposto dello standard ECMA-376. Maggiori informazioni su queste forme sono disponibili nella descrizione del tipo "ST_PlaceholderType" nella sezione 19.7.10 di "Office File XML XML Format - Fundamentals and Markup Language Reference", parte 1 della 4a edizione di ECMA-376.

Enum
NONE Il valore predefinito significa che non è un segnaposto.
BODY Testo del corpo.
CHART Grafico.
CLIP_ART Immagine clip art.
CENTERED_TITLE Titolo centrato.
DIAGRAM Diagramma.
DATE_AND_TIME Data e ora.
FOOTER Testo a piè di pagina.
HEADER Testo intestazione.
MEDIA Multimedia.
OBJECT Qualsiasi tipo di contenuto.
PICTURE Immagine.
SLIDE_NUMBER Numero di una diapositiva.
SUBTITLE Sottotitolo.
TABLE Tabella.
TITLE Titolo diapositiva.
SLIDE_IMAGE Immagine diapositiva.

ImageProperties

Le proprietà di 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 impostata, l'immagine non viene ritagliata. Questa proprietà è di sola lettura.

transparency

number

L'effetto trasparenza dell'immagine. Il valore deve essere compreso 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 luminosità dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0, 1,0], dove 0 significa 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 significa 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 una struttura.

shadow

object (Shadow)

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

ProprietàRitaglia

Le proprietà di ritaglio di un oggetto racchiuso in un container. 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 è compreso 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 viene capovolto orizzontalmente.
  • Se il bordo superiore del rettangolo di ritaglio si trova al di sotto del bordo inferiore, l'oggetto viene capovolto in verticale.
  • Se tutti i valori di offset e angolo di rotazione sono pari a 0, l'oggetto non viene ritagliato.

Dopo il ritaglio, i contenuti nel rettangolo di ritaglio vengono estesi per adattarli 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 di ritaglio attorno al centro, in radianti. L'angolo di rotazione viene applicato dopo la differenza.

Ricolora

Un 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 valore recolorStops corrispondendo al gradiente con i colori nell'attuale color scheme della pagina. 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 della sfumatura.

alpha

number

Il valore alfa di questo colore nella banda delle sfumature. Il valore predefinito è 1.0, completamente opaco.

position

number

La posizione relativa della fermata del colore nella banda della sfumatura 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 Un effetto di ricolorazione che illumina l'immagine utilizzando il primo colore disponibile della pagina dalla combinazione di colori.
LIGHT2 Un effetto di ricolorazione che illumina l'immagine utilizzando il secondo colore disponibile della pagina dalla combinazione di colori.
LIGHT3 Un effetto di ricolorazione che illumina l'immagine utilizzando il terzo colore disponibile della pagina dalla combinazione di colori.
LIGHT4 Un effetto di ricolorazione che illumina l'immagine utilizzando il colore disponibile della pagina per la combinazione di colori.
LIGHT5 Un effetto di ricolorazione che illumina l'immagine utilizzando il quinto colore disponibile della pagina dalla combinazione di colori.
LIGHT6 Un effetto di ricolorazione che illumina l'immagine utilizzando il sesto colore disponibile della pagina dalla combinazione di colori.
LIGHT7 Un effetto di ricolorazione che illumina l'immagine utilizzando il settimo colore disponibile della pagina con la combinazione di colori.
LIGHT8 Un effetto di ricolorazione che illumina l'immagine utilizzando l'ottavo colore disponibile della pagina dalla combinazione di colori.
LIGHT9 Un effetto di ricolorazione che illumina l'immagine utilizzando il nono colore disponibile della pagina dalla combinazione di colori.
LIGHT10 Un effetto di ricolorazione che illumina l'immagine utilizzando il decimo colore disponibile della combinazione di colori.
DARK1 Un effetto di ricolorazione che scurisce l'immagine utilizzando il primo colore disponibile della pagina con la combinazione di colori.
DARK2 Un effetto di ricolorazione che scurisce l'immagine utilizzando il secondo colore disponibile della pagina dalla combinazione di colori.
DARK3 Un effetto di ricolorazione che scurisce l'immagine utilizzando il terzo colore disponibile della pagina dalla combinazione di colori.
DARK4 Un effetto di ricolorazione che scurisce l'immagine utilizzando il quarto colore disponibile della pagina dalla combinazione di colori.
DARK5 Un effetto di ricolorazione che scurisce l'immagine utilizzando il quinto colore disponibile della combinazione di colori della pagina.
DARK6 Un effetto di ricolorazione che scurisce l'immagine utilizzando il sesto colore disponibile della pagina dalla combinazione di colori.
DARK7 Un effetto di colore che scurisce l'immagine utilizzando il settimo colore della pagina disponibile nella combinazione di colori.
DARK8 Un effetto di ricolorazione che scurisce l'immagine utilizzando l'ottavo colore disponibile della pagina dalla combinazione di colori.
DARK9 Un effetto di ricolorazione che scurisce l'immagine utilizzando il nono colore disponibile della pagina dalla combinazione di colori.
DARK10 Un effetto di ricolorazione che scurisce l'immagine utilizzando il decimo colore disponibile della combinazione di colori.
GRAYSCALE Un effetto di ricolorazione che ricolora l'immagine in scala di grigi.
NEGATIVE Un effetto di ricolorazione che ricolora l'immagine in scala di grigi esclusa.
SEPIA Un effetto di ricolorazione che ricolora l'immagine utilizzando il colore seppia.
CUSTOM Effetto di ricolorazione personalizzato. Fai riferimento a recolorStops per conoscere il gradiente di cemento.