Cargando fuentes SVG | .NET

Cargando fuentes SVG con Aspose.Font para .NET

Por qué fuentes SVG?

• Descripción vectorial escalable – cada glifo se define mediante un elemento XML <glyph> (caminos, transformaciones, asignación Unicode).
• Formato orientado a la web – las fuentes SVG pueden incrustarse directamente en HTML/CSS (@font-face) y son compatibles con la mayoría de los navegadores modernos.
• Editable – como los datos son XML puro, puede ajustar programáticamente los contornos de los glifos o los metadatos antes de renderizar o convertir a otro formato (TTF/WOFF/OTF).

Aspose.Font proporciona una API única y unificada para cargar cualquier tipo de fuente compatible (TTF, OTF, WOFF, WOFF2, SVG, …) y trabajar con ella como un objeto fuertemente tipado Aspose.Font.Font.

Qué se necesita

Elemento	Descripción	Cómo obtener
Aspose.Font for .NET	Biblioteca central que lee/escribe todos los formatos de fuente compatibles (incluido SVG).	dotnet add package Aspose.Font o mediante la UI de NuGet: https://www.nuget.org/packages/Aspose.Font/
Target framework	.NET Framework 4.x / .NET Core 3.x / .NET 5/6/7 – cualquier plataforma compatible con Aspose.Font.	No se necesita tiempo de ejecución adicional.
Importaciones de espacio de nombres	csharp<br>using Aspose.Font;<br>using Aspose.Font.Sources;<br>using System.IO;<br>	—

Añadir el paquete NuGet

dotnet add package Aspose.Font

Conceptos clave de la API

Clase / Enumeración	Propósito
FontDefinition	Describe qué se quiere cargar (tipo de fuente + origen).
FontFileDefinition	Asocia una fuente de flujo (FileSystemStreamSource, ByteContentStreamSource, etc.) con la extensión de archivo ("svg").
FileSystemStreamSource / ByteContentStreamSource	Proporciona un flujo legible de los bytes subyacentes – ya sea desde un archivo en disco o desde un búfer en memoria.
Font.Open(FontDefinition)	Método de fábrica que analiza el origen y devuelve una implementación concreta de Aspose.Font.Font (SvgFont).

Lo único que cambia entre formatos es el valor del enum FontType (Svg) y la cadena de extensión de archivo ("svg").

Cargando una fuente SVG – tres escenarios comunes

Cargando desde el sistema de archivos

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

class LoadSvgFromFile
{
    static void Main()
    {
        // 1️⃣ Ruta al archivo *.svg*
        string svgPath = @"C:\Fonts\MyWebFont.svg";

        // Verificar que el archivo exista
        if (!File.Exists(svgPath))
            throw new FileNotFoundException($"SVG file not found: {svgPath}");

        // 2️⃣ Fuente de flujo que lee directamente del archivo
        FileSystemStreamSource streamSrc = new FileSystemStreamSource(svgPath);

        // 3️⃣ FontFileDefinition – indicamos a Aspose que la extensión es "svg"
        FontFileDefinition fileDef = new FontFileDefinition("svg", streamSrc);

        // 4️⃣ FontDefinition – especificamos el tipo exacto de fuente
        FontDefinition fontDef = new FontDefinition(FontType.Svg, fileDef);

        // 5️⃣ Cargar la fuente
        Font svgFont = Font.Open(fontDef);

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

Resultado: svgFont es una instancia de Aspose.Font.Svg.SvgFont. Desde aquí puede consultar glifos, métricas o convertirla a otro formato.

Cargando desde una matriz de bytes

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

class LoadSvgFromBytes
{
    static void Main()
    {
        // Supongamos que la fuente SVG se incluyó como recurso incrustado
        byte[] svgBytes = File.ReadAllBytes(@"C:\Fonts\MyWebFont.svg");

        // Envolver los bytes sin procesar en una fuente de flujo
        ByteContentStreamSource byteSrc = new ByteContentStreamSource(svgBytes);

        // Construir la definición – la extensión sigue siendo “svg”
        FontDefinition fd = new FontDefinition(
            FontType.Svg,
            "svg",
            byteSrc);

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

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

Cuándo usar:

• La fuente se almacena dentro de su ensamblado como recurso.
• Ha descargado la fuente vía HTTP y ya la tiene en memoria.

Cargando directamente desde un flujo abierto

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"))
        {
            // La fuente de flujo puede construirse a partir de cualquier objeto Stream
            FileSystemStreamSource src = new FileSystemStreamSource(fs);

            // Pasar la fuente de flujo + extensión directamente a 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 qué es importante:
Si ya posee un Stream (por ejemplo, desde una carga en ASP.NET) no necesita escribirlo en disco primero – simplemente envuélvalo y ábralo.

Todos estos escenarios se demuestran en el repositorio oficial de ejemplos:

Conclusión

Con solo tres líneas de código puede obtener una fuente SVG desde disco, memoria o cualquier flujo personalizado y obtener de inmediato acceso programático completo a sus rutas de glifos, métricas y capacidades de conversión—gracias al modelo unificado de Aspose.Font. Combínelo con el motor de renderizado de Aspose.SVG si necesita rasterizar texto directamente en una imagen o PDF, y tendrá una canalización completa para tipografía web‑centrada moderna en .NET.