使用 Python via Java 创建演示文稿形状的缩略图
简介
Aspose.Slides for Python via Java 可用于创建演示文稿文件，其中每页对应一张幻灯片。可以使用 Microsoft PowerPoint 打开演示文稿文件来查看幻灯片。但是，开发人员有时需要在图像查看器中单独查看形状的图像。在这种情况下，Aspose.Slides for Python via Java 可帮助他们生成幻灯片形状的缩略图图像。
本文说明了以不同方式生成形状缩略图的方法：
- 在幻灯片内生成形状缩略图。
- 为幻灯片形状生成具有用户自定义尺寸的形状缩略图。
- 在形状外观的边界内生成形状缩略图。
从幻灯片生成形状缩略图
要使用 Aspose.Slides for Python via Java 从任意幻灯片生成形状缩略图，请执行以下操作：
- 创建 Presentation 类的实例。
- 使用其 ID 或索引获取对幻灯片的引用。
- 获取形状缩略图图像（在默认比例下）位于引用的幻灯片上的形状。
- 将缩略图图像保存为您首选的图像格式。
此示例代码展示了如何从幻灯片生成形状缩略图：
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import ImageFormat, Presentation
# 实例化一个表示演示文稿文件的 Presentation 类。
presentation = Presentation("Thumbnail.pptx")
try:
# 创建一个全比例图像。
shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage()
try:
# 将图像以 PNG 格式保存到磁盘。
shape_image.save("output.png", ImageFormat.Png)
finally:
shape_image.dispose()
finally:
presentation.dispose()
使用用户自定义缩放因子生成缩略图
要使用 Aspose.Slides for Python via Java 生成幻灯片的形状缩略图，请执行以下操作：
- 创建 Presentation 类的实例。
- 使用其 ID 或索引获取对幻灯片的引用。
- 获取形状缩略图图像（使用用户自定义尺寸）位于引用的幻灯片上的形状。
- 将缩略图图像保存为您首选的图像格式。
此示例代码展示了如何基于定义的缩放因子生成形状缩略图：
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import ImageFormat, Presentation, ShapeThumbnailBounds
# 实例化一个表示演示文稿文件的 Presentation 类。
presentation = Presentation("Thumbnail.pptx")
try:
# 创建一个在两个方向上均按 2 倍比例缩放的图像。
shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Shape, 2, 2)
try:
# 将图像以 PNG 格式保存到磁盘。
shape_image.save("output.png", ImageFormat.Png)
finally:
shape_image.dispose()
finally:
presentation.dispose()
创建基于边界的形状外观缩略图
此方法创建形状缩略图，使开发人员能够在形状外观的边界内生成缩略图。它考虑了所有形状效果。生成的形状缩略图受幻灯片边界的限制。要在外观边界内生成幻灯片形状的缩略图，请执行以下操作：
- 创建 Presentation 类的实例。
- 使用其 ID 或索引获取对幻灯片的引用。
- 使用外观边界获取引用幻灯片上形状的缩略图图像。
- 将缩略图图像保存为您首选的图像格式。
基于上述步骤的示例代码：
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import ImageFormat, Presentation, ShapeThumbnailBounds
# 实例化一个表示演示文稿文件的 Presentation 类。
presentation = Presentation("Thumbnail.pptx")
try:
# 创建一个全比例图像。
shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Appearance, 1, 1)
try:
# 将图像以 PNG 格式保存到磁盘。
shape_image.save("output.png", ImageFormat.Png)
finally:
shape_image.dispose()
finally:
presentation.dispose()
获取形状的实际可视边界
Shape 的框架属性——其 getX、getY、getWidth 和 getHeight 方法——描述了存储在演示模型中的矩形。实际渲染的内容可能超出该框架或占据不同的轴对齐矩形。旋转、轮廓、箭头、文本布局与溢出、生成的 SmartArt 几何以及其他渲染效果都可能改变占用区域。
使用 Shape.getVisualBounds 可在不创建图像的情况下计算该占用区域。该方法返回以幻灯片坐标表示的 Rectangle2D.Float。返回的矩形未被裁剪到幻灯片内，因此当内容超出幻灯片原点时，其坐标可能为负。
以下示例获取并比较框架和可视边界：
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
from java.awt.geom import Rectangle2D
presentation = Presentation("example.pptx")
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().get_Item(0)
visual_bounds = shape.getVisualBounds()
frame_bounds = Rectangle2D.Float(shape.getX(), shape.getY(), shape.getWidth(), shape.getHeight())
print("Frame bounds:", frame_bounds)
print("Visual bounds:", visual_bounds)
finally:
presentation.dispose()
相同的 Rectangle2D.Float 可用于将相邻形状对齐到其左、右、上或下边缘；在生成的布局中预留足够空间；或检测内容是否超出允许的区域。可视边界对于 SmartArt、文本框、箭头、图片、旋转形状和组合形状尤为有用，因为存储的框架可能未能完整表示渲染结果。
当您需要布局或验证的坐标且不需要位图时，请使用 [Shape.getVisualBounds]。当您需要渲染形状时，请使用 [Shape.getImage]。使用 [ShapeThumbnailBounds] 时， [ShapeThumbnailBounds.Shape] 根据形状边界（包括轮廓设置）确定图像大小，而 [ShapeThumbnailBounds.Appearance] 根据形状的外观确定大小并将结果限制在幻灯片边界内。相对而言，[Shape.getVisualBounds] 仅返回计算得到的矩形且不裁剪到幻灯片。
FAQ
保存形状缩略图时可以使用哪些图像格式？
PNG, JPEG, BMP, GIF, TIFF，以及其他格式。形状还可以通过将形状内容保存为 SVG 来导出为矢量 SVG。
在渲染缩略图时，Shape 边界和 Appearance 边界有什么区别？
Shape 使用形状的几何；Appearance 会考虑视觉效果（阴影、发光等）。
如果形状被标记为隐藏会怎样？它仍会生成缩略图吗？
隐藏的形状仍是模型的一部分，可以渲染；隐藏标志影响幻灯片放映显示，但不会阻止生成形状的图像。
是否支持组合形状、图表、SmartArt 和其他复杂对象？
是的。任何表示为 Shape（包括 GroupShape、Chart 和 SmartArt）的对象均可保存为缩略图或 SVG。
系统安装的字体会影响文本形状缩略图的质量吗？
会的。您应当提供所需的字体（或配置字体替换）以避免不必要的回退和文本重排。