Caricamento di font SVG | .NET

Caricamento di font SVG con Aspose.Font per .NET

Perché i font SVG?

• Scalabile descrizione vettoriale – ogni glifo è definito da un elemento XML <glyph> (percorsi, trasformazioni, mappatura Unicode).
• Formato web‑first – i font SVG possono essere incorporati direttamente in HTML/CSS (@font-face) e sono supportati dalla maggior parte dei browser moderni.
• Modificabile – poiché i dati sono XML puro è possibile modificare programmaticamente i contorni dei glifi o i metadati prima del rendering o della conversione in un altro formato (TTF/WOFF/OTF).

Aspose.Font fornisce un’API unica e unificata per caricare qualsiasi tipo di font supportato (TTF, OTF, WOFF, WOFF2, SVG, …) e lavorarci come oggetto tipizzato Aspose.Font.Font.

Cosa serve

Voce	Descrizione	Come ottenerla
Aspose.Font per .NET	Libreria core che legge/scrive tutti i formati di font supportati (incluso SVG).	dotnet add package Aspose.Font o tramite l’interfaccia NuGet: https://www.nuget.org/packages/Aspose.Font/
Framework di destinazione	.NET Framework 4.x / .NET Core 3.x / .NET 5/6/7 – qualsiasi piattaforma supportata da Aspose.Font.	Non è necessario alcun runtime aggiuntivo.
Importazioni di namespace	csharp<br>using Aspose.Font;<br>using Aspose.Font.Sources;<br>using System.IO;<br>	—

Aggiungi il pacchetto NuGet

dotnet add package Aspose.Font

Concetti chiave dell’API

Classe / Enum	Scopo
FontDefinition	Descrive cosa vuoi caricare (tipo di font + origine).
FontFileDefinition	Associa una fonte stream (FileSystemStreamSource, ByteContentStreamSource, ecc.) con l’estensione del file ("svg").
FileSystemStreamSource / ByteContentStreamSource	Fornisce uno stream leggibile dei byte sottostanti – sia da un file su disco sia da un buffer in memoria.
Font.Open(FontDefinition)	Metodo factory che analizza l’origine e restituisce un’implementazione concreta Aspose.Font.Font (SvgFont).

L’unica cosa che cambia tra i formati è il valore dell’enumerazione FontType (Svg) e la stringa dell’estensione file ("svg").

Caricamento di un font SVG – tre scenari comuni

Caricamento dal file system

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

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

        // Verifica che il file esista
        if (!File.Exists(svgPath))
            throw new FileNotFoundException($"SVG file not found: {svgPath}");

        // 2️⃣ Fonte stream che legge direttamente dal file
        FileSystemStreamSource streamSrc = new FileSystemStreamSource(svgPath);

        // 3️⃣ FontFileDefinition – indichiamo ad Aspose che l'estensione è "svg"
        FontFileDefinition fileDef = new FontFileDefinition("svg", streamSrc);

        // 4️⃣ FontDefinition – specifica il tipo di font esatto
        FontDefinition fontDef = new FontDefinition(FontType.Svg, fileDef);

        // 5️⃣ Carica il font
        Font svgFont = Font.Open(fontDef);

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

Risultato: svgFont è un’istanza di Aspose.Font.Svg.SvgFont. Da qui puoi interrogare i glifi, le metriche o convertirlo in un altro formato.

Caricamento da un array di byte

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

class LoadSvgFromBytes
{
    static void Main()
    {
        // Supponiamo che il font SVG sia incluso come risorsa incorporata
        byte[] svgBytes = File.ReadAllBytes(@"C:\Fonts\MyWebFont.svg");

        // Avvolge i byte grezzi in una fonte stream
        ByteContentStreamSource byteSrc = new ByteContentStreamSource(svgBytes);

        // Costruisci la definizione – l'estensione deve ancora essere “svg”
        FontDefinition fd = new FontDefinition(
            FontType.Svg,
            "svg",
            byteSrc);

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

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

Quando usarlo:

• Il font è memorizzato all’interno del tuo assembly come risorsa.
• Hai scaricato il font via HTTP e lo hai già in memoria.

Caricamento direttamente da uno stream aperto

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 fonte stream può essere costruita da qualsiasi oggetto Stream
            FileSystemStreamSource src = new FileSystemStreamSource(fs);

            // Passa fonte stream + estensione direttamente 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]}");
        }
    }
}

Perché è importante:
Se possiedi già uno Stream (ad esempio da un upload ASP.NET) non è necessario scriverlo su disco prima – basta avvolgerlo e aprirlo.

Tutti questi scenari sono dimostrati nel repository ufficiale degli esempi:

Conclusione

Con sole tre righe di codice puoi prelevare un font SVG dal disco, dalla memoria o da qualsiasi stream personalizzato e ottenere immediatamente accesso completo programmatico ai percorsi dei glifi, alle metriche e alle capacità di conversione—grazie al modello unificato di Aspose.Font. Combinalo con il motore di rendering di Aspose.SVG se devi rasterizzare testo direttamente su un’immagine o PDF, e avrai una pipeline completa per tipografia web‑centrica moderna in .NET.