Aspose.HTML for .NET 24.10 – Улучшение качества рендеринга

Aspose.HTML for .NET 24.10

В версии 24.10 Aspose.HTML представил обновления общедоступного API, направленные в первую очередь на улучшение поддержки сред Linux. Эти обновления включают замену нескольких перечислений из System.Drawing реализациями в собственных пространствах имен Aspose.Html.Drawing и Aspose.Html.Rendering.Image:

• Системное перечисление FontStyle заменено на WebFontStyle.
• Системное перечисление SmoothingMode заменено свойством ImageRenderingOptions.UseAntialiasing.
• Системное перечисление TextRenderingHint заменено свойством TextOptions.UseHinting.

FontStyle против WebFontStyle

В версии 24.10 перечисление FontStyle, определяющее такие стили шрифта, как обычный, полужирный и курсив, было заменено перечислением WebFontStyle:

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

Соответственно, в классе GraphicContext изменился тип свойства FontStyle:

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

SmoothingMode и TextRenderingHint против UseAntialiasing и UseHinting

В версии 24.10

• системное перечисление SmoothingMode, ранее использовавшееся для управления качеством сглаживания визуализируемых фигур и изображений, заменено свойством ImageRenderingOptions.UseAntialiasing;
• системное перечисление TextRenderingHint, помогающее контролировать качество отрисовки текста, теперь заменено свойством TextOptions.UseHinting. Это свойство обеспечивает четкость и читаемость текста.

В таблице соответствия ниже показано, как применяются настройки рендеринга при переходе между старой и новой версиями Aspose.HTML for .NET.

Таблица соответствия для разных случаев рендеринга

В таблице представлены четкие инструкции, показывающие, как настройки UseAntialiasing и UseHinting соответствуют старым свойствам, таким как SmoothingMode и 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

В этой таблице показано, как преобразовать предыдущие настройки сглаживания и рендеринга текста в новые свойства UseAntialiasing и UseHinting. Вот как можно интерпретировать и применять эту таблицу:

1. Когда вы определитесь с необходимым уровнем четкости текста и прорисовки форм для вашего проекта, сопоставьте предыдущие настройки с новыми свойствами.
2. Замените старые значения SmoothingMode и TextRenderingHint соответствующими настройками UseAntialiasing и UseHinting.

Например, если в вашей предыдущей конфигурации использовались SmoothingMode.AntiAlias ​​и TextRenderingHint.AntiAliasGridFit, переключитесь на UseAntialiasing = true и UseHinting = true.

Именно этот пример мы рассмотрим ниже.

Использование перечислений SmoothingMode и TextRenderingHint – 24.9 и более ранние версии

Этот фрагмент кода C# демонстрирует, как визуализировать содержимое HTML в файл изображения с помощью Aspose.HTML for .NET со старыми зависимостями System.Drawing, специально настраивая вывод для оптимизации качества рендеринга с помощью параметров сглаживания:

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

Использование новых свойств UseAntialiasing и UseHinting – начиная с версии 24.10.

Следующий код демонстрирует рендеринг содержимого HTML в файл изображения с использованием новых свойств UseAntialiasing и UseHinting. Этот пример аналогичен предыдущему, где использовались системные перечисления SmoothingMode и 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);
    }

Выводы

• Переход к перечислению WebFontStyle, свойствам UseAntialiasing и UseHinting в Aspose.HTML for .NET 24.10 представляет собой шаг вперед в поддержке сред Linux.
• Базовые значения свойств UseAntialiasing и UseHinting были изменены, что привело к улучшению рендеринга текста при использовании параметров по умолчанию.
• В рамках перехода на поддержку Linux эта миграция также направлена на унификацию общедоступного API для упрощения доступа к различным версиям библиотеки Aspose.HTML for .NET, которые поддерживают различные механизмы рендеринга HTML.

Таким образом, изменения API, реализованные в версии 24.10, существенно влияют на качество отображения текста и изображений, упрощают пользователям переключение между различными версиями библиотек Aspose.HTML for .NET, поддерживающих разные механизмы рендеринга HTML, и являются шагами вперед в поддержке Linux.

Примечания к выпуску Aspose.HTML for .NET 24.10 – этот выпуск включает изменения в общедоступный API, связанные с улучшением поддержки Linux, качеством рендеринга и исправлением ошибок для повышения общей производительности и стабильности библиотеки.