Gérer les objets d'encre de présentation dans .NET
Introduction
PowerPoint fournit une fonction 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.
L’espace de noms Aspose.Slides.Ink contient les classes et interfaces nécessaires pour travailler avec les objets encre. Par exemple, l’interface IInk représente un objet encre sur une diapositive.
Différences entre les objets ordinaires et les objets 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.
Cependant, lorsque PowerPoint gère un objet 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 propriétés standards IShape.Width et IShape.Height :

Traces d’encre
Une trace d’encre est un élément de base utilisé pour enregistrer la trajectoire d’un stylet 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 :

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 taille, représentées par les propriétés IInkBrush.Color et IInkBrush.Size .
Définir la couleur du pinceau d’encre
Ce code C# montre comment définir la couleur d’un pinceau d’encre :
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Ink;
using var presentation = new Presentation("pres.pptx");
var ink = (IInk)presentation.Slides[0].Shapes[0];
var brush = ink.Traces[0].Brush;
brush.Color = Color.Red;
Définir la taille du pinceau d’encre
Ce code C# montre comment définir la taille d’un pinceau d’encre :
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Ink;
using var presentation = new Presentation("pres.pptx");
var ink = (IInk)presentation.Slides[0].Shapes[0];
var brush = ink.Traces[0].Brush;
brush.Size = new SizeF(5f, 10f);
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 correspondante est grisées). Lorsque la largeur et la hauteur du pinceau correspondent, PowerPoint affiche sa taille ainsi :

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

Le conteneur (cadre) ne tient pas compte de la taille des pinceaux — il suppose toujours que l’épaisseur de la ligne est nulle (voir l’image précédente).
Par conséquent, pour déterminer la zone visible de l’ensemble de l’objet 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.

PowerPoint utilise un comportement similaire pour les objets texte :

Contrôler l’apparence de l’encre lors de l’exportation et du rendu
Aspose.Slides fournit l’interface IInkOptions permettant de contrôler la façon dont les objets 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 de 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 |
|---|---|
PdfOptions.InkOptions |
|
| HTML | HtmlOptions.InkOptions |
| SVG | SVGOptions.InkOptions |
| TIFF | TiffOptions.InkOptions |
| Image de diapositive | RenderingOptions.InkOptions |
Les deux mêmes paramètres sont disponibles via ces propriétés :
HideInkdétermine si les objets encre sont inclus dans la sortie. Sa valeur par défaut estfalse.InterpretMaskOpAsOpacitydétermine si une opération de masque est interprétée comme une opacité lors du rendu d’un pinceau d’encre. Sa valeur par défaut esttrue; définissez‑la surfalsepour utiliser l’opération ROP à la place.
Masquer les objets encre dans la sortie PDF
Par défaut, les objets encre restent visibles lors de l’exportation. Réglez IInkOptions.HideInk sur true lorsque vous avez besoin d’une sortie propre sans annotations manuscrites ou autre contenu encre.
L’exemple C# suivant exporte une présentation au format PDF tout en masquant tous les objets encre :
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("presentation.pptx");
var pdfOptions = new PdfOptions();
pdfOptions.InkOptions.HideInk = true;
presentation.Save("presentation_without_ink.pdf", SaveFormat.Pdf, pdfOptions);
Masquer les objets encre lors du rendu d’une diapositive en image
Pour masquer les objets encre lors du rendu des diapositives en images bitmap, configurez RenderingOptions.InkOptions et transmettez les options de rendu à la méthode ISlide.GetImage .
L’exemple C# suivant rend la première diapositive en image PNG sans objets encre :
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("presentation.pptx");
var renderingOptions = new RenderingOptions();
renderingOptions.InkOptions.HideInk = true;
using var image = presentation.Slides[0].GetImage(renderingOptions);
image.Save("slide_without_ink.png", ImageFormat.Png);
Contrôler le rendu du masque d’encre
La propriété IInkOptions.InterpretMaskOpAsOpacity contrôle la façon 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é. Définissez la propriété sur false pour utiliser l’opération ROP à la place.
L’exemple C# suivant exporte une diapositive au format SVG et utilise le rendu basé sur ROP pour les opérations de masque d’encre :
using System.IO;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("presentation.pptx");
var svgOptions = new SVGOptions();
svgOptions.InkOptions.InterpretMaskOpAsOpacity = false;
using var stream = File.Create("slide.svg");
presentation.Slides[0].WriteAsSvg(stream, svgOptions);
Le même paramètre peut être appliqué via TiffOptions.InkOptions lors de l’exportation d’une présentation ou du rendu d’une diapositive en TIFF.
Choisir de masquer ou de conserver l’encre
Utilisez IInkOptions.HideInk réglé sur true lorsque le fichier exporté doit être une version propre d’une présentation annotée, par exemple une copie finale destinée à la diffusion sans marques de révision.
Laissez IInkOptions.HideInk à sa valeur par défaut false lorsque les annotations encre font partie du contenu attendu, comme des commentaires de révision, des notes manuscrites, des surlignages ou des 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 encre source.
FAQ
Puis‑je modifier la couleur ou la taille d’un trait d’encre existant ?
Oui. Récupérez la trace via IInk.Traces, puis modifiez son IInkTrace.Brush. Vous pouvez définir les propriétés IInkBrush.Color et IInkBrush.Size du pinceau.
Le masquage de l’encre modifie‑t‑il la présentation source ?
Non. IInkOptions.HideInk n’affecte que le résultat rendu ou exporté ; il ne supprime ni ne modifie les objets 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 de diapositives via les options d’exportation ou de rendu correspondantes indiquées ci‑dessus.
Lectures complémentaires
- Pour en savoir plus sur les formes en général, consultez la section PowerPoint Shapes .
- Pour plus d’informations sur les valeurs effectives, voir Shape Effective Properties .
- Pour les détails sur l’exportation PDF, voir Convert PPT and PPTX to PDF .
- Pour les détails sur l’exportation HTML, voir Convert PowerPoint Presentations to HTML .
- Pour les détails sur l’exportation SVG, voir Render Presentation Slides as SVG Images .
- Pour les détails sur l’exportation TIFF, voir Convert PowerPoint Presentations to TIFF .
- Pour les détails sur le rendu de diapositive en image, voir Convert Presentation Slides to Images .