Gérer les objets d'encre de présentation en PHP

PowerPoint propose la fonction encre qui vous permet de dessiner des formes non standard, pouvant être utilisées pour mettre en évidence d’autres objets, montrer des connexions et des processus, et attirer l’attention sur des éléments spécifiques d’une diapositive.

Aspose.Slides fournit tous les types d’encre (par exemple la classe Ink) dont vous avez besoin pour créer et gérer des objets encre.

Différences entre les objets normaux et les objets encre

Les objets sur une diapositive PowerPoint sont généralement représentés par des objets forme. Un objet forme, dans sa forme la plus simple, est un conteneur qui définit la zone de l’objet lui‑même (son cadre) ainsi que ses propriétés. Ces dernières comprennent la taille de la zone du conteneur, la forme du conteneur, l’arrière‑plan du conteneur, etc. Pour plus d’informations, voir Format de mise en page de forme.

Cependant, lorsqu’un objet encre est traité par PowerPoint, il ignore toutes les propriétés du cadre de l’objet (conteneur) à l’exception de sa taille. La taille de la zone du conteneur est déterminée par les valeurs standard width et height :

ink_powerpoint1

Traces d’Inkshape

Une trace est un élément de base ou une norme utilisée pour enregistrer la trajectoire d’un stylo lorsqu’un utilisateur écrit de l’encre digitale. Les traces sont des enregistrements qui décrivent des séquences de points connectés.

La forme la plus simple d’encodage indique les coordonnées X et Y de chaque point d’échantillonnage. Lorsque tous les points connectés sont rendus, ils produisent une image comme celle‑ci :

ink_powerpoint2

Propriétés du pinceau pour le dessin

Vous pouvez utiliser un pinceau pour tracer des lignes reliant les points des éléments de trace. Le pinceau possède sa propre couleur et taille, correspondant aux propriétés Brush.Color et Brush.Size.

Définir la couleur du pinceau encre

Ce code PHP montre comment définir la couleur d’un pinceau :

  $pres = new Presentation("pres.pptx");
  try {
    $ink = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    $traces = $ink->getTraces();
    $brush = $traces[0]->getBrush();
    $brushColor = $brush->getColor();
    $brush->setColor(java("java.awt.Color")->RED);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Définir la taille du pinceau encre

Ce code PHP montre comment définir la taille d’un pinceau :

  $pres = new Presentation("pres.pptx");
  try {
    $ink = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    $traces = $ink->getTraces();
    $brush = $traces[0]->getBrush();
    $brushSize = $brush->getSize();
    $brush->setSize(new Java("java.awt.Dimension", 5, 10));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

En général, la largeur et la hauteur d’un pinceau ne correspondent pas, de sorte que PowerPoint n’affiche pas la taille du pinceau (la section de données est grisée). Mais lorsque la largeur et la hauteur du pinceau correspondent, PowerPoint affiche sa taille de cette manière :

ink_powerpoint3

Pour plus de clarté, augmentons la hauteur de l’objet encre et examinons les dimensions importantes :

ink_powerpoint4

Le conteneur (cadre) ne tient pas compte de la taille des pinceaux — il suppose toujours que l’épaisseur de la ligne est nulle (voir la dernière image).

Par conséquent, pour déterminer la zone visible de l’ensemble de l’objet encre, nous devons tenir compte de la taille du pinceau des objets trace. Ici, l’objet cible (l’objet trace du texte manuscrit) a été mis à l’échelle selon la taille du conteneur (cadre). Lorsque la taille du conteneur (cadre) change, la taille du pinceau reste constante et vice‑versa.

ink_powerpoint5

PowerPoint présente le même comportement lorsqu’il traite du texte :

ink_powerpoint6

Lecture supplémentaire

Formes PowerPoint PowerPoint SmartArt