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

Introduction

PowerPoint propose une fonctionnalité d’encre qui vous permet de dessiner des traits libres. L’encre peut être utilisée 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 les types nécessaires pour travailler avec les objets d’encre. Par exemple, la classe Ink représente un objet d’encre sur une diapositive.

Différences entre les objets ordinaires et les objets d’encre

Les objets d’une diapositive PowerPoint sont généralement représentés par des objets forme. Dans sa forme la plus simple, une forme est un conteneur qui définit la zone de l’objet lui‑même (son cadre) ainsi que des propriétés telles que la taille du conteneur, la forme et l’arrière‑plan. Pour plus d’informations, consultez Shape Layout Format.

En revanche, lorsquPowerPoint gère un objet d’encre, il 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 méthodes standards Shape.getWidth et Shape.getHeight :

ink_powerpoint1

Traces d’encre

Une trace d’encre est un élément de base utilisé pour enregistrer la trajectoire d’un stylo lorsqu’un utilisateur écrit de l’encre numérique. Une trace stocke une séquence 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

Un pinceau est utilisé pour tracer des lignes qui relient les points d’une trace d’encre. Le pinceau possède sa propre couleur et sa propre taille, représentées par les méthodes InkBrush.getColor et InkBrush.getSize .

Définir la couleur du pinceau d’encre

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

const aspose = {
    slides: require("aspose.slides.via.java")
};
const java = require("java");

const presentation = new aspose.slides.Presentation("pres.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const ink = slide.getShapes().get_Item(0);
    const brush = ink.getTraces()[0].getBrush();
    const red = java.getStaticFieldValue("java.awt.Color", "RED");
    brush.setColor(red);
} finally {
    presentation.dispose();
}

Définir la taille du pinceau d’encre

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

const aspose = {
    slides: require("aspose.slides.via.java")
};
const java = require("java");

const presentation = new aspose.slides.Presentation("pres.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const ink = slide.getShapes().get_Item(0);
    const brush = ink.getTraces()[0].getBrush();
    const brushSize = java.newInstanceSync("java.awt.Dimension", 5, 10);
    brush.setSize(brushSize);
} finally {
    presentation.dispose();
}

Généralement, la largeur et la hauteur d’un pinceau ne correspondent pas, ainsi PowerPoint n’affiche pas la taille du pinceau (la section de données correspondante est grisées). Lorsque la largeur et la hauteur du pinceau correspondent, PowerPoint affiche sa taille ainsi :

ink_powerpoint3

Pour plus de clarté, augmentons la hauteur de l’objet d’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 zéro (voir l’image précédente).

Par conséquent, pour déterminer la zone visible de l’ensemble de l’objet d’encre, il faut prendre en compte la taille du pinceau de ses traces. Ici, l’objet cible (la trace de texte manuscrit) a été mis à l’échelle à la taille du conteneur (cadre). Lorsque la taille du conteneur change, la taille du pinceau reste constante, et inversement.

ink_powerpoint5

PowerPoint utilise un comportement similaire pour les objets texte :

ink_powerpoint6

Contrôler l’apparence de l’encre lors de l’exportation et du rendu

Aspose.Slides fournit la classe InkOptions pour contrôler la façon dont les objets d’encre apparaissent dans la sortie exportée ou rendue. Vous pouvez utiliser ses propriétés pour masquer complètement l’encre ou modifier la manière dont les opérations de masque du pinceau d’encre sont interprétées.

Les options d’encre sont disponibles via les options d’exportation ou de rendu pour plusieurs types de sortie :

Sortie Propriété des options d’encre
PDF PdfOptions.getInkOptions
HTML HtmlOptions.getInkOptions
SVG SVGOptions.getInkOptions
TIFF TiffOptions.getInkOptions
Slide image RenderingOptions.getInkOptions

Les méthodes suivantes de InkOptions exposent les mêmes deux paramètres :

Masquer les objets d’encre dans la sortie PDF

Par défaut, les objets d’encre restent visibles lors de l’exportation. Pour créer une sortie propre sans annotations manuscrites ou autre contenu d’encre, appelez InkOptions.setHideInk avec true.

Le code JavaScript suivant exporte une présentation au format PDF tout en masquant tous les objets d’encre :

const aspose = {
    slides: require("aspose.slides.via.java")
};

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const pdfOptions = new aspose.slides.PdfOptions();
    pdfOptions.getInkOptions().setHideInk(true);

    presentation.save("presentation_without_ink.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
    presentation.dispose();
}

Masquer les objets d’encre lors du rendu d’une diapositive en image

Pour masquer les objets d’encre lors du rendu des diapositives en images bitmap, configurez RenderingOptions.getInkOptions et transmettez les options de rendu à Slide.getImage.

Le code JavaScript suivant rend la première diapositive en image PNG sans objets d’encre :

const aspose = {
    slides: require("aspose.slides.via.java")
};

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const renderingOptions = new aspose.slides.RenderingOptions();
    renderingOptions.getInkOptions().setHideInk(true);

    const slide = presentation.getSlides().get_Item(0);
    const image = slide.getImage(renderingOptions);
    try {
        image.save("slide_without_ink.png", aspose.slides.ImageFormat.Png);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

Contrôler le rendu du masque d’encre

Le setting InkOptions.getInterpretMaskOpAsOpacity contrôle la manière dont les opérations de masque sont interprétées lors du rendu des pinceaux d’encre. La valeur par défaut est true, ce qui utilise l’opacité. Pour utiliser l’opération ROP à la place, appelez InkOptions.setInterpretMaskOpAsOpacity avec false.

Le code JavaScript suivant exporte une diapositive au format SVG et utilise un rendu basé sur ROP pour les opérations de masque d’encre :

const aspose = {
    slides: require("aspose.slides.via.java")
};
const java = require("java");

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const svgOptions = new aspose.slides.SVGOptions();
    svgOptions.getInkOptions().setInterpretMaskOpAsOpacity(false);

    const outputStream = java.newInstanceSync("java.io.FileOutputStream", "slide.svg");
    try {
        const slide = presentation.getSlides().get_Item(0);
        slide.writeAsSvg(outputStream, svgOptions);
    } finally {
        outputStream.close();
    }
} finally {
    presentation.dispose();
}

Le même paramètre peut être appliqué via TiffOptions.getInkOptions lors de l’exportation d’une présentation ou du rendu d’une diapositive en TIFF.

Choisir de masquer ou de conserver l’encre

Lorsque vous avez besoin d’une version épurée d’une présentation annotée pour la distribution sans marques de révision, appelez InkOptions.setHideInk avec true lors de l’exportation.

Laissez InkOptions.getHideInk à sa valeur par défaut false lorsque les annotations d’encre font partie du contenu prévu, comme les commentaires de révision, les notes manuscrites, les surlignages ou les dessins qui doivent rester visibles dans le résultat exporté. Cela permet aux applications de générer des sorties de révision et finales séparées à partir de la même présentation sans modifier les objets d’encre source.

FAQ

Puis-je modifier la couleur ou la taille d’un trait d’encre existant ?

Oui. Récupérez la trace via Ink.getTraces puis modifiez son InkTrace.getBrush. Appelez InkBrush.setColor ou InkBrush.setSize pour changer le pinceau.

Masquer l’encre modifie‑t‑il la présentation source ?

Non. L’appel de InkOptions.setHideInk n’affecte que le rendu ou le résultat exporté ; il ne supprime ni ne modifie les objets d’encre dans la présentation source.

Quels formats d’exportation prennent en charge les options d’encre ?

Vous pouvez configurer les options d’encre pour PDF, HTML, SVG, TIFF et les images bitmap des diapositives via les options d’exportation ou de rendu correspondantes présentées ci‑dessus.

Lectures complémentaires

Propriétés d'affichage de la présentation Gérer les commentaires de présentation dans Node.js