RTLTMPro

Malha de texto RTL Pro

Este plugin adiciona suporte ao idioma da direita para a esquerda ao plugin Unity "TextMeshPro". Você precisa ter o plugin TextMeshPro em seu projeto. Você pode instalar o TMPro através Package Manager .

Atualmente há suporte para árabe, farsi e hebraico. Se você encontrar um problema com um desses idiomas ou quiser suporte para outro idioma RTL, abra um problema.

• Características
• Instalação
• Criando fontes
• Uso
• Problemas conhecidos
• Contribuição

Características

Farsi, árabe e hebraico

Texto RTL em tempo real

Você não precisa converter, copiar e colar textos. Comece a escrever e os textos serão convertidos imediatamente.

Texto rico

Todas as tags do Text Mesh Pro estão disponíveis no RTL Text Mesh Pro

RTL InputField (veja problemas conhecidos)

InputField em tempo real é suportado.

Lista suspensa RTL (veja problemas conhecidos)

Multilinha

Sim, este plugin não tem problemas com textos RTL multilinhas.

Dimensionamento automático

O tamanho automático da fonte é totalmente suportado.

Dígitos ingleses, farsi e árabes são suportados

Tashkeel árabe

Tashkeel árabe são suportados.

Suporte a caracteres sem junção de largura zero

Você pode inserir caracteres sem junção de largura zero com a tecla de atalho Ctrl + Shift + 2.

Instalação

Você precisa ter o plugin TextMeshPro em seu projeto. Você pode instalar o TMPro através Package Manager . NÃO instale o Text Mesh Pro da Asset Store.

do arquivo .unitypackage

Baixe o arquivo UnityPackage mais recente da seção de lançamentos e importe-o para o seu projeto no menu "Ativos -> Pacote de Importação -> Pacote Personalizado..." no Unity.

do OpenUPM

hk1ll3r mantém uma versão do gerenciador de pacotes deste repositório no OpenUPM.

Na janela Configurações do projeto, adicione OpenUPM como um registro com escopo ou se você já o adicionou, adicione o novo escopo a ele.

Em seguida, na janela Package Manager, altere o escopo para My Registries . Selecione o pacote "RTL Text Mesh Pro" e pressione Instalar .

As cenas de amostra e recursos de demonstração (fontes, shaders, etc.) estão incluídos no pacote como um arquivo .unitypackage. Você precisa importá-los para sua pasta Ativos para usá-los. Na janela do projeto, navegue até a pasta do pacote e clique duas vezes no arquivo "RTLTMPRo-demo-resources" para importar esses ativos para o seu projeto.

Como criar ativos de fonte

Você precisa criar ativos de fonte a partir de arquivos de fonte para usá-los com TextMeshPro. Aqui estão instruções básicas para sua conveniência. Você pode verificar a documentação oficial do TextMeshPro para saber mais.

Abra a janela Window/TextMeshPro/Font Asset Creator .

1. Atribua sua fonte no campo Font Source (sua fonte deve incluir seus caracteres)
2. Defina o tamanho do atlas. Para árabe recomendamos 512x512 e para hebraico 128x128 no mínimo. Um atlas maior terá melhor qualidade, mas tamanho maior no disco.
3. Defina Character Set como Unicode Range .
4. Copie os intervalos de caracteres dos arquivos na pasta Assets/RTLTMPro/Ranges para Character Sequence (Hex) .
   • As letras árabes estão no arquivo ArabicLetters.txt
   • Os dígitos árabes estão no arquivo ArabicDigits.txt
   • A letra tashkeel árabe está no arquivo ArabicTashkeel.txt .
   • Todos os caracteres árabes estão em ArabicAll.txt . Normalmente você usaria isso para criar seu recurso de fonte.
   • As letras hebraicas estão em HebrewLetters.txt .
5. Pressione o botão Generate Font Atlas e espere que ele gere o atlas.
6. Pressione Save TextMeshPro Font Asset e salve o ativo de fonte.

Descrição de uso

• Use GameObject/UI/* - RTLTMP para criar elementos de UI RTL. (Como alternativa, você pode substituir os componentes Text Mesh Pro UGUI pelo RTL Text Mesh Pro )
• Atribua a propriedade Font Asset ao seu recurso de fonte no componente RTL Text Mesh Pro
• Insira o texto na seção RTL TEXT INPUT BOX .

persa

Quando marcado, os números ingleses serão convertidos em números farsi. Quando desmarcado, os números ingleses serão convertidos em números arábicos.

Preservar números

Quando marcado, os números não serão convertidos.

Forçar correção

RTL Text Mesh Pro não corrige textos que começam com caracteres ingleses. Marcar esta caixa de seleção força o RTL TextMeshPro a corrigir o texto mesmo quando ele começa com caracteres em inglês. Textos multilinha em inglês terão problemas em componentes que tenham ForceFix marcado.

Corrigir tags

Quando marcado, RTL Text Mesh Pro tentará corrigir tags de rich text.

Problemas conhecidos

• Corrigido na versão mais recente. Para versões mais antigas siga os passos abaixo . Precisamos substituir a propriedade text de TextMeshProUGUI . Mas a propriedade text não está definida virtual . Você precisa tornar a propriedade virtual manualmente.
  • Abra TMP_Text.cs do código-fonte TextMeshPro
  • adicione palavra-chave virtual à propriedade de texto.
    
  • Abra RTLTextMeshPro.cs e remova o comentário da linha superior onde diz //#define RTL_OVERRIDE
  • Agora você pode usar InputFields e Dropdowns.

Contribuição

Todas as contribuições são bem-vindas. Certifique-se de seguir o estilo de código do projeto. Monitoramos ativamente as solicitações pull.

Contato:

• [email protected]
• [email protected]