# dxDrawImage (Cliente)

> Desenha uma imagem na tela durante um quadro.

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

## Sintaxe

```lua
bool dxDrawImage(float x, y, float width, height, texture|dui|string image [, float rotation = 0, float rotationCenterOffsetX, rotationCenterOffsetY = 0, 0, color color = tocolor(255, 255, 255), bool postGUI = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y` | `float` | Canto superior esquerdo na tela, em pixels. Aceita também um vec2. |
| `width, height` | `float` | Tamanho na tela, em pixels. Aceita também um vec2. |
| `image` | `texture\|dui\|string` | A imagem (textura, render target, screen source ou dui) ou o caminho de um arquivo de imagem do recurso. |
| `rotation` | `float` | Rotação em graus, no sentido horário. *(padrão: `0`)* |
| `rotationCenterOffsetX, rotationCenterOffsetY` | `float` | Deslocamento do centro de rotação a partir do centro da imagem, em pixels. Aceita também um vec2. *(padrão: `0, 0`)* |
| `color` | `color` | Cor que multiplica a imagem, um valor de `tocolor`. *(padrão: `tocolor(255, 255, 255)`)* |
| `postGUI` | `bool` | Desenha por cima da interface. *(padrão: `false`)* |

## Retorno

`true` se o desenho foi enfileirado, `false` se a imagem não pôde ser carregada.

Um caminho é carregado uma vez e guardado para as próximas chamadas. Enquanto o arquivo carrega, nada é desenhado.

## Exemplo

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

addEventHandler("onClientRender", root, function()
    dxDrawImage(sx - 140, 20, 120, 120, "images/logo.png", getTickCount() / 20 % 360)
end)
```

## Veja também

- [dxDrawImageSection (Cliente)](https://wiki.mymp.gg/pt/dxDrawImageSection.md): Desenha uma parte de uma imagem na tela durante um quadro.
- [engineCreateTexture (Cliente)](https://wiki.mymp.gg/pt/engineCreateTexture.md): Cria uma textura a partir de um arquivo de imagem do recurso ou dos bytes de uma imagem na memória. A textura existe só neste cliente.
- [dxCreateRenderTarget (Cliente)](https://wiki.mymp.gg/pt/dxCreateRenderTarget.md): Cria um render target: uma imagem em que as funções dx podem desenhar e que pode ser usada como qualquer outra imagem.
- [dxGetMaterialSize (Cliente)](https://wiki.mymp.gg/pt/dxGetMaterialSize.md): Devolve o tamanho de uma imagem em pixels.