# dxDrawText (Cliente)

> Dibuja un texto en la pantalla durante un fotograma, dentro de una caja.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Dibujo en pantalla
- **URL**: https://wiki.mymp.gg/es/dxDrawText

## Sintaxis

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

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `text` | `string` | El texto, en UTF-8. `\n` salta de línea. |
| `leftX, topY` | `float` | Esquina superior izquierda de la caja, en píxeles. También acepta un vec2. |
| `rightX, bottomY` | `float` | Esquina inferior derecha de la caja, en píxeles. También acepta un vec2. *(por defecto: `leftX, topY`)* |
| `color` | `color` | Color, un valor de `tocolor`. *(por defecto: `tocolor(255, 255, 255)`)* |
| `scaleX, scaleY` | `float` | Escala del texto. Un solo número vale para los dos ejes. También acepta un vec2. *(por defecto: `1`)* |
| `font` | `string\|element` | El nombre de una fuente (de un pack o dado a `dxCreateFont`) o un elemento de fuente de `dxCreateFont`. *(por defecto: `default`)* |
| `alignX` | `string` | Alineación horizontal en la caja: `left`, `center` o `right`. *(por defecto: `left`)* |
| `alignY` | `string` | Alineación vertical en la caja: `top`, `center` o `bottom`. *(por defecto: `top`)* |
| `clip` | `bool` | Recorta lo que sale de la caja. *(por defecto: `false`)* |
| `wordBreak` | `bool` | Parte las líneas que no caben en el ancho de la caja. *(por defecto: `false`)* |
| `postGUI` | `bool` | Dibuja por encima de la interfaz. *(por defecto: `false`)* |
| `colorCoded` | `bool` | Lee códigos de color `#RRGGBB` dentro del texto. *(por defecto: `false`)* |
| `subPixelPositioning` | `bool` | Usa posiciones fraccionarias en lugar de redondear al píxel. *(por defecto: `false`)* |
| `rotation` | `float` | Rotación en grados. *(por defecto: `0`)* |
| `rotationCenterX, rotationCenterY` | `float` | Centro de la rotación, en píxeles. Por defecto, el centro de la caja. *(por defecto: `nil`)* |
| `lineHeight` | `float` | Alto de cada línea en píxeles. 0 usa el alto de la fuente. *(por defecto: `0`)* |

## Retorno

`true` si el dibujo quedó en cola, `false` si la fuente no existe.

## Ejemplo

```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)
```

### Atención

`lineHeight` solo vale para texto con `colorCoded`; el texto sin códigos de color siempre usa el alto de la fuente. Un nombre de fuente que no existe registra un aviso y la función devuelve `false`.

## Ver también

- [dxGetTextWidth (Cliente)](https://wiki.mymp.gg/es/dxGetTextWidth.md): Mide el ancho que ocupa un texto en la pantalla, en su línea más ancha.
- [dxGetTextSize (Cliente)](https://wiki.mymp.gg/es/dxGetTextSize.md): Mide el ancho y el alto que ocupa un texto en la pantalla.
- [dxCreateFont (Cliente)](https://wiki.mymp.gg/es/dxCreateFont.md): Crea una fuente a partir de un archivo de fuente del recurso, para las funciones de texto.
- [onClientRender (Cliente)](https://wiki.mymp.gg/es/onClientRender.md): Se dispara en cada fotograma, cuando se deben hacer los dibujos dx de ese fotograma.