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') in base a:

 [ 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 questi sei elementi della matrice.

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

number

L'elemento di scalabilità della coordinata X.

scaleY

number

L'elemento di scalabilità della coordinata Y.

shearX

number

L'elemento di taglio della coordinata X.

shearY

number

L'elemento di taglio della coordinata Y.

translateX

number

L'elemento di traslazione della coordinata X.

translateY

number

L'elemento di traslazione della coordinata Y.

unit

enum (Unit)

Le unità per gli elementi di traduzione.

OpaqueColor

Un valore di colore a tinta unita modificabile.

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 tipi:
rgbColor

object (RgbColor)

Un colore RGB opaco.

themeColor

enum (ThemeColorType)

Un colore del tema opaco.

RgbColor

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, da 0,0 a 1,0.

ThemeColorType

Tipi di colore del tema.

PageProperties contengono un ColorScheme che definisce una mappatura di questi tipi di colori del tema 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 chiaro.
DARK2 Rappresenta il secondo colore scuro.
LIGHT2 Rappresenta il colore della seconda luce.
ACCENT1 Rappresenta il primo colore intenso.
ACCENT2 Rappresenta il secondo colore intenso.
ACCENT3 Rappresenta il terzo colore intenso.
ACCENT4 Rappresenta il quarto colore intenso.
ACCENT5 Rappresenta il quinto colore intenso.
ACCENT6 Rappresenta il sesto colore intenso.
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

I possibili stati di una proprietà.

Enum
RENDERED Se lo stato di una proprietà è RENDERED, l'elemento ha la proprietà corrispondente quando viene visualizzato il rendering su una pagina. Se l'elemento è una forma segnaposto come determinato dal campo placeholder e 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 sottoposto a rendering. Questo è il valore predefinito.
NOT_RENDERED Se lo stato di una proprietà è NOT_RENDERED, l'elemento non ha la proprietà corrispondente quando viene visualizzato il rendering su una pagina. Tuttavia, il campo potrebbe comunque essere impostato in modo da poter essere ereditato dalle forme secondarie. Per rimuovere una proprietà da un elemento sottoposto a rendering, imposta propertyState su NOT_RENDERED.
INHERIT Se lo stato di una proprietà è INHERIT, lo stato della proprietà utilizza il valore del campo propertyState corrispondente nella forma principale. Gli elementi che non ereditano non avranno mai uno stato della proprietà INHERIT.

SolidFill

Un riempimento a tinta unita. La pagina o l'elemento di pagina è completamente riempito con il valore di colore specificato.

Se un campo non è impostato, 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 color che deve essere applicata al pixel. ovvero il colore finale del pixel è definito dall'equazione:

colore pixel = alpha * (colore) + (1.0 - alpha) * (colore di sfondo)

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

Contorno

Il profilo di un PageElement.

Se questi campi non sono impostati, potrebbero essere ereditati da un segnaposto principale, se esistente. Se non è presente un elemento principale, i campi verranno impostati sul valore predefinito utilizzato per i nuovi elementi della pagina creati nell'editor di Presentazioni, che può variare a seconda del 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 di tratteggio del contorno.

propertyState

enum (PropertyState)

Lo stato della proprietà del contorno.

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

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 del contorno. kind può essere solo uno dei seguenti tipi:
solidFill

object (SolidFill)

Riempimento a tinta unita.

DashStyle

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.49 di "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 di ECMA-376 5th edition.

Enum
DASH_STYLE_UNSPECIFIED Stile del trattino non specificato.
SOLID Linea continua. Corrisponde al valore "solid" di ECMA-376 ST_PresetLineDashVal. Questo è lo stile del tratto predefinito.
DOT Linea tratteggiata. 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 Alternanza di trattini e punti grandi. Corrisponde al valore "lgDashDot" di ECMA-376 ST_PresetLineDashVal.

Ombre

Le proprietà dell'ombra di un elemento della pagina.

Se questi campi non sono impostati, potrebbero essere ereditati da un segnaposto principale, se esistente. Se non è presente un elemento principale, i campi verranno impostati sul valore predefinito utilizzato per i nuovi elementi della pagina creati nell'editor di Presentazioni, che può variare a seconda del 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 scalatura e l'inclinazione dell'ombra rispetto alla posizione di allineamento.

alignment

enum (RectanglePosition)

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

blurRadius

object (Dimension)

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

color

object (OpaqueColor)

Il valore del colore dell'ombra.

alpha

number

Il valore 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à ombra.

L'aggiornamento dell'ombreggiatura di un elemento di pagina aggiornerà implicitamente questo campo a RENDERED, a meno che non venga specificato un altro valore nella stessa richiesta. Per non avere ombreggiature 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.

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 Centro sinistra.
CENTER Al centro.
RIGHT_CENTER Centro 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.

Derivato da un sottoinsieme dei valori del tipo semplice "ST_TextAnchoringType" nella sezione 20.1.10.60 di "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 di ECMA-376 5th edition.

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

Segnaposto

Le informazioni sul 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 è impostato, la forma del segnaposto principale non esiste, quindi la forma non eredita le proprietà da nessun'altra forma.

Tipo

Il tipo di forma di un segnaposto.

Molti di questi tipi di segnaposto corrispondono agli ID segnaposto dello standard ECMA-376. Per ulteriori informazioni, consulta la descrizione del tipo "ST_PlaceholderType" nella sezione 19.7.10 di "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 di ECMA-376 5th edition.

Enum
NONE Valore predefinito, indica 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 del piè di pagina.
HEADER Testo dell'intestazione.
MEDIA Multimediale.
OBJECT Qualsiasi tipo di contenuti.
PICTURE Immagine.
SLIDE_NUMBER Numero di una slide.
SUBTITLE Sottotitolo.
TABLE Tabella.
TITLE Titolo della slide.
SLIDE_IMAGE Immagine slide.

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

transparency

number

L'effetto di trasparenza dell'immagine. Il valore deve essere compreso nell'intervallo [0,0, 1,0], dove 0 indica nessun effetto e 1 indica una trasparenza totale. 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 è impostato, l'immagine non viene ricolorata. Questa proprietà è di sola lettura.

outline

object (Outline)

Il contorno dell'immagine. Se non è impostato, l'immagine non ha contorno.

shadow

object (Shadow)

L'ombra dell'immagine. Se non è impostato, l'immagine non ha ombre. 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 sono misurati in percentuale dai bordi corrispondenti del rettangolo di selezione 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 si trova all'interno del rettangolo di selezione originale dell'oggetto.
  • Se l'offset è negativo o maggiore di 1, il bordo corrispondente del rettangolo di ritaglio viene posizionato al di fuori del rettangolo di selezione originale dell'oggetto.
  • Se il bordo sinistro del rettangolo di ritaglio si trova a destra 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 all'interno del 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 selezione 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 selezione 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 selezione 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 selezione originale, rispetto all'altezza originale dell'oggetto.

angle

number

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

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 punti di colore.

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

name

enum (Name)

Il nome dell'effetto di ricolorazione.

Il nome viene determinato da recolorStops abbinando il gradiente ai colori nel color scheme corrente della pagina. Questa proprietà è di sola lettura.

ColorStop

Un colore e una posizione in una banda di gradiente.

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 del gradiente. Il valore predefinito è 1.0, completamente opaco.

position

number

La posizione relativa dell'interruzione del colore nella banda di 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 schiarisce l'immagine utilizzando il primo colore disponibile della pagina dalla combinazione di colori.
LIGHT2 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il secondo colore disponibile della pagina dalla combinazione di colori.
LIGHT3 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il terzo colore disponibile della pagina dalla combinazione di colori.
LIGHT4 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il quarto colore disponibile della combinazione di colori della pagina.
LIGHT5 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il quinto colore disponibile della pagina dalla combinazione di colori.
LIGHT6 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il sesto colore disponibile della pagina dalla combinazione di colori.
LIGHT7 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il settimo colore disponibile della pagina dalla combinazione di colori.
LIGHT8 Un effetto di ricolorazione che schiarisce l'immagine utilizzando l'ottavo colore disponibile della pagina dalla combinazione di colori.
LIGHT9 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il nono colore disponibile della combinazione di colori della pagina.
LIGHT10 Un effetto di ricolorazione che schiarisce l'immagine utilizzando il decimo colore disponibile della pagina dalla combinazione di colori.
DARK1 Un effetto di ricolorazione che scurisce l'immagine utilizzando il primo colore disponibile della pagina dalla 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 pagina dalla combinazione di colori.
DARK6 Un effetto di ricolorazione che scurisce l'immagine utilizzando il sesto colore disponibile della pagina dalla combinazione di colori.
DARK7 Un effetto di ricolorazione che scurisce l'immagine utilizzando il settimo colore disponibile della pagina dalla 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 pagina dalla 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 negativa.
SEPIA Un effetto di ricolorazione che ricolora l'immagine utilizzando il colore seppia.
CUSTOM Effetto di ricolorazione personalizzato. Consulta recolorStops per la pendenza del cemento.