Traduzione in codice Morse con Aspose.Font | .NET

Traduzione in codice Morse con Aspose.Font per.NET

Cos’è la traduzione in codice Morse?

Questa è una funzionalità che ti consente di:

Obiettivo	Come funziona
Codifica il testo normale in glifi in codice Morse di un font (o di un’immagine bitmap)	IFontMorseEncoder converte i caratteri in una sequenza di simboli punto (.) e trattino (-) e li mappa agli identificatori di glifo dell’IFont fornito.
Decodificare una stringa Morse in testo leggibile	IMorseDecoder restituisce testo normale; IFontMorseDecoder restituisce identificatori di glifi o un flusso PNG con un font fornito.
Renderizzare il testo come codice Morse in formato PNG	Gli overload di rendering accettano un font, la dimensione, l’interlinea e la larghezza massima e restituiscono un flusso PNG.

La funzionalità è stata introdotta in Aspose.Fontfor.NET23.10 (FONTNET‑602 – Supporto per la codifica del codice Morse).

Perché usarlo?

• Soluzione Pure‑C#: nessuna libreria esterna, nessuna dipendenza a livello di sistema operativo.
• Funziona con qualsiasi font che contenga i glifi richiesti (TrueType, OpenType, CFF…).
• L’euristica incorporata seleziona automaticamente l’alfabeto corretto (latino, greco, cirillico e così via) quando lo ometti.
• Sono disponibili sia testo → identificatori di glifi (per pipeline di rendering personalizzate) sia testo → PNG Morse.
• Completamente coperto dal supporto di Aspose (forum, documenti, demo live).

Iniziare

1 Installare il pacchetto NuGet

dotnet add package Aspose.Font

2 Aggiungere spazi dei nomi (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;

Panoramica dell’API

1 Fabbrica – punto di ingresso

Creare un’istanza di TextUtilsFactory con new TextUtilsFactory(), quindi chiamare i relativi metodi di istanza:

Metodo	Restituisce	Descrizione
GetFontMorseEncoder()	IFontMorseEncoder	Codifica il testo in identificatori di glifi o in un flusso PNG utilizzando un font fornito
GetMorseEncoder()	IMorseEncoder	Codifica il testo in una stringa Morse senza font
GetFontMorseDecoder()	IFontMorseDecoder	Decodifica il Morse in identificatori di glifi o in un flusso PNG utilizzando un font fornito
GetMorseDecoder()	IMorseDecoder	Decodifica una stringa Morse in testo normale senza font

La fabbrica si trova in Aspose.Font.Factories.TextUtilsFactory (aggiunto nel 23.10).

2 interfacce principali

“IFontMorseEncoder”.

Gli overload per i glifi restituiscono GlyphId[]. Gli overload di rendering restituiscono uno Stream PNG che il chiamante deve rilasciare dopo averlo copiato o utilizzato.

Risultato	Parametri
GlyphId[]	Testo e un’istanza IFont, con rilevamento automatico dell’alfabeto o un valore MorseAlphabets esplicito
PNG Stream	Testo, un’istanza IFont, fontSize, RenderingUtils.LineSpacingType, lineSpacingValue e maxWidth; un altro overload consente di specificare l’alfabeto

LineSpacingType supporta Pixels e PercentOfFontHeight. Il renderer calcola l’altezza dell’immagine; non esiste un parametro per un’altezza fissa.

I caratteri facoltativi inputSeparator e outputSeparator delimitano le parole. Durante la codifica, i valori predefiniti sono rispettivamente uno spazio e /. Non sostituiscono i simboli di punto e linea del codice Morse.

“IFontMorseDecoder”.

IFontMorseDecoder accetta una stringa Morse, un font e un valore MorseAlphabets esplicito. Restituisce GlyphId[] per il testo decodificato oppure uno Stream PNG se vengono forniti parametri di rendering. Non restituisce testo normale.

Utilizzare IMorseDecoder per ottenere una string decodificata senza caricare un font. Durante la decodifica, inputSeparator è / per impostazione predefinita e outputSeparator è uno spazio.

IMorseEncoder / IMorseDecoder.

Funzionano solo con stringhe grezze (nessun carattere coinvolto). Usali quando hai solo bisogno di sequenze “punto-linea”.

3 Enumerazione di supporto – “Alfabeti Morse”.

Valore	Script
Latino	Inglese e la maggior parte delle lingue occidentali
Greco	Lettere greche
Cirillico	Russo, bulgaro, ecc.
Ebraico	Lettere ebraiche
Arabo	Scrittura araba
Portoghese	Simboli specifici del portoghese
Curdo	Lettere curde
Persiano	Lettere persiane/farsi

Se ometti l’enumerazione, il codificatore tenta il rilevamento automatico.

Esempi pratici

Gli esempi basati su font utilizzano TTF/LatoWeb-Regular.ttf. Impostare DataDir sulla directory che contiene la cartella TTF e OutputDir su una directory di output esistente. La decodifica in testo normale non richiede un font.

1.  Codifica in ID glifi

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

Risultato: un array di oggetti GlyphId che rappresentano i simboli Morse, adatto a pipeline di disegno personalizzate.

2.  Codifica e renderizza un PNG

Questo frammento riutilizza font ed encoder dell’esempio precedente. Salva 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);
    }
}

Il PNG rappresenta il codice Morse utilizzando i glifi di punto (.) e linea (-) del font. I parametri dei caratteri controllano i separatori di parole, non simboli alternativi di punto e linea.

3.  Decodifica in testo normale

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

Quando durante la codifica è stato utilizzato un alfabeto personalizzato, passa lo stesso valore “MorseAlphabets” al decodificatore.

4. Esempio combinato (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}");

L’esempio combinato salva callme.png in OutputDir, stampa gli identificatori dei glifi codificati e decodifica ... --- ... in SOS. Utilizzare gli spazi dei nomi e la configurazione delle directory indicati sopra.

Dimostrazione in linea

Aspose fornisce una demo web gratuita per provare il traduttore senza installare nulla:

Caratteristiche della demo:

• Testo ↔︎ Morse ↔︎ Rendering glifi
• Scegli caratteri punto/trattino personalizzati
• Scarica il PNG generato o visualizza gli ID dei glifi

Note sulla versione

Aspose.Font for .NET 23.10
Added APIs: TextUtilsFactory, IFontMorseEncoder, IFontMorseDecoder, IMorseEncoder, IMorseDecoder, enumeration MorseAlphabets.
New Feature: “Support for Morse code encoding”.

Quando utilizzare quale sovraccarico

Situazione	Sovraccarico consigliato
Sono necessari solo identificatori di glifi per l’ulteriore elaborazione	Encode(string text, IFont font) (o con alfabeto esplicito)
Ottenere un flusso PNG senza gestire il codice di rendering	Utilizzare l’overload con fontSize, lineSpacingType, lineSpacingValue e maxWidth
Separatori di parole personalizzati	Impostare inputSeparator e outputSeparator; questi parametri non modificano i simboli di punto e linea
La lingua di origine utilizza un alfabeto non latino e il rilevamento automatico fallisce	Passa esplicitamente il valore MorseAlphabets appropriato

Riepilogo

Aspose.Font ora include un motore completo di traduzione del codice Morse che opera sia a livello di glifi che a livello di bitmap. Utilizzando i semplici metodi di fabbrica puoi iniziare immediatamente a codificare, decodificare e rendere testo negli alfabeti supportati senza scrivere le tue tabelle di mappatura o occuparti del rendering di basso livello.

Sia che tu stia costruendo:

• Un componente personalizzato per la visualizzazione del segnale
• Uno strumento educativo per insegnare la comunicazione Morse
• Una fase di offuscamento dei dati che memorizza le informazioni come caratteri stilizzati

l’API ti offre il pieno controllo mantenendo il codice pulito, multipiattaforma e completamente supportato.