Chargement des polices SVG | .NET

Chargement des polices SVG avec Aspose.Font pour .NET

Pourquoi les polices SVG ?

• Description vectorielle évolutive – chaque glyphe est défini par un élément XML <glyph> (chemins, transformations, mappage Unicode).
• Format privilégié pour le Web – les polices SVG peuvent être intégrées directement dans HTML/CSS (@font-face) et sont prises en charge par la plupart des navigateurs modernes.
• Modifiable – comme les données sont du XML brut, vous pouvez ajuster programmatiquement les contours des glyphes ou les métadonnées avant le rendu ou la conversion vers un autre format (TTF/WOFF/OTF).

Aspose.Font fournit une API unique et unifiée pour charger tout type de police pris en charge (TTF, OTF, WOFF, WOFF2, SVG, …) et travailler avec elle sous la forme d’un objet fortement typé Aspose.Font.Font.

Ce dont vous avez besoin

Élément	Description	Comment l’obtenir
Aspose.Font for .NET	Bibliothèque principale qui lit/écrit tous les formats de police pris en charge (y compris SVG).	dotnet add package Aspose.Font ou via l’interface NuGet : https://www.nuget.org/packages/Aspose.Font/
Framework cible	.NET Framework 4.x / .NET Core 3.x / .NET 5/6/7 – toute plateforme prise en charge par Aspose.Font.	Aucun runtime supplémentaire requis.
Importations d’espaces de noms	csharp<br>using Aspose.Font;<br>using Aspose.Font.Sources;<br>using System.IO;<br>	—

Ajouter le package NuGet

dotnet add package Aspose.Font

Concepts clés de l’API

Classe / Enum	Objectif
FontDefinition	Définit ce que vous voulez charger (type de police + source).
FontFileDefinition	Associe une source de flux (FileSystemStreamSource, ByteContentStreamSource, etc.) à l’extension de fichier ("svg").
FileSystemStreamSource / ByteContentStreamSource	Fournissent un flux lisible des octets sous‑jacent – soit à partir d’un fichier disque, soit d’un tampon en mémoire.
Font.Open(FontDefinition)	Méthode usine qui analyse la source et renvoie une implémentation concrète Aspose.Font.Font (SvgFont).

La seule chose qui change entre les formats est la valeur de l’énumération FontType (Svg) et la chaîne d’extension de fichier ("svg").

Chargement d’une police SVG – trois scénarios courants

Chargement depuis le système de fichiers

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

class LoadSvgFromFile
{
    static void Main()
    {
        // 1️⃣ Chemin vers le fichier *.svg*
        string svgPath = @"C:\Fonts\MyWebFont.svg";

        // Vérifier que le fichier existe
        if (!File.Exists(svgPath))
            throw new FileNotFoundException($"SVG file not found: {svgPath}");

        // 2️⃣ Source de flux qui lit directement depuis le fichier
        FileSystemStreamSource streamSrc = new FileSystemStreamSource(svgPath);

        // 3️⃣ FontFileDefinition – on indique à Aspose que l'extension est "svg"
        FontFileDefinition fileDef = new FontFileDefinition("svg", streamSrc);

        // 4️⃣ FontDefinition – spécifier le type de police exact
        FontDefinition fontDef = new FontDefinition(FontType.Svg, fileDef);

        // 5️⃣ Charger la police
        Font svgFont = Font.Open(fontDef);

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

Résultat : svgFont est une instance de Aspose.Font.Svg.SvgFont. À partir de là vous pouvez interroger les glyphes, les métriques ou la convertir vers un autre format.

Chargement depuis un tableau d’octets

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

class LoadSvgFromBytes
{
    static void Main()
    {
        // Supposons que la police SVG ait été intégrée comme ressource embarquée
        byte[] svgBytes = File.ReadAllBytes(@"C:\Fonts\MyWebFont.svg");

        // Envelopper les octets bruts dans une source de flux
        ByteContentStreamSource byteSrc = new ByteContentStreamSource(svgBytes);

        // Construire la définition – l'extension doit toujours être “svg”
        FontDefinition fd = new FontDefinition(
            FontType.Svg,
            "svg",
            byteSrc);

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

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

Quand l’utiliser :

• La police est stockée dans votre assembly en tant que ressource.
• Vous avez téléchargé la police via HTTP et elle se trouve déjà en mémoire.

Chargement directement depuis un flux ouvert

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 source de flux peut être construite à partir de n’importe quel objet Stream
            FileSystemStreamSource src = new FileSystemStreamSource(fs);

            // Passer la source de flux + l'extension directement dans 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]}");
        }
    }
}

Pourquoi c’est important :
Si vous possédez déjà un Stream (par ex. à partir d’un upload ASP.NET), vous n’avez pas besoin de l’écrire d’abord sur le disque – il suffit de l’envelopper et de le charger.

Tous ces scénarios sont démontrés dans le dépôt officiel des exemples :

Conclusion

En à peine trois lignes de code, vous pouvez extraire une police SVG depuis le disque, la mémoire ou n’importe quel flux personnalisé et obtenir immédiatement un accès programmatique complet à ses chemins de glyphes, métriques et capacités de conversion—grâce au modèle unifié d’Aspose.Font. Combinez cela avec le moteur de rendu d’Aspose.SVG si vous devez rasteriser du texte directement sur une image ou un PDF, et vous disposez d’une chaîne complète pour la typographie moderne orientée Web en .NET.