# dxDrawText (Cliente)

> Desenha um texto na tela durante um quadro, dentro de uma caixa.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Desenho na tela
- **URL**: https://wiki.mymp.gg/pt/dxDrawText

## Sintaxe

```lua
bool dxDrawText(string text, float leftX, topY [, float rightX, bottomY = leftX, topY, color color = tocolor(255, 255, 255), float scaleX, scaleY = 1, string|element font = default, string alignX = left, string alignY = top, bool clip = false, bool wordBreak = false, bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false, float rotation = 0, float rotationCenterX, rotationCenterY = nil, float lineHeight = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `text` | `string` | O texto, em UTF-8. `\n` quebra a linha. |
| `leftX, topY` | `float` | Canto superior esquerdo da caixa, em pixels. Aceita também um vec2. |
| `rightX, bottomY` | `float` | Canto inferior direito da caixa, em pixels. Aceita também um vec2. *(padrão: `leftX, topY`)* |
| `color` | `color` | Cor, um valor de `tocolor`. *(padrão: `tocolor(255, 255, 255)`)* |
| `scaleX, scaleY` | `float` | Escala do texto. Um único número vale para os dois eixos. Aceita também um vec2. *(padrão: `1`)* |
| `font` | `string\|element` | O nome de uma fonte (de um pack ou dada a `dxCreateFont`) ou um elemento de fonte de `dxCreateFont`. *(padrão: `default`)* |
| `alignX` | `string` | Alinhamento horizontal na caixa: `left`, `center` ou `right`. *(padrão: `left`)* |
| `alignY` | `string` | Alinhamento vertical na caixa: `top`, `center` ou `bottom`. *(padrão: `top`)* |
| `clip` | `bool` | Corta o que sai da caixa. *(padrão: `false`)* |
| `wordBreak` | `bool` | Quebra as linhas que não cabem na largura da caixa. *(padrão: `false`)* |
| `postGUI` | `bool` | Desenha por cima da interface. *(padrão: `false`)* |
| `colorCoded` | `bool` | Lê códigos de cor `#RRGGBB` dentro do texto. *(padrão: `false`)* |
| `subPixelPositioning` | `bool` | Usa posições fracionárias em vez de arredondar para o pixel. *(padrão: `false`)* |
| `rotation` | `float` | Rotação em graus. *(padrão: `0`)* |
| `rotationCenterX, rotationCenterY` | `float` | Centro da rotação, em pixels. Por padrão, o centro da caixa. *(padrão: `nil`)* |
| `lineHeight` | `float` | Altura de cada linha em pixels. 0 usa a altura da fonte. *(padrão: `0`)* |

## Retorno

`true` se o desenho foi enfileirado, `false` se a fonte não existe.

## Exemplo

```lua
local sx, sy = getScreenSize()

addEventHandler("onClientRender", root, function()
    dxDrawText("#FFAA00MYMP #FFFFFFRoleplay", 0, 20, sx, 60, tocolor(255, 255, 255), 2, "default", "center", "top", false, false, false, true)
end)
```

### Atenção

`lineHeight` só vale para texto com `colorCoded`; o texto sem códigos de cor sempre usa a altura da fonte. Um nome de fonte que não existe gera um aviso e a função devolve `false`.

## Veja também

- [dxGetTextWidth (Cliente)](https://wiki.mymp.gg/pt/dxGetTextWidth.md): Mede a largura que um texto ocupa na tela, na linha mais larga.
- [dxGetTextSize (Cliente)](https://wiki.mymp.gg/pt/dxGetTextSize.md): Mede a largura e a altura que um texto ocupa na tela.
- [dxCreateFont (Cliente)](https://wiki.mymp.gg/pt/dxCreateFont.md): Cria uma fonte a partir de um arquivo de fonte do recurso, para usar nas funções de texto.
- [onClientRender (Cliente)](https://wiki.mymp.gg/pt/onClientRender.md): Disparado a cada quadro, quando os desenhos dx daquele quadro devem ser feitos.