使用 Aspose.Font 进行摩尔斯电码翻译 | .NET

使用 Aspose.Font for .NET 进行摩尔斯电码翻译

什么是摩尔斯电码翻译？

该功能可让您：

目标	工作原理
编码 纯文本到字体（或位图图像）的莫尔斯电码字形	IFontMorseEncoder 将字符转换为点 (.) 和划 (-) 符号序列，并将其映射到所提供 IFont 的字形标识符。
将摩尔斯电码字符串解码为可读文本	IMorseDecoder 返回纯文本；IFontMorseDecoder 使用指定字体返回字形标识符或 PNG 流。
将文本作为摩尔斯电码渲染为 PNG	渲染重载接受字体、字号、行距和最大宽度，并返回 PNG 流。

该功能在 Aspose.Fontfor.NET23.10 中引入(FONTNET-602 – 支持摩尔斯电码编码)。

为什么要使用它？

• 纯 C# 解决方案 – 没有外部库，没有操作系统级依赖项。
• 适用于包含所需字形的任何字体(TrueType、OpenType、CFF …)。
• 当您省略时，内置启发式算法会自动选择正确的字母(拉丁语、希腊语、西里尔语等)。
• 支持 文本 → 字形标识符（用于自定义渲染流程）和 文本 → 摩尔斯电码 PNG。
• Aspose 的支持完全覆盖(论坛、文档、现场演示)。

开始使用

1 安装NuGet包

dotnet add package Aspose.Font

2 添加命名空间 (C#)

using System;
using System.IO;
using System.Linq;
using Aspose.Font;
using Aspose.Font.Factories;
using Aspose.Font.Glyphs;
using Aspose.Font.Renderers;
using Aspose.Font.Sources;
using Aspose.Font.TextUtils;

API概览

1 个工厂 – 入口点

使用 new TextUtilsFactory() 创建 TextUtilsFactory 实例，然后调用其实例方法：

方法	返回值	描述
GetFontMorseEncoder()	IFontMorseEncoder	使用指定字体将文本编码为字形标识符或 PNG 流
GetMorseEncoder()	IMorseEncoder	无需字体，将文本编码为摩尔斯电码字符串
GetFontMorseDecoder()	IFontMorseDecoder	使用指定字体将摩尔斯电码解码为字形标识符或 PNG 流
GetMorseDecoder()	IMorseDecoder	无需字体，将摩尔斯电码字符串解码为纯文本

该工厂位于 Aspose.Font.Factories.TextUtilsFactory (在 23.10 中添加)。

2 核心接口

IFontMorseEncoder

字形重载返回 GlyphId[]。渲染重载返回 PNG 格式的 Stream，调用方应在复制或处理完成后释放该流。

结果	参数
GlyphId[]	文本和 IFont，使用自动字母表检测或显式指定的 MorseAlphabets 值
PNG Stream	文本、IFont、fontSize、RenderingUtils.LineSpacingType、lineSpacingValue 和 maxWidth；另有重载可显式指定字母表

LineSpacingType 支持 Pixels 和 PercentOfFontHeight。渲染器会计算图像高度，没有固定高度参数。

可选字符参数 inputSeparator 和 outputSeparator 用于分隔单词。编码时，它们的默认值分别为空格和 /。它们不会替换摩尔斯电码中的点和划。

IFontMorseDecoder

IFontMorseDecoder 接受摩尔斯电码字符串、字体以及显式指定的 MorseAlphabets 值。它返回解码后文本的 GlyphId[]，或者在提供渲染参数时返回 PNG 格式的 Stream，而不是纯文本。

使用 IMorseDecoder 可在不加载字体的情况下获得解码后的 string。解码时，inputSeparator 默认为 /，outputSeparator 默认为空格。

IMorseEncoder / IMorseDecoder

这些仅适用于原始字符串(不涉及字体)。当您只需要“点划”序列时使用它们。

3 支持枚举 – MorseAlphabets

Value	Script
Latin	英语和大多数西方语言
Greek	希腊字母
Cyrillic	俄语、保加利亚语等
Hebrew	希伯来字母
Arabic	阿拉伯文字
Portuguese	葡萄牙语特有符号
Kurdish	库尔德语字母
Persian	波斯语/法尔西语字母

如果省略枚举，编码器会尝试自动检测。

实际例子

使用字体的示例采用 TTF/LatoWeb-Regular.ttf。将 DataDir 设置为包含 TTF 文件夹的目录，将 OutputDir 设置为已存在的输出目录。解码为纯文本不需要字体。

1.  编码为字形 ID

// Encode text as Morse-code glyph identifiers

// Load a font containing the Morse-code symbols.
string fontPath = Path.Combine(DataDir, "TTF", "LatoWeb-Regular.ttf");
Font font = Font.Open(new FontDefinition(
    FontType.TTF, "ttf", new FileSystemStreamSource(fontPath)));

// Create the factory and get the font encoder.
var factory = new TextUtilsFactory();
IFontMorseEncoder encoder = factory.GetFontMorseEncoder();

// Encode HELLO WORLD using automatic alphabet detection.
GlyphId[] glyphIds = encoder.Encode("HELLO WORLD", font);
Console.WriteLine(string.Join(", ", glyphIds.Select(id => id.ToString())));

结果：表示摩尔斯电码符号的 GlyphId 对象数组，可用于自定义绘制流程。

2.  编码并渲染 PNG

此片段复用前一个示例中的 font 和 encoder，并将 morse.png 保存到 OutputDir。

// Encode text as Morse code and save a PNG

double fontSize = 48;
var spacing = RenderingUtils.LineSpacingType.Pixels;
int lineSpacing = 10;
int maxWidth = 800;

// The renderer returns a stream and determines the image height.
using (Stream pngStream = encoder.Encode(
    "SOS HELP", font, fontSize, spacing, lineSpacing, maxWidth))
{
    if (pngStream.CanSeek)
        pngStream.Position = 0;

    using (FileStream output = File.Create(Path.Combine(OutputDir, "morse.png")))
    {
        pngStream.CopyTo(output);
    }
}

PNG 使用字体中的点（.）和划（-）字形显示摩尔斯电码。字符参数控制的是单词分隔符，而不是替代的点或划符号。

3.  解码回纯文本

// Decode a Morse-code string to plain text

// Plain-text decoding does not require a font.
IMorseDecoder decoder = new TextUtilsFactory().GetMorseDecoder();
string morse = "... --- ...";
string result = decoder.Decode(morse, MorseAlphabets.Latin);
Console.WriteLine(result); // SOS

当编码期间使用自定义字母表时，将相同的“MorseAlphabets”值传递给解码器。

4. 组合示例（C#）

// Render Morse code, obtain glyph identifiers and decode a message

// Load a font.
string fontPath = Path.Combine(DataDir, "TTF", "LatoWeb-Regular.ttf");
Font font = Font.Open(new FontDefinition(
    FontType.TTF, "ttf", new FileSystemStreamSource(fontPath)));

var factory = new TextUtilsFactory();
IFontMorseEncoder encoder = factory.GetFontMorseEncoder();
IMorseDecoder decoder = factory.GetMorseDecoder();
const string message = "CALL ME AT 5PM";

// Encode to PNG. Height is calculated by the renderer.
using (Stream pngStream = encoder.Encode(
    message, font,
    fontSize: 36,
    lineSpacingType: RenderingUtils.LineSpacingType.Pixels,
    lineSpacingValue: 10,
    maxWidth: 900))
{
    if (pngStream.CanSeek)
        pngStream.Position = 0;

    using (FileStream output = File.Create(Path.Combine(OutputDir, "callme.png")))
    {
        pngStream.CopyTo(output);
    }
}
Console.WriteLine("PNG created.");

// Encode to glyph identifiers.
GlyphId[] ids = encoder.Encode(message, font);
Console.WriteLine("Glyph IDs: " + string.Join(", ", ids.Select(id => id.ToString())));

// Decode a plain Morse string.
string morse = "... --- ...";
string decoded = decoder.Decode(morse, MorseAlphabets.Latin);
Console.WriteLine($"Decoded '{morse}' -> {decoded}");

组合示例将 callme.png 保存到 OutputDir，输出编码后的字形标识符，并将 ... --- ... 解码为 SOS。请使用上文所示的命名空间和目录设置。

在线演示

Aspose 提供了 免费网络演示 来尝试翻译器而无需安装任何东西：

演示的特点：

• 文本 ↔︎ 莫尔斯电码 ↔︎ 字形渲染
• 选择自定义点/划字符
• 下载生成的 PNG 或查看字形 ID

发行说明

Aspose.Font for .NET 23.10 新增 API：TextUtilsFactory、IFontMorseEncoder、IFontMorseDecoder、IMorseEncoder、IMorseDecoder、枚举类型 MorseAlphabets。

何时使用哪种重载

应用场景	推荐重载
仅需字形标识符进行后续处理	Encode(string text, IFont font)（或使用显式字母表）
无需自行编写渲染代码即可获取 PNG 流	使用接受 fontSize、lineSpacingType、lineSpacingValue 和 maxWidth 的重载
自定义单词分隔符	设置 inputSeparator 和 outputSeparator；这些参数不会更改点或划符号
源语言使用非拉丁字母且自动检测失败	显式传递相应的 MorseAlphabets 值

总结

Aspose.Font 现在包含一个 完整的摩尔斯电码翻译引擎，可在 字形级别 和 位图级别 运行。使用简单的工厂方法，您可以立即开始编码、解码和渲染受支持字母表中的文本，而无需编写自己的映射表或处理低级渲染。

无论您正在构建：

• 自定义信号可视化组件
• 教授莫尔斯通讯的教育工具
• 将信息存储为风格化字体的数据混淆步骤

API 为您提供完全控制，同时保持代码整洁、跨平台和完全支持。