使用现代 API 增强图像处理

介绍

Aspose.Slides for Python 公共 API 当前依赖以下 aspose.pydrawing 类型：

  • aspose.pydrawing.Graphics
  • aspose.pydrawing.Image
  • aspose.pydrawing.Bitmap
  • aspose.pydrawing.printing.PrinterSettings

从 24.4 版本开始，由于 更改 ，此公共 API 已 不推荐使用。

为消除公共 API 中的 aspose.pydrawing，我们引入了 现代 API。使用 aspose.pydrawing.Image 和 aspose.pydrawing.Bitmap 的方法已不推荐使用，并将被其现代 API 等价方法取代。使用 aspose.pydrawing.Graphics 的方法已不推荐使用，对它们的支持将从公共 API 中移除。

计划在 24.8 版本中删除依赖 aspose.pydrawing 的不推荐 API。

现代 API

已向公共 API 添加以下类和枚举：

新 API 的典型使用场景如下：

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with slides.Images.from_file("image.png") as image:
        pp_image = presentation.images.add_image(image)

    slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 100, 100, pp_image)

    with slide.get_image(drawing.Size(1920, 1080)) as slide_image:
        slide_image.save("slide1.jpeg", slides.ImageFormat.JPEG)

将旧代码替换为现代 API

为方便迁移，新的 IImage 接口镜像了 Image 和 Bitmap 类的独立 API。在大多数情况下，您只需将使用 aspose.pydrawing 的方法调用替换为其现代 API 等价方法。

获取幻灯片缩略图

不推荐的 API：

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    slide.get_thumbnail().save("slide1.png")

现代 API：

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    with slide.get_image() as image:
        image.save("slide1.png")

获取形状缩略图

不推荐的 API：

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]
    
    shape.get_thumbnail().save("shape.png")

现代 API：

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    with shape.get_image() as image:
        image.save("shape.png")

获取演示文稿缩略图

不推荐的 API：

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation("sample.pptx") as presentation:
    thumbnails = presentation.get_thumbnails(slides.export.RenderingOptions(), drawing.Size(1980, 1028))

    for index, thumbnail in enumerate(thumbnails):
        thumbnail.save(f"slide_{index}.png", drawing.imaging.ImageFormat.png)

现代 API：

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation("sample.pptx") as presentation:
    thumbnails = presentation.get_images(slides.export.RenderingOptions(), drawing.Size(1980, 1028))

    for index, thumbnail in enumerate(thumbnails):
        thumbnail.save(f"slide_{index}.png", slides.ImageFormat.PNG)

向演示文稿添加图片

不推荐的 API：

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    image = drawing.Image.from_file("image.png")
    pp_image = presentation.images.add_image(image)
    slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 100, 100, pp_image)

现代 API：

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with slides.Images.from_file("image.png") as image:
        pp_image = presentation.images.add_image(image)

    slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 100, 100, pp_image)

将被删除的方法和属性以及它们的现代替代品

Presentation 类

方法签名 替代方法签名
get_thumbnails(options) get_images(options)
get_thumbnails(options, slides) get_images(options, slides)
get_thumbnails(options, scale_x, scale_y) get_images(options, scale_x, scale_y)
get_thumbnails(options, slides, scale_x, scale_y) get_images(options, slides, scale_x, scale_y)
get_thumbnails(options, image_size) get_images(options, image_size)
get_thumbnails(options, slides, image_size) get_images(options, slides, image_size)
save(fname, format, response, show_inline) 将被完全删除
save(fname, format, options, response, show_inline) 将被完全删除
print() 将被完全删除
print(printer_settings) 将被完全删除
print(printer_name) 将被完全删除
print(printer_settings, pres_name) 将被完全删除

Slide 类

方法签名 替代方法签名
get_thumbnail() get_image()
get_thumbnail(scale_x, scale_y) get_image(scale_x, scale_y)
get_thumbnail(image_size) get_image(image_size)
get_thumbnail(options) get_image(options: ITiffOotions)
get_thumbnail(options) get_image(options: IRenderingOptions)
get_thumbnail(options, scale_x, scale_y) get_image(options, scale_x, scale_y)
get_thumbnail(options, image_size) get_image(options, image_size)
render_to_graphics(options, graphics) 将被完全删除
render_to_graphics(options, graphics, scale_x, scale_y) 将被完全删除
render_to_graphics(options, graphics, rendering_size) 将被完全删除

Shape 类

方法签名 替代方法签名
get_thumbnail() get_image()
get_thumbnail(bounds, scale_x, scale_y) get_image(bounds, scale_x, scale_y)

ImageCollection 类

方法签名 替代方法签名
add_image(image: aspose.pydrawing.Image) add_image(image)

PPImage 类

方法/属性签名 替代方法/属性签名
replace_image(new_image: aspose.pydrawing.Image) replace_image(new_image)
system_image image

ImageWrapperFactory 类

方法签名 替代方法签名
create_image_wrapper(image: aspose.pydrawing.Image) create_image_wrapper(image)

PatternFormat 类

方法签名 替代方法签名
get_tile_image(background, foreground) get_tile(background, foreground)
get_tile_image(style_color) get_tile(style_color)

IPatternFormatEffectiveData 类

方法签名 替代方法签名
get_tile_image(background, foreground) get_tile_i_image(background, foreground)

Output 类

方法签名 替代方法签名
add(path, image: aspose.pydrawing.Image) add(path, image)

对 aspose.pydrawing.Graphics 的 API 支持将停止

使用 aspose.pydrawing.Graphics 的方法已不推荐使用；对它们的支持将从公共 API 中移除。

将被删除的、依赖 aspose.pydrawing.Graphics 的 API 成员包括：

  • aspose.pydrawing.Slide.render_to_graphics(options, graphics)
  • aspose.pydrawing.Slide.render_to_graphics(options, graphics, scale_x, scale_y)
  • aspose.pydrawing.Slide.render_to_graphics(options, graphics, rendering_size)

常见问题

为什么删除了 aspose.pydrawing.Graphics？

正在从公共 API 中移除对 Graphics 的支持，以统一渲染和图像的工作方式，消除对平台特定依赖的束缚，并通过 IImage 采用跨平台方式。所有渲染至 Graphics 的方法都将被删除。

IImage 相比 Image/Bitmap 的实际好处是什么？

IImage 统一了对光栅和矢量图像的处理，配合 ImageFormat 简化了各种格式的保存，降低了对 pydrawing 的依赖，使代码在不同环境之间更具可移植性。

现代 API 会影响生成缩略图的性能吗？

从 get_thumbnail 切换到 get_image 不会导致性能下降：新方法在提供相同的选项和尺寸生成功能的同时，仍保留对渲染选项的支持。具体的提升或下降取决于使用场景，但功能上两者是等价的。

技术文章 常见问题