RTLTMPro

Текстовая сетка RTL Pro

Этот плагин добавляет поддержку языка с письмом справа налево в плагин Unity «TextMeshPro». В вашем проекте должен быть плагин TextMeshPro . Вы можете установить TMPro через Package Manager .

В настоящее время поддерживаются арабский, фарси и иврит. Если вы обнаружили проблему с одним из этих языков или вам нужна поддержка другого языка с письмом справа налево, откройте проблему.

• Функции
• Установка
• Создание шрифтов
• Использование
• Известные проблемы
• Вклад

Функции

фарси, арабский и иврит

Текст с письмом справа налево в реальном времени

Вам не нужно конвертировать, копировать и вставлять тексты. Начните писать, и тексты будут сразу же конвертированы.

Форматированный текст

Все теги Text Mesh Pro доступны в RTL Text Mesh Pro

RTL InputField (см. известные проблемы)

Поддерживается поле ввода в реальном времени.

Раскрывающийся список RTL (см. известные проблемы)

Многострочный

Да, у этого плагина нет проблем с многострочными текстами с письмом справа налево.

Авторазмер

Автоматический размер шрифта полностью поддерживается.

Поддерживаются английские, фарси и арабские цифры.

Арабский ташкиль

Поддерживается арабский ташкиль.

Поддержка символов нулевой ширины без объединения

Вы можете вставить символ нулевой ширины без соединения с помощью горячей клавиши Ctrl+Shift+2.

Установка

В вашем проекте должен быть плагин TextMeshPro . Вы можете установить TMPro через Package Manager . НЕ устанавливайте Text Mesh Pro из Asset Store.

из файла .unitypackage

Загрузите последний файл unitypackage из раздела релизов и импортируйте его в свой проект из меню «Активы -> Импортировать пакет -> Пользовательский пакет...» в Unity.

из ОпенУПМ

hk1ll3r поддерживает версию этого репозитория для менеджера пакетов в OpenUPM.

В окне «Настройки проекта» добавьте OpenUPM в качестве реестра с заданной областью или, если вы уже добавили его, добавьте к нему новую область.

Затем в окне «Диспетчер пакетов» измените область на «Мои реестры» . Выберите пакет «RTL Text Mesh Pro» и нажмите «Установить» .

Примеры сцен и демонстрационные ресурсы (шрифты, шейдеры и т. д.) включены в пакет в виде файла .unitypackage. Чтобы использовать их, вам необходимо импортировать их в папку «Ресурсы». В окне проекта перейдите в папку пакета и дважды щелкните файл «RTLTMPRo-demo-resources», чтобы импортировать эти ресурсы в свой проект.

Как создать шрифтовые ресурсы

Вам необходимо создать ресурсы шрифтов из файлов шрифтов, чтобы использовать их с TextMeshPro. Вот основные инструкции для удобства. Вы можете ознакомиться с официальной документацией TextMeshPro, чтобы узнать больше.

Откройте окно Window/TextMeshPro/Font Asset Creator .

1. Назначьте свой шрифт в поле Font Source (ваш шрифт должен содержать ваши символы)
2. Установите размер атласа. Для арабского языка мы рекомендуем как минимум 512x512, а для иврита — 128x128. Атлас большего размера будет иметь лучшее качество, но больший размер на диске.
3. Установите Character Set в Unicode Range .
4. Скопируйте диапазоны символов из файлов в папке Assets/RTLTMPro/Ranges в Character Sequence (Hex) .
   • Арабские буквы находятся в файле ArabicLetters.txt .
   • Арабские цифры находятся в файле ArabicDigits.txt
   • Арабская буква ташкиль находится в файле ArabicTashkeel.txt .
   • Все арабские символы находятся в ArabicAll.txt . Обычно вы используете это для создания вашего шрифта.
   • Буквы иврита находятся в файле HebrewLetters.txt .
5. Нажмите кнопку Generate Font Atlas и подождите, пока он сгенерирует атлас.
6. Нажмите Save TextMeshPro Font Asset и сохраните ресурс шрифта.

Описание использования

• Используйте меню GameObject/UI/* - RTLTMP для создания элементов пользовательского интерфейса RTL. (В качестве альтернативы вы можете заменить компоненты Text Mesh Pro UGUI на RTL Text Mesh Pro )
• Назначьте свой ресурс шрифта Свойство Font Asset в компоненте RTL Text Mesh Pro
• Введите текст в разделе RTL TEXT INPUT BOX .

фарси

Если этот флажок установлен, английские номера будут преобразованы в номера на фарси. Если флажок снят, английские цифры будут преобразованы в арабские.

Сохранение чисел

При проверке числа не будут конвертироваться.

Принудительное исправление

RTL Text Mesh Pro не исправляет тексты, начинающиеся с английских символов. Установка этого флажка заставляет RTL TextMeshPro исправлять текст, даже если он начинается с английских символов. Многострочные тексты на английском языке будут вызывать проблемы на компонентах, на которых установлен флажок ForceFix .

Исправить теги

Если этот флажок установлен, RTL Text Mesh Pro попытается исправить теги форматированного текста.

Известные проблемы

• Исправлено в последней версии. Для более старых версий выполните следующие действия . Нам нужно переопределить свойство text TextMeshProUGUI . Но свойство text не определено virtual . Вам необходимо вручную сделать свойство виртуальным.
  • Откройте TMP_Text.cs из исходного кода TextMeshPro.
  • добавить виртуальное ключевое слово в свойство text.
    
  • Откройте RTLTextMeshPro.cs и раскомментируйте верхнюю строку, где написано //#define RTL_OVERRIDE
  • Теперь вы можете использовать поля ввода и раскрывающиеся списки.

Вклад

Все вклады приветствуются. Убедитесь, что вы следуете стилю кода проекта. Мы активно отслеживаем запросы на включение.

Контакт:

• [email protected]
• [email protected]