Aspose.HTML for .NET 24.10 – mejora de la calidad de renderizado

Aspose.HTML for .NET 24.10

En la versión 24.10, Aspose.HTML introdujo actualizaciones en la API pública, destinadas principalmente a mejorar el soporte para entornos Linux. Estas actualizaciones incluyen el reemplazo de varias enumeraciones de System.Drawing con implementaciones dentro de los espacios de nombres Aspose.Html.Drawing y Aspose.Html.Rendering.Image de Aspose:

• La enumeración del sistema FontStyle fue reemplazada por una WebFontStyle.
• La enumeración del sistema SmoothingMode se reemplazó con la propiedad ImageRenderingOptions.UseAntialiasing.
• La enumeración del sistema TextRenderingHint fue reemplazada por la propiedad TextOptions.UseHinting.

Estilo de fuente versus estilo de fuente web

En la versión 24.10, la enumeración FontStyle, que especifica estilos de fuente como regular, negrita y cursiva, ha sido reemplazada por la enumeración WebFontStyle:

Old	New
FontStyle.Bold	WebFontStyle.Bold
FontStyle.Italic	WebFontStyle.Italic
FontStyle.Regular	WebFontStyle.Regular

En consecuencia, en la clase GraphicContext, el tipo de propiedad FontStyle ha cambiado:

namespace Aspose.Html.Rendering
{
    public class GraphicContext
    { 
        //From:
        public virtual FontStyle FontStyle { get; set; }
 
        //To:
        public virtual WebFontStyle FontStyle { get; set; }
    }
}

SmoothingMode y TextRenderingHint vs UseAntialiasing y UseHinting

En la versión 24.10,

• la enumeración del sistema SmoothingMode, utilizada anteriormente para controlar la calidad del suavizado de formas e imágenes renderizadas, ha sido reemplazada por la propiedad ImageRenderingOptions.UseAntialiasing;
• la enumeración del sistema TextRenderingHint, que ayuda a controlar la calidad de la representación del texto, ahora ha sido reemplazada por la propiedad TextOptions.UseHinting. Esta propiedad mantiene la claridad y legibilidad del texto.

La siguiente tabla de correspondencia guía cómo se aplican las configuraciones de renderizado al migrar entre versiones antiguas y nuevas de Aspose.HTML for .NET.

Tabla de correspondencias para diferentes casos de representación

La tabla proporciona una guía clara, indicando cómo las configuraciones UseAntialiasing y UseHinting corresponden a propiedades más antiguas como SmoothingMode y TextRenderingHint:

UseAntialiasing	UseHinting	SmoothingMode	TextRenderingHint
true	true	SmoothingMode.AntiAlias	TextRenderingHint.AntiAliasGridFit
false	true	SmoothingMode.None	TextRenderingHint.SingleBitPerPixelGridFit
true	false	SmoothingMode.AntiAlias	TextRenderingHint.AntiAlias
false	false	SmoothingMode.None	TextRenderingHint.SingleBitPerPixel

Esta tabla muestra cómo convertir las configuraciones anteriores de suavizado y representación de texto a las nuevas propiedades UseAntialiasing y UseHinting. Así es como puede interpretar y aplicar esta tabla:

1. Cuando decida el nivel requerido de claridad del texto y representación de formas para su proyecto, haga coincidir la configuración anterior con las nuevas propiedades.
2. Reemplace los antiguos valores SmoothingMode y TextRenderingHint con las configuraciones correspondientes UseAntialiasing y UseHinting.

Por ejemplo, si su configuración anterior usaba SmoothingMode.AntiAlias y TextRenderingHint.AntiAliasGridFit, cambie a UseAntialiasing = true y UseHinting = true.

Este es el ejemplo que consideraremos a continuación.

Uso de enumeraciones SmoothingMode y TextRenderingHint: 24.9 y versiones anteriores

Este fragmento de código C# demuestra cómo renderizar contenido HTML en un archivo de imagen usando Aspose.HTML for .NET con dependencias antiguas de System.Drawing, configurando específicamente la salida para optimizar la calidad de renderizado con opciones de suavizado:

using System.IO;
using Aspose.Html;
using Aspose.Html.Rendering.Image;
using System.Drawing.Drawing2D;
using System.Drawing.Text;
...
    // Create an instance of the ImageRenderingOptions class to specify rendering quality
    var opt = new ImageRenderingOptions
    {
        SmoothingMode = SmoothingMode.AntiAlias,
        Text =
        {
            TextRenderingHint = TextRenderingHint.AntiAliasGridFit
        }
    };

    // Create an HTML Document
    using (var doc = new HTMLDocument("text", string.Empty))
    // Create an ImageDevice object
    using (var device = new ImageDevice(opt, "out-old.png"))
    {
        // Rendering HTML to image
        doc.RenderTo(device);
    }

Uso de las nuevas propiedades UseAntialiasing y UseHinting: desde la versión 24.10

El siguiente código demuestra la representación de contenido HTML en un archivo de imagen utilizando las nuevas propiedades UseAntialiasing y UseHinting. Este ejemplo es igual que el ejemplo anterior, donde se utilizaron las enumeraciones del sistema SmoothingMode y TextRenderingHint:

using System.IO;
using Aspose.Html;
using Aspose.Html.Rendering.Image;
...
    // Create an instance of the ImageRenderingOptions class
    var opt = new ImageRenderingOptions
    {
        UseAntialiasing = true,
        Text =
        {
            UseHinting = true
        }
    };

    // Create an HTML Document
    using (var doc = new HTMLDocument("text", string.Empty))
    // Create an ImageDevice object
    using (var device = new ImageDevice(opt, "out-new.png"))
    {
        // Rendering HTML to image
        doc.RenderTo(device);
    }

Conclusiones

• La migración a las propiedades WebFontStyle, UseAntialiasing y UseHinting en Aspose.HTML for .NET 24.10 representa un paso adelante en el soporte de entornos Linux.
• Se han cambiado los valores base de las propiedades UseAntialiasing y UseHinting, lo que da como resultado una mejor representación del texto cuando se usan las opciones predeterminadas.
• Como parte del paso al soporte de Linux, esta migración también tiene como objetivo unificar la API pública para simplificar el acceso a las diferentes versiones de la biblioteca Aspose.HTML for .NET que admiten diferentes motores de renderizado HTML.

Por lo tanto, los cambios de API implementados en la versión 24.10 afectan en gran medida la calidad de la visualización de texto e imágenes, facilitan a los usuarios cambiar entre diferentes versiones de las bibliotecas Aspose.HTML for .NET que admiten diferentes motores de renderizado HTML y son pasos adelante. en soporte de Linux.

Notas de la versión de Aspose.HTML for .NET 24.10: esta versión incluye cambios en la API pública relacionados con la mejora del soporte de Linux, la calidad de la representación y la corrección de errores para mejorar el rendimiento y la estabilidad general de la biblioteca.