RTLTMPro

RTL Text Mesh Pro

Dieses Plugin fügt dem Unity-Plugin „TextMeshPro“ Sprachunterstützung für die Schreibrichtung von rechts nach links hinzu. Sie benötigen das TextMeshPro Plugin in Ihrem Projekt. Sie können TMPro über Package Manager installieren.

Derzeit werden Arabisch, Farsi und Hebräisch unterstützt. Wenn Sie ein Problem mit einer dieser Sprachen feststellen oder Unterstützung für eine andere RTL-Sprache wünschen, öffnen Sie ein Problem.

• Merkmale
• Installation
• Schriftarten erstellen
• Verwendung
• Bekannte Probleme
• Beitrag

Merkmale

Farsi, Arabisch und Hebräisch

Echtzeit-RTL-Text

Sie müssen keine Texte konvertieren, kopieren und einfügen. Beginnen Sie mit dem Schreiben und die Texte werden sofort umgesetzt.

Rich-Text

Alle Tags von Text Mesh Pro sind in RTL Text Mesh Pro verfügbar

RTL InputField (Siehe bekannte Probleme)

Echtzeit-InputField wird unterstützt.

RTL-Dropdown (siehe bekannte Probleme)

Mehrzeilig

Ja, dieses Plugin hat kein Problem mit mehrzeiligen RTL-Texten.

AutoSize

Die automatische Schriftgröße wird vollständig unterstützt.

Englische, Farsi- und arabische Ziffern werden unterstützt

Arabischer Taschkeel

Arabische Taschkeel werden unterstützt.

Unterstützung für No-Joiner-Zeichen mit Nullbreite

Sie können ein Null-Breite-No-Joiner-Zeichen mit der Tastenkombination Strg+Umschalt+2 einfügen.

Installation

Sie benötigen das TextMeshPro Plugin in Ihrem Projekt. Sie können TMPro über Package Manager installieren. Installieren Sie Text Mesh Pro NICHT aus dem Asset Store.

aus der .unitypackage-Datei

Laden Sie die neueste Unitypackage-Datei aus dem Abschnitt „Releases“ herunter und importieren Sie sie über das Menü „Assets -> Paket importieren -> Benutzerdefiniertes Paket...“ in Unity in Ihr Projekt.

von OpenUPM

hk1ll3r verwaltet eine Paketmanagerversion dieses Repos auf OpenUPM.

Fügen Sie im Fenster „Projekteinstellungen“ OpenUPM als bereichsbezogene Registrierung hinzu. Wenn Sie es bereits hinzugefügt haben, fügen Sie den neuen Bereich hinzu.

Ändern Sie dann im Fenster „Paketmanager“ den Bereich in „Meine Registrierungen“ . Wählen Sie das Paket „RTL Text Mesh Pro“ und klicken Sie auf „Installieren“ .

Die Beispielszenen und Demoressourcen (Schriftarten, Shader usw.) sind als .unitypackage-Datei im Paket enthalten. Sie müssen diese in Ihren Assets-Ordner importieren, um sie verwenden zu können. Navigieren Sie im Projektfenster zum Paketordner und doppelklicken Sie auf die Datei „RTLTMPRo-demo-resources“, um diese Assets in Ihr Projekt zu importieren.

So erstellen Sie Schriftarten-Assets

Sie müssen Schriftarten-Assets aus Schriftartendateien erstellen, um sie mit TextMeshPro verwenden zu können. Zur Vereinfachung finden Sie hier grundlegende Anweisungen. Weitere Informationen finden Sie in der offiziellen TextMeshPro-Dokumentation.

Öffnen Sie das Fenster Window/TextMeshPro/Font Asset Creator .

1. Weisen Sie Ihre Schriftart im Feld Font Source zu (Ihre Schriftart muss Ihre Zeichen enthalten)
2. Atlasgröße festlegen. Für Arabisch empfehlen wir mindestens 512 x 512 und für Hebräisch 128 x 128. Ein größerer Atlas hat eine bessere Qualität, ist aber auf der Festplatte größer.
3. Stellen Sie Character Set auf Unicode Range ein.
4. Kopieren Sie Zeichenbereiche aus Dateien im Ordner Assets/RTLTMPro/Ranges in Character Sequence (Hex) .
   • Arabische Buchstaben befinden sich in der Datei ArabicLetters.txt
   • Arabische Ziffern befinden sich in der Datei ArabicDigits.txt
   • Der arabische Taschkeel-Buchstabe befindet sich in der Datei ArabicTashkeel.txt .
   • Alle arabischen Zeichen sind in ArabicAll.txt enthalten. Normalerweise würden Sie dies zum Erstellen Ihres Schriftarten-Assets verwenden.
   • Hebräische Buchstaben sind in HebrewLetters.txt enthalten.
5. Klicken Sie auf die Schaltfläche Generate Font Atlas und warten Sie, bis der Atlas generiert wird.
6. Klicken Sie auf Save TextMeshPro Font Asset und speichern Sie das Schriftart-Asset.

Nutzungsbeschreibung

• Verwenden Sie das Menü GameObject/UI/* - RTLTMP um RTL-UI-Elemente zu erstellen. (Alternativ können Sie Text Mesh Pro UGUI durch RTL Text Mesh Pro ersetzen.)
• Weisen Sie die Schriftart-Asset-Eigenschaft Ihres Schriftart- Font Asset in RTL Text Mesh Pro -Komponente zu
• Geben Sie Text in den Abschnitt RTL TEXT INPUT BOX ein.

Farsi

Wenn diese Option aktiviert ist, werden englische Zahlen in Farsi-Zahlen umgewandelt. Wenn diese Option deaktiviert ist, werden englische Zahlen in arabische Zahlen umgewandelt.

Zahlen bewahren

Wenn aktiviert, werden Zahlen nicht konvertiert.

Fix erzwingen

RTL Text Mesh Pro korrigiert keine Texte, die mit englischen Zeichen beginnen. Durch Aktivieren dieses Kontrollkästchens wird RTL TextMeshPro gezwungen, den Text zu korrigieren, selbst wenn er mit englischen Zeichen beginnt. Bei mehrzeiligen englischen Texten treten Probleme bei Komponenten auf, bei denen ForceFix überprüft wurde.

Tags reparieren

Wenn diese Option aktiviert ist, versucht RTL Text Mesh Pro, Rich-Text-Tags zu reparieren.

Bekannte Probleme

• In der neuesten Version behoben. Für ältere Versionen befolgen Sie die folgenden Schritte . Wir müssen die text von TextMeshProUGUI überschreiben. Die text ist jedoch nicht virtual definiert. Sie müssen die Eigenschaft manuell virtuell machen.
  • Öffnen Sie TMP_Text.cs aus dem TextMeshPro-Quellcode
  • Fügen Sie der Texteigenschaft ein virtuelles Schlüsselwort hinzu.
    
  • Öffnen Sie RTLTextMeshPro.cs und kommentieren Sie die oberste Zeile dort aus, wo //#define RTL_OVERRIDE steht
  • Jetzt können Sie InputFields und Dropdowns verwenden.

Beitrag

Alle Beiträge sind willkommen. Stellen Sie sicher, dass Sie dem Codestil des Projekts folgen. Wir überwachen Pull-Requests aktiv.

Kontakt:

• [email protected]
• [email protected]