Завантаження файлів Web-Open-Font (WOFF) | .NET

Завантаження файлів Web-Open-Font (WOFF) за допомогою Aspose.Font для .NET

Те, що вам потрібно

Елемент	Опис	Де взяти
Aspose.Font для .NET	Основна бібліотека, яка читає, записує та конвертує файли шрифтів (включаючи WOFF/WOFF2).	dotnet додати пакет Aspose.Font або через інтерфейс користувача NuGet (https://www.nuget.org/packages/Aspose.Font).
Цільова платформа	.NETFramework4.x / .NETCore3.x / .NET5/6/7 – будь-яка платформа, що підтримується Aspose.Font.	Додаткове середовище виконання не потрібне.
Імпорт простору імен	csharp\nusing Aspose.Font;\nusing Aspose.Font.Sources;\nusing System.IO;\n

Порада: Вся документація API знаходиться за адресою https://reference.aspose.com/font/net/.

Завантаження файлу WOFF із файлової системи

Покрокова послідовність

1. Знайдіть файл шрифту (наприклад, C:\Fonts\MyWebFont.woff).
2. Створіть FileSystemStreamSource, який надає бібліотеці потік до цього файлу.
3. Оберніть джерело потоку у FontFileDefinition – укажіть розширення "woff" (бібліотека використовує це, щоб вибрати правильний аналізатор).
4. Створіть FontDefinition – передайте відповідний FontType (Woff) і FontFileDefinition.
5. Відкрийте шрифт за допомогою Font.Open() – ви отримаєте об’єкт, похідний від Aspose.Font.Font (наприклад, WoffFont).

using System;
using System.IO;
using Aspose.Font;
using Aspose.Font.Sources;

class LoadWoffExample
{
    static void Main()
    {
        // Path to the .woff file
        string woffPath = @"C:\Fonts\MyWebFont.woff";

        // Stream source that reads directly from the file system
        FileSystemStreamSource streamSrc = new FileSystemStreamSource(woffPath);

        // FontFileDefinition – we tell Aspose it is a “woff” file
        FontFileDefinition fileDef = new FontFileDefinition("woff", streamSrc);

        // FontDefinition – specify the font type (Woff)
        FontDefinition fontDef = new FontDefinition(FontType.WOFF, fileDef);

        // Load the font
        Font woffFont = Font.Open(fontDef);

        // woffFont now gives you access to glyphs, metrics, encoding, etc.
        Console.WriteLine($"Loaded font: {woffFont.GetType().Name}");
    }
}

Результат: woffFont є екземпляром Aspose.Font.Woff.WoffFont. Тепер можна рендерити текст, перевіряти метрики гліфів або конвертувати його в інший формат (TTF, SVG тощо).

Альтернативні способи завантаження шрифтів WOFF

Завантаження з байтового масиву (наприклад, коли шрифт вбудовано в ресурс або завантажено через HTTP)

byte[] woffBytes = File.ReadAllBytes(@"C:\Fonts\MyWebFont.woff");

// ByteContentStreamSource wraps the byte[] as a readable stream
ByteContentStreamSource byteSrc = new ByteContentStreamSource(woffBytes);

// Create definition – note we still supply "woff" as extension
FontDefinition fd = new FontDefinition(FontType.WOFF,
                                      "woff",
                                      byteSrc);

Font woffFont = Font.Open(fd);

Завантаження безпосередньо з потоку без проміжного FileDefinition

Якщо у вас уже є відкритий FileStream:

using (FileStream fs = File.OpenRead(@"C:\Fonts\MyWebFont.woff"))
{
    // Wrap the live FileStream in FileSystemStreamSource
    var streamSrc = new FileSystemStreamSource(fs);

    // Directly pass stream source + extension into FontDefinition
    var fd = new FontDefinition(FontType.WOFF, "woff", streamSrc);
    var woffFont = Font.Open(fd);
}

Обидва підходи використовують ті самі базові класи, змінюється лише джерело байтів (дисковий файл проти пам’яті чи спеціального потоку).

Після завантаження – що ще ви можете зробити?

• Виводити текст – використовувати підсистему Aspose.Font.Rendering або експортувати контури гліфів.
• Читати показники шрифту – напр. ((WoffFont)woffFont).Метрики.
• Перетворіть в інший формат – викличте font.Save("output.ttf"); після перетворення у відповідний підклас або за допомогою загального API.
• Підмножина / злиття – об’єднати кілька шрифтів в одну колекцію.
• Витягти інформацію про ліцензування – якщо є в заголовку WOFF.

Усе це продемонстровано в офіційному репозиторії прикладів:

📂 https://github.com/aspose-font/Aspose.Font-Documentation/tree/master/net-examples

Швидкий контрольний список (для сторінок документації)

• ✅ Додайте значок NuGet: [![NuGet](https://img.shields.io/nuget/v/Aspose.Font.svg)](https://www.nuget.org/packages/Aspose.Font/)
• ✅ Додайте зразок блоку коду (як показано вище) з належним виділенням синтаксису.
• ✅ Вкажіть таблицю підтримуваних розширень (копія з розділу 2 вище).
• ✅ Посилання на посилання на API для:
  • Aspose.Font.Font.Open
  • Aspose.Font.Sources.FileSystemStreamSource
  • Aspose.Font.Sources.ByteContentStreamSource
  • Aspose.Font.FontFileDefinition
  • Aspose.Font.FontDefinition
• ✅ Надайте посилання на «Дальше читання»:
  • Getting started: https://docs.aspose.com/font/net/getting-started/
  • Full API reference: https://reference.aspose.com/font/net/
  • Free online demo: https://products.aspose.app/font/conversion
• ✅ Додайте пораду щодо усунення несправностей: Якщо ви отримуєте повідомлення «Непідтримуваний формат шрифту», переконайтеся, що ви передали розширення FontType.WOFF і woff.