使用現代 API 強化影像處理
Contents
[
Hide
]
簡介
Aspose.Slides for Python 的公開 API 目前依賴以下 aspose.pydrawing 類型：
aspose.pydrawing.Graphicsaspose.pydrawing.Imageaspose.pydrawing.Bitmapaspose.pydrawing.printing.PrinterSettings
從 24.4 版開始，該公開 API 因為 變更 而 已棄用。
為了將 aspose.pydrawing 從公開 API 中移除，我們引入了 Modern API。使用 aspose.pydrawing.Image 和 aspose.pydrawing.Bitmap 的方法已棄用，應改為使用其 Modern API 等價方法。使用 aspose.pydrawing.Graphics 的方法已棄用，且沒有直接的 Modern API 替代。
在當前版本中，將依賴 aspose.pydrawing 的公開 API 視為遺留/已棄用。對於新程式碼以及遷移現有影像處理工作流程時，請使用 Modern API。
Modern API
已在公開 API 中加入以下類別與列舉：
- aspose.slides.IImage - 代表光柵或向量圖像。
- aspose.slides.ImageFormat - 代表圖像檔案格式。
- aspose.slides.Images - 提供建立和使用 IImage 的方法。
使用 get_image 來呈現單一投影片或形狀。使用 get_images 來呈現多個投影片。使用 Images 方法載入圖像，使用 add_image 搭配 IImage 將圖像加入投影片，並使用 replace_image 搭配 IImage 更新現有投影片圖像。
新 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 類別鏡像了 aspose.pydrawing.Image 與 aspose.pydrawing.Bitmap 兩個獨立 API。在大多數情況下，只需將使用 aspose.pydrawing 的方法呼叫替換為其 Modern API 等價方法。
取得投影片縮圖
已棄用的 API：
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
slide.get_thumbnail().save("slide1.png")
Modern 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")
Modern 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)
Modern 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)
Modern 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)
方法與屬性將被移除及其 Modern 替代方案
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) | No Modern API replacement |
| save(fname, format, options, response, show_inline) | No Modern API replacement |
| print() | No Modern API replacement |
| print(printer_settings) | No Modern API replacement |
| print(printer_name) | No Modern API replacement |
| print(printer_settings, pres_name) | No Modern API replacement |
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: ITiffOptions) |
| 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) | No Modern API replacement |
| render_to_graphics(options, graphics, scale_x, scale_y) | No Modern API replacement |
| render_to_graphics(options, graphics, rendering_size) | No Modern API replacement |
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 的方法已棄用，且沒有直接的 Modern API 替代。
請改用 Modern 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？
aspose.pydrawing.Graphics 在公開 API 中已棄用，以統一渲染與圖像的工作、消除對平台特定相依性的綁定，並透過 IImage 採用跨平台方式。請改用 get_image 或 get_images 取代渲染至 aspose.pydrawing.Graphics。
相較於 aspose.pydrawing.Image/aspose.pydrawing.Bitmap，IImage 的實際好處是什麼？
IImage 統一了光柵與向量圖像的操作，透過 ImageFormat 簡化了多種格式的儲存，減少了對 pydrawing 的依賴，讓程式碼在不同環境間更具可移植性。
Modern API 會影響產生縮圖的效能嗎？
將 get_thumbnail 改為 get_image 並不會使效能變差：新方法提供相同的選項與尺寸產生圖像的能力，且仍支援渲染選項。具體的效能提升或下降取決於使用情境，但功能上兩者是等價的。