Aspose.SVG for .NET 25.1 – унифицированный API и улучшенное качество рендеринга

Aspose.SVG for .NET 25.1

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

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

FontStyle Vs WebFontStyle

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

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

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

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

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

В версии 25.1,

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

В приведенной ниже таблице соответствия указано, как применяются настройки рендеринга при переходе между старой и новой версиями Aspose.SVG 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.12 и более ранние версии

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

using System.IO;
using Aspose.Svg;
using Aspose.Svg.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
        }
    };
    // Initialize an SVG Document
    using (var doc = new SVGDocument("source.svg"))
    // Create an ImageDevice object
    using (var device = new ImageDevice(options, "out-old.png"))
    {
        // Rendering SVG to image
        doc.RenderTo(device);
    }

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

Следующий код демонстрирует рендеринг SVG-контента в файл изображения с использованием новых свойств UseAntialiasing и UseHinting. Этот пример аналогичен предыдущему, где использовались системные перечисления SmoothingMode и TextRenderingHint:

using System.IO;
using Aspose.Svg;
using Aspose.Svg.Rendering.Image;
...
    // Create an instance of the ImageRenderingOptions class
    var options = new ImageRenderingOptions
    {
        UseAntialiasing = true,
        Text =
        {
            UseHinting = true
        }
    };
    // Initialize an SVG Document
    using (var doc = new SVGDocument("source.svg"))
    // Create an ImageDevice object
    using (var device = new ImageDevice(options, "out-new.png"))
    {
        // Rendering SVG to image
        doc.RenderTo(device);
    }

Выводы

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

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

Aspose.SVG for .NET 25.1 Release Notes – Этот выпуск включает изменения в публичном API, связанные с улучшением качества рендеринга, и исправление ошибок для повышения общей производительности и стабильности библиотеки.