dxDrawCircle

Desenha um disco (ou uma fatia dele) usando um leque de triângulos.

Sintaxe

bool dxDrawCircle ( number x, number y, number raio [, number anguloInicial = 0, number anguloFinal = 360, number cor = tocolor(255,255,255,255), number corCentro = cor, number segmentos = 32, number proporcao = 1, bool postGUI = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
x, y	number	—	Centro do círculo, em pixels.
raio	number	—	Raio em pixels. Precisa ser maior que zero.
anguloInicial	number	0	Onde a fatia começa, em graus.
anguloFinal	number	360	Onde a fatia termina, em graus.
cor	number	branco opaco	Cor da borda.
corCentro	number	igual a cor	Cor do centro — diferente da borda, gera um degradê.
segmentos	number	32	Quantos triângulos formam o círculo, de 3 a 1024. Quanto maior, mais liso.
proporcao	number	1	Multiplica o raio no eixo horizontal, transformando o círculo em elipse. Aceita valores acima de 0 e até 100.
postGUI	bool	false	true desenha depois da GUI, por cima dela.

Retorno

true se o círculo foi desenhado. Devolve false sem desenhar nada quando o raio não é positivo, quando os dois ângulos são iguais, quando segmentos está fora de 3–1024 ou quando proporcao está fora do intervalo aceito.

Se os ângulos vierem invertidos, eles são trocados; e um arco maior que uma volta completa é cortado em 360 graus.

Exemplo

-- medidor de 3/4 de volta, escuro no meio e claro na borda
dxDrawCircle(200, 200, 60, 0, 270, tocolor(0, 170, 255, 255), tocolor(0, 40, 80, 255), 64)

Veja também

• dxDrawLine — Desenha uma linha reta entre dois pontos.
• dxDrawPrimitive — Desenha uma figura livre a partir de uma lista de vértices.
• dxDrawMaterialPrimitive — O mesmo que dxDrawPrimitive, mas preenchendo a figura com uma imagem.