使用现代 API 增强图像处理

介绍

历史上，Aspose Slides 依赖于 System.Drawing，并在公共 API 中包含以下来自该程序集的类：

从 24.4 版起，此公共 API 已被标记为弃用。

由于 .NET6 及以上版本对非 Windows 平台已移除 System.Drawing 支持（breaking change），Slides 实现了两套库的策略：

Aspose.Slides.NET – 支持 Windows 下的 .NET6+、Windows/Linux/MacOS 的 .NETStandard、Windows 的 .NETFramework 2+。
- 依赖于 System.Drawing.Common。
Aspose.Slides.NET6.CrossPlatform – Windows/Linux/MacOS 版本，无任何依赖。

Aspose.Slides.NET6.CrossPlatform 的不便之处在于它在同一命名空间下实现了自己的 System.Drawing（以保持对公共 API 的向后兼容）。因此，当同时使用 Aspose.Slides.NET6.CrossPlatform 与来自 .NETFramework 或 System.Drawing.Common 包的 System.Drawing 时，会出现命名冲突，除非使用别名。

为了解除对主 Aspose.Slides.NET 包中 System.Drawing 的依赖，我们加入了所谓的 “现代 API” —— 即应替代已弃用 API 使用的接口，其签名不再依赖 System.Drawing 中的 Image 与 Bitmap。PrinterSettings 与 Graphics 已被声明为弃用，并从公共 Slides API 中移除。

带有 System.Drawing 依赖的已弃用公共 API 将在 24.8 版中被移除。

现代 API

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

Aspose.Slides.IImage – 表示栅格或矢量图像。
Aspose.Slides.ImageFormat – 表示图像的文件格式。
Aspose.Slides.Images – 用于实例化和操作 IImage 接口的方法。

请注意，IImage 实现了 IDisposable 接口，应使用 using 包装或以其他合适方式释放。

使用新 API 的典型场景可能如下所示：

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    // 实例化一个可释放的 IImage 实例，来源于磁盘上的文件。  
    using (IImage image = Images.FromFile("image.png"))
    {
        // 通过将 IImage 实例添加到演示文稿的图像集合中，创建一个 PowerPoint 图像。
        ppImage = pres.Images.AddImage(image);
    }

    // 在第 1 张幻灯片上添加图片形状
    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

    // 获取代表第 1 张幻灯片的 IImage 实例。
    using (var slideImage = pres.Slides[0].GetImage(new Size(1920, 1080)))
    {
        // 将图像保存到磁盘。
        slideImage.Save("slide1.jpeg", ImageFormat.Jpeg);
    }
}

将旧代码替换为现代 API

为方便迁移，IImage 接口重复了 Image 与 Bitmap 类的独立签名。一般情况下，只需将使用 System.Drawing 的旧方法调用替换为新的即可。

获取幻灯片缩略图

使用已弃用 API 的代码：

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].GetThumbnail().Save("slide1.png");
}

现代 API：

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].GetImage().Save("slide1.png");
}

获取形状缩略图

使用已弃用 API 的代码：

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].Shapes[0].GetThumbnail().Save("shape.png");
}

现代 API：

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].Shapes[0].GetImage().Save("shape.png");
}

获取演示文稿缩略图

使用已弃用 API 的代码：

using (Presentation pres = new Presentation("pres.pptx"))
{
    var bitmaps = pres.GetThumbnails(new RenderingOptions(), new Size(1980, 1028));
    try
    {
        for (var index = 0; index < bitmaps.Length; index++)
        {
            Bitmap thumbnail = bitmaps[index];
            thumbnail.Save($"slide{index}.png", ImageFormat.Png);
        }
    }
    finally
    {
        foreach (Bitmap bitmap in bitmaps)
        {
            bitmap.Dispose();
        }
    }
}

现代 API：

using (Presentation pres = new Presentation("pres.pptx"))
{
    var images = pres.GetImages(new RenderingOptions(), new Size(1980, 1028));
    try
    {
        for (var index = 0; index < images.Length; index++)
        {
            IImage thumbnail = images[index];
            thumbnail.Save($"slide{index}.png", ImageFormat.Png);
        }
    }
    finally
    {
        foreach (IImage image in images)
        {
            image.Dispose();
        }
    }
}

向演示文稿添加图片

使用已弃用 API 的代码：

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    using (Image image = Image.FromFile("image.png"))
    {
        ppImage = pres.Images.AddImage(image);
    }

    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
}

现代 API：

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    using (IImage image = Aspose.Slides.Images.FromFile("image.png"))
    {
        ppImage = pres.Images.AddImage(image);
    }

    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
}

将被移除的方法/属性及其在现代 API 中的替代方案

Presentation

方法签名	替代方法签名
public Bitmap[] GetThumbnails(IRenderingOptions options)	GetImages(IRenderingOptions options)
public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides)	GetImages(IRenderingOptions options, int[] slides)
public Bitmap[] GetThumbnails(IRenderingOptions options, float scaleX, float scaleY)	GetImages(IRenderingOptions options, float scaleX, float scaleY)
public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides, float scaleX, float scaleY)	GetImages(IRenderingOptions options, int[] slides, float scaleX, float scaleY)
public Bitmap[] GetThumbnails(IRenderingOptions options, Size imageSize)	GetImages(IRenderingOptions options, Size imageSize)
public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides, Size imageSize)	GetImages(IRenderingOptions options, int[] slides, Size imageSize)
public void Save(string fname, SaveFormat format, HttpResponse response, bool showInline)	将被完全删除
public void Save(string fname, SaveFormat format, ISaveOptions options, HttpResponse response, bool showInline)	将被完全删除
public void Print()	将被完全删除
public void Print(PrinterSettings printerSettings)	将被完全删除
public void Print(string printerName)	将被完全删除
public void Print(PrinterSettings printerSettings, string presName)	将被完全删除

Shape

方法签名	替代方法签名
public Bitmap GetThumbnail()	GetImage
public Bitmap GetThumbnail(ShapeThumbnailBounds bounds, float scaleX, float scaleY)	GetImage(ShapeThumbnailBounds bounds, float scaleX, float scaleY)

Slide

方法签名	替代方法签名
public Bitmap GetThumbnail(float scaleX, float scaleY)	GetImage(float scaleX, float scaleY)
public Bitmap GetThumbnail()	GetImage
public Bitmap GetThumbnail(IRenderingOptions options)	GetImage(IRenderingOptions options)
public Bitmap GetThumbnail(Size imageSize)	GetImage(Size imageSize)
public Bitmap GetThumbnail(ITiffOptions options)	GetImage(ITiffOptions options)
public Bitmap GetThumbnail(IRenderingOptions options, float scaleX, float scaleY)	GetImage(IRenderingOptions options, float scaleX, float scaleY)
public Bitmap GetThumbnail(IRenderingOptions options, Size imageSize)	GetImage(IRenderingOptions options, Size imageSize)
public void RenderToGraphics(IRenderingOptions options, Graphics graphics)	将被完全删除
public void RenderToGraphics(IRenderingOptions options, Graphics graphics, float scaleX, float scaleY)	将被完全删除
public void RenderToGraphics(IRenderingOptions options, Graphics graphics, Size renderingSize)	将被完全删除

Output

方法签名	替代方法签名
public IOutputFile Add(string path, Image image)	Add(string path, IImage image)

ImageCollection

方法签名	替代方法签名
IPPImage AddImage(Image image)	AddImage(IImage image)

ImageWrapperFactory

方法签名	替代方法签名
IImageWrapper CreateImageWrapper(Image image)	CreateImageWrapper(IImage image)

PPImage

方法/属性签名	替代方法签名
void ReplaceImage(Image newImage)	ReplaceImage(IImage newImage)
Image SystemImage { get; }	IImage Image { get; }

PatternFormat

方法签名	替代方法签名
Bitmap GetTileImage(Color background, Color foreground)	GetTile(Color background, Color foreground)
Bitmap GetTileImage(Color styleColor)	GetTile(Color styleColor)

IPatternFormatEffectiveData

方法签名	替代方法签名
Bitmap GetTileImage(Color background, Color foreground)	GetTileIImage(SlidesImage image)

Graphics 与 PrinterSettings 的 API 支持将被停止

Graphics 类在跨平台的 .NET6 及更高版本中不再受支持。Aspose Slides 中使用该类的 API 部分将被移除： Slide

同时，与打印相关的 API 部分也将被移除：

Presentation：

常见问题

为什么放弃 System.Drawing.Graphics？

从公共 API 中移除 Graphics，以统一渲染与图像处理，消除对平台特定依赖的绑定，并转向使用跨平台的 IImage。所有渲染到 Graphics 的方法都会被删除。

IImage 相比 Image/Bitmap 有何实际优势？

IImage 统一了栅格和矢量图像的操作，通过 ImageFormat 简化多种格式的保存，减少对 System.Drawing 的依赖，使代码在不同环境间更具可移植性。

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

从 GetThumbnail 切换到 GetImage 并不会导致性能下降：新方法在提供相同选项和尺寸生成图像的能力的同时，仍保留渲染选项的支持。具体的提升或下降取决于实际场景，但功能上是等价的。

.NET 6 支持受支持目标平台的更新