FreeType 介绍及 C# 示例

news2025/1/18 18:14:16

FreeType 是一个开源的字体渲染引擎，用于将字体文件（如 TrueType、OpenType、Type 1 等）转换为位图或矢量图形。它广泛应用于操作系统、图形库、游戏引擎等领域，支持高质量的字体渲染和复杂的文本布局。

FreeType 的核心功能

字体加载
- 支持多种字体格式，包括 TrueType (TTF)、OpenType (OTF)、Type 1、CID、CFF 等。
- 可以从文件或内存中加载字体。
字形渲染
- 将字符（Glyph）渲染为位图或矢量图形。
- 支持抗锯齿（Anti-aliasing）和子像素渲染，提高渲染质量。
字体度量
- 提供字体的度量信息，如字符宽度、高度、基线、字间距等。
- 支持复杂的文本布局（如双向文本、垂直文本）。
跨平台
- 支持 Windows、Linux、macOS 等操作系统。
- 提供 C 语言接口，易于集成到其他编程语言中。
高性能
- 优化的渲染算法，适合实时渲染场景（如游戏、图形界面）。

FreeType 的基本概念

Face
- 表示一个字体文件，包含字体的所有信息（如字形、度量、编码等）。
Glyph
- 表示一个字符的形状，可以是位图或矢量图形。
Library
- FreeType 的核心对象，用于管理字体加载和渲染。
Metrics
- 字体的度量信息，包括字符宽度、高度、基线等。

C# 中使用 FreeType

在 C# 中使用 FreeType 需要通过 P/Invoke 调用 FreeType 的 C 语言接口，或者使用现成的封装库（如 SharpFont）。以下是一个使用 SharpFont 的示例。

C# 示例：使用 SharpFont 渲染文本

1. 安装 SharpFont

通过 NuGet 安装 SharpFont：

bash

复制

dotnet add package SharpFont

2. 示例代码

以下代码演示了如何使用 SharpFont 加载字体文件并将文本渲染到位图中。

csharp

复制

using System;
using System.Drawing;
using System.Drawing.Imaging;
using SharpFont;

class Program
{
    static void Main(string[] args)
    {
        // 初始化 FreeType 库
        var library = new Library();

        // 加载字体文件
        var face = new Face(library, "arial.ttf");

        // 设置字体大小
        face.SetPixelSizes(0, 48); // 宽度为 0（自动计算），高度为 48 像素

        // 创建位图
        int width = 800;
        int height = 100;
        var bitmap = new Bitmap(width, height, PixelFormat.Format32bppArgb);
        var graphics = Graphics.FromImage(bitmap);
        graphics.Clear(Color.White);

        // 渲染文本
        string text = "Hello, FreeType!";
        int x = 10;
        int y = 50;
        foreach (char c in text)
        {
            // 加载字形
            uint glyphIndex = face.GetCharIndex(c);
            face.LoadGlyph(glyphIndex, LoadFlags.Default, LoadTarget.Normal);
            face.Glyph.RenderGlyph(RenderMode.Normal);

            // 获取字形位图
            var glyphBitmap = face.Glyph.Bitmap;
            var bitmapData = glyphBitmap.Buffer;

            // 绘制字形到位图
            for (int row = 0; row < glyphBitmap.Rows; row++)
            {
                for (int col = 0; col < glyphBitmap.Width; col++)
                {
                    byte alpha = bitmapData[row * glyphBitmap.Pitch + col];
                    if (alpha > 0)
                    {
                        int pixelX = x + face.Glyph.BitmapLeft + col;
                        int pixelY = y + face.Glyph.BitmapTop - row;
                        if (pixelX >= 0 && pixelX < width && pixelY >= 0 && pixelY < height)
                        {
                            bitmap.SetPixel(pixelX, pixelY, Color.FromArgb(alpha, Color.Black));
                        }
                    }
                }
            }

            // 移动光标
            x += (int)(face.Glyph.Advance.X >> 6);
            y += (int)(face.Glyph.Advance.Y >> 6);
        }

        // 保存位图
        bitmap.Save("output.png", ImageFormat.Png);
        Console.WriteLine("Text rendered to output.png");

        // 释放资源
        face.Dispose();
        library.Dispose();
    }
}