# dxDrawRectangle (Cliente)

> Desenha um retângulo preenchido 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/dxDrawRectangle

## Sintaxe

```lua
bool dxDrawRectangle(float x, y, float width, height [, color color = tocolor(255, 255, 255), bool postGUI = false, bool subPixelPositioning = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y` | `float` | Canto superior esquerdo, em pixels. Aceita também um vec2. |
| `width, height` | `float` | Tamanho em pixels. Aceita também um vec2. |
| `color` | `color` | Cor, um valor de `tocolor`. *(padrão: `tocolor(255, 255, 255)`)* |
| `postGUI` | `bool` | Desenha por cima da interface. *(padrão: `false`)* |
| `subPixelPositioning` | `bool` | Usa posições fracionárias em vez de arredondar para o pixel. *(padrão: `false`)* |

## Retorno

`true` se o desenho foi enfileirado.

## Exemplo

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

addEventHandler("onClientRender", root, function()
    dxDrawRectangle(sx - 220, 20, 200, 60, tocolor(0, 0, 0, 160))
end)
```

## Veja também

- [dxDrawImage (Cliente)](https://wiki.mymp.gg/pt/dxDrawImage.md): Desenha uma imagem na tela durante um quadro.
- [dxDrawCircle (Cliente)](https://wiki.mymp.gg/pt/dxDrawCircle.md): Desenha um círculo preenchido, ou um setor dele, na tela durante um quadro.
- [getScreenSize (Cliente)](https://wiki.mymp.gg/pt/getScreenSize.md): Devolve o tamanho da tela do jogo em pixels.
- [onClientRender (Cliente)](https://wiki.mymp.gg/pt/onClientRender.md): Disparado a cada quadro, quando os desenhos dx daquele quadro devem ser feitos.