常见问题
常见问题
如何安装 Aspose.Slides FOSS？
使用 pip 从 PyPI 安装。需要 Python 3.10 或更高版本。
pip install aspose-slides-foss验证安装：
import aspose.slides_foss as slides
with slides.Presentation() as prs:
print(f"Slides: {len(prs.slides)}")lxml 依赖会自动安装。无需 Microsoft Office 或其他系统运行时。
为什么我必须使用 with slides.Presentation() as prs:?
Presentation 类管理内部文件句柄和 XML 资源。没有上下文管理器时，当 Presentation 对象超出作用域，这些资源不会被释放，可能导致资源泄漏或在 Windows 上出现文件锁定。
始终遵循此模式：
with slides.Presentation("input.pptx") as prs:
# work here
prs.save("output.pptx", SaveFormat.PPTX)我可以保存为哪些文件格式？
仅支持 PPTX：
from aspose.slides_foss.export import SaveFormat
prs.save("output.pptx", SaveFormat.PPTX)此版本不支持导出为 PDF、HTML、SVG 或图像格式（PNG、JPEG）。
我可以打开 .ppt（旧的 PowerPoint 97–2003）文件吗？
不。仅支持 .pptx（Office Open XML）文件。此库不处理传统的 .ppt 二进制格式。
我如何访问幻灯片？
幻灯片是一个从零开始的列表，可通过 prs.slides 访问：
first_slide = prs.slides[0]
slide_count = len(prs.slides)如何添加第二张幻灯片？
使用 prs.slides.add_empty_slide() 与布局：
with slides.Presentation() as prs:
layout = prs.layout_slides[0]
prs.slides.add_empty_slide(layout)
slide2 = prs.slides[1]
prs.save("two-slides.pptx", SaveFormat.PPTX)如何设置幻灯片的背景颜色？
幻灯片背景着色在此版本不可用。Slide 类未公开 background 属性。尝试 slide.background 将引发 AttributeError。此功能在当前版本中未实现。
我该如何使用 NullableBool?
NullableBool 是用于格式化属性的三态枚举。使用 NullableBool.TRUE（而不是 Python 的 True）来表示粗体、斜体等属性：
from aspose.slides_foss import NullableBool, TextUnderlineType
fmt.font_bold = NullableBool.TRUE
fmt.font_italic = NullableBool.FALSE
# font_underline is TextUnderlineType, not NullableBool:
fmt.font_underline = TextUnderlineType.NOT_DEFINED # inherits from theme为什么设置文本颜色没有效果？
在分配颜色之前，您还必须设置 fill_type = FillType.SOLID：
from aspose.slides_foss import FillType
from aspose.slides_foss.drawing import Color
fmt.fill_format.fill_type = FillType.SOLID
fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)我可以使用图表或SmartArt吗？
不。图表、SmartArt、OLE 对象、动画、过渡、超链接、VBA 宏以及数字签名在此版本中未实现，并会触发 NotImplementedError。
该库支持 Python 3.9 吗？
不。需要 Python 3.10 或更高版本。
这个库是线程安全的吗？
每个 Presentation 对象都是独立的。只要不在没有外部锁定的情况下跨线程共享单个 Presentation 对象，从不同线程创建和使用独立的 Presentation 实例是安全的。
如何嵌入图像？
读取图像字节并将其添加到 prs.images，然后创建一个 PictureFrame:
with open("logo.png", "rb") as f:
image_data = f.read()
image = prs.images.add_image(image_data)
slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 200, 150, image)