Carregando fontes SVG | .NET

Carregando fontes SVG com Aspose.Font para .NET

Por que fontes SVG?

• Descrição vetorial escalável – cada glifo é definido por um elemento XML <glyph> (caminhos, transformações, mapeamento Unicode).
• Formato web‑first – fontes SVG podem ser incorporadas diretamente em HTML/CSS (@font-face) e são suportadas pela maioria dos navegadores modernos.
• Editável – como os dados são XML puro, pode ajustar programaticamente contornos de glifos ou metadados antes de renderizar ou converter para outro formato (TTF/WOFF/OTF).

Aspose.Font fornece uma API única e unificada para carregar qualquer tipo de fonte suportado (TTF, OTF, WOFF, WOFF2, SVG, …) e trabalhá‑la como um objeto Aspose.Font.Font fortemente tipado.

O que você precisa

Item	Descrição	Como obter
Aspose.Font for .NET	Biblioteca principal que lê/escreve todos os formatos de fonte suportados (incluindo SVG).	dotnet add package Aspose.Font ou via a UI do NuGet: https://www.nuget.org/packages/Aspose.Font/
Target framework	.NET Framework 4.x / .NET Core 3.x / .NET 5/6/7 – qualquer plataforma suportada pelo Aspose.Font.	Não é necessário runtime adicional.
Namespace imports	csharp<br>using Aspose.Font;<br>using Aspose.Font.Sources;<br>using System.IO;<br>	—

Adicionar o pacote NuGet

dotnet add package Aspose.Font

Conceitos principais da API

Classe / Enum	Propósito
FontDefinition	Descreve o que você deseja carregar (tipo de fonte + origem).
FontFileDefinition	Associa uma fonte de fluxo (FileSystemStreamSource, ByteContentStreamSource, etc.) ao extensão de arquivo ("svg").
FileSystemStreamSource / ByteContentStreamSource	Fornece um fluxo legível dos bytes subjacentes – seja a partir de um arquivo no disco ou de um buffer em memória.
Font.Open(FontDefinition)	Método de fábrica que analisa a origem e devolve uma implementação concreta de Aspose.Font.Font (SvgFont).

A única coisa que muda entre os formatos é o valor enum FontType (Svg) e a string da extensão do arquivo ("svg").

Carregando uma fonte SVG – três cenários comuns

Carregando a partir do sistema de arquivos

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

class LoadSvgFromFile
{
    static void Main()
    {
        // 1️⃣ Path to the *.svg* file
        string svgPath = @"C:\Fonts\MyWebFont.svg";

        // Verify the file exists
        if (!File.Exists(svgPath))
            throw new FileNotFoundException($"SVG file not found: {svgPath}");

        // 2️⃣ Stream source that reads directly from the file
        FileSystemStreamSource streamSrc = new FileSystemStreamSource(svgPath);

        // 3️⃣ FontFileDefinition – we tell Aspose the extension is "svg"
        FontFileDefinition fileDef = new FontFileDefinition("svg", streamSrc);

        // 4️⃣ FontDefinition – specify the exact font type
        FontDefinition fontDef = new FontDefinition(FontType.Svg, fileDef);

        // 5️⃣ Load the font
        Font svgFont = Font.Open(fontDef);

        Console.WriteLine($"Loaded font: {svgFont.GetType().Name}");   // → SvgFont
    }
}

Resultado: svgFont é uma instância de Aspose.Font.Svg.SvgFont. A partir daqui pode consultar glifos, métricas ou convertê‑la para outro formato.

Carregando a partir de um array de bytes

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

class LoadSvgFromBytes
{
    static void Main()
    {
        // Assume the SVG font was bundled as an embedded resource
        byte[] svgBytes = File.ReadAllBytes(@"C:\Fonts\MyWebFont.svg");

        // Wrap the raw bytes into a stream source
        ByteContentStreamSource byteSrc = new ByteContentStreamSource(svgBytes);

        // Build the definition – extension still must be “svg”
        FontDefinition fd = new FontDefinition(
            FontType.Svg,
            "svg",
            byteSrc);

        // Load
        Font svgFont = Font.Open(fd);

        Console.WriteLine($"Glyph count: {((Aspose.Font.Svg.SvgFont)svgFont).Glyphs.Count}");
    }
}

Quando usar:

• A fonte está armazenada dentro do seu assembly como um recurso.
• Você baixou a fonte via HTTP e já a tem na memória.

Carregando diretamente de um fluxo aberto

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

class LoadSvgFromOpenStream
{
    static void Main()
    {
        using (FileStream fs = File.OpenRead(@"C:\Fonts\MyWebFont.svg"))
        {
            // The stream source can be constructed from any Stream object
            FileSystemStreamSource src = new FileSystemStreamSource(fs);

            // Pass stream source + extension straight into FontDefinition
            FontDefinition fd = new FontDefinition(
                FontType.Svg,
                "svg",
                src);

            Font svgFont = Font.Open(fd);
            Console.WriteLine($"Family name: {((Aspose.Font.Svg.SvgFont)svgFont).FamilyNames[0]}");
        }
    }
}

Por que isso importa:
Se já possui um Stream (por exemplo, de um upload ASP.NET) não precisa gravá‑lo no disco primeiro – basta encapsulá‑lo e abrir.

Todos esses cenários são demonstrados no repositório oficial de exemplos:

Conclusão

Com apenas três linhas de código, pode obter uma fonte SVG a partir de disco, memória ou qualquer fluxo personalizado e obter instantaneamente acesso programático completo aos seus caminhos de glifos, métricas e capacidades de conversão — graças ao modelo unificado do Aspose.Font. Combine isso com o engine de renderização do Aspose.SVG se precisar rasterizar texto diretamente numa imagem ou PDF, e tem um pipeline completo para tipografia moderna centrada na web em .NET.