CKTIS / JavaScript
Canvas 2D: borrar una región y dibujar un círculo relleno
Distingue entre borrar píxeles y reiniciar el trazado. Crea un círculo con `arc()`, elige el estilo con `fillStyle` y rellénalo con `fill()`.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
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() y fill() son métodos de CanvasRenderingContext2D; fillStyle es una propiedad. Son API de la plataforma web, no de ECMAScript 2024. En un elemento canvas, llama a canvas.getContext("2d") y comprueba que no devuelva null; la disponibilidad depende del entorno de ejecución.
clearRect(x, y, width, height) deja en negro transparente los píxeles de un rectángulo si el contexto tiene el canal alfa habilitado. Respeta la transformación y la región de recorte actuales, pero no usa fillStyle ni elimina el trazado. Para borrar todo el lienzo con clearRect(0, 0, canvas.width, canvas.height), usa la transformación identidad y asegúrate de que el recorte no excluya ninguna parte del lienzo.
beginPath() vacía el trazado actual sin cambiar los píxeles ni el estilo. Llámalo antes de construir una figura independiente para que el siguiente fill() no vuelva a pintar por error la geometría anterior.
arc(x, y, radius, startAngle, endAngle, counterclockwise) agrega un arco con centro en (x, y) sin pintarlo. Los ángulos se miden en radianes a partir del eje X positivo. El sentido predeterminado es el de las agujas del reloj; true lo invierte en el sistema de coordenadas predeterminado. Los ángulos 0 y 2 * Math.PI en el sentido predeterminado forman una circunferencia completa. Si el trazado ya tiene un punto final, arc() lo une al inicio del arco con un segmento recto. Si algún argumento numérico es NaN, Infinity o -Infinity, arc() termina sin modificar el trazado. Si todos los argumentos numéricos son finitos, un radio negativo lanza IndexSizeError.
La propiedad fillStyle acepta una cadena de color CSS, un CanvasGradient o un CanvasPattern. El color predeterminado es negro; una cadena de color no válida deja intacto el estilo anterior. La asignación no cambia el color de los píxeles ya dibujados.
fill() y fill(fillRule) rellenan el trazado actual con el estilo vigente. fill(path) y fill(path, fillRule) rellenan en su lugar el Path2D indicado. La regla predeterminada "nonzero" comprueba que la suma de los cruces del trazado con una semirrecta, con signo según el sentido de cada cruce, no sea cero; "evenodd" comprueba que el número de cruces sea impar. El relleno trata los subtrazados abiertos como cerrados sin modificarlos ni vaciar el trazado.
Ejemplos
<!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 el ejemplo como archivo HTML y ábrelo en un navegador. Las tres muestras RGBA que se muestran son el centro rojo del primer círculo, el píxel transparente en esa misma posición tras redibujar y el centro azul del nuevo círculo. El lienzo no se añade a la página. `getImageData()` lanza `SecurityError` si el lienzo deja de ser `origin-clean`, por ejemplo, tras dibujar una imagen de otro origen sin permiso CORS; `clearRect()` por sí solo no restaura ese estado.
Lecciones relacionadas
- JavaScript · Lección 27 · Intermedio · Versión: 3