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

PowerPoint fournit la fonction encre pour vous permettre de dessiner des figures non standard, qui peuvent ê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 classiques 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, consultez le Format de disposition de forme.

En revanche, lorsqu’il s’agit d’un objet encre, PowerPoint ignore toutes les propriétés du cadre de l’objet (conteneur) sauf sa taille. La taille de la zone du conteneur est déterminée par les valeurs standards 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 numérique. Les traces sont des enregistrements qui décrivent des séquences de points connectés.

La forme d’encodage la plus simple spécifie 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 dessiner 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 Java montre comment définir la couleur d’un pinceau :

Presentation pres = new Presentation("pres.pptx");
try {
    IInk ink = (IInk)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    IInkTrace[] traces = ink.getTraces();
    IInkBrush brush = traces[0].getBrush();
    Color brushColor = brush.getColor();
    brush.setColor(Color.RED);
} finally {
    if (pres != null) pres.dispose();
}

Définir la taille du pinceau encre

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

Presentation pres = new Presentation("pres.pptx");
try {
    IInk ink = (IInk)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    IInkTrace[] traces = ink.getTraces();
    IInkBrush brush = traces[0].getBrush();
    Dimension2D brushSize = brush.getSize();
    brush.setSize(new Dimension(5, 10));
} finally {
    if (pres != null) pres.dispose();
}

Généralement, la largeur et la hauteur d’un pinceau ne correspondent pas, de sorte que PowerPoint n’affiche pas la taille du pinceau (la section des données est grisée). Mais lorsque la largeur et la hauteur du pinceau correspondent, PowerPoint affiche sa taille de cette façon :

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 prendre en compte la taille du pinceau des objets trace. Ici, l’objet cible (l’objet trace du texte manuscrit) a été mis à l’échelle à la taille du conteneur (cadre). Lorsque la taille du conteneur (cadre) change, la taille du pinceau reste constante et inversement.

ink_powerpoint5

PowerPoint montre le même comportement lorsqu’il s’agit de textes :

ink_powerpoint6

Lectures complémentaires