Präsentationen in Python über Java speichern

Worum es auf dieser Seite geht

Speichern Sie PowerPoint- und OpenDocument-Präsentationen in Dateien oder Streams in Python über Java mit Aspose.Slides und konfigurieren Sie die PPTX-Ausgabe sowie die Fortschrittsberichterstattung.

Übersicht

Nachdem Sie eine Präsentation erstellt oder eine vorhandene öffnen, verwenden Sie die Methode Presentation.save, um das Ergebnis zu schreiben. Aspose.Slides für Python über Java kann eine Präsentation in einer Datei oder einem Stream in PowerPoint, OpenDocument, PDF und anderen Formaten speichern. Die folgenden Abschnitte behandeln die standardmäßigen Speicheroperationen und die für PPTX‑Ausgabe verfügbaren Optionen.

Präsentationen in Dateien speichern

Um eine Präsentation in einer Datei zu speichern, übergeben Sie dem Aufruf von Presentation.save den Ausgabepfad und einen SaveFormat-Wert. Der Formatwert bestimmt den Dateityp, den Aspose.Slides erzeugt.

Das folgende Beispiel erstellt eine Präsentation und speichert sie als PPTX‑Datei:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    # Fügen Sie hier Inhalte zur Präsentation hinzu oder ändern Sie sie.

    presentation.save("Output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Präsentationen im Originalformat speichern

Für Beispiele zur Erkennung von Datei‑ und Streamformaten, das Verhalten neu erstellter Präsentationen und den Unterschied zwischen Quell‑ und Zielformaten siehe Bestimmen des Originalpräsentationsformats.

In einer Batch‑Verarbeitungsanwendung ist das Eingabeformat möglicherweise im Voraus nicht bekannt. Nachdem eine Datei geladen wurde, lesen Sie ihr Originalformat über die Methode Presentation.getSourceFormat. Übergeben Sie den resultierenden SourceFormat-Wert an SlideUtil.toSaveFormat, um den entsprechenden SaveFormat-Wert zu erhalten, und verwenden Sie anschließend Presentation.save, um die geänderte Präsentation zu schreiben.

Das folgende vollständige Beispiel verarbeitet jede Datei in einem Eingabeverzeichnis, aktualisiert ihren Titel und speichert sie in ein Ausgabeverzeichnis im Format, aus dem sie geladen wurde:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SlideUtil
from pathlib import Path

IllegalArgumentException = jpype.JClass("java.lang.IllegalArgumentException")
input_directory = Path("Input")
output_directory = Path("Output")

try:
    output_directory.mkdir(parents=True, exist_ok=True)
except OSError:
    print("Cannot create the output directory.")

if input_directory.is_dir() and output_directory.is_dir():
    for input_file in input_directory.iterdir():
        if input_file.is_file():
            try:
                presentation = Presentation(str(input_file))
                try:
                    save_format = SlideUtil.toSaveFormat(presentation.getSourceFormat())
                    presentation.getDocumentProperties().setTitle("Processed by the batch application")

                    output_file = output_directory / input_file.name
                    presentation.save(str(output_file), save_format)
                finally:
                    presentation.dispose()
            except IllegalArgumentException as exception:
                print(f"Cannot map the source format of '{input_file}': {exception}")
            except Exception as exception:
                print(f"Cannot process '{input_file}': {exception}")

SlideUtil.toSaveFormat ordnet PPT, PPTX, ODP, PPTM, PPSX, PPSM, POTX, POTM, PPS, POT, OTP, FODP und PowerPoint XML den entsprechenden Präsentations‑Speicherformaten zu. Es mappt ausschließlich Präsentations‑Quellformate; es soll nicht zum Auswählen von Exportformaten wie PDF, HTML, TIFF oder Bildern verwendet werden. Das Übergeben eines nicht unterstützten oder ungültigen SourceFormat-Werts führt zu einer IllegalArgumentException.

Legacy‑PPT-, PPS‑ und POT‑Dateien verwenden denselben binären Container. Wird eine solche Präsentation aus einem Stream ohne Dateierweiterung geladen, kann eine PPS‑ oder POT‑Datei daher als PPT identifiziert werden. Wenn das Beibehalten dieser Legacy‑Subtypen erforderlich ist, sollten Sie den Originaldateinamen oder Metadaten zum Format separat aufbewahren und beim Festlegen des Ausgabedateinamens und -formats verwenden.

Präsentationen in Streams speichern

Um eine Präsentation zu schreiben, ohne einen endgültigen Dateipfad zu benötigen, übergeben Sie einen beschreibbaren Stream und einen SaveFormat-Wert an die Methode Presentation.save. Dieser Ansatz ist nützlich, wenn die Ausgabe von einem Web‑Service zurückgegeben, in einer Datenbank gespeichert oder im Speicher verarbeitet werden soll.

Das folgende Beispiel speichert eine neue Präsentation in einen Dateistream:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

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

presentation = Presentation()
try:
    output_stream = FileOutputStream("Output.pptx")
    try:
        presentation.save(output_stream, SaveFormat.Pptx)
    finally:
        output_stream.close()
finally:
    presentation.dispose()

Präsentationen mit vordefiniertem Ansichtstyp speichern

Sie können die Ansicht festlegen, in der PowerPoint eine gespeicherte Präsentation zunächst öffnet. Verwenden Sie vor dem Speichern die Methode ViewProperties.setLastView mit einem ViewType-Wert.

Das folgende Beispiel konfiguriert die Folienmaster‑Ansicht als Anfangsansicht:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, ViewType

presentation = Presentation()
try:
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView)
    presentation.save("SlideMasterView.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Präsentationen im Strict‑Office‑Open‑XML‑Format speichern

Um eine PPTX‑Datei zu erstellen, die dem Strict‑Profil von Office Open XML entspricht, erzeugen Sie eine Instanz von PptxOptions und verwenden deren Methode setConformance mit dem Wert Conformance.Iso29500_2008_Strict. Übergaben Sie anschließend die Optionen an die Methode Presentation.save.

import jpype
import asposeslides

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

from asposeslides.api import Conformance, PptxOptions, Presentation, SaveFormat

options = PptxOptions()
options.setConformance(Conformance.Iso29500_2008_Strict)

presentation = Presentation()
try:
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Präsentationen im Office‑Open‑XML‑Format im Zip64‑Modus speichern

Ein Standard‑ZIP‑Archiv begrenzt die komprimierte und unkomprimierte Größe jedes Eintrags, die Gesamtarchivgröße und die Anzahl der Einträge. Da eine PPTX‑Datei ein ZIP‑Archiv ist, kann eine sehr große Präsentation diese Grenzen überschreiten. ZIP64‑Erweiterungen erhöhen die jeweiligen Größen‑ und Eintragslimits.

Verwenden Sie die Methode PptxOptions.setZip64Mode, um zu steuern, ob Aspose.Slides ZIP64‑Erweiterungen schreibt:

IfNecessary verwendet ZIP64 nur, wenn die Präsentation die Standard‑ZIP‑Grenzen überschreitet. Dies ist der Standardmodus.
Never deaktiviert ZIP64‑Erweiterungen.
Always schreibt immer ZIP64‑Erweiterungen.

Das folgende Beispiel aktiviert ZIP64‑Erweiterungen für die Ausgabepäsentation stets:

import jpype
import asposeslides

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

from asposeslides.api import PptxOptions, Presentation, SaveFormat, Zip64Mode

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setZip64Mode(Zip64Mode.Always)

    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Warning

Wenn Zip64Mode.Never verwendet wird und die Präsentation nicht in die Standard‑ZIP‑Grenzen passt, wirft der Speichervorgang eine PptxException.

Präsentationen im Office‑Open‑XML‑Format mit Komprimierungsstufen speichern

Für die PPTX‑Ausgabe können Sie die Speicher‑Geschwindigkeit gegen die Dateigröße abwägen, indem Sie die Methode PptxOptions.setCompressionLevel verwenden. Die Klasse CompressionLevel liefert folgende Werte:

None speichert Daten ohne Kompression.
Level1 liefert die schnellste Kompression und das größte komprimierte Ergebnis.
Level2 bis Level5 bevorzugen zunehmend kleinere Ausgaben gegenüber der Speichergeschwindigkeit.
Level6 balanciert Speichergeschwindigkeit und Dateigröße. Dies ist die Standardstufe.
Level7 und Level8 favorisieren noch stärker kleinere Ausgaben gegenüber der Speichergeschwindigkeit.
Level9 liefert die stärkste Kompression und erfordert die meiste Verarbeitungszeit.

Das folgende Beispiel speichert eine Präsentation ohne Kompression:

import jpype
import asposeslides

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

from asposeslides.api import CompressionLevel, PptxOptions, Presentation, SaveFormat

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setCompressionLevel(CompressionLevel.None_)

    presentation.save("OutputNoCompression.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Das folgende Beispiel verwendet die maximale Komprimierungsstufe:

import jpype
import asposeslides

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

from asposeslides.api import CompressionLevel, PptxOptions, Presentation, SaveFormat

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setCompressionLevel(CompressionLevel.Level9)

    presentation.save("OutputMaximumCompression.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Präsentationen ohne Aktualisierung des Miniaturbildes speichern

Beim Speichern einer Präsentation als PPTX steuert die Methode PptxOptions.setRefreshThumbnail das Dokument‑Miniaturbild:

True regeneriert das Miniaturbild während des Speichervorgangs. Dies ist der Standardwert.
False bewahrt das vorhandene Miniaturbild. Hat die Präsentation kein Miniaturbild, erzeugt Aspose.Slides keines.

Das folgende Beispiel speichert eine Präsentation, ohne ihr Miniaturbild zu aktualisieren:

import jpype
import asposeslides

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

from asposeslides.api import PptxOptions, Presentation, SaveFormat

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setRefreshThumbnail(False)

    presentation.save("Output.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Note

Das Deaktivieren der Miniaturbild‑Aktualisierung kann die zum Speichern einer PPTX‑Datei erforderliche Zeit verkürzen.

Speicherfortschritt als Prozentsatz melden

Um einen Speicher‑Vorgang zu überwachen, registrieren Sie einen Python‑Fortschritts‑Handler über jpype.JProxy und übergeben ihn an die Methode SaveOptions.setProgressCallback. Aspose.Slides ruft dann die Methode reporting des Handlers mit Fortschrittswerten während des Exports auf.

Das folgende Beispiel gibt den Fortschritt eines PDF‑Exports in der Konsole aus:

import jpype
import asposeslides

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

from asposeslides.api import PdfOptions, Presentation, SaveFormat


class ExportProgressHandler:
    def reporting(self, progress_value):
        progress = int(progress_value)
        print(f"{progress}% of the file has been converted.")


handler = ExportProgressHandler()
callback = jpype.JProxy("com.aspose.slides.IProgressCallback", inst=handler)
options = PdfOptions()
options.setProgressCallback(callback)

presentation = Presentation("Sample.pptx")
try:
    presentation.save("Output.pdf", SaveFormat.Pdf, options)
finally:
    presentation.dispose()

Note

Aspose stellt einen kostenlosen PowerPoint Splitter bereit, der mit der Aspose.Slides‑API gebaut wurde. Er speichert ausgewählte Folien aus einer Präsentation als separate PPT‑ oder PPTX‑Dateien.

FAQ

Unterstützt Aspose.Slides inkrementelles oder „Fast‑Save“?

Nein. Jeder Speichervorgang schreibt eine vollständige Ausgabedatei, anstatt nur die geänderten Teile zu aktualisieren.

Können mehrere Threads dieselbe Presentation‑Instanz speichern?

Nein. Eine Presentation‑Instanz ist nicht thread‑sicher. Greifen Sie nur jeweils von einem Thread auf eine Instanz zu und speichern Sie sie.

Was geschieht mit Hyperlinks und extern verlinkten Dateien, wenn ich eine Präsentation speichere?

Hyperlinks bleiben in der Präsentation erhalten. Aspose.Slides kopiert keine extern verlinkten Dateien; die gespeicherte Präsentation muss daher weiterhin Zugriff auf deren Speicherorte haben.

Kann ich Dokument‑Metadaten wie Autor, Titel, Unternehmen und Erstellungsdatum speichern?

Ja. Setzen Sie die entsprechenden Dokument‑eigenschaften vor dem Speichern, und Aspose.Slides schreibt sie in die Ausgabedatei.

Präsentationen in Python in mehrere Formate konvertieren Verwalten von Diashows in Python über Java