Loading SVG fonts | .NET

使用 Aspose.Font for .NET 加载 SVG 字体

为什么选择 SVG 字体？

• 可伸缩矢量描述 – 每个字形由 XML <glyph> 元素定义（路径、变换、Unicode 映射）。
• Web 优先格式 – SVG 字体可以直接嵌入 HTML/CSS（@font-face），并且被大多数现代浏览器支持。
• 可编辑 – 由于数据是纯 XML，您可以在渲染或转换为其他格式（TTF/WOFF/OTF）之前，以编程方式微调字形轮廓或元数据。

Aspose.Font 提供了一个统一的 API，可加载任何受支持的字体类型（TTF、OTF、WOFF、WOFF2、SVG 等），并将其作为强类型的 Aspose.Font.Font 对象进行操作。

What you need

Item	Description	How to obtain
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>	—

Add the NuGet package

dotnet add package Aspose.Font

Core API Concepts

Class / Enum	Purpose
FontDefinition	描述 您 想要加载的内容（字体类型 + 来源）。
FontFileDefinition	将 流源（FileSystemStreamSource、ByteContentStreamSource 等）与 文件扩展名（"svg"）绑定在一起。
FileSystemStreamSource / ByteContentStreamSource	提供底层字节的可读流 —— 可以来自磁盘上的文件或内存缓冲区。
Font.Open(FontDefinition)	工厂方法，解析来源并返回具体的 Aspose.Font.Font 实现（SvgFont）。

唯一变化的只有 FontType 枚举值（Svg）以及文件扩展名字符串（"svg"）。

Loading an SVG font – three common scenarios

从文件系统加载

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 上传），则无需先将其写入磁盘——只需包装后直接打开。

所有这些场景都在官方示例仓库中演示：

结论

只需三行代码，您即可从磁盘、内存或任何自定义流中加载 SVG 字体，并立即获得对其字形路径、度量和转换功能的完整编程访问——这要归功于 Aspose.Font 的统一模型。如果需要将文本直接光栅化到图像或 PDF 上，可结合 Aspose.SVG 的渲染引擎，这就形成了在 .NET 中针对现代 Web 为中心的排版的完整流水线。