Mejorar el procesamiento de imágenes con la API moderna
Introducción
Históricamente, Aspose Slides tiene una dependencia de System.Drawing y en la API pública incluye las siguientes clases de ese espacio:
A partir de la versión 24.4, esta API pública se declara obsoleta.
Dado que el soporte de System.Drawing en versiones .NET6 y superiores se elimina para versiones no Windows (cambio importante), Slides ha implementado un enfoque de dos versiones de biblioteca:
- Aspose.Slides.NET - soporte para .NET6+ en Windows, .NETStandard para Windows/Linux/macOS, .NETFramework 2+ (Windows).
- depende de System.Drawing.Common.
- Aspose.Slides.NET6.CrossPlatform - versión Windows/Linux/macOS sin dependencias.
El inconveniente de Aspose.Slides.NET6.CrossPlatform es que implementa su propia versión de System.Drawing en el mismo espacio de nombres (para mantener la compatibilidad con la API pública). Por lo tanto, cuando Aspose.Slides.NET6.CrossPlatform y System.Drawing de .NETFramework o el paquete System.Drawing.Common se usan simultáneamente, ocurre un conflicto de nombres a menos que se utilice un alias.
Para eliminar las dependencias de System.Drawing en el paquete principal Aspose.Slides.NET, añadimos la llamada “API moderna”, es decir, la API que debe usarse en lugar de la obsoleta, cuyas firmas contienen dependencias de los siguientes tipos de System.Drawing: Image y Bitmap. PrinterSettings y Graphics se declaran obsoletos y su soporte se elimina de la API pública de Slides.
La eliminación de la API pública obsoleta con dependencias de System.Drawing será en la versión 24.8.
API moderna
Se añadieron las siguientes clases y enumeraciones a la API pública:
- Aspose.Slides.IImage – representa la imagen raster o vectorial.
- Aspose.Slides.ImageFormat – representa el formato de archivo de la imagen.
- Aspose.Slides.Images – métodos para instanciar y trabajar con la interfaz IImage.
Tenga en cuenta que IImage es descartable (implementa la interfaz IDisposable y su uso debe envolver en using o disponer de otro modo conveniente).
Un escenario típico de uso de la nueva API puede verse así:
using (Presentation pres = new Presentation())
{
IPPImage ppImage;
// instanciar una instancia descartable de IImage desde el archivo en el disco.
using (IImage image = Images.FromFile("image.png"))
{
// crear una imagen de PowerPoint añadiendo una instancia de IImage a las imágenes de la presentación.
ppImage = pres.Images.AddImage(image);
}
// agregar una forma de imagen en la diapositiva #1
pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
// obtener una instancia de IImage que representa la diapositiva #1.
using (var slideImage = pres.Slides[0].GetImage(new Size(1920, 1080)))
{
// guardar la imagen en el disco.
slideImage.Save("slide1.jpeg", ImageFormat.Jpeg);
}
}
Reemplazo de código antiguo con la API moderna
Para facilitar la transición, la interfaz de la nueva IImage repite las firmas separadas de las clases Image y Bitmap. En general, solo necesitará reemplazar la llamada al método antiguo que usa System.Drawing por el nuevo.
Obtención de una miniatura de diapositiva
Código que usa una API obsoleta:
using (Presentation pres = new Presentation("pres.pptx"))
{
pres.Slides[0].GetThumbnail().Save("slide1.png");
}
API moderna:
using (Presentation pres = new Presentation("pres.pptx"))
{
pres.Slides[0].GetImage().Save("slide1.png");
}
Obtención de una miniatura de forma
Código que usa una API obsoleta:
using (Presentation pres = new Presentation("pres.pptx"))
{
pres.Slides[0].Shapes[0].GetThumbnail().Save("shape.png");
}
API moderna:
using (Presentation pres = new Presentation("pres.pptx"))
{
pres.Slides[0].Shapes[0].GetImage().Save("shape.png");
}
Obtención de una miniatura de presentación
Código que usa una API obsoleta:
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 moderna:
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();
}
}
}
Añadir una imagen a una presentación
Código que usa una API obsoleta:
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 moderna:
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étodos/Propiedades que se eliminarán y su reemplazo en la API moderna
Presentation
| Firma del método | Firma del método de reemplazo |
|---|---|
| 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) | Se eliminará completamente |
| public void Save(string fname, SaveFormat format, ISaveOptions options, HttpResponse response, bool showInline) | Se eliminará completamente |
| public void Print() | Se eliminará completamente |
| public void Print(PrinterSettings printerSettings) | Se eliminará completamente |
| public void Print(string printerName) | Se eliminará completamente |
| public void Print(PrinterSettings printerSettings, string presName) | Se eliminará completamente |
Shape
| Firma del método | Firma del método de reemplazo |
|---|---|
| public Bitmap GetThumbnail() | GetImage |
| public Bitmap GetThumbnail(ShapeThumbnailBounds bounds, float scaleX, float scaleY) | GetImage(ShapeThumbnailBounds bounds, float scaleX, float scaleY) |
Slide
| Firma del método | Firma del método de reemplazo |
|---|---|
| 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) | Se eliminará completamente |
| public void RenderToGraphics(IRenderingOptions options, Graphics graphics, float scaleX, float scaleY) | Se eliminará completamente |
| public void RenderToGraphics(IRenderingOptions options, Graphics graphics, Size renderingSize) | Se eliminará completamente |
Output
| Firma del método | Firma del método de reemplazo |
|---|---|
| public IOutputFile Add(string path, Image image) | Add(string path, IImage image) |
ImageCollection
| Firma del método | Firma del método de reemplazo |
|---|---|
| IPPImage AddImage(Image image) | AddImage(IImage image) |
ImageWrapperFactory
| Firma del método | Firma del método de reemplazo |
|---|---|
| IImageWrapper CreateImageWrapper(Image image) | CreateImageWrapper(IImage image) |
PPImage
| Firma del método/propiedad | Firma del método de reemplazo |
|---|---|
| void ReplaceImage(Image newImage) | ReplaceImage(IImage newImage) |
| Image SystemImage { get; } | IImage Image { get; } |
PatternFormat
| Firma del método | Firma del método de reemplazo |
|---|---|
| Bitmap GetTileImage(Color background, Color foreground) | GetTile(Color background, Color foreground) |
| Bitmap GetTileImage(Color styleColor) | GetTile(Color styleColor) |
IPatternFormatEffectiveData
| Firma del método | Firma del método de reemplazo |
|---|---|
| Bitmap GetTileImage(Color background, Color foreground) | GetTileIImage(SlidesImage image) |
El soporte de Graphics y PrinterSettings dejará de estar disponible
La clase Graphics no está soportada en versiones multiplataforma de .NET6 y superiores. En Aspose Slides, la parte de la API que la utiliza será eliminada: Slide
- 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)
También se eliminará la parte de la API relacionada con la impresión:
- public void Presentation.Print
- public void Print(PrinterSettings printerSettings)
- public void Print(string printerName)
- public void Print(PrinterSettings printerSettings, string presName)
Preguntas frecuentes
¿Por qué se eliminó System.Drawing.Graphics?
El soporte para Graphics se elimina de la API pública para unificar el trabajo con renderizado e imágenes, eliminar dependencias específicas de plataforma y pasar a un enfoque multiplataforma con IImage. Todos los métodos de renderizado a Graphics serán eliminados.
¿Cuál es el beneficio práctico de IImage frente a Image/Bitmap?
IImage unifica el trabajo con imágenes raster y vectoriales, simplifica el guardado en diversos formatos mediante ImageFormat, reduce la dependencia de System.Drawing y hace que el código sea más portátil entre entornos.
¿Afectará la API moderna al rendimiento de generación de miniaturas?
Cambiar de GetThumbnail a GetImage no empeora los escenarios: los nuevos métodos brindan las mismas capacidades para producir imágenes con opciones y tamaños, manteniendo el soporte para opciones de renderizado. La ganancia o pérdida específica depende del caso, pero funcionalmente los reemplazos son equivalentes.