使用字体渲染文本

previous post 中,您已经了解了如何使用 Aspose.Font for .NET API 来加载和保存 CFFTrueTypeType1 以编程方式使用字体。在本文中,您将学习如何使用 C# 以 TrueType 和 Type1 字体呈现文本。代码示例将向您展示如何根据提供的文本生成 JPG 图像。

.NET 字体渲染 API - 安装

Aspose.Font for .NET 提供强大的字体渲染机制,以便使用 TrueType 和 Type1 字体渲染文本。您可以 下载 API 或使用 NuGet 安装它。

PM> Install-Package Aspose.Font

实现文本渲染接口

为了实现文本渲染,Aspose.Font for .NET 提供了一个 IGlyphOutlinePainter 接口来绘制字形。以下步骤演示了如何实现 IGlyphOutlinePainter 中的方法。

// 如需完整的示例和数据文件,请访问 https://github.com/aspose-font/Aspose.Font-for-.NET
class GlyphOutlinePainter : IGlyphOutlinePainter
{
    private System.Drawing.Drawing2D.GraphicsPath _path;
    private System.Drawing.PointF _currentPoint;

    public GlyphOutlinePainter(System.Drawing.Drawing2D.GraphicsPath path)
    {
        _path = path;
    }

    public void MoveTo(MoveTo moveTo)
    {
        _path.CloseFigure();
        _currentPoint.X = (float)moveTo.X;
        _currentPoint.Y = (float)moveTo.Y;
    }

    public void LineTo(LineTo lineTo)
    {
        float x = (float)lineTo.X;
        float y = (float)lineTo.Y;
        _path.AddLine(_currentPoint.X, _currentPoint.Y, x, y);
        _currentPoint.X = x;
        _currentPoint.Y = y;
    }

    public void CurveTo(CurveTo curveTo)
    {
        float x3 = (float)curveTo.X3;
        float y3 = (float)curveTo.Y3;

        _path.AddBezier(
                  _currentPoint.X,
                  _currentPoint.Y,
                  (float)curveTo.X1,
                  (float)curveTo.Y1,
                  (float)curveTo.X2,
                  (float)curveTo.Y2,
                  x3,
                  y3);

        _currentPoint.X = x3;
        _currentPoint.Y = y3;
    }

    public void ClosePath()
    {
        _path.CloseFigure();
    }
}
// 如需完整的示例和数据文件,请访问 https://github.com/aspose-font/Aspose.Font-for-.NET
static void DrawText(string text, IFont font, double fontSize,
            Brush backgroundBrush, Brush textBrush, string outFile)
{
    //获取文本行中每个符号的字形标识符
    GlyphId[] gids = new GlyphId[text.Length];
   for (int i = 0; i < text.Length; i++)
        gids[i] = font.Encoding.DecodeToGid(text[i]);
    // 设置常用绘图设置
    double dpi = 300;

    double resolutionCorrection = dpi / 72; // 72 is font's internal dpi
    // 准备输出位图
    Bitmap outBitmap = new Bitmap(960, 720);
    outBitmap.SetResolution((float)dpi, (float)dpi);
    Graphics outGraphics = Graphics.FromImage(outBitmap);
    outGraphics.FillRectangle(backgroundBrush, 0, 0, outBitmap.Width, outBitmap.Height);
    outGraphics.SmoothingMode = SmoothingMode.HighQuality;
    //声明坐标变量和先前的 gid
    GlyphId previousGid = null;
    double glyphXCoordinate = 0;
    double glyphYCoordinate = fontSize * resolutionCorrection;
    //在 gids 中绘制每个字形的循环
    foreach (GlyphId gid in gids)
    {
        // 如果字体包含 gid
        if (gid != null)
        {
            Glyph glyph = font.GlyphAccessor.GetGlyphById(gid);
            if (glyph == null)
                continue;

            // 接受绘图指令的路径
            GraphicsPath path = new GraphicsPath();

            // 创建 IGlyphOutlinePainter 实现
            GlyphOutlinePainter outlinePainter = new GlyphOutlinePainter(path);

            // 创建渲染器
            Aspose.Font.Renderers.IGlyphRenderer renderer = new
                Aspose.Font.Renderers.GlyphOutlineRenderer(outlinePainter);

            // 获取常用字形属性
            double kerning = 0;

            // 获取字距调整值
            if (previousGid != null)
            {
                kerning = (font.Metrics.GetKerningValue(previousGid, gid) /
                           glyph.SourceResolution) * fontSize * resolutionCorrection;
                kerning += FontWidthToImageWith(font.Metrics.GetGlyphWidth(previousGid),
                        glyph.SourceResolution, fontSize);
            }

            // 字形定位 - 根据字距增加字形 X 坐标
            glyphXCoordinate += kerning;

            // 字形放置矩阵
            TransformationMatrix glyphMatrix =
                new TransformationMatrix(
                    new double[]
                            {
                                    fontSize*resolutionCorrection,
                                    0,
                                    0,
                                // 负数,因为位图坐标系从顶部开始
                                    - fontSize*resolutionCorrection,
                                    glyphXCoordinate,
                                    glyphYCoordinate
                            });

            // 渲染当前字形
            renderer.RenderGlyph(font, gid, glyphMatrix);
            // 填充路径
            path.FillMode = FillMode.Winding;
            outGraphics.FillPath(textBrush, path);
        }
        //将当前 gid 设置为先前的 gid 以获得下一个字形的正确字距
        previousGid = gid;
    }
    //保存结果
    outBitmap.Save(outFile);
}
  • 定义一个实用方法来根据图像的宽度计算字体的宽度。
// 如需完整的示例和数据文件,请访问 https://github.com/aspose-font/Aspose.Font-for-.NET
static double FontWidthToImageWith(double width, int fontSourceResulution, double fontSize, double dpi = 300)
{
    double resolutionCorrection = dpi / 72; // 72 is font's internal dpi
    return (width / fontSourceResulution) * fontSize * resolutionCorrection;
}

使用 C# 使用 TrueType 字体呈现文本

下面的代码示例展示了如何使用上述实现来使用 C# 呈现具有 TrueType 字体的文本。

// 如需完整的示例和数据文件,请访问 https://github.com/aspose-font/Aspose.Font-for-.NET
string dataDir = RunExamples.GetDataDir_Data();

string fileName1 = dataDir + "Montserrat-Bold.ttf"; //Font file name with full path
FontDefinition fd1 = new FontDefinition(FontType.TTF, new FontFileDefinition("ttf", new FileSystemStreamSource(fileName1)));
TtfFont ttfFont1 = Aspose.Font.Font.Open(fd1) as TtfFont;
            
string fileName2 = dataDir + "Lora-Bold.ttf"; //Font file name with full path
FontDefinition fd2 = new FontDefinition(FontType.TTF, new FontFileDefinition("ttf", new FileSystemStreamSource(fileName2)));
TtfFont ttfFont2 = Aspose.Font.Font.Open(fd2) as TtfFont;

DrawText("Hello world", ttfFont1, 14, Brushes.White, Brushes.Black, dataDir + "hello1_montserrat_out.jpg");
DrawText("Hello world", ttfFont2, 14, Brushes.Yellow, Brushes.Red, dataDir + "hello2_lora_out.jpg");

使用 C# 以 Type1 字体呈现文本

以下代码示例演示如何使用 C# 呈现具有 Type1 字体的文本。

// 如需完整的示例和数据文件,请访问 https://github.com/aspose-font/Aspose.Font-for-.NET
string fileName = dataDir + "courier.pfb"; //Font file name with full path

FontDefinition fd = new FontDefinition(FontType.Type1, new FontFileDefinition("pfb", new FileSystemStreamSource(fileName)));
Type1Font font = Aspose.Font.Font.Open(fd) as Type1Font;
            

DrawText("Hello world", font, 14, Brushes.White, Brushes.Black, dataDir + "hello1_type1_out.jpg");
DrawText("Hello world", font, 14, Brushes.Yellow, Brushes.Red, dataDir + "hello2_type1_out.jpg");

结论

在本文中,您学习了如何使用 C# 实现具有 TrueType 或 Type1 字体的文本呈现。代码示例展示了如何根据提供的文本生成 JPG 图像。您可以使用 文档 探索有关 Aspose.Font for .NET 的更多信息。

也可以看看