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

Introduction

L’API publique Aspose.Slides pour Python dépend actuellement des types aspose.pydrawing suivants :

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

À partir de la version 24.4, cette API publique est obsolète en raison des modifications dans l’API publique Aspose.Slides pour Python.

Pour éliminer aspose.pydrawing de l’API publique, nous avons introduit l'API Moderne. Les méthodes qui utilisent aspose.pydrawing.Image et aspose.pydrawing.Bitmap sont obsolètes et doivent être remplacées par leurs équivalents de l’API Moderne. Les méthodes qui utilisent aspose.pydrawing.Graphics sont obsolètes et n’ont aucun remplacement direct dans l’API Moderne.

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

API Moderne

Les classes et énumérations suivantes ont été ajoutées à l’API publique :

aspose.slides.IImage - représente une image raster ou vectorielle.
aspose.slides.ImageFormat - représente un format de fichier image.
aspose.slides.Images - fournit des méthodes pour créer et travailler avec IImage.

Utilisez get_image pour rendre une seule diapositive ou forme. Utilisez get_images pour rendre plusieurs diapositives d’une présentation. Utilisez les méthodes de Images pour charger des images, add_image avec IImage pour les ajouter à une présentation, et replace_image avec IImage pour mettre à jour une image existante d’une présentation.

Un scénario d’utilisation typique pour la nouvelle API ressemble à ceci :

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)

Remplacer le code ancien par l’API Moderne

Pour une transition plus simple, la nouvelle classe IImage reflète les API séparées des classes aspose.pydrawing.Image et aspose.pydrawing.Bitmap. Dans la plupart des cas, vous devez simplement remplacer les appels aux méthodes qui utilisent aspose.pydrawing par leurs équivalents de l’API Moderne.

Obtenir une miniature de diapositive

API obsolète :

import aspose.slides as slides

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

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

API Moderne :

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")

Obtenir une miniature de forme

API obsolète :

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

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")

Obtenir une miniature de présentation

API obsolète :

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

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)

Ajouter une image à une présentation

API obsolète :

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

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)

Méthodes et propriétés à supprimer et leurs remplacements modernes

Classe Presentation

Signature de la méthode	Signature de la méthode de remplacement
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)	Pas de remplacement dans l’API Moderne
save(fname, format, options, response, show_inline)	Pas de remplacement dans l’API Moderne
print()	Pas de remplacement dans l’API Moderne
print(printer_settings)	Pas de remplacement dans l’API Moderne
print(printer_name)	Pas de remplacement dans l’API Moderne
print(printer_settings, pres_name)	Pas de remplacement dans l’API Moderne

Classe Slide

Signature de la méthode	Signature de la méthode de remplacement
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)	Pas de remplacement dans l’API Moderne
render_to_graphics(options, graphics, scale_x, scale_y)	Pas de remplacement dans l’API Moderne
render_to_graphics(options, graphics, rendering_size)	Pas de remplacement dans l’API Moderne

Classe Shape

Signature de la méthode	Signature de la méthode de remplacement
get_thumbnail()	get_image()
get_thumbnail(bounds, scale_x, scale_y)	get_image(bounds, scale_x, scale_y)

Classe ImageCollection

Signature de la méthode	Signature de la méthode de remplacement
add_image(image: aspose.pydrawing.Image)	add_image(image)

Classe PPImage

Signature de la méthode/propriété	Signature de la méthode/propriété de remplacement
replace_image(new_image: aspose.pydrawing.Image)	replace_image(new_image)
system_image	image

Classe ImageWrapperFactory

Signature de la méthode	Signature de la méthode de remplacement
create_image_wrapper(image: aspose.pydrawing.Image)	create_image_wrapper(image)

Classe PatternFormat

Signature de la méthode	Signature de la méthode de remplacement
get_tile_image(background, foreground)	get_tile(background, foreground)
get_tile_image(style_color)	get_tile(style_color)

Classe IPatternFormatEffectiveData

Signature de la méthode	Signature de la méthode de remplacement
get_tile_image(background, foreground)	get_tile_i_image(background, foreground)

Classe Output

Signature de la méthode	Signature de la méthode de remplacement
add(path, image: aspose.pydrawing.Image)	add(path, image)

Prise en charge de aspose.pydrawing.Graphics dans l’API

Les méthodes qui utilisent aspose.pydrawing.Graphics sont obsolètes et n’ont aucun remplacement direct dans l’API Moderne.

Utilisez les méthodes de rendu d’image de l’API Moderne à la place de l’API qui rend vers aspose.pydrawing.Graphics :

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)

FAQ

Pourquoi aspose.pydrawing.Graphics a-t-il été supprimé ?

La prise en charge de aspose.pydrawing.Graphics est obsolète dans l’API publique afin d’unifier le travail de rendu et d’images, d’éliminer les dépendances spécifiques à la plateforme et de passer à une approche multiplateforme avec IImage. Utilisez get_image ou get_images au lieu de rendre vers aspose.pydrawing.Graphics.

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

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

L’API Moderne affectera-t-elle les performances de génération de miniatures ?

Passer de get_thumbnail à get_image n’aggrave pas les scénarios : les nouvelles méthodes offrent les mêmes capacités de production d’images avec options et tailles, tout en conservant le support des options de rendu. Le gain ou la perte spécifiques dépendent du scénario, mais fonctionnellement les remplacements sont équivalents.

Articles techniques Problèmes connus