# dxCreateRenderTarget (Cliente)

> Cria um render target: uma imagem em que as funções `dx` podem desenhar e que pode ser usada como qualquer outra imagem.

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

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `width, height` | `int` | Tamanho em pixels, de 1 a 16384. Aceita também um vec2. |
| `withAlpha` | `bool\|string` | Mantém o canal alfa. Também aceita o nome de um formato de superfície do MTA (`a8r8g8b8`, `x8r8g8b8`, `r5g6b5`...): os que têm `a` mantêm o alfa, os outros não. *(padrão: `false`)* |

## Retorno

O render target, ou `false` se o tamanho está fora de 1 a 16384, se não há memória de vídeo livre ou se o formato não é suportado.

## Exemplo

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

### Atenção

Um nome de formato que o MYMP não conhece (como os formatos de profundidade) gera um aviso e devolve `false`.

## Veja também

- [dxSetRenderTarget (Cliente)](https://wiki.mymp.gg/pt/dxSetRenderTarget.md): Escolhe onde as próximas funções dx desenham: num render target ou, sem ele, na tela.
- [dxDrawImage (Cliente)](https://wiki.mymp.gg/pt/dxDrawImage.md): Desenha uma imagem na tela durante um quadro.
- [engineSetWorldTexture (Cliente)](https://wiki.mymp.gg/pt/engineSetWorldTexture.md): Troca uma textura em todos os modelos dos tipos escolhidos que a usam. Só os materiais dos modelos mudam, não o txd de onde a textura vem.
- [destroyElement (Compartilhado)](https://wiki.mymp.gg/pt/destroyElement.md): Destrói um elemento e todos os seus filhos. Antes de sumir, cada um dispara onElementDestroy no servidor ou onClientElementDestroy no cliente.