# dxDrawCircle (Cliente)

> Desenha um círculo preenchido, ou um setor dele, 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/dxDrawCircle

## Sintaxe

```lua
bool dxDrawCircle(float x, y, float radius [, float startAngle = 0, float stopAngle = 360, color color = tocolor(255, 255, 255), color centerColor = color, int segments = 32, float ratio = 1, bool postGUI = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y` | `float` | Centro, em pixels. Aceita também um vec2. |
| `radius` | `float` | Raio em pixels. |
| `startAngle` | `float` | Ângulo inicial em graus. 0 aponta para a direita e o ângulo cresce no sentido horário. *(padrão: `0`)* |
| `stopAngle` | `float` | Ângulo final em graus. Os dois ângulos são trocados se estiverem invertidos, e o setor cobre no máximo 360°. *(padrão: `360`)* |
| `color` | `color` | Cor da borda, um valor de `tocolor`. *(padrão: `tocolor(255, 255, 255)`)* |
| `centerColor` | `color` | Cor do centro, que se mistura até a borda. *(padrão: `color`)* |
| `segments` | `int` | Quantidade de segmentos, de 3 a 1024. *(padrão: `32`)* |
| `ratio` | `float` | Largura dividida pela altura, para elipses. Acima de 0 e até 100. *(padrão: `1`)* |
| `postGUI` | `bool` | Desenha por cima da interface. *(padrão: `false`)* |

## Retorno

`true` se o desenho foi enfileirado. `false` quando `segments` está fora de 3 a 1024, `ratio` fora de 0 a 100, `radius` não é positivo ou os ângulos são iguais.

## Exemplo

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

addEventHandler("onClientRender", root, function()
    local health = getElementHealth(localPlayer)
    dxDrawCircle(sx - 60, sy - 60, 40, 0, 360 * health / 100, tocolor(200, 40, 40, 220))
end)
```

## Veja também

- [dxDrawRectangle (Cliente)](https://wiki.mymp.gg/pt/dxDrawRectangle.md): Desenha um retângulo preenchido na tela durante um quadro.
- [dxDrawPrimitive (Cliente)](https://wiki.mymp.gg/pt/dxDrawPrimitive.md): Desenha uma primitiva 2D (pontos, linhas ou triângulos) na tela durante um quadro.
- [tocolor (Compartilhado)](https://wiki.mymp.gg/pt/tocolor.md): Junta os componentes de uma cor num único número ARGB. É a mesma função que rgb.