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 de destination (x', y') selon la formule suivante :

 [ 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ément de mise à l'échelle de la coordonnée X.

scaleY

number

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

shearX

number

Élément de cisaillement de la coordonnée X.

shearY

number

Élément de cisaillement de la coordonnée Y.

translateX

number

Élément de translation de la coordonnée X.

translateY

number

Élément de translation de la coordonnée Y.

unit

enum (Unit)

Unités pour les éléments de traduction.

OpaqueColor

Valeur de couleur unie pouvant être thématisée.

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 qu'un des éléments suivants :
rgbColor

object (RgbColor)

Couleur RVB opaque.

themeColor

enum (ThemeColorType)

Couleur de thème opaque.

RgbColor

Couleur RVB.

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

number

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

green

number

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

blue

number

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

ThemeColorType

Types de couleurs de thème.

PageProperties contiennent un ColorScheme qui définit un mappage de ces types de couleurs de thème à des couleurs concrètes.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Couleur de 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 claire.
DARK2 Représente la deuxième couleur sombre.
LIGHT2 Représente la deuxième couleur de la 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 du texte.
BACKGROUND1 Représente la première couleur d'arrière-plan.
TEXT2 Représente la deuxième couleur du texte.
BACKGROUND2 Représente la deuxième couleur d'arrière-plan.

PropertyState

Les différents é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é, comme déterminé par le champ placeholder, et qu'il hérite d'une forme d'espace réservé, le champ correspondant peut ne pas être 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, le champ contient 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, le champ peut toujours être défini pour pouvoir être hérité par les formes enfants. Pour supprimer une propriété d'un élément affiché, définissez son propertyState sur NOT_RENDERED.
INHERIT Si l'état d'une propriété est INHERIT, l'état de la propriété utilise la valeur du champ propertyState correspondant dans la forme parente. Les éléments qui n'héritent pas n'auront jamais d'état de propriété INHERIT.

SolidFill

Remplissage de couleur unie. La page ou l'élément de page est entièrement rempli 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 uni.

alpha

number

Fraction de cette color à appliquer au pixel. En d'autres termes, la couleur finale du pixel est définie par l'équation :

couleur de pixel = alpha * (couleur) + (1,0 - alpha) * (couleur de fond)

Cela signifie qu'une valeur de 1,0 correspond à une couleur opaque, tandis qu'une valeur de 0,0 correspond à une couleur totalement transparente.

Contour

Contour d'un PageElement.

Si ces champs ne sont pas définis, ils peuvent être hérités d'un espace réservé parent, s'il existe. S'il n'y a pas de parent, les champs sont définis par défaut sur la valeur utilisée pour les nouveaux éléments de page créés dans l'éditeur Slides, 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)

Épaisseur du contour.

dashStyle

enum (DashStyle)

Style de tiret du contour.

propertyState

enum (PropertyState)

État de la propriété de contour.

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

OutlineFill

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 qu'un des éléments suivants :
solidFill

object (SolidFill)

Remplissage de couleur unie.

DashStyle

Types de tirets avec lesquels la géométrie linéaire peut être affichée. Ces valeurs sont basées sur le type simple "ST_PresetLineDashVal" décrit dans la section 20.1.10.49 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", partie 1 de ECMA-376 5e édition.

Enums
DASH_STYLE_UNSPECIFIED Style de tiret non spécifié.
SOLID Ligne continue. Correspond à la valeur "solid" de ECMA-376 ST_PresetLineDashVal. Il s'agit du style de tiret par défaut.
DOT Ligne en pointillés. 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 Tirets et points en alternance. Correspond à la valeur "dashDot" de ECMA-376 ST_PresetLineDashVal.
LONG_DASH Ligne avec de grands tirets. Correspond à la valeur ECMA-376 ST_PresetLineDashVal "lgDash".
LONG_DASH_DOT Alternance de grands tirets et de points. Correspond à la valeur ECMA-376 ST_PresetLineDashVal "lgDashDot".

Ombre

Propriétés d'ombre d'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. S'il n'y a pas de parent, les champs sont définis par défaut sur la valeur utilisée pour les nouveaux éléments de page créés dans l'éditeur Slides, 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, la mise à l'échelle et l'inclinaison de l'ombre par rapport à la position d'alignement.

alignment

enum (RectanglePosition)

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

blurRadius

object (Dimension)

Rayon du flou de l'ombre. Plus le rayon est grand, plus l'ombre devient diffuse.

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 avec la forme. Cette propriété est en lecture seule.

propertyState

enum (PropertyState)

État de la propriété fantôme.

La mise à jour de l'ombre d'un élément de page mettra implicitement à jour ce champ sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour qu'un élément de page n'ait pas d'ombre, définissez ce champ sur NOT_RENDERED. Dans ce cas, tous les autres champs fantômes définis dans la même requête seront ignorés.

Type

Types d'ombre.

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

RectanglePosition

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

Enums
RECTANGLE_POSITION_UNSPECIFIED Non spécifié.
TOP_LEFT En haut à gauche.
TOP_CENTER En haut au centre.
TOP_RIGHT En haut à droite.
LEFT_CENTER Au centre à gauche.
CENTER et Security Command Center.
RIGHT_CENTER Au centre à droite.
BOTTOM_LEFT En bas à gauche.
BOTTOM_CENTER En bas au centre.
BOTTOM_RIGHT En bas à droite.

ContentAlignment

Types d'alignement de contenu.

Dérivé d'un sous-ensemble des valeurs du type simple "ST_TextAnchoringType" dans la section 20.1.10.60 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", partie 1 de ECMA-376 5e édition.

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

Espace réservé

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

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

enum (Type)

Type de l'espace réservé.

index

integer

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

parentObjectId

string

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

Type

Type de forme d'espace réservé.

De nombreux types d'espaces réservés correspondent à des ID d'espaces réservés de la norme ECMA-376. Pour en savoir plus, consultez la description du type "ST_PlaceholderType" dans la section 19.7.10 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", partie 1 de ECMA-376 5e édition.

Enums
NONE Valeur par défaut, indique qu'il ne s'agit pas d'un espace réservé.
BODY Le corps de texte.
CHART Tableau ou graphique.
CLIP_ART Image clipart.
CENTERED_TITLE Titre centré.
DIAGRAM Diagramme.
DATE_AND_TIME Date et heure.
FOOTER Texte de pied de page.
HEADER Texte de l'en-tête.
MEDIA Multimédia.
OBJECT Tout type de contenu.
PICTURE Image.
SLIDE_NUMBER Numéro d'une diapositive.
SUBTITLE Sous-titre.
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 elle n'est pas définie, 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 être comprise dans l'intervalle [0.0, 1.0], où 0 signifie aucun effet et 1 signifie complètement 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 signifie 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 signifie aucun effet. Cette propriété est en lecture seule.

recolor

object (Recolor)

Effet de recoloration de l'image. Si elle n'est pas définie, l'image n'est pas recolorée. Cette propriété est en lecture seule.

outline

object (Outline)

Contour de l'image. Si elle n'est pas définie, l'image n'a pas de contour.

shadow

object (Shadow)

Ombre de l'image. Si elle n'est pas définie, l'image n'a pas d'ombre. Cette propriété est en lecture seule.

CropProperties

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

Les propriétés de recadrage sont représentées par les décalages des quatre bords qui définissent un rectangle de recadrage. Les décalages sont mesurés en pourcentage à partir des 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 se trouve dans l'intervalle (0, 1), le bord correspondant du rectangle de recadrage est positionné à l'intérieur du 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 sélection 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 en dessous de son bord inférieur, l'objet est 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 spécifie 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 spécifie le bord droit du rectangle de recadrage situé à gauche du bord droit 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 de délimitation 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 du rectangle de délimitation d'origine, 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 de recoloration est représenté par un dégradé, qui est une liste de points 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 de recoloration.

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

ColorStop

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

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

object (OpaqueColor)

Couleur du point d'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 (totalement opaque).

position

number

Position relative du repère de couleur dans la bande de dégradé, exprimée en pourcentage. La valeur doit être comprise dans l'intervalle [0,0, 1,0].

Nom

Noms des effets de recoloration.

Enums
NONE Aucun effet de recoloration. Valeur par défaut.
LIGHT1 Effet de recoloration qui éclaircit l'image en utilisant la première couleur disponible de la page dans son jeu de couleurs.
LIGHT2 Effet de recoloration qui éclaircit l'image à l'aide de la deuxième couleur disponible de la page dans son jeu de couleurs.
LIGHT3 Effet de recoloration qui éclaircit l'image à l'aide de la troisième couleur disponible de la page dans son jeu de couleurs.
LIGHT4 Effet de recoloration qui éclaircit l'image à l'aide de la quatrième couleur disponible de la page dans son jeu de couleurs.
LIGHT5 Effet de recoloration qui éclaircit l'image à l'aide de la cinquième couleur disponible de la page dans son jeu de couleurs.
LIGHT6 Effet de recoloration qui éclaircit l'image à l'aide de la sixième couleur disponible de la page dans son jeu de couleurs.
LIGHT7 Effet de recoloration qui éclaircit l'image à l'aide de la septième couleur disponible de la page dans sa palette de couleurs.
LIGHT8 Effet de recoloration qui éclaircit l'image en utilisant la huitième couleur disponible de la page dans son jeu de couleurs.
LIGHT9 Effet de recoloration qui éclaircit l'image à l'aide de la neuvième couleur disponible de la page dans sa palette de couleurs.
LIGHT10 Un effet de recoloration qui éclaircit l'image en utilisant la dixième couleur disponible de la palette de couleurs de la page.
DARK1 Effet de recoloration qui assombrit l'image à l'aide de la première couleur disponible de la page dans son jeu de couleurs.
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 Un effet de recoloration qui assombrit l'image à l'aide de la troisième couleur disponible de la page dans son jeu de couleurs.
DARK4 Effet de recoloration qui assombrit l'image à l'aide de la quatrième couleur disponible de la page dans son jeu de couleurs.
DARK5 Effet de recoloration qui assombrit l'image à l'aide de la cinquième couleur disponible de la page dans son jeu de couleurs.
DARK6 Un effet de recoloration qui assombrit l'image à l'aide de la sixième couleur disponible de la page dans son jeu de couleurs.
DARK7 Effet de recoloration qui assombrit l'image à l'aide de la septième couleur disponible dans le jeu de couleurs de la page.
DARK8 Un effet de recoloration qui assombrit l'image à l'aide de la huitième couleur disponible de la page dans son jeu de couleurs.
DARK9 Effet de recoloration qui assombrit l'image à l'aide de la neuvième couleur disponible de la page dans son jeu de couleurs.
DARK10 Un effet de recoloration qui assombrit l'image à l'aide de la dixième couleur disponible de la page dans sa 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 négatives.
SEPIA Effet de recoloration qui recolore l'image en sépia.
CUSTOM Effet de nouvelle coloration personnalisée. Reportez-vous à recolorStops pour obtenir le dégradé concret.