Ink‑Objekte in Präsentationen mit Python via Java verwalten

Einleitung

PowerPoint bietet eine Ink‑Funktion, mit der Sie Freihand‑Striche zeichnen können. Ink kann verwendet werden, um andere Objekte hervorzuheben, Verbindungen und Prozesse darzustellen und die Aufmerksamkeit auf bestimmte Elemente einer Folie zu lenken.

Aspose.Slides stellt die Typen bereit, die zum Arbeiten mit Ink‑Objekten erforderlich sind. Beispielsweise repräsentiert die Ink‑Klasse ein Ink‑Objekt auf einer Folie.

Unterschiede zwischen normalen Objekten und Ink‑Objekten

Objekte auf einer PowerPoint‑Folie werden typischerweise durch Shape‑Objekte dargestellt. In seiner einfachsten Form ist ein Shape ein Container, der den Bereich des eigentlichen Objekts (seinen Rahmen) zusammen mit Eigenschaften wie Größe, Form und Hintergrund definiert. Weitere Informationen finden Sie unter Shape Layout Format.

Wenn PowerPoint jedoch ein Ink‑Objekt verarbeitet, ignoriert es alle Eigenschaften des Objekt‑Rahmens (Containers) außer seiner Größe. Die Größe des Container‑Bereichs wird durch die Standardmethoden Shape.getWidth und Shape.getHeight bestimmt:

ink_powerpoint1

Ink‑Spuren

Eine Ink‑Spur ist ein Basiselement, das die Laufbahn einer Feder aufzeichnet, während ein Benutzer digitale Ink schreibt. Eine Spur speichert eine Sequenz verbundener Punkte.

Die einfachste Form der Codierung gibt die X‑ und Y‑Koordinaten jedes Sample‑Punktes an. Wenn alle verbundenen Punkte gerendert werden, entsteht ein Bild wie dieses:

ink_powerpoint2

Pinsel‑Eigenschaften zum Zeichnen

Ein Pinsel wird verwendet, um Linien zu zeichnen, die die Punkte einer Ink‑Spur verbinden. Der Pinsel verfügt über eigene Farbe und Größe, die durch die Methoden InkBrush.getColor und InkBrush.getSize bereitgestellt werden.

Ink‑Pinsel‑Farbe festlegen

Dieser Python‑Code zeigt, wie die Farbe eines Ink‑Pinsels festgelegt wird:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Ink

Color = jpype.JClass("java.awt.Color")

presentation = Presentation("pres.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    ink = slide.getShapes().get_Item(0)
    if isinstance(ink, Ink):
        traces = ink.getTraces()
        if len(traces) > 0:
            brush = traces[0].getBrush()
            brush.setColor(Color.RED)
        else:
            print("The ink object has no traces.")
    else:
        print("The first shape is not an ink object.")
finally:
    presentation.dispose()

Ink‑Pinsel‑Größe festlegen

Dieser Python‑Code zeigt, wie die Größe eines Ink‑Pinsels festgelegt wird:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Ink

Dimension = jpype.JClass("java.awt.Dimension")

presentation = Presentation("pres.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    ink = slide.getShapes().get_Item(0)
    if isinstance(ink, Ink):
        traces = ink.getTraces()
        if len(traces) > 0:
            brush = traces[0].getBrush()
            brush_size = Dimension(5, 10)
            brush.setSize(brush_size)
        else:
            print("The ink object has no traces.")
    else:
        print("The first shape is not an ink object.")
finally:
    presentation.dispose()

In der Regel stimmen Breite und Höhe eines Pinsels nicht überein, sodass PowerPoint die Pinselgröße nicht anzeigt (der entsprechende Datenbereich ist ausgegraut). Stimmen Breite und Höhe überein, wird die Größe in PowerPoint wie folgt angezeigt:

ink_powerpoint3

Zur Veranschaulichung erhöhen wir die Höhe des Ink‑Objekts und betrachten die wichtigen Abmessungen:

ink_powerpoint4

Der Container (Rahmen) berücksichtigt nicht die Größe der Pinsel – er geht stets davon aus, dass die Linien­dicke Null ist (siehe das vorherige Bild).

Um therefore die sichtbare Fläche des gesamten Ink‑Objekts zu bestimmen, muss die Pinselgröße seiner Spuren berücksichtigt werden. Hier wurde das Zielobjekt (die handgeschriebene Textspur) auf die Größe des Containers (Rahmens) skaliert. Ändert sich die Container‑Größe, bleibt die Pinselgröße konstant und umgekehrt.

ink_powerpoint5

PowerPoint verwendet ein ähnliches Verhalten für Textobjekte:

ink_powerpoint6

Steuerung des Ink‑Erscheinungsbildes beim Export und Rendern

Aspose.Slides stellt die Klasse InkOptions bereit, um zu steuern, wie Ink‑Objekte in exportierten oder gerenderten Ausgaben erscheinen. Mit ihren Eigenschaften können Sie Ink vollständig ausblenden oder ändern, wie Ink‑Pinsel‑Masken‑Operationen interpretiert werden.

Ink‑Optionen stehen über die Export‑ bzw. Rendering‑Optionen für mehrere Ausgabetypen zur Verfügung:

Ausgabe Ink‑Option‑Eigenschaft
PDF PdfOptions.getInkOptions
HTML HtmlOptions.getInkOptions
SVG SVGOptions.getInkOptions
TIFF TiffOptions.getInkOptions
Folien‑Bild RenderingOptions.getInkOptions

Die folgenden InkOptions-Methoden stellen dieselben beiden Einstellungen bereit:

  • getHideInk bestimmt, ob Ink‑Objekte in die Ausgabe einbezogen werden. Der Standardwert ist False.
  • getInterpretMaskOpAsOpacity bestimmt, ob eine Masken‑Operation beim Rendern eines Ink‑Pinsels als Deckkraft interpretiert wird. Der Standardwert ist True; rufen Sie setInterpretMaskOpAsOpacity mit False auf, um stattdessen die ROP‑Operation zu verwenden.

Ink‑Objekte in PDF‑Ausgabe ausblenden

Standardmäßig bleiben Ink‑Objekte beim Export sichtbar. Um eine saubere Ausgabe ohne handschriftliche Anmerkungen oder andere Ink‑Inhalte zu erzeugen, rufen Sie InkOptions.setHideInk mit True auf.

Das folgende Python‑Beispiel exportiert eine Präsentation als PDF und blendet dabei alle Ink‑Objekte aus:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, PdfOptions, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    pdf_options = PdfOptions()
    pdf_options.getInkOptions().setHideInk(True)

    presentation.save("presentation_without_ink.pdf", SaveFormat.Pdf, pdf_options)
finally:
    presentation.dispose()

Ink‑Objekte beim Rendern einer Folie als Bild ausblenden

Um Ink‑Objekte beim Rendern von Folien als Bitmap‑Bilder auszublenden, konfigurieren Sie RenderingOptions.getInkOptions und übergeben Sie die Rendering‑Optionen an Slide.getImage.

Das folgende Python‑Beispiel rendert die erste Folie als PNG‑Bild ohne Ink‑Objekte:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, RenderingOptions, ImageFormat

presentation = Presentation("presentation.pptx")
try:
    rendering_options = RenderingOptions()
    rendering_options.getInkOptions().setHideInk(True)

    slide = presentation.getSlides().get_Item(0)
    image = slide.getImage(rendering_options)
    try:
        image.save("slide_without_ink.png", ImageFormat.Png)
    finally:
        image.dispose()
finally:
    presentation.dispose()

Steuerung der Ink‑Masken‑Darstellung

Die Einstellung InkOptions.getInterpretMaskOpAsOpacity kontrolliert, wie Masken‑Operationen beim Rendern von Ink‑Pinseln interpretiert werden. Der Standardwert ist True, was Deckkraft verwendet. Um stattdessen die ROP‑Operation zu nutzen, rufen Sie InkOptions.setInterpretMaskOpAsOpacity mit False auf.

Das folgende Python‑Beispiel exportiert eine Folie als SVG und verwendet ROP‑basiertes Rendering für Ink‑Masken‑Operationen:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SVGOptions

FileOutputStream = jpype.JClass("java.io.FileOutputStream")

presentation = Presentation("presentation.pptx")
try:
    svg_options = SVGOptions()
    svg_options.getInkOptions().setInterpretMaskOpAsOpacity(False)

    stream = FileOutputStream("slide.svg")
    try:
        slide = presentation.getSlides().get_Item(0)
        slide.writeAsSvg(stream, svg_options)
    finally:
        stream.close()
finally:
    presentation.dispose()

Die gleiche Einstellung kann über TiffOptions.getInkOptions angewendet werden, wenn eine Präsentation als TIFF exportiert oder eine Folie gerendert wird.

Auswählen, ob Ink ausgeblendet oder erhalten bleibt

Wenn Sie für die Verteilung eine saubere Version einer annotierten Präsentation ohne Prüfzeichen benötigen, rufen Sie InkOptions.setHideInk mit True während des Exports auf.

Lassen Sie InkOptions.getHideInk bei seinem Standardwert False, wenn Ink‑Anmerkungen Teil des beabsichtigten Inhalts sind, etwa Prüfbemerkungen, handschriftliche Notizen, Hervorhebungen oder Zeichnungen, die im exportierten Ergebnis sichtbar bleiben sollen. Dadurch können Anwendungen separate Prüf‑ und Endausgaben aus derselben Präsentation erzeugen, ohne die Quell‑Ink‑Objekte zu ändern.

FAQ

Kann ich die Farbe oder Größe eines bestehenden Ink‑Strichs ändern?

Ja. Holen Sie die Spur über Ink.getTraces und ändern Sie deren InkTrace.getBrush. Rufen Sie InkBrush.setColor oder InkBrush.setSize auf, um den Pinsel zu ändern.

Ändert das Ausblenden von Ink die Quell‑Präsentation?

Nein. Der Aufruf von InkOptions.setHideInk wirkt sich nur auf das gerenderte bzw. exportierte Ergebnis aus; er entfernt oder verändert Ink‑Objekte in der Quell‑Präsentation nicht.

Welche Export‑Formate unterstützen Ink‑Optionen?

Sie können Ink‑Optionen für PDF, HTML, SVG, TIFF und bitmap‑Folien‑Bilder über die entsprechenden Export‑ bzw. Rendering‑Optionen, die oben gezeigt wurden, konfigurieren.

Weiterführende Lektüre

PowerPoint-Formen in Python verwalten Erstellen und Anpassen von PowerPoint SmartArt in Python