Other

AffineTransform

AffineTransform utilise une matrice 3x3 avec une dernière ligne implicite de [ 0 0 1 ] pour transformer les coordonnées sources (x,y) en coordonnées (x', y') en fonction de: 

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

Après la transformation, 

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

Ce message est donc composé de ces six éléments matriciels.

Représentation JSON 
{
  "scaleX": number,
  "scaleY": number,
  "shearX": number,
  "shearY": number,
  "translateX": number,
  "translateY": number,
  "unit": enum (Unit)
}
Champs
scaleX

number

L'élément de mise à l'échelle de la coordonnée X.

scaleY

number

L'élément de mise à l'échelle de la coordonnée Y.

shearX

number

L'élément de coordonnée des coordonnées X.

shearY

number

Élément de coordonnée des coordonnées Y.

translateX

number

L'élément de traduction avec la coordonnée X.

translateY

number

Élément de traduction des coordonnées Y.

unit

enum (Unit)

Unités des éléments de traduction.

Couleur opaque

Valeur de couleur unie thématique.

Représentation 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.
}
Champs
Champ d'union kind. Type de valeur de couleur. kind ne peut être que l'un des éléments suivants:
rgbColor

object (RgbColor)

Couleur RVB opaque.

themeColor

enum (ThemeColorType)

Une couleur de thème opaque.

Couleur RVB

Couleur RVB.

Représentation JSON 
{
  "red": number,
  "green": number,
  "blue": number
}
Champs
red

number

Composant rouge de la couleur, de 0 à 1.

green

number

Composant vert de la couleur, de 0,0 à 1,0.

blue

number

Composant bleu de la couleur, de 0,0 à 1,0.

Type de thème

Types de couleurs du thème.

PageProperties contient un élément ColorScheme qui définit un mappage de ces types de couleurs de thème vers des couleurs concrètes.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Couleur du thème non spécifiée. Cette valeur ne doit pas être utilisée.
DARK1 Représente la première couleur sombre.
LIGHT1 Représente la première couleur de lumière.
DARK2 Représente la deuxième couleur sombre.
LIGHT2 Représente la deuxième couleur de lumière.
ACCENT1 Représente la première couleur d'accentuation.
ACCENT2 Représente la deuxième couleur d'accentuation.
ACCENT3 Représente la troisième couleur d'accentuation.
ACCENT4 Représente la quatrième couleur d'accentuation.
ACCENT5 Représente la cinquième couleur d'accentuation.
ACCENT6 Représente la sixième couleur d'accentuation.
TEXT1 Représente la première couleur de texte.
BACKGROUND1 Représente la première couleur d'arrière-plan.
TEXT2 Représente la deuxième couleur de texte.
BACKGROUND2 Représente la deuxième couleur d'arrière-plan.

état de la propriété

États possibles d'une propriété.

Enums
RENDERED Si l'état d'une propriété est RENDERED, l'élément possède la propriété correspondante lorsqu'il est affiché sur une page. Si l'élément est une forme d'espace réservé, telle que déterminée par le champ placeholder, et qu'il hérite d'une forme d'espace réservé, le champ correspondant peut être non défini, ce qui signifie que la valeur de la propriété est héritée d'un espace réservé parent. Si l'élément n'hérite pas de cette valeur, le champ contiendra la valeur affichée. Il s'agit de la valeur par défaut.
NOT_RENDERED Si l'état d'une propriété est NOT_RENDERED, l'élément ne possède pas la propriété correspondante lorsqu'il est affiché sur une page. Toutefois, il est possible que le champ soit toujours défini pour que les formes enfants en héritent. Pour supprimer une propriété d'un élément affiché, définissez sa propriété state sur NOT_RENDERED.
INHERIT Si l'état d'une propriété est INHERIT, il utilise la valeur du champ propertyState correspondant sur la forme parente. Les éléments qui n'héritent pas n'ont jamais d'état INHERIT.

Remplissage

Remplissage de couleurs unies. La page ou l'élément de page sont entièrement remplis avec la valeur de couleur spécifiée.

Si un champ n'est pas défini, sa valeur peut être héritée d'un espace réservé parent s'il existe.

Représentation JSON 
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
Champs
color

object (OpaqueColor)

Valeur de couleur du remplissage plein.

alpha

number

Fraction de cette color qui doit être appliquée au pixel. En d'autres termes, la couleur finale du pixel est définie par l'équation :

couleur du pixel = alpha * (couleur) + (1,0 - alpha) * (couleur d'arrière-plan)

Cela signifie qu'une valeur de 1,0 correspond à une couleur solide, tandis qu'une valeur de 0,0 correspond à une couleur complètement transparente.

Contour

Contour d'une PageElement.

Si ces champs ne sont pas définis, ils peuvent être hérités d'un espace réservé parent s'il existe. En l'absence de parent, les champs seront définis par défaut sur la valeur utilisée pour les nouveaux éléments de page créés dans l'éditeur Slides, ce qui peut dépendre du type d'élément de page.

Représentation JSON 
{
  "outlineFill": {
    object (OutlineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Champs
outlineFill

object (OutlineFill)

Remplissage du contour.

weight

object (Dimension)

L'épaisseur du contour.

dashStyle

enum (DashStyle)

Style de tiret du contour.

propertyState

enum (PropertyState)

État de la propriété "outline".

La mise à jour du plan d'un élément de page entraîne implicitement la mise à jour de ce champ sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour n'afficher aucun contour sur un élément de page, définissez ce champ sur NOT_RENDERED. Dans ce cas, tous les autres champs du plan définis dans la même requête sont ignorés.

Remplissage

Remplissage du contour.

Représentation JSON 
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
Champs
Champ d'union kind. Type de remplissage du contour. kind ne peut être que l'un des éléments suivants:
solidFill

object (SolidFill)

Remplissage des couleurs unies.

Style de tirets

Types de tirets permettant d'afficher la géométrie linéaire. Ces valeurs sont basées sur le type simple "ST_PresetLineDashVal", décrit à la section 20.1.10.48 de l'article "Formats de fichiers XML Office ouverts – Références et langage de balisage", partie 1 de la quatrième édition ECMA-376.

Enums
DASH_STYLE_UNSPECIFIED Style de tiret non spécifié.
SOLID Ligne continue. Correspond à la valeur "solide" ECMA-376 ST_PresetLineDashVal. Il s'agit du style de tiret par défaut.
DOT Ligne pointillée. Correspond à la valeur "dot" de ECMA-376 ST_PresetLineDashVal.
DASH Ligne en pointillés Correspond à la valeur "dash" de ECMA-376 ST_PresetLineDashVal.
DASH_DOT Des tirets et des points. Correspond à la valeur ECMA-376 ST_PresetLineDashVal "dashDot".
LONG_DASH Ligne avec grands tirets. Correspond à la valeur ECMA-376 ST_PresetLineDashVal "lgDash".
LONG_DASH_DOT Petits tirets et points en alternance. Correspond à la valeur ECMA-376 ST_PresetLineDashVal "lgDashDot".

Ombre

Propriétés d'ombre associées à un élément de page.

Si ces champs ne sont pas définis, ils peuvent être hérités d'un espace réservé parent s'il existe. En l'absence de parent, les champs seront définis par défaut sur la valeur utilisée pour les nouveaux éléments de page créés dans l'éditeur Slides, ce qui peut dépendre du type d'élément de page.

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

enum (Type)

Type d'ombre. Cette propriété est en lecture seule.

transform

object (AffineTransform)

Transformation qui encode la translation, l'échelle et le décalage de l'ombre par rapport à la position.

alignment

enum (RectanglePosition)

Point d'alignement de l'ombre qui définit l'origine de la translation, de l'échelle et de l'inclinaison. Cette propriété est en lecture seule.

blurRadius

object (Dimension)

Rayon du flou. Plus le rayon est grand, plus l'ombre est visible.

color

object (OpaqueColor)

Valeur de la couleur de l'ombre.

alpha

number

Valeur alpha de la couleur de l'ombre, comprise entre 0,0 et 1,0.

rotateWithShape

boolean

Indique si l'ombre doit pivoter selon la forme. Cette propriété est en lecture seule.

propertyState

enum (PropertyState)

État de la propriété Shadow.

La mise à jour de l'ombre sur un élément de la page entraîne implicitement la mise à jour de ce champ sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour n'afficher aucune ombre sur un élément de la page, définissez ce champ sur NOT_RENDERED. Dans ce cas, tous les autres champs d'ombre définis dans la même requête sont ignorés.

Type

Types d'ombres.

Enums
SHADOW_TYPE_UNSPECIFIED Type d'ombre non spécifié.
OUTER Ombre extérieure

Position rectangulaire

Définit les positions de référence dans un rectangle.

Enums
RECTANGLE_POSITION_UNSPECIFIED URL indéterminée.
TOP_LEFT En haut à gauche.
TOP_CENTER Au centre, en haut.
TOP_RIGHT En haut à droite.
LEFT_CENTER Au centre à gauche.
CENTER Au centre.
RIGHT_CENTER Au centre à droite.
BOTTOM_LEFT En bas à gauche.
BOTTOM_CENTER En bas au centre.
BOTTOM_RIGHT En bas à droite.

Alignement du contenu

Types d'alignement de contenu.

Dérivé d'un sous-ensemble des valeurs du type simple "ST_TextAnchoringType" de la section 20.1.10.59 de la section "Formats de fichiers XML Office ouverts – Références et langage de balisage", partie 1 de la quatrième édition ECMA-376.

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Un alignement de contenu non spécifié. L'alignement de contenu est hérité de l'élément parent s'il existe.
CONTENT_ALIGNMENT_UNSUPPORTED Un alignement de contenu non accepté.
TOP Un alignement qui aligne le contenu sur le haut du conteneur Correspond à ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Un alignement qui aligne le contenu au milieu du conteneur. Correspond à ECMA-376 ST_TextAnchoringType 'ctr'.
BOTTOM Alignement qui aligne le contenu sur le bas du conteneur. Correspond à ECMA-376 ST_TextAnchoringType "b".

Espace réservé

Informations d'espace réservé qui identifient une forme d'espace réservé de manière unique.

Représentation JSON 
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
Champs
type

enum (Type)

Type d'espace réservé.

index

integer

Index de l'espace réservé. Si des mêmes types d'espaces réservés sont présents sur la même page, leurs valeurs d'index seront différentes.

parentObjectId

string

ID d'objet de l'espace réservé parent de la forme. Si cette valeur n'est pas définie, la forme de l'espace réservé parent n'existe pas. Elle n'hérite donc pas des propriétés d'une autre forme.

Type

Type de forme de l'espace réservé.

Un grand nombre de ces types d'espaces réservés correspondent aux identifiants d'espace réservé de la norme ECMA-376. Pour en savoir plus sur ces formes, consultez la description du type "ST_PlaceholderType" dans la section 19.7.10 de la section "Formats de fichiers XML Office ouverts – Principes de base et langage de balisage", partie 1 de la quatrième édition ECMA-376.

Enums
NONE Valeur par défaut, ce qui signifie qu'il ne s'agit pas d'un espace réservé.
BODY Le corps de texte.
CHART Graphique.
CLIP_ART Image clipart.
CENTERED_TITLE Centré sur le titre.
DIAGRAM Diagramme
DATE_AND_TIME Date et heure.
FOOTER Texte du pied de page.
HEADER Texte de l'en-tête.
MEDIA Multimédia
OBJECT Tous types de contenus
PICTURE Image.
SLIDE_NUMBER Nombre de diapositives.
SUBTITLE Sous-titres.
TABLE Tableau.
TITLE Titre de la diapositive.
SLIDE_IMAGE Image de la diapositive.

ImageProperties

Propriétés de Image

Représentation JSON 
{
  "cropProperties": {
    object (CropProperties)
  },
  "transparency": number,
  "brightness": number,
  "contrast": number,
  "recolor": {
    object (Recolor)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  }
}
Champs
cropProperties

object (CropProperties)

Propriétés de recadrage de l'image. Si cette règle n'est pas configurée, l'image n'est pas recadrée. Cette propriété est en lecture seule.

transparency

number

Effet de transparence de l'image. La valeur doit correspondre à l'intervalle [0,0, 1,0], où 0 correspond à "aucun effet" et 1 à "totalement transparent". Cette propriété est en lecture seule.

brightness

number

Effet de luminosité de l'image. La valeur doit être comprise dans l'intervalle [-1,0, 1,0], où 0 correspond à "aucun effet". Cette propriété est en lecture seule.

contrast

number

Effet de contraste de l'image. La valeur doit être comprise dans l'intervalle [-1,0, 1,0], où 0 correspond à "aucun effet". Cette propriété est en lecture seule.

recolor

object (Recolor)

Effet de recoloration de l'image. Si cette règle n'est pas configurée, l'image n'est pas recolorée. Cette propriété est en lecture seule.

outline

object (Outline)

Contour de l'image. Si ce paramètre n'est pas défini, l'image n'a pas de contour.

shadow

object (Shadow)

Ombre de l'image. Si ce paramètre n'est pas défini, l'image n'a pas d'ombre. Cette propriété est en lecture seule.

Propriétés du cadrage

Propriétés de recadrage d'un objet contenu dans un conteneur Par exemple, un objet Image.

Les propriétés de recadrage sont représentées par les décalages de quatre bords qui définissent un rectangle de recadrage. Les décalages sont mesurés en pourcentage par rapport aux bords correspondants du rectangle de délimitation d'origine de l'objet vers l'intérieur, par rapport aux dimensions d'origine de l'objet.

  • Si le décalage est dans l'intervalle (0, 1), le bord correspondant du rectangle de recadrage est positionné dans le rectangle de délimitation d'origine de l'objet.
  • Si le décalage est négatif ou supérieur à 1, le bord correspondant du rectangle de recadrage est positionné en dehors du rectangle de délimitation d'origine de l'objet.
  • Si le bord gauche du rectangle de recadrage se trouve à droite de son bord droit, l'objet est inversé horizontalement.
  • Si le bord supérieur du rectangle de recadrage est inférieur à son bord inférieur, l'objet sera inversé verticalement.
  • Si tous les décalages et l'angle de rotation sont définis sur 0, l'objet n'est pas recadré.

Après le recadrage, le contenu du rectangle de recadrage est étiré pour s'adapter à son conteneur.

Représentation JSON 
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
Champs
leftOffset

number

Le décalage indique le bord gauche du rectangle de recadrage situé à droite du bord gauche du rectangle de délimitation d'origine, par rapport à la largeur d'origine de l'objet.

rightOffset

number

Le décalage indique le bord droit du rectangle de recadrage situé à gauche du rectangle de délimitation d'origine par rapport à la largeur d'origine de l'objet.

topOffset

number

Le décalage spécifie le bord supérieur du rectangle de recadrage situé sous le bord supérieur du rectangle d'origine par rapport à la hauteur d'origine de l'objet.

bottomOffset

number

Le décalage spécifie le bord inférieur du rectangle de recadrage situé au-dessus du bord inférieur original du rectangle de délimitation, par rapport à la hauteur d'origine de l'objet.

angle

number

Angle de rotation de la fenêtre de recadrage autour de son centre, en radians. L'angle de rotation est appliqué après le décalage.

Recolorer

Effet de recoloration appliqué à une image.

Représentation JSON 
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
Champs
recolorStops[]

object (ColorStop)

L'effet "Recolor" est représenté par un dégradé, qui est une liste d'arrêts de couleur.

Les couleurs du dégradé remplaceront les couleurs correspondantes à la même position dans la palette de couleurs et s'appliqueront à l'image. Cette propriété est en lecture seule.

name

enum (Name)

Nom de l'effet "Nouvelle couleur".

Le nom est déterminé à partir de la recolorStops en faisant correspondre le dégradé aux couleurs de l'color scheme actuel de la page. Cette propriété est en lecture seule.

Stop

Couleur et position dans une bande de dégradé.

Représentation JSON 
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
Champs
color

object (OpaqueColor)

Couleur de l'arrêt du dégradé.

alpha

number

Valeur alpha de cette couleur dans la bande de dégradé. La valeur par défaut est 1.0, entièrement opaque.

position

number

Position relative de l'arrêt de la couleur dans la bande de dégradé, mesurée en pourcentage. La valeur doit se situer dans l'intervalle [0,0, 1,0].

Nom

Noms des effets de nouvelle couleur.

Enums
NONE Aucun effet de nouvelle coloration. Valeur par défaut.
LIGHT1 Effet de nouvelle couleur qui éclaircit l'image à l'aide de la première couleur disponible sur la page à partir de son jeu de couleurs.
LIGHT2 Effet de nouvelle couleur qui éclaircit l'image à l'aide de la deuxième couleur disponible de la page à partir de son jeu de couleurs.
LIGHT3 Effet de recoloration qui éclaircit l'image en utilisant la troisième couleur disponible de la page dans son jeu de couleurs.
LIGHT4 Effet de recoloration qui éclaircit l'image en utilisant la couleur disponible de la page à partir du jeu de couleurs.
LIGHT5 Effet de nouvelle couleur qui éclaircit l'image en utilisant la cinquième couleur disponible de la palette de couleurs de la page.
LIGHT6 Effet de recoloration qui éclaircit l'image à l'aide de la sixième couleur disponible de la palette de couleurs.
LIGHT7 Effet de recoloration qui éclaircit l'image en utilisant la septième couleur disponible sur la page.
LIGHT8 Effet de recoloration qui éclaircit l'image en utilisant le huitième coloris disponible de la page.
LIGHT9 Effet de recoloration qui éclaircit l'image en utilisant la neuvième couleur disponible de la palette de couleurs.
LIGHT10 Effet de recoloration qui éclaircit l'image en utilisant la dixième couleur disponible sur la palette de couleurs.
DARK1 Effet de recoloration qui assombrit l'image à l'aide de la première couleur disponible de la page.
DARK2 Effet de recoloration qui assombrit l'image à l'aide de la deuxième couleur disponible de la page dans son jeu de couleurs.
DARK3 Effet de recoloration qui assombrit l'image en utilisant la troisième couleur disponible de la page dans son jeu de couleurs.
DARK4 Effet de recoloration qui assombrit l'image en utilisant la quatrième couleur disponible de la page.
DARK5 Effet de recoloration qui assombrit l'image en utilisant la cinquième couleur disponible de la palette de couleurs de la page.
DARK6 Effet de recoloration qui assombrit l'image en utilisant la sixième couleur disponible pour la page à partir de son jeu de couleurs.
DARK7 Effet de recoloration qui assombrit l'image en utilisant la septième couleur disponible de la page.
DARK8 Effet de recoloration qui assombrit l'image en utilisant le huitième coloris disponible de la page.
DARK9 Effet de recoloration qui assombrit l'image en utilisant la neuvième couleur disponible de la page.
DARK10 Effet de recoloration qui assombrit l'image en utilisant la dixième couleur disponible de la palette de couleurs.
GRAYSCALE Effet de recoloration qui recolore l'image en nuances de gris.
NEGATIVE Effet de recoloration qui recolore l'image en nuances de gris.
SEPIA Effet de recoloration qui recolore l'image en utilisant la couleur sépia.
CUSTOM Effet de recoloration personnalisé. Reportez-vous à recolorStops pour connaître le dégradé concret.