在 Python via Java 中儲存簡報

本頁內容簡介

使用 Aspose.Slides 在 Python via Java 中將 PowerPoint 與 OpenDocument 簡報儲存至檔案或串流，並設定 PPTX 輸出與進度回報。

概觀

在建立簡報或開啟現有簡報之後，使用Presentation.save方法寫入結果。Aspose.Slides for Python via Java 能將簡報儲存為檔案或串流，支援 PowerPoint、OpenDocument、PDF 以及其他格式。以下章節說明標準的儲存操作以及 PPTX 輸出的可用選項。

將簡報儲存為檔案

若要將簡報儲存為檔案，請將輸出路徑與SaveFormat值傳遞給Presentation.save方法。格式值決定 Aspose.Slides 所建立檔案的類型。

以下範例建立一個簡報並將其儲存為 PPTX 檔案：

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    # 在此新增或修改簡報內容。

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

將簡報以原始格式儲存

在批次處理應用程式中，輸入格式可能事先未知。載入檔案後，從Presentation.getSourceFormat方法取得其原始格式。將取得的SourceFormat值傳遞給SlideUtil.toSaveFormat以獲得對應的SaveFormat值，然後使用Presentation.save寫入已修改的簡報。

以下完整範例會處理輸入目錄中的每個檔案，更新其標題，並以載入時的格式儲存至輸出目錄：

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會將 PPT、PPTX、ODP、PPTM、PPSX、PPSM、POTX、POTM、PPS、POT、OTP、FODP 以及 PowerPoint XML 映射到相應的簡報儲存格式。它只映射簡報來源格式；不適用於選擇 PDF、HTML、TIFF 或影像等匯出格式。傳遞不支援或無效的SourceFormat值會導致IllegalArgumentException。

舊版 PPT、PPS 與 POT 檔案使用相同的二進位容器。若此類簡報從沒有副檔名的串流載入，PPS 或 POT 檔案可能會被辨識為 PPT。若需要保留這些舊版子類型，請另行保留原始檔名或格式中繼資料，並在選擇輸出檔名與格式時使用它們。

將簡報儲存為串流

若要在不依賴最終檔案路徑的情況下寫入簡報，請將可寫入的串流與SaveFormat值傳遞給Presentation.save方法。此方式在需將輸出從 Web 服務回傳、存入資料庫或在記憶體中處理時特別有用。

以下範例將新簡報儲存至檔案串流：

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

以預先定義的檢視類型儲存簡報

您可以指定 PowerPoint 開啟已儲存簡報時的預設檢視。於儲存前，使用帶有ViewType值的ViewProperties.setLastView方法。

以下範例將 Slide Master 檢視設定為初始檢視：

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

以嚴格的 Office Open XML 格式儲存簡報

若要建立符合 Office Open XML 嚴格規範的 PPTX 檔案，請建立一個PptxOptions實例，並使用其setConformance方法，傳入Conformance.Iso29500_2008_Strict。之後將此選項傳遞給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()

在 Zip64 模式下以 Office Open XML 格式儲存簡報

標準 ZIP 壓縮檔對每個項目的壓縮與未壓縮大小、整個壓縮檔大小以及項目數量都有上限。由於 PPTX 檔案本質上是 ZIP 壓縮檔，過大的簡報可能會超過這些限制。ZIP64 延伸可提高相關的大小與項目數限制。

使用PptxOptions.setZip64Mode方法可控制 Aspose.Slides 是否寫入 ZIP64 延伸：

IfNecessary 只在簡報超過標準 ZIP 限制時使用 ZIP64，這是預設模式。
Never 停用 ZIP64 延伸。
Always 總是寫入 ZIP64 延伸。

以下範例在輸出簡報時始終啟用 ZIP64 延伸：

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

如果使用 Zip64Mode.Never 且簡報無法符合標準 ZIP 限制，儲存作業會拋出 PptxException。

在 Office Open XML 格式中使用壓縮等級儲存簡報

對於 PPTX 輸出，您可以透過PptxOptions.setCompressionLevel方法在儲存速度與檔案大小之間取得平衡。CompressionLevel類別提供以下值：

None 不進行壓縮。
Level1 提供最快的壓縮速度與最大的壓縮後檔案。
Level2 至 Level5 逐步偏好較小的輸出而犧牲儲存速度。
Level6 在儲存速度與檔案大小之間取得平衡，為預設等級。
Level7 與 Level8 更傾向於較小的輸出。
Level9 提供最強的壓縮，但需要最長的處理時間。

以下範例在不使用壓縮的情況下儲存簡報：

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

以下範例使用最高壓縮等級：

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

儲存簡報時不重新整理縮圖

當簡報以 PPTX 格式儲存時，PptxOptions.setRefreshThumbnail方法會控制其文件縮圖：

True 在儲存過程中重新產生縮圖。為預設值。
False 保留現有縮圖。若簡報沒有縮圖，Aspose.Slides 不會生成。

以下範例在儲存時不重新整理縮圖：

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

停用縮圖重新整理可減少儲存 PPTX 檔案所需的時間。

以百分比報告儲存進度

若要監控儲存作業，可透過 jpype.JProxy 註冊一個 Python 進度處理程序，並將其傳遞給SaveOptions.setProgressCallback方法。Aspose.Slides 會在匯出過程中呼叫處理程序的 reporting 方法，提供進度數值。

以下範例將 PDF 匯出的進度報告至主控台：

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 提供一個免費的 PowerPoint Splitter，以 Aspose.Slides API 建置，可將簡報中的選定投影片另存為個別的 PPT 或 PPTX 檔案。

常見問題

Aspose.Slides 是否支援增量或「快速儲存」？

不支援。每次儲存作業都會寫入完整的輸出檔案，而不是僅更新變更的部分。

多個執行緒可以同時儲存同一個 Presentation 實例嗎？

不行。Presentation 實例 不是執行緒安全的（/slides/zh-hant/python-java/multithreading/）。每次只能由單一執行緒存取與儲存該實例。

儲存簡報時，超連結和外部連結的檔案會發生什麼情況？

Hyperlinks 會保留在簡報中。Aspose.Slides 不會自行複製外部連結的檔案，所儲存的簡報仍必須能夠存取這些位置。

我可以儲存文件的作者、標題、公司和建立日期等中繼資料嗎？

可以。於儲存前設定相應的文件屬性，Aspose.Slides 會將它們寫入輸出檔案。

使用 Python 轉換簡報為多種格式在 Python via Java 中管理投影片放映