Morsecode-Übersetzung mit Aspose.Font | .NET

Morsecode-Übersetzung mit Aspose.Font für.NET

Was ist Morsecode-Übersetzung?

Mit dieser Funktionalität können Sie:

Ziel	Funktionsweise
Kodieren von Klartext in Morsecode-Glyphen einer Schriftart (oder eines Bitmap-Bildes)	IFontMorseEncoder wandelt Zeichen in eine Folge von Punkt (.) und Strich (-) um und ordnet sie den Glyphen-IDs der angegebenen IFont zu.
Dekodieren einer Morsezeichenfolge in lesbaren Text	IMorseDecoder liefert Klartext; IFontMorseDecoder liefert mit einer angegebenen Schriftart Glyphen-IDs oder einen PNG-Stream.
Rendern von Text als Morsecode im PNG-Format	Rendering-Überladungen akzeptieren Schriftart, Schriftgröße, Zeilenabstand und maximale Breite und liefern einen PNG-Stream.

Die Funktion wurde in Aspose.Fontfor.NET23.10 (FONTNET‑602 – Unterstützung für Morsecode-Kodierung) eingeführt.

Warum es verwenden?

• Reine C#-Lösung – keine externen Bibliotheken, keine Abhängigkeiten auf Betriebssystemebene.
• Funktioniert mit jeder Schriftart, die die erforderlichen Glyphen enthält (TrueType, OpenType, CFF …).
• Integrierte Heuristiken wählen automatisch das richtige Alphabet (Latein, Griechisch, Kyrillisch usw.) aus, wenn Sie es weglassen.
• Sowohl Text → Glyphen-IDs (für eigene Rendering-Pipelines) als auch Text → Morse-PNG sind verfügbar.
• Vollständig abgedeckt durch Asposes Support (Foren, Dokumente, Live-Demo).

Erste Schritte

1 Installieren Sie das NuGet-Paket

dotnet add package Aspose.Font

2 Namespaces hinzufügen (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-Übersicht

1 Fabrik – Einstiegspunkt

Erstellen Sie mit new TextUtilsFactory() eine TextUtilsFactory-Instanz und rufen Sie deren Instanzmethoden auf:

Methode	Rückgabewert	Beschreibung
GetFontMorseEncoder()	IFontMorseEncoder	Kodiert Text mit einer angegebenen Schriftart als Glyphen-IDs oder PNG-Stream
GetMorseEncoder()	IMorseEncoder	Kodiert Text ohne Schriftart als einfache Morsezeichenfolge
GetFontMorseDecoder()	IFontMorseDecoder	Dekodiert Morsecode mit einer angegebenen Schriftart in Glyphen-IDs oder einen PNG-Stream
GetMorseDecoder()	IMorseDecoder	Dekodiert eine Morsezeichenfolge ohne Schriftart in Klartext

Die Fabrik befindet sich in Aspose.Font.Factories.TextUtilsFactory (hinzugefügt in 23.10).

2 Core-Schnittstellen

IFontMorseEncoder.

Die Glyphenüberladungen liefern GlyphId[]. Die Rendering-Überladungen liefern einen PNG-Stream, den der Aufrufer nach dem Kopieren oder Verarbeiten freigeben sollte.

Ergebnis	Parameter
GlyphId[]	Text und eine IFont-Instanz, mit automatischer Alphabeterkennung oder einem expliziten MorseAlphabets-Wert
PNG Stream	Text, eine IFont-Instanz, fontSize, RenderingUtils.LineSpacingType, lineSpacingValue und maxWidth; eine weitere Überladung nimmt ein explizites Alphabet entgegen

LineSpacingType unterstützt Pixels und PercentOfFontHeight. Der Renderer berechnet die Bildhöhe; es gibt keinen Parameter für eine feste Höhe.

Die optionalen Zeichen inputSeparator und outputSeparator trennen Wörter. Beim Kodieren sind die Standardwerte ein Leerzeichen bzw. /. Sie ersetzen nicht die Morsezeichen für Punkt und Strich.

IFontMorseDecoder.

IFontMorseDecoder akzeptiert eine Morsezeichenfolge, eine Schriftart und einen expliziten MorseAlphabets-Wert. Das Ergebnis ist entweder GlyphId[] für den dekodierten Text oder ein PNG-Stream, wenn Rendering-Parameter angegeben werden. Klartext wird nicht zurückgegeben.

Verwenden Sie IMorseDecoder, um ohne Laden einer Schriftart einen dekodierten string zu erhalten. Beim Dekodieren ist inputSeparator standardmäßig / und outputSeparator ein Leerzeichen.

IMorseEncoder / IMorseDecoder.

Diese funktionieren nur mit Rohzeichenfolgen (keine Schriftart beteiligt). Verwenden Sie sie, wenn Sie nur „Punkt-Strich“-Sequenzen benötigen.

3 Unterstützende Enumeration – MorseAlphabets.

Wert	Schrift
Latin	Englisch und die meisten westlichen Sprachen
Greek	Griechische Buchstaben
Cyrillic	Russisch, Bulgarisch usw.
Hebrew	Hebräische Buchstaben
Arabic	Arabische Schrift
Portuguese	Portugiesische Schriftzeichen
Kurdish	Kurdische Buchstaben
Persian	Persische/Farsi-Buchstaben

Wenn Sie die Enumeration weglassen, versucht der Encoder eine automatische Erkennung.

Praxisbeispiele

Die schriftbasierten Beispiele verwenden TTF/LatoWeb-Regular.ttf. Setzen Sie DataDir auf das Verzeichnis mit dem Ordner TTF und OutputDir auf ein vorhandenes Ausgabeverzeichnis. Die Dekodierung in Klartext benötigt keine Schriftart.

1.  In Glyphen-IDs kodieren

// 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())));

Ergebnis: Ein Array von GlyphId-Objekten, die die Morsezeichen darstellen und für eigene Zeichnungspipelines geeignet sind.

2.  Kodieren und rendern Sie ein PNG

Dieses Fragment verwendet font und encoder aus dem vorherigen Beispiel. Es speichert morse.png in 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);
    }
}

Das PNG stellt Morsecode mit Punkt- (.) und Strichglyphen (-) der Schriftart dar. Die Zeichenparameter steuern Worttrenner, keine alternativen Punkt-/Strichzeichen.

3.  Zurück in Klartext dekodieren

// 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

Wenn beim Codieren ein benutzerdefiniertes Alphabet verwendet wurde, übergeben Sie denselben „MorseAlphabets“-Wert an den Decoder.

4. Kombiniertes Beispiel (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}");

Das kombinierte Beispiel speichert callme.png in OutputDir, gibt die kodierten Glyphen-IDs aus und dekodiert ... --- ... zu SOS. Verwenden Sie die oben angegebenen Namespaces und Verzeichnisse.

Online-Demo

Aspose bietet eine kostenlose Web-Demo an, mit der Sie den Übersetzer testen können, ohne etwas zu installieren:

Funktionen der Demo:

• Text ↔︎ Morse ↔︎ Glyphendarstellung
• Wählen Sie benutzerdefinierte Punkt-/Strichzeichen
• Laden Sie generiertes PNG herunter oder zeigen Sie Glyphen-IDs an

Versionshinweise

Aspose.Font für .NET 23.10 Hinzugefügte APIs: TextUtilsFactory, IFontMorseEncoder, IFontMorseDecoder, IMorseEncoder, IMorseDecoder, Enumeration MorseAlphabets. Neue Funktion: „Unterstützung für Morsecode-Codierung“.

Wann welche Überlastung verwendet werden soll

Situation	Empfohlene Überladung
Nur Glyphenbezeichner für die Weiterverarbeitung erforderlich	Encode(string text, IFont font) (oder mit explizitem Alphabet)
PNG-Stream ohne eigenen Rendering-Code benötigt	Verwenden Sie die Überladung mit fontSize, lineSpacingType, lineSpacingValue und maxWidth
Benutzerdefinierte Worttrenner	Legen Sie inputSeparator und outputSeparator fest; diese Parameter ändern die Punkt-/Strichzeichen nicht
Quellsprache verwendet nicht-lateinische Schrift und automatische Erkennung schlägt fehl	Den entsprechenden Wert für MorseAlphabets explizit angeben

Zusammenfassung

Aspose.Font enthält jetzt eine vollständige Morsecode-Übersetzungs-Engine, die sowohl auf der Glyphenebene als auch auf der Bitmapebene arbeitet. Mit den einfachen Factory-Methoden können Sie sofort mit dem Kodieren, Dekodieren und Rendern von Texten in den unterstützten Alphabeten beginnen, ohne eigene Zuordnungstabellen schreiben oder sich mit Low-Level-Rendering befassen zu müssen.

Ob Sie bauen:

• Eine benutzerdefinierte Signalvisualisierungskomponente
• Ein Lehrmittel zum Erlernen der Morsekommunikation
• Ein Datenverschleierungsschritt, der Informationen als stilisierte Schriftarten speichert

Die API gibt Ihnen die volle Kontrolle und sorgt gleichzeitig dafür, dass der Code sauber, plattformübergreifend und vollständig unterstützt bleibt.