Carregando arquivos Web-Open-Font (WOFF) | .NET

Carregando arquivos Web-Open-Font (WOFF) com Aspose.Font para .NET

O que você precisa

Artigo	Descrição	Onde obter
Aspose.Font para .NET	Biblioteca principal que lê, escreve e converte ficheiros de fontes (incluindo WOFF/WOFF2).	dotnet add package Aspose.Font ou através da interface do NuGet (https://www.nuget.org/packages/Aspose.Font).
Framework de destino	.NETFramework4.x / .NETCore3.x / .NET5/6/7 – qualquer plataforma suportada pelo Aspose.Font.	Nenhum runtime adicional é necessário.
Importações de namespace	csharp\nusing Aspose.Font;\nusing Aspose.Font.Sources;\nusing System.IO;\n

Dica: Toda a documentação da API está em https://reference.aspose.com/font/net/.

Carregando um arquivo WOFF do sistema de arquivos

Passo a passo

1. Localize o arquivo da fonte (por exemplo, C:\Fonts\MyWebFont.woff).
2. Crie um FileSystemStreamSource que forneça à biblioteca um fluxo para esse arquivo.
3. Envolva a fonte do stream em um FontFileDefinition – especifique a extensão "woff" (a biblioteca usa isso para escolher o analisador correto).
4. Crie um FontDefinition – passe o FontType (Woff) e o FontFileDefinition apropriados.
5. Abra a fonte via Font.Open() – você obtém um objeto derivado de Aspose.Font.Font (por exemplo, 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}");
    }
}

Resultado: woffFont é uma instância de Aspose.Font.Woff.WoffFont. Agora pode renderizar texto, inspecionar as métricas dos glifos ou convertê-lo para outro formato (TTF, SVG, …).

Maneiras alternativas de carregar fontes WOFF

Carregando de uma matriz de bytes (por exemplo, quando a fonte está incorporada em um recurso ou baixada por 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);

Carregando diretamente de um stream sem um FileDefinition intermediário

Se você já tem um FileStream aberto:

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

Ambas as abordagens usam as mesmas classes subjacentes, apenas a origem dos bytes muda (arquivo de disco versus memória versus fluxo personalizado).

Após o carregamento – o que você pode fazer?

• Renderizar texto – use o subsistema Aspose.Font.Rendering ou exporte contornos de glifos.
• Leia as métricas de fonte – por exemplo. ((WoffFont)woffFont).Métricas.
• Converter para outro formato – chame font.Save("output.ttf"); após converter para a subclasse apropriada ou usar a API genérica.
• Subconjunto/mesclagem – combine várias fontes em uma coleção.
• Extraia informações de licenciamento – se presente no cabeçalho WOFF.

Tudo isso é demonstrado no repositório oficial de exemplos:

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

Lista de verificação rápida (para páginas de documentação)

• ✅ Adicione o emblema do NuGet: [![NuGet](https://img.shields.io/nuget/v/Aspose.Font.svg)](https://www.nuget.org/packages/Aspose.Font/)
• ✅ Inclui bloco de código de amostra (conforme mostrado acima) com destaque de sintaxe adequado.
• ✅ Mencione a tabela de extensões suportadas (cópia da seção 2 acima).
• ✅ Link para referência da API para:
  • Aspose.Font.Font.Open
  • Aspose.Font.Sources.FileSystemStreamSource
  • Aspose.Font.Sources.ByteContentStreamSource
  • Aspose.Font.FontFileDefinition
  • Aspose.Font.FontDefinition
• ✅ Forneça links de “leitura adicional”:
  • 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
• ✅ Adicione dica de solução de problemas: Se você receber “Formato de fonte não suportado”, verifique se você passou as extensões FontType.WOFF e woff.