# dxCreateRenderTarget (Cliente)

> Crea un render target: una imagen en la que las funciones `dx` pueden dibujar y que se puede usar como cualquier otra imagen.

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

## Sintaxis

```lua
texture|false dxCreateRenderTarget(int width, height [, bool|string withAlpha = false])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `width, height` | `int` | Tamaño en píxeles, de 1 a 16384. También acepta un vec2. |
| `withAlpha` | `bool\|string` | Mantiene el canal alfa. También acepta el nombre de un formato de superficie de MTA (`a8r8g8b8`, `x8r8g8b8`, `r5g6b5`...): los que tienen `a` mantienen el alfa, los demás no. *(por defecto: `false`)* |

## Retorno

El render target, o `false` si el tamaño está fuera de 1 a 16384, si no hay memoria de vídeo libre o si el formato no es compatible.

## Ejemplo

```lua
local canvas = dxCreateRenderTarget(256, 64, true)

addEventHandler("onClientRender", root, function()
    dxSetRenderTarget(canvas, true)
    dxDrawText("Placar: 3 x 1", 0, 0, 256, 64, tocolor(255, 255, 255), 2, "default", "center", "center")
    dxSetRenderTarget()
    dxDrawImage(20, 20, 256, 64, canvas)
end)
```

### Atención

Un nombre de formato que MYMP no conoce (como los formatos de profundidad) registra un aviso y devuelve `false`.

## Ver también

- [dxSetRenderTarget (Cliente)](https://wiki.mymp.gg/es/dxSetRenderTarget.md): Elige dónde dibujan las siguientes funciones dx: en un render target o, sin él, en la pantalla.
- [dxDrawImage (Cliente)](https://wiki.mymp.gg/es/dxDrawImage.md): Dibuja una imagen en la pantalla durante un fotograma.
- [engineSetWorldTexture (Cliente)](https://wiki.mymp.gg/es/engineSetWorldTexture.md): Cambia una textura en todos los modelos de los tipos elegidos que la usan. Solo cambian los materiales de los modelos, no el txd del que viene la textura.
- [destroyElement (Compartido)](https://wiki.mymp.gg/es/destroyElement.md): Destruye un elemento y todos sus hijos. Antes de desaparecer, cada uno dispara onElementDestroy en el servidor u onClientElementDestroy en el cliente.