# dxGetTextSize (Cliente)

> Mide el ancho y el alto que ocupa un texto en la pantalla.

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

## Sintaxis

```lua
float, float|false dxGetTextSize(string text [, float width = 0, float scaleX, scaleY = 1, string|element font = default, bool wordBreak = false, bool colorCoded = false])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `text` | `string` | El texto. |
| `width` | `float` | Ancho disponible en píxeles, usado con `wordBreak`. *(por defecto: `0`)* |
| `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`)* |
| `wordBreak` | `bool` | Parte las líneas que no caben en `width`. *(por defecto: `false`)* |
| `colorCoded` | `bool` | Deja fuera de la medida los códigos de color `#RRGGBB`. *(por defecto: `false`)* |

## Retorno

El ancho y el alto en píxeles, o `false` si la fuente no existe.

## Ejemplo

```lua
local text = "Una descripción larga que debe dividirse en varias líneas."
local w, h = dxGetTextSize(text, 300, 1, "default", true)

addEventHandler("onClientRender", root, function()
    dxDrawRectangle(20, 20, w + 20, h + 20, tocolor(0, 0, 0, 160))
    dxDrawText(text, 30, 30, 330, 30 + h, tocolor(255, 255, 255), 1, "default", "left", "top", false, true)
end)
```

## 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.
- [dxGetFontHeight (Cliente)](https://wiki.mymp.gg/es/dxGetFontHeight.md): Devuelve el alto de una línea de texto de una fuente.
- [dxDrawText (Cliente)](https://wiki.mymp.gg/es/dxDrawText.md): Dibuja un texto en la pantalla durante un fotograma, dentro de una caja.
