SVG フォントの読み込み | .NET

Loading SVG Fonts with Aspose.Font for .NET

なぜ SVG フォントなのか？

• スケーラブルなベクタ記述 – 各グリフは XML の <glyph> 要素（パス、変換、Unicode マッピング）で定義されます。
• Web ファースト形式 – SVG フォントは HTML/CSS（@font-face）に直接埋め込むことができ、主要な最新ブラウザでサポートされています。
• 編集可能 – データがプレーンな XML であるため、レンダリングや別フォーマット（TTF/WOFF/OTF）への変換前にプログラムでグリフのアウトラインやメタデータを調整できます。

Aspose.Font は、TTF、OTF、WOFF、WOFF2、SVG など、すべてのサポートされているフォントタイプを読み込む単一の統一 API を提供し、Aspose.Font.Font オブジェクトとして扱えます。

必要なもの

項目	説明	取得方法
Aspose.Font for .NET	サポートされているすべてのフォント形式（SVG を含む）を読み書きするコア ライブラリです。	dotnet add package Aspose.Font or via the NuGet UI: https://www.nuget.org/packages/Aspose.Font/
Target framework	.NET Framework 4.x / .NET Core 3.x / .NET 5/6/7 – Aspose.Font がサポートする任意のプラットフォームです。	No extra runtime needed.
Namespace imports	csharp<br>using Aspose.Font;<br>using Aspose.Font.Sources;<br>using System.IO;<br>	—

NuGet パッケージの追加

dotnet add package Aspose.Font

Core API Concepts

クラス / 列挙型	目的
FontDefinition	読み込む対象（フォントタイプ + ソース）を記述します。
FontFileDefinition	ストリーム ソース（FileSystemStreamSource、ByteContentStreamSource など）と ファイル拡張子（"svg"）を結び付けます。
FileSystemStreamSource / ByteContentStreamSource	基礎バイトの読み取り可能なストリームを提供します – ディスク上のファイルまたはメモリ バッファからです。
Font.Open(FontDefinition)	ソースを解析し、具体的な Aspose.Font.Font 実装（SvgFont）を返すファクトリ メソッドです。

フォーマット間で変わる唯一の要素は、FontType 列挙値（Svg）とファイル拡張子文字列（"svg"）です。

SVG フォントの読み込み – 3 つの一般的シナリオ

ファイルシステムからの読み込み

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

結果: svgFont は Aspose.Font.Svg.SvgFont のインスタンスです。ここからグリフやメトリックを照会したり、別のフォーマットに変換したりできます。

バイト配列からの読み込み

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

使用シーン:

• フォントがアセンブリ内のリソースとして格納されている場合。
• HTTP でフォントをダウンロードし、メモリ上に保持している場合。

オープン ストリームから直接読み込み

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

重要性:
すでに Stream（例: ASP.NET のアップロード）を持っている場合、まずディスクに書き込む必要はなく、直接ラップして開くだけで済みます。

これらすべてのシナリオは公式サンプルリポジトリで実演されています：

結論

たった 3 行のコードで、ディスク、メモリ、または任意のカスタムストリームから SVG フォントを取得し、グリフパス、メトリック、変換機能への完全なプログラム的アクセスを即座に得られます—これは Aspose.Font の統一モデルのおかげです。テキストを画像や PDF に直接ラスタライズする必要がある場合は、Aspose.SVG のレンダリング エンジンと組み合わせることで、.NET におけるモダンな Web 中心のタイポグラフィ向けの完全なパイプラインが構築できます。