Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Canvas 2D: transformaciones, estado de dibujo, recorte y rectángulos

Distingue el estado de dibujo del trazado actual y del mapa de bits para limitar el recorte a una fase del dibujo y borrar solo los píxeles deseados.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform()
ctx.setTransform(matrix2D)
ctx.save()
ctx.restore()
ctx.beginPath()
ctx.rect(x, y, width, height)
ctx.clip()
ctx.clip(fillRule)
ctx.clip(path)
ctx.clip(path, fillRule)
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.strokeRect(x, y, width, height)

Estos métodos pertenecen a la interfaz web CanvasRenderingContext2D, no a ECMAScript 2024. La compatibilidad depende del entorno de ejecución. setTransform(a, b, c, d, e, f) sustituye la matriz en lugar de multiplicarla: (x, y) se convierte en (a*x + c*y + e, b*x + d*y + f). También acepta un objeto DOMMatrix2DInit: a y d valen 1 por defecto y los demás coeficientes valen 0, por lo que una llamada sin argumentos establece la matriz identidad. Los valores contradictorios en claves equivalentes, como a y m11, provocan TypeError. La forma de seis números no modifica la matriz si un argumento es infinito o vale NaN.

save() apila una copia del estado de dibujo, que incluye la transformación, el recorte y los estilos. restore() extrae y restaura el último estado guardado; si la pila está vacía, no hace nada. Ni el trazado actual ni los píxeles se guardan. beginPath() vacía el trazado sin cambiar el recorte ni el mapa de bits. rect(x, y, width, height) añade un subtrazado rectangular cerrado sin pintar píxeles. La transformación se aplica a la geometría de ese trazado al construirlo.

clip() sustituye la región de recorte por su intersección con el interior del trazado actual o del Path2D proporcionado. Con Path2D, la transformación se aplica al llamar a clip(), sin modificar el objeto. La regla de relleno opcional 'nonzero' (predeterminada) comprueba que el recuento de cruces con signo no sea cero; 'evenodd' comprueba que el número de cruces sea impar. clip() no pinta nada y las llamadas sucesivas no pueden ampliar la región. Guarda el estado antes de recortar y restáuralo después de dibujar: establecer la matriz identidad no elimina el recorte.

fillRect() rellena con fillStyle, strokeRect() dibuja el contorno con strokeStyle y los ajustes de línea, y clearRect() borra a negro transparente (negro opaco con alpha: false), sin aplicar sombras, alfa global ni composición. Los tres actúan directamente sobre el mapa de bits, respetan la transformación y el recorte y dejan intacto el trazado. Por eso, fillRect() no aporta geometría a clip(). clearRect() no elimina las restricciones de lectura de un mapa de bits contaminado por datos de otro origen: getImageData() sigue lanzando SecurityError.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D clipping</title>
<canvas id="canvas" width="20" height="12"></canvas>
<script>
(() => {
  const canvas = document.getElementById('canvas');
  const ctx = canvas.getContext('2d', { alpha: true });
  if (!ctx) throw new Error('Canvas 2D unavailable');

  ctx.fillRect(0, 0, 12, 12);
  ctx.save();
  try {
    ctx.setTransform(1, 0, 0, 1, 4, 2);
    ctx.beginPath();
    ctx.rect(0, 0, 8, 8);
    ctx.clip();
    ctx.clearRect(-2, 2, 6, 4);
  } finally {
    ctx.restore();
  }

  ctx.lineWidth = 2;
  ctx.strokeRect(14, 2, 4, 8);
  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([3, 5, 9, 14, 16].map(x => alphaAt(x, 5)).join(', '));
})();
</script>

Resultado

255, 0, 255, 255, 0

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de desarrollo. Los cinco valores alfa muestran, en orden: el relleno protegido por el recorte, un píxel borrado, el relleno intacto, el contorno dibujado tras restaurar el estado y el interior transparente de ese contorno.

Lecciones relacionadas

  • JavaScript · Lección 12 · Avanzado · Versión: 4

Fuentes