Améliorer le traitement d'images avec l'API Moderne

Introduction

Historiquement, Aspose Slides a une dépendance sur System.Drawing et possède dans l’API publique les classes suivantes provenant de là :

À partir de la version 24.4, cette API publique est déclarée obsolète.

Depuis que la prise en charge de System.Drawing dans les versions .NET6 et supérieures est supprimée pour les versions non Windows (breaking change), Slides a mis en œuvre une approche à deux packages :

L’inconvénient de Aspose.Slides.NET6.CrossPlatform est qu’il implémente sa propre version de System.Drawing dans le même espace de noms (pour prendre en charge la compatibilité rétroactive avec l’API publique). Ainsi, lorsque Aspose.Slides.NET6.CrossPlatform et System.Drawing du .NET Framework ou le package System.Drawing.Common sont utilisés en même temps, un conflit de noms se produit à moins qu’un alias ne soit utilisé.

Afin d’éliminer les dépendances à System.Drawing dans le paquet principal Aspose.Slides.NET, nous avons ajouté ce que l’on appelle l'« Modern API » – c’est‑à‑dire l’API qui doit être utilisée à la place de celle obsolète, dont les signatures contiennent des dépendances aux types suivants de System.Drawing : Image et Bitmap. PrinterSettings et Graphics sont déclarés obsolètes et leur support est retiré de l’API publique Slides.

Dans les versions actuelles, considérez l’API publique qui dépend de System.Drawing comme héritée/obsolète. Utilisez le Modern API pour le nouveau code et lors de la migration des flux de travail de traitement d’images existants.

Modern API

Ajout des classes et énumérations suivantes à l’API publique :

Veuillez noter que IImage est jetable (il implémente l’interface IDisposable et son utilisation doit être enveloppée dans un using ou être libérée d’une autre manière pratique).

Utilisez GetImage pour rendre une diapositive ou une forme unique. Utilisez GetImages pour rendre plusieurs diapositives d’une présentation. Utilisez les méthodes de Images pour charger des images, AddImage avec IImage pour les ajouter à une présentation, et ReplaceImage avec IImage pour mettre à jour une image existante d’une présentation.

Un scénario typique d’utilisation de la nouvelle API peut ressembler à ce qui suit :

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    // instancier une instance jetable de IImage à partir du fichier sur le disque.  
    using (IImage image = Images.FromFile("image.png"))
    {
        // créer une image PowerPoint en ajoutant une instance de IImage aux images de la présentation.
        ppImage = pres.Images.AddImage(image);
    }

    // ajouter une forme d'image sur la diapositive #1
    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

    // obtenir une instance de IImage représentant la diapositive #1.
    using (var slideImage = pres.Slides[0].GetImage(new Size(1920, 1080)))
    {
        // enregistrer l'image sur le disque.
        slideImage.Save("slide1.jpeg", ImageFormat.Jpeg);
    }
}

Remplacement du code ancien par le Modern API

Pour faciliter la transition, l’interface du nouveau IImage répète les signatures distinctes des classes Image et Bitmap. En général, il vous suffira de remplacer l’appel à l’ancienne méthode utilisant System.Drawing par la nouvelle.

Obtention d’une vignette de diapositive

API héritée/obsolète :

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

API moderne :

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

Obtention d’une vignette de forme

API héritée/obsolète :

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

API moderne :

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

Obtention d’une vignette de présentation

API héritée/obsolète :

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 moderne :

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

Ajout d’une image à une présentation

API héritée/obsolète :

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 moderne :

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

Méthodes/Propriétés obsolètes et leur remplacement dans le Modern API

Presentation

Signature de la méthode Signature de la méthode de remplacement
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

Signature de la méthode Signature de la méthode de remplacement
public Bitmap GetThumbnail() GetImage
public Bitmap GetThumbnail(ShapeThumbnailBounds bounds, float scaleX, float scaleY) GetImage(ShapeThumbnailBounds bounds, float scaleX, float scaleY)

Slide

Signature de la méthode Signature de la méthode de remplacement
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

Signature de la méthode Signature de la méthode de remplacement
public IOutputFile Add(string path, Image image) Add(string path, IImage image)

ImageCollection

Signature de la méthode Signature de la méthode de remplacement
IPPImage AddImage(Image image) AddImage(IImage image)

ImageWrapperFactory

Signature de la méthode Signature de la méthode de remplacement
IImageWrapper CreateImageWrapper(Image image) CreateImageWrapper(IImage image)

PPImage

Signature de la méthode/propriété Signature de la méthode de remplacement
void ReplaceImage(Image newImage) ReplaceImage(IImage newImage)
Image SystemImage { get; } IImage Image { get; }

PatternFormat

Signature de la méthode Signature de la méthode de remplacement
Bitmap GetTileImage(Color background, Color foreground) GetTile(Color background, Color foreground)
Bitmap GetTileImage(Color styleColor) GetTile(Color styleColor)

IPatternFormatEffectiveData

Signature de la méthode Signature de la méthode de remplacement
Bitmap GetTileImage(Color background, Color foreground) GetTileIImage(SlidesImage image)

Prise en charge de l’API pour Graphics et PrinterSettings

La classe Graphics n’est pas prise en charge pour les versions multiplateformes de .NET6 et supérieures. Dans Aspose Slides, utilisez les méthodes de rendu d’images du Modern API au lieu de l’API qui rend vers Graphics : ISlide

De plus, l’API liée à l’impression via PrinterSettings n’a pas de remplacement direct dans le Modern API :

IPresentation:

FAQ

Pourquoi Graphics a-t-il été supprimé ?

Le support de Graphics est déclaré obsolète dans l’API publique afin d’unifier le travail avec le rendu et les images, d’éliminer les dépendances spécifiques à la plateforme, et de passer à une approche multiplateforme avec IImage. Utilisez GetImage ou GetImages au lieu de rendre vers Graphics.

Quel est l’avantage pratique de IImage par rapport à Image/Bitmap ?

IImage unifie le travail avec les images raster et vectorielles, simplifie la sauvegarde dans divers formats via ImageFormat, réduit la dépendance à System.Drawing, et rend le code plus portable entre les environnements.

Le Modern API affectera-t-il les performances de génération de vignettes ?

Passer de GetThumbnail à GetImage ne détériore pas les scénarios : les nouvelles méthodes offrent les mêmes capacités pour produire des images avec des options et tailles, tout en conservant le support des options de rendu. Le gain ou la perte spécifique dépend du scénario, mais fonctionnellement les remplacements sont équivalents.

Support .NET 6 Mises à jour des plates-formes cibles prises en charge