Bildverarbeitung mit der Modernen API verbessern

Einleitung

Historisch hat Aspose Slides eine Abhängigkeit von System.Drawing und enthält in der öffentlichen API die folgenden Klassen daraus:

Ab Version 24.4 wird diese öffentliche API als veraltet gekennzeichnet.

Da die Unterstützung von System.Drawing in den Versionen .NET6 und höher für Nicht‑Windows‑Versionen entfernt wurde (breaking change), hat Slides einen Zwei‑Package‑Ansatz implementiert:

Aspose.Slides.NET – Unterstützung für .NET6+ unter Windows, .NETStandard für Windows/Linux/macOS, .NETFramework 2+ (Windows).
- hat eine Abhängigkeit von System.Drawing.Common.
Aspose.Slides.NET6.CrossPlatform – Windows/Linux/macOS‑Version ohne Abhängigkeiten.

Der Nachteil von Aspose.Slides.NET6.CrossPlatform besteht darin, dass es seine eigene Version von System.Drawing im gleichen Namespace implementiert (um die Rückwärtskompatibilität mit der öffentlichen API zu unterstützen). Daher entsteht ein Namenskonflikt, wenn Aspose.Slides.NET6.CrossPlatform und System.Drawing aus dem .NET Framework oder dem System.Drawing.Common‑Paket gleichzeitig verwendet werden, sofern kein Alias verwendet wird.

Um die Abhängigkeiten von System.Drawing im Hauptpaket Aspose.Slides.NET zu entfernen, haben wir die sogenannte „Moderne API“ hinzugefügt – also die API, die anstelle der veralteten verwendet werden soll und deren Signaturen Abhängigkeiten zu den folgenden Typen aus System.Drawing enthalten: Image und Bitmap. PrinterSettings und Graphics sind als veraltet gekennzeichnet und ihre Unterstützung wurde aus der öffentlichen Slides‑API entfernt.

In den aktuellen Versionen sollte die öffentliche API, die von System.Drawing abhängt, als Legacy/veraltet behandelt werden. Verwenden Sie die Moderne API für neuen Code und bei der Migration bestehender Bildverarbeitungs‑Workflows.

Moderne API

Folgende Klassen und Aufzählungen wurden der öffentlichen API hinzugefügt:

Aspose.Slides.IImage – repräsentiert das Raster‑ oder Vektorbild.
Aspose.Slides.ImageFormat – repräsentiert das Dateiformat des Bildes.
Aspose.Slides.Images – Methoden zum Instanziieren und Arbeiten mit dem IImage-Interface.

Bitte beachten Sie, dass IImage disposable ist (es implementiert das IDisposable-Interface und sollte mit using oder auf andere bequeme Weise freigegeben werden).

Verwenden Sie GetImage, um eine einzelne Folie oder Form zu rendern. Verwenden Sie GetImages, um mehrere Präsentationsfolien zu rendern. Verwenden Sie die Methoden von Images, um Bilder zu laden, AddImage mit IImage zum Hinzufügen zu einer Präsentation und ReplaceImage mit IImage zum Aktualisieren eines vorhandenen Präsentationsbildes.

Ein typisches Szenario für die Verwendung der neuen API könnte wie folgt aussehen:

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    // Instanziieren Sie eine verwaltbare Instanz von IImage aus der Datei auf der Festplatte.  
    using (IImage image = Images.FromFile("image.png"))
    {
        // Erstellen Sie ein PowerPoint-Bild, indem Sie eine Instanz von IImage zu den Bildern der Präsentation hinzufügen.
        ppImage = pres.Images.AddImage(image);
    }

    // Fügen Sie eine Bildform zur Folie #1 hinzu
    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

    // Erhalten Sie eine Instanz von IImage, die Folie #1 darstellt.
    using (var slideImage = pres.Slides[0].GetImage(new Size(1920, 1080)))
    {
        // Speichern Sie das Bild auf der Festplatte.
        slideImage.Save("slide1.jpeg", ImageFormat.Jpeg);
    }
}

Alten Code durch Moderne API ersetzen

Um den Übergang zu erleichtern, wiederholt das Interface der neuen IImage-Klasse die separaten Signaturen der Klassen Image und Bitmap. Im Allgemeinen müssen Sie lediglich den Aufruf der alten Methode, die System.Drawing verwendet, durch den neuen ersetzen.

Ein Thumbnail einer Folie erhalten

Veraltete API:

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

Moderne API:

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

Ein Thumbnail einer Form erhalten

Veraltete API:

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

Moderne API:

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

Ein Thumbnail einer Präsentation erhalten

Veraltete 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();
        }
    }
}

Moderne 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();
        }
    }
}

Ein Bild zu einer Präsentation hinzufügen

Veraltete 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);
}

Moderne 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);
}

Veraltete Methoden/Eigenschaften und deren Ersatz in der Modernen API

Presentation

Methodensignatur	Ersatz‑Methodensignatur
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)	No Modern API replacement
public void Save(string fname, SaveFormat format, ISaveOptions options, HttpResponse response, bool showInline)	No Modern API replacement
public void Print()	No Modern API replacement
public void Print(PrinterSettings printerSettings)	No Modern API replacement
public void Print(string printerName)	No Modern API replacement
public void Print(PrinterSettings printerSettings, string presName)	No Modern API replacement

Shape

Methodensignatur	Ersatz‑Methodensignatur
public Bitmap GetThumbnail()	GetImage
public Bitmap GetThumbnail(ShapeThumbnailBounds bounds, float scaleX, float scaleY)	GetImage(ShapeThumbnailBounds bounds, float scaleX, float scaleY)

Slide

Methodensignatur	Ersatz‑Methodensignatur
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)	No Modern API replacement
public void RenderToGraphics(IRenderingOptions options, Graphics graphics, float scaleX, float scaleY)	No Modern API replacement
public void RenderToGraphics(IRenderingOptions options, Graphics graphics, Size renderingSize)	No Modern API replacement

Output

Methodensignatur	Ersatz‑Methodensignatur
public IOutputFile Add(string path, Image image)	Add(string path, IImage image)

ImageCollection

Methodensignatur	Ersatz‑Methodensignatur
IPPImage AddImage(Image image)	AddImage(IImage image)

ImageWrapperFactory

Methodensignatur	Ersatz‑Methodensignatur
IImageWrapper CreateImageWrapper(Image image)	CreateImageWrapper(IImage image)

PPImage

Methoden-/Eigenschaftssignatur	Ersatz‑Methodensignatur
void ReplaceImage(Image newImage)	ReplaceImage(IImage newImage)
Image SystemImage { get; }	IImage Image { get; }

PatternFormat

Methodensignatur	Ersatz‑Methodensignatur
Bitmap GetTileImage(Color background, Color foreground)	GetTile(Color background, Color foreground)
Bitmap GetTileImage(Color styleColor)	GetTile(Color styleColor)

IPatternFormatEffectiveData

Methodensignatur	Ersatz‑Methodensignatur
Bitmap GetTileImage(Color background, Color foreground)	GetTileIImage(SlidesImage image)

API‑Unterstützung für Graphics und PrinterSettings

Die Graphics-Klasse wird für plattformübergreifende Versionen von .NET 6 und höher nicht unterstützt. Verwenden Sie in Aspose Slides die Bild‑Render‑Methoden der Modernen API anstelle der API, die zu Graphics rendert: ISlide

Außerdem hat die API, die das Drucken über PrinterSettings betrifft, keine direkte Modern‑API‑Ersetzung:

IPresentation:

FAQ

Warum wurde Graphics entfernt?

Die Unterstützung für Graphics ist in der öffentlichen API veraltet, um die Arbeit mit Rendering und Bildern zu vereinheitlichen, Abhängigkeiten von plattformspezifischen Bibliotheken zu entfernen und zu einem plattformübergreifenden Ansatz mit IImage zu wechseln. Verwenden Sie GetImage oder GetImages anstelle des Renderns zu Graphics.

Welchen praktischen Nutzen bietet IImage im Vergleich zu Image/Bitmap?

IImage vereinheitlicht die Arbeit mit Raster‑ und Vektorbildern, vereinfacht das Speichern in verschiedene Formate über ImageFormat, reduziert die Abhängigkeit von System.Drawing und macht den Code portabler über verschiedene Umgebungen hinweg.

Beeinflusst die Moderne API die Performance beim Erzeugen von Thumbnails?

Der Wechsel von GetThumbnail zu GetImage verschlechtert die Szenarien nicht: Die neuen Methoden bieten dieselben Möglichkeiten zur Erzeugung von Bildern mit Optionen und Größen, während sie weiterhin Rendering‑Optionen unterstützen. Der konkrete Gewinn oder Verlust hängt vom jeweiligen Szenario ab, funktional sind die Ersatzmethoden jedoch äquivalent.

Unterstützung für .NET 6 Aktualisierungen der unterstützten Zielplattformen