Spara presentationer i Python via Java

Vad den här sidan handlar om

Spara PowerPoint- och OpenDocument-presentationer till filer eller strömmar i Python via Java med Aspose.Slides, och konfigurera PPTX-utmatning samt rapportering av framsteg.

Översikt

Efter att du har skapat en presentation eller öppnat en befintlig, använder du metoden Presentation.save för att skriva resultatet. Aspose.Slides för Python via Java kan spara en presentation till en fil eller ström i PowerPoint, OpenDocument, PDF och andra format. Följande avsnitt täcker de standard-spara-operationerna och de alternativ som är tillgängliga för PPTX-utmatning.

Spara presentationer till filer

För att spara en presentation till en fil, skicka sökvägen för utskriften och ett SaveFormat-värde till metoden Presentation.save. Formatvärdet bestämmer vilken typ av fil som Aspose.Slides skapar.

Följande exempel skapar en presentation och sparar den som en PPTX-fil:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    # Lägg till eller ändra presentationsinnehåll här.

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

Spara presentationer i deras ursprungliga format

I ett batch-bearbetningsprogram kan indataformatet vara okänt i förväg. Efter att en fil har laddats, läs dess ursprungliga format från metoden Presentation.getSourceFormat. Skicka det resulterande SourceFormat-värdet till SlideUtil.toSaveFormat för att erhålla motsvarande SaveFormat-värde, och använd sedan Presentation.save för att skriva den ändrade presentationen.

Följande kompletta exempel bearbetar varje fil i en inmatningskatalog, uppdaterar dess titel och sparar den till en utdatakatalog i det format som den laddades i:

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 mappar PPT, PPTX, ODP, PPTM, PPSX, PPSM, POTX, POTM, PPS, POT, OTP, FODP och PowerPoint-XML till deras motsvarande presentations-spara-format. Den mappar endast presentations-källformat; den är inte avsedd att välja exportformat såsom PDF, HTML, TIFF eller bilder. Att skicka ett ej-stött eller ogiltigt SourceFormat-värde resulterar i ett IllegalArgumentException.

Äldre PPT-, PPS- och POT-filer använder samma binära behållare. När en sådan presentation laddas från en ström utan filnamnstillägg kan en PPS- eller POT-fil därför identifieras som PPT. Om bevarande av dessa äldre undertyper krävs, behåll det ursprungliga filnamnet eller formatmetadata separat och använd dem när du väljer utdatafilnamn och format.

Spara presentationer till strömmar

För att skriva en presentation utan att förlita sig på en slutgiltig filsökväg, skicka en skrivbar ström och ett SaveFormat-värde till metoden Presentation.save. Detta tillvägagångssätt är användbart när utdata måste returneras från en webb-tjänst, lagras i en databas eller bearbetas i minnet.

Följande exempel sparar en ny presentation till en filström:

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

Spara presentationer med en fördefinierad visningstyp

Du kan ange den vy som PowerPoint öppnar en sparad presentation i initialt. Använd metoden ViewProperties.setLastView med ett ViewType-värde innan du sparar.

Följande exempel konfigurerar Master-bild-vyn som den initiala vyn:

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

Spara presentationer i det strikta Office Open XML-formatet

För att skapa en PPTX-fil som följer den strikta profilen av Office Open XML, skapa en instans av PptxOptions och använd dess setConformance-metod med Conformance.Iso29500_2008_Strict. Skicka sedan alternativen till metoden 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()

Spara presentationer i Office Open XML-format i Zip64-läge

Ett standard-ZIP-arkiv begränsar den komprimerade och okomprimerade storleken för varje post, den totala arkivstorleken samt antalet poster. Eftersom en PPTX-fil är ett ZIP-arkiv kan en mycket stor presentation överskrida dessa gränser. ZIP64-tillägg höjer de tillämpliga storleks- och postantal-gränserna.

Använd metoden PptxOptions.setZip64Mode för att styra om Aspose.Slides skriver ZIP64-tillägg:

IfNecessary använder ZIP64 endast när presentationen överskrider standard-ZIP-gränserna. Detta är standardläget.
Never inaktiverar ZIP64-tillägg.
Always skriver alltid ZIP64-tillägg.

Följande exempel aktiverar alltid ZIP64-tillägg för utdata-presentationen:

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

Om Zip64Mode.Never används och presentationen inte får plats inom standard-ZIP-gränserna, kastar spara-operationen ett PptxException.

Spara presentationer i Office Open XML-format med komprimeringsnivåer

För PPTX-utmatning kan du balansera spara-hastighet mot filstorlek genom att använda metoden PptxOptions.setCompressionLevel. Klassen CompressionLevel tillhandahåller följande värden:

None lagrar data utan komprimering.
Level1 ger den snabbaste komprimeringen och den största komprimerade utmatningen.
Level2 till Level5 favoriserar successivt mindre utmatning framför spara-hastighet.
Level6 balanserar spara-hastighet och filstorlek. Detta är standardnivån.
Level7 och Level8 favoriserar ytterligare mindre utmatning framför spara-hastighet.
Level9 ger den starkaste komprimeringen och kräver mest bearbetningstid.

Följande exempel sparar en presentation utan komprimering:

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

Följande exempel använder den maximala komprimeringsnivån:

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

Spara presentationer utan att uppdatera miniatyren

När en presentation sparas som PPTX styr metoden PptxOptions.setRefreshThumbnail dess dokument-miniatyr:

True regenererar miniatyren under spara-operationen. Detta är standardvärdet.
False bevarar befintlig miniatyr. Om presentationen saknar miniatyr genererar Aspose.Slides ingen.

Följande exempel sparar en presentation utan att uppdatera dess miniatyr:

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

Att inaktivera miniatyruppdatering kan minska den tid som krävs för att spara en PPTX-fil.

Rapportera spara-framsteg som en procentandel

För att övervaka en spara-operation, registrera en Python-framstegshanterare via jpype.JProxy och skicka den till metoden SaveOptions.setProgressCallback. Aspose.Slides anropar sedan hanterarens reporting-metod med framstegsvärden under exporten.

Följande exempel rapporterar framstegen för en PDF-export till konsolen:

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 erbjuder en gratis PowerPoint Splitter byggd med Aspose.Slides-API. Den sparar markerade bilder från en presentation som separata PPT- eller PPTX-filer.

FAQ

Stöder Aspose.Slides inkrementell eller “snabb sparning”?

Nej. Varje spara-operation skriver en komplett utdatafil istället för att bara uppdatera de ändrade delarna.

Kan flera trådar spara samma Presentation-instans?

Nej. En Presentation‑instans är inte trådsäker. Åtkomst och spara varje instans från endast en tråd åt gången.

Vad händer med hyperlänkar och externt länkade filer när jag sparar en presentation?

Hyperlinks förblir i presentationen. Aspose.Slides kopierar inte externt länkade filer, så den sparade presentationen måste fortfarande kunna nå deras platser.

Kan jag spara dokumentmetadata såsom författare, titel, företag och skapelsedatum?

Ja. Ställ in lämpliga dokumentegenskaper innan du sparar, så skriver Aspose.Slides dem till utdatafilen.

Konvertera presentationer till flera format i Python Hantera bildspel i Python via Java