Aspose.Font を使用したモールス信号変換 | .NET

Aspose.Font for.NET を使用したモールス信号変換

モールス信号翻訳とは何ですか?

これは次のことを可能にする機能です。

目標	仕組み
プレーンテキストをフォント (またはビットマップ画像) のモールス信号グリフにエンコードします	IFontMorseEncoder は、文字を ドット (.) と ダッシュ (-) 記号のシーケンスに変換し、指定された IFont のグリフ識別子にマッピングします。
モールス信号の文字列を読みやすいテキストにデコード	IMorseDecoder はプレーンテキストを返します。IFontMorseDecoder は指定されたフォントを使用してグリフ識別子または PNG ストリームを返します。
テキストをモールス信号として PNG 形式で描画	描画用オーバーロードはフォント、フォントサイズ、行間、最大幅を受け取り、PNG ストリームを返します。

この機能は Aspose.Fontfor.NET23.10 (FONTNET‑602 – モールス符号エンコーディングのサポート) で導入されました。

なぜそれを使うのでしょうか？

• Pure‑C# ソリューション – 外部ライブラリや OS レベルの依存関係はありません。
• 必要なグリフ (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 コアインターフェイス

IFontモールスエンコーダ

グリフ用オーバーロードは 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 を返します。プレーンテキストは返しません。

フォントを読み込まずにデコードされた string を取得するには、IMorseDecoder を使用します。デコード時の既定値は、inputSeparator が /、outputSeparator が空白です。

IMorseEncoder / IMorseDecoder

これらは生の文字列のみを処理します (フォントは関係しません)。 「ドットダッシュ」シーケンスのみが必要な場合に使用します。

3 サポートする列挙型 – MorseAlphabets

Value	Script
Latin	英語およびほとんどの西洋言語
Greek	ギリシャ文字
Cyrillic	ロシア語、ブルガリア語など
Hebrew	ヘブライ文字
Arabic	アラビア文字
Portuguese	ポルトガル語固有の記号
Kurdish	ポルトガル語固有の記号
Persian	ペルシア文字 / ペルシア文字

enum を省略した場合、エンコーダは自動検出を試みます。

実践例

フォントを使用する例では 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 を再利用し、OutputDir に morse.png を保存します。

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

この例は OutputDir に callme.png を保存し、エンコードされたグリフ識別子を出力して、... --- ... を SOS にデコードします。上記の名前空間とディレクトリ設定を使用してください。

オンラインデモ

Aspose は、何もインストールせずにトランスレーターを試すための 無料の Web デモ を提供しています。

デモの特徴:

• テキスト ↔︎ モールス信号 ↔︎ グリフ レンダリング
• カスタムのドット/ダッシュ文字を選択してください
• 生成された PNG をダウンロードするか、グリフ ID を表示します

リリースノート

Aspose.Font for .NET23.10 追加された API: TextUtilsFactory、IFontMorseEncoder、IFontMorseDecoder、IMorseEncoder、IMorseDecoder、列挙体 MorseAlphabets。 新機能: 「モールス信号エンコードのサポート」

どのオーバーロードをいつ使用するか

状況	推奨されるオーバーロード
以降の処理にグリフ識別子のみが必要な場合	Encode(string text, IFont font) (または明示的なアルファベットを使用)
独自の描画コードなしで PNG ストリームを取得	fontSize、lineSpacingType、lineSpacingValue、maxWidth を受け取るオーバーロードを使用
単語区切りのカスタマイズ	inputSeparator と outputSeparator を設定します。これらは点や線の記号を変更しません
ソース言語で非ラテン文字が使用されており、自動検出が失敗する	適切な MorseAlphabets 値を明示的に渡す場合

概要

Aspose.Font には、グリフ レベル と ビットマップ レベル の両方で動作する 完全なモールス信号変換エンジンが含まれるようになりました。シンプルなファクトリ メソッドを使用すると、独自のマッピング テーブルを作成したり、低レベルのレンダリングを処理したりすることなく、サポートされているアルファベットのテキストのエンコード、デコード、レンダリングを即座に開始できます。

構築しているかどうか:

• カスタム信号可視化コンポーネント
• モールス通信を教えるための教育ツール
• 情報を様式化されたフォントとして保存するデータ難読化ステップ

API を使用すると、コードをクリーンに保ち、クロスプラットフォームで完全にサポートされながら、完全な制御が可能になります。