Presentaties opslaan in Python via Java

Waar deze pagina over gaat

PowerPoint- en OpenDocument‑presentaties opslaan naar bestanden of streams in Python via Java met Aspose.Slides, en PPTX‑output en voortgangsrapportage configureren.

Overzicht

Nadat je een presentatie hebt gemaakt of een bestaande opent, gebruik je de Presentation.save‑methode om het resultaat weg te schrijven. Aspose.Slides for Python via Java kan een presentatie opslaan naar een bestand of stream in PowerPoint, OpenDocument, PDF en andere formaten. De volgende secties behandelen de standaard opslagbewerkingen en de beschikbare opties voor PPTX‑uitvoer.

Presentaties opslaan naar bestanden

Om een presentatie op te slaan naar een bestand, geef je het uitvoerpad en een SaveFormat‑waarde door aan de Presentation.save‑methode. De formatwaarde bepaalt het type bestand dat Aspose.Slides maakt.

Het volgende voorbeeld maakt een presentatie en slaat deze op als een PPTX‑bestand:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    # Voeg presentatie-inhoud toe of bewerk hier.

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

Presentaties opslaan in hun oorspronkelijke formaat

In een batch‑verwerkingsapplicatie is het ingangformaat mogelijk van tevoren niet bekend. Na het laden van een bestand lees je het oorspronkelijke formaat via de Presentation.getSourceFormat‑methode. Geef de resulterende SourceFormat‑waarde door aan SlideUtil.toSaveFormat om de overeenkomstige SaveFormat‑waarde te verkrijgen, en gebruik vervolgens Presentation.save om de aangepaste presentatie weg te schrijven.

Het volgende volledige voorbeeld verwerkt elk bestand in een invoermap, werkt de titel bij, en slaat het op naar een uitvoermap in het formaat waarin het werd geladen:

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 koppelt PPT, PPTX, ODP, PPTM, PPSX, PPSM, POTX, POTM, PPS, POT, OTP, FODP en PowerPoint XML aan hun overeenkomstige presentatie‑opslaformaten. Het koppelt alleen presentatie‑bronformaten; het is niet bedoeld om exportformaten zoals PDF, HTML, TIFF of afbeeldingen te selecteren. Het doorgeven van een niet‑ondersteunde of ongeldige SourceFormat‑waarde leidt tot een IllegalArgumentException.

Legacy‑PPT, PPS‑ en POT‑bestanden gebruiken dezelfde binaire container. Wanneer zo’n presentatie wordt geladen vanuit een stream zonder bestandsextensie, kan een PPS‑ of POT‑bestand daarom als PPT worden geïdentificeerd. Indien het behouden van deze legacy‑subtypen vereist is, bewaar dan de oorspronkelijke bestandsnaam of formaat‑metadata apart en gebruik deze bij het kiezen van de uitvoer‑bestandsnaam en -formaat.

Presentaties opslaan naar streams

Om een presentatie weg te schrijven zonder een definitief bestandspad, geef je een beschrijfbare stream en een SaveFormat‑waarde door aan de Presentation.save‑methode. Deze aanpak is nuttig wanneer de output moet worden geretourneerd vanuit een webservice, opgeslagen in een database of in het geheugen verwerkt.

Het volgende voorbeeld slaat een nieuwe presentatie op naar een bestands‑stream:

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()

Presentaties opslaan met een vooraf gedefinieerd weergavetype

Je kunt de weergave specificeren waarin PowerPoint een opgeslagen presentatie initieel opent. Gebruik de ViewProperties.setLastView‑methode met een ViewType‑waarde vóór het opslaan.

Het volgende voorbeeld stelt de Slide Master‑weergave in als de initiële weergave:

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()

Presentaties opslaan in het strikte Office Open XML‑formaat

Om een PPTX‑bestand te maken dat voldoet aan het Strict‑profiel van Office Open XML, maak je een PptxOptions‑instantie en gebruik je de setConformance‑methode met Conformance.Iso29500_2008_Strict. Geef vervolgens de opties door aan de Presentation.save‑methode.

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()

Presentaties opslaan in Office Open XML‑formaat in Zip64‑modus

Een standaard ZIP‑archief beperkt de gecomprimeerde en ongecomprimeerde grootte van elk item, de totale archiefgrootte en het aantal items. Omdat een PPTX‑bestand een ZIP‑archief is, kan een zeer grote presentatie die limieten overschrijden. ZIP64‑extensies verhogen de toepasselijke grootte‑ en item‑limieten.

Gebruik de PptxOptions.setZip64Mode‑methode om te bepalen of Aspose.Slides ZIP64‑extensies schrijft:

IfNecessary gebruikt ZIP64 alleen wanneer de presentatie de standaard ZIP‑limieten overschrijdt. Dit is de standaardmodus.
Never schakelt ZIP64‑extensies uit.
Always schrijft altijd ZIP64‑extensies.

Het volgende voorbeeld schakelt ZIP64‑extensies altijd in voor de uitvoer‑presentatie:

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()

Waarschuwing

Als Zip64Mode.Never wordt gebruikt en de presentatie kan niet binnen de standaard ZIP‑limieten passen, werpt de opslaan‑operatie een PptxException.

Presentaties opslaan in Office Open XML‑formaat met compressieniveaus

Voor PPTX‑output kun je de opslagsnelheid afwegen tegen de bestandsgrootte door de PptxOptions.setCompressionLevel‑methode te gebruiken. De CompressionLevel‑klasse biedt de volgende waarden:

None slaat gegevens op zonder compressie.
Level1 biedt de snelste compressie en de grootste gecomprimeerde output.
Level2 tot en met Level5 geven de voorkeur aan een kleinere output boven opslagsnelheid.
Level6 balanceert opslagsnelheid en bestandsgrootte. Dit is de standaardwaarde.
Level7 en Level8 geven nog sterker de voorkeur aan een kleinere output boven opslagsnelheid.
Level9 biedt de sterkste compressie en vereist de meeste verwerkingstijd.

Het volgende voorbeeld slaat een presentatie op zonder compressie:

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()

Het volgende voorbeeld gebruikt het maximale compressieniveau:

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()

Presentaties opslaan zonder miniatuur te vernieuwen

Wanneer een presentatie wordt opgeslagen als PPTX, bepaalt de PptxOptions.setRefreshThumbnail‑methode de miniatuur van het document:

True regenereert de miniatuur tijdens de opslagoperatie. Dit is de standaardwaarde.
False behoudt de bestaande miniatuur. Als de presentatie geen miniatuur heeft, genereert Aspose.Slides er geen.

Het volgende voorbeeld slaat een presentatie op zonder de miniatuur te vernieuwen:

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()

Opmerking

Het uitschakelen van het vernieuwen van de miniatuur kan de tijd die nodig is om een PPTX‑bestand op te slaan verminderen.

Opslagvoortgang rapporteren als percentage

Om een opslagoperatie te monitoren, registreer je een Python‑progress‑handler via jpype.JProxy en geef je deze door aan de SaveOptions.setProgressCallback‑methode. Aspose.Slides roept vervolgens de reporting‑methode van de handler aan met voortgangswaarden tijdens de export.

Het volgende voorbeeld rapporteert de voortgang van een PDF‑export naar de console:

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()

Opmerking

Aspose biedt een gratis PowerPoint Splitter gebouwd met de Aspose.Slides API. Het slaat geselecteerde dia’s uit een presentatie op als afzonderlijke PPT‑ of PPTX‑bestanden.

FAQ

Ondersteunt Aspose.Slides incrementeel of “fast save”?

Nee. Elke opslagoperatie schrijft een volledig uitvoerbestand weg in plaats van alleen de gewijzigde delen bij te werken.

Kunnen meerdere threads dezelfde Presentation‑instantie opslaan?

Nee. Een Presentation‑instantie is not thread-safe. Toegang en opslaan moeten per instantie uit slechts één thread tegelijk gebeuren.

Wat gebeurt er met hyperlinks en extern gelinkte bestanden wanneer ik een presentatie opsla?

Hyperlinks blijven in de presentatie aanwezig. Aspose.Slides kopieert geen extern gelinkte bestanden, dus de opgeslagen presentatie moet nog steeds toegang hebben tot hun locaties.

Kan ik document‑metadata zoals auteur, titel, bedrijf en aanmaakdatum opslaan?

Ja. Stel de juiste document properties in vóór het opslaan, en Aspose.Slides schrijft ze naar het uitvoerbestand.

Presentaties converteren naar meerdere formaten in Python Beheer diavoorstellingen in Python via Java