CKTIS / JavaScript
Canvas 2D: limpar uma área e desenhar um círculo preenchido
Distingue a limpeza de píxeis da reposição do caminho. Cria um círculo com `arc()`, define `fillStyle` e preenche o interior com `fill()`.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const ctx = canvas.getContext("2d"); // CanvasRenderingContext2D or null
ctx.clearRect(x, y, width, height);
ctx.beginPath();
ctx.arc(x, y, radius, startAngle, endAngle);
ctx.arc(x, y, radius, startAngle, endAngle, counterclockwise);
ctx.fillStyle = style; // CSS color string, CanvasGradient, or CanvasPattern
ctx.fill();
ctx.fill(fillRule);
ctx.fill(path);
ctx.fill(path, fillRule); // path: Path2D; fillRule: "nonzero" or "evenodd"clearRect(), beginPath(), arc() e fill() são métodos de CanvasRenderingContext2D; fillStyle é uma propriedade. Pertencem à plataforma Web, não ao ECMAScript 2024. Num elemento canvas, chama canvas.getContext("2d") e verifica se o resultado é diferente de null; a disponibilidade depende do ambiente de execução.
clearRect(x, y, width, height) deixa os píxeis de um retângulo a preto transparente num contexto com o canal alfa ativo. Respeita a transformação e a região de recorte atuais, mas não usa fillStyle nem elimina o caminho. Para limpar toda a área de desenho com clearRect(0, 0, canvas.width, canvas.height), usa a transformação identidade e garante que o recorte não exclua nenhuma parte dessa área.
beginPath() esvazia o caminho atual sem alterar os píxeis nem o estilo. Chama este método antes de construir uma forma independente para que o fill() seguinte não volte a pintar por engano a geometria anterior.
arc(x, y, radius, startAngle, endAngle, counterclockwise) acrescenta um arco com centro em (x, y) sem o pintar. Os ângulos são medidos em radianos a partir do eixo X positivo. O sentido predefinido é o dos ponteiros do relógio; true inverte-o no sistema de coordenadas predefinido. Os ângulos 0 e 2 * Math.PI, no sentido predefinido, formam uma circunferência completa. Se o caminho já tiver um ponto final, arc() liga-o ao início do arco por um segmento de reta. Se algum argumento numérico for NaN, Infinity ou -Infinity, arc() termina sem alterar o caminho. Se todos os argumentos numéricos forem finitos, um raio negativo lança IndexSizeError.
A propriedade fillStyle aceita uma cadeia de caracteres com uma cor CSS, um CanvasGradient ou um CanvasPattern. O valor predefinido é preto; uma cadeia de cor inválida não altera o estilo anterior. A atribuição não muda a cor dos píxeis já desenhados.
fill() e fill(fillRule) preenchem o caminho atual com o estilo atual. fill(path) e fill(path, fillRule) preenchem o Path2D fornecido. A regra predefinida "nonzero" verifica se a soma dos cruzamentos do caminho com uma semirreta, com sinal consoante o sentido do cruzamento, é diferente de zero; "evenodd" verifica se o número de cruzamentos é ímpar. O preenchimento trata os subcaminhos abertos como fechados, sem os modificar nem esvaziar o caminho.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel samples</title>
<pre id="output"></pre>
<script>
const canvas = document.createElement("canvas");
canvas.width = 48;
canvas.height = 24;
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable");
const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(",");
ctx.beginPath();
ctx.arc(12, 12, 8, 0, 2 * Math.PI);
ctx.fillStyle = "#ff0000";
ctx.fill();
const samples = [rgba(12, 12)];
ctx.clearRect(0, 0, canvas.width, canvas.height);
ctx.beginPath();
ctx.arc(36, 12, 8, 0, 2 * Math.PI);
ctx.fillStyle = "#0000ff";
ctx.fill();
samples.push(rgba(12, 12), rgba(36, 12));
document.getElementById("output").textContent = samples.join("\n");
</script>Resultado
255,0,0,255 0,0,0,0 0,0,255,255
Guarda o exemplo como ficheiro HTML e abre-o num navegador. As três amostras RGBA apresentadas são o centro vermelho do primeiro círculo, o píxel transparente na mesma posição após o novo desenho e o centro azul do novo círculo. O canvas não é inserido na página. `getImageData()` lança `SecurityError` se o canvas deixar de estar `origin-clean`, por exemplo, após desenhar uma imagem de outra origem sem autorização CORS; `clearRect()` por si só não repõe esse estado.
Lições relacionadas
- JavaScript · Lição 27 · Intermédio · Versão: 3