在 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 打开已保存演示文稿时的初始视图。使用 ViewProperties.setLastView 方法并传入一个 ViewType 值后再保存。

下面的示例将 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 提供了一个基于 Aspose.Slides API 的免费 PowerPoint Splitter 工具。它可将演示文稿中的选定幻灯片保存为独立的 PPT 或 PPTX 文件。

常见问题

Aspose.Slides 是否支持增量保存或“快速保存”？
不支持。每次保存操作都会写入完整的输出文件，而不是仅更新已更改的部分。

多个线程能否保存同一个 Presentation 实例？
不能。一个 Presentation 实例 不是线程安全的。每次只能由单个线程访问并保存该实例。

保存演示文稿时，超链接和外部链接的文件会怎样？
超链接会保留在演示文稿中。Aspose.Slides 不会复制外部链接的文件，因此已保存的演示文稿仍需能够访问这些位置。

我能否保存文档元数据，如作者、标题、公司和创建日期？
可以。在保存之前设置相应的文档属性，Aspose.Slides 会将它们写入输出文件。

在 Python 中将演示文稿转换为多种格式在 Python via Java 中管理幻灯片放映