Other

AffineTransform

AffineTransform utilise une matrice 3x3 avec une dernière ligne implicite de [ 0 0 1 ] pour transformer les coordonnées source (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 de matrice.

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 des coordonnées 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 de translation des éléments.

OpaqueColor

Valeur de couleur unie personnalisable.

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, compris entre 0,0 et 1,0.

green

number

Composant vert de la couleur, compris entre 0,0 et 1,0.

blue

number

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

ThemeColorType

Types de couleurs du thème.

PageProperties contiennent un ColorScheme qui définit une mise en correspondance de ces types de couleurs de thème avec 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 l'éclairage.
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.

PropertyState

États possibles d'un établissement.

Enums
RENDERED Si l'état d'une propriété est "AFFICHÉ", 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 dispose pas de la propriété correspondante lorsqu'il est affiché sur une page. Toutefois, le champ peut toujours être défini pour qu'il puisse ê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 sur la forme parente. Les éléments qui n'héritent pas n'auront jamais d'état de propriété INHERIT.

SolidFill

Un remplissage de couleur unie. La page ou l'élément de page est entièrement remplie de 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, le cas échéant.

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

object (OpaqueColor)

Valeur de couleur du remplissage uni.

alpha

number

Fraction de cet élément 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 solide, tandis qu'une valeur de 0,0 correspond à une couleur complètement 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, le cas échéant. S'il n'y a pas de parent, la valeur utilisée pour les nouveaux éléments de page créés dans l'éditeur de diapositives est utilisée par défaut dans les champs, 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)

Couleur de remplissage du contour.

weight

object (Dimension)

Épaisseur du contour.

dashStyle

enum (DashStyle)

Style de trait du contour.

propertyState

enum (PropertyState)

État de la propriété de contour.

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

OutlineFill

Couleur de 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 traits 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 la 5e édition de la norme ECMA-376.

Enums
DASH_STYLE_UNSPECIFIED Style de tiret non spécifié.
SOLID Ligne continue. Correspond à la valeur "solid" de ST_PresetLineDashVal dans la norme ECMA-376. Il s'agit du style de trait par défaut.
DOT Ligne en pointillés. Correspond à la valeur "point" de ST_PresetLineDashVal ECMA-376.
DASH Ligne en pointillés. Correspond à la valeur "dash" de ST_PresetLineDashVal dans la norme ECMA-376.
DASH_DOT Des tirets et des points alternés. Correspond à la valeur "dashDot" de ST_PresetLineDashVal dans la norme ECMA-376.
LONG_DASH Ligne avec des traits longs. Correspond à la valeur ST_PresetLineDashVal ECMA-376 "lgDash".
LONG_DASH_DOT Des traits et des points de grande taille alternés. Correspond à la valeur ST_PresetLineDashVal ECMA-376 "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, le cas échéant. S'il n'y a pas de parent, la valeur utilisée pour les nouveaux éléments de page créés dans l'éditeur de diapositives est utilisée par défaut dans les champs, 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 d'alignement.

alignment

enum (RectanglePosition)

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

blurRadius

object (Dimension)

Rayon du flou de l'ombre. Plus le rayon est élevé, plus l'ombre est diffuse.

color

object (OpaqueColor)

Valeur de la couleur de l'ombre.

alpha

number

Alpha de la couleur de l'ombre, compris 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é d'ombre.

La mise à jour de l'ombre d'un élément de page remplace implicitement ce champ par RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour qu'aucune ombre ne soit appliquée à un élément de 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 seront ignorés.

Type

Types d'ombres.

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

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 Centre gauche.
CENTER et Security Command Center.
RIGHT_CENTER Au milieu, à droite.
BOTTOM_LEFT En bas à gauche.
BOTTOM_CENTER En bas au centre.
BOTTOM_RIGHT En bas à droite.

ContentAlignment

Types d'alignement du contenu.

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

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Alignement de contenu non spécifié. L'alignement du contenu est hérité du parent, le cas échéant.
CONTENT_ALIGNMENT_UNSUPPORTED Alignement de contenu non accepté.
TOP Alignement qui place le contenu en haut du conteneur de contenu. Correspond à ECMA-376 ST_TextAnchoringType "t".
MIDDLE Alignement qui place le contenu au milieu du conteneur de contenu. Correspond à ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Alignement qui place 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'espaces réservés sont présents sur la même page, ils auront des valeurs d'indice différentes.

parentObjectId

string

ID de l'objet de l'espace réservé parent de cette forme. Si ce paramètre n'est pas défini, la forme d'espace réservé parent n'existe pas. Par conséquent, la forme n'hérite pas des propriétés d'une autre forme.

Type

Type de forme d'espace réservé.

De nombreux types d'espaces réservés correspondent aux 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 la 5e édition de la norme ECMA-376.

Enums
NONE Valeur par défaut, indique qu'il ne s'agit pas d'un espace réservé.
BODY Le corps de texte.
CHART Graphique
CLIP_ART Image clipart.
CENTERED_TITLE Titre centré.
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 Tout type de contenu.
PICTURE Image.
SLIDE_NUMBER Numéro de la 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 ce champ n'est pas défini, 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 qu'aucun effet n'est appliqué. 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 qu'aucun effet n'est appliqué. Cette propriété est en lecture seule.

recolor

object (Recolor)

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

outline

object (Outline)

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

shadow

object (Shadow)

Ombre de l'image. Si ce champ n'est pas défini, 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 de 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 situe 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 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 se trouve 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é.

Une fois le recadrage effectué, 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.

Nouvelle coloration

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 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 de recoloration.

Le nom est déterminé à partir de recolorStops en faisant correspondre le dégradé aux couleurs de l'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 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, soit une opacité totale.

position

number

Position relative de la couleur dans la bande de dégradé, mesuré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 à l'aide de la première couleur disponible dans le jeu de couleurs de la page.
LIGHT2 Effet de recoloration qui éclaircit l'image à l'aide de la deuxième couleur disponible dans le jeu de couleurs de la page.
LIGHT3 Effet de recoloration qui éclaircit l'image à l'aide de la troisième couleur disponible dans le jeu de couleurs de la page.
LIGHT4 Effet de recoloration qui éclaircit l'image à l'aide de la quatrième couleur disponible dans le jeu de couleurs de la page.
LIGHT5 Effet de recoloration qui éclaircit l'image à l'aide de la cinquième couleur disponible dans le jeu de couleurs de la page.
LIGHT6 Effet de recoloration qui éclaircit l'image à l'aide de la sixième couleur disponible dans le jeu de couleurs de la page.
LIGHT7 Effet de recoloration qui éclaircit l'image à l'aide de la septième couleur disponible dans le jeu de couleurs de la page.
LIGHT8 Effet de recoloration qui éclaircit l'image à l'aide de la huitième couleur disponible dans le jeu de couleurs de la page.
LIGHT9 Effet de recoloration qui éclaircit l'image à l'aide de la neuvième couleur disponible dans le jeu de couleurs de la page.
LIGHT10 Effet de recoloration qui éclaircit l'image à l'aide de la dixième couleur disponible dans le jeu de couleurs de la page.
DARK1 Effet de recoloration qui assombrit l'image à l'aide de la première couleur disponible dans le jeu de couleurs de la page.
DARK2 Effet de recoloration qui assombrit l'image à l'aide de la deuxième couleur disponible dans le jeu de couleurs de la page.
DARK3 Effet de recoloration qui assombrit l'image à l'aide de la troisième couleur disponible dans le jeu de couleurs de la page.
DARK4 Effet de recoloration qui assombrit l'image à l'aide de la quatrième couleur disponible dans le jeu de couleurs de la page.
DARK5 Effet de recoloration qui assombrit l'image à l'aide de la cinquième couleur disponible dans le jeu de couleurs de la page.
DARK6 Effet de recoloration qui assombrit l'image à l'aide de la sixième couleur disponible dans le jeu de couleurs de la page.
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 Effet de recoloration qui assombrit l'image à l'aide de la huitième couleur disponible dans le jeu de couleurs de la page.
DARK9 Effet de recoloration qui assombrit l'image à l'aide de la neuvième couleur disponible dans le jeu de couleurs de la page.
DARK10 Effet de recoloration qui assombrit l'image à l'aide de la dixième couleur disponible dans le jeu de couleurs de la page.
GRAYSCALE Effet de recoloration qui transforme l'image en niveaux de gris.
NEGATIVE Effet de recoloration qui recolore l'image en niveaux de gris négatifs.
SEPIA Effet de recoloration qui recolore l'image en sépia.
CUSTOM Effet de nouvelle coloration personnalisée. Reportez-vous à recolorStops pour le dégradé de béton.