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

CKTIS / JavaScript

Canvas 2D: transformaciones, rectángulos y trazados

Distingue la transformación, los píxeles y el trazado predeterminado. Aprende cuándo se transforman las coordenadas, qué operaciones cambian los píxeles al instante y qué conserva `stroke()`.

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

Sintaxis

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform(matrix)
ctx.setTransform()
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.beginPath()
ctx.moveTo(x, y)
ctx.lineTo(x, y)
ctx.stroke()
ctx.stroke(path)

CanvasRenderingContext2D es una interfaz de una API web, no de ECMAScript 2024. Llama a estos métodos sobre el contexto ctx que devuelve canvas.getContext('2d'), que puede ser null. La compatibilidad con las distintas formas de llamada depende del entorno de ejecución. Los siete métodos devuelven undefined en una llamada normal.

setTransform(a, b, c, d, e, f) sustituye la matriz actual; transform(), en cambio, la multiplica. El punto (x, y) se convierte en (a*x + c*y + e, b*x + d*y + f). La sobrecarga con objeto acepta un diccionario de matriz 2D (DOMMatrix2DInit): los componentes omitidos toman los valores de la identidad y dos alias con valores incompatibles, como a y m11, provocan TypeError. El estándar permite llamar sin argumentos para establecer la identidad. En la sobrecarga con seis números, si algún argumento es NaN o infinito, la matriz actual no cambia. La sobrecarga con diccionario construye una DOMMatrix a partir de un diccionario válido y la asigna como matriz actual sin esa comprobación.

fillRect(x, y, width, height) pinta inmediatamente un rectángulo con fillStyle. Con los mismos parámetros, clearRect() borra los píxeles dejándolos en negro transparente (negro opaco con alpha: false), sin depender del estilo de pintura, de globalAlpha ni del modo de composición. Ambos respetan la transformación y la región de recorte actuales y no modifican el trazado. Una dimensión cero no tiene efecto; una negativa extiende el rectángulo en sentido contrario desde (x, y).

beginPath() vacía el trazado predeterminado sin borrar píxeles. moveTo(x, y) inicia un subtrazado sin conectarlo con el anterior. lineTo(x, y) añade un segmento recto desde el último punto; si no existe un subtrazado, solo fija el punto inicial. Ninguno de los tres pinta. moveTo(), lineTo() y ambos métodos de rectángulo ignoran las llamadas con coordenadas o dimensiones infinitas o NaN.

stroke() pinta el contorno del trazado predeterminado con strokeStyle y ajustes de línea como lineWidth. No cierra los subtrazados abiertos ni vacía el trazado. Las coordenadas del trazado predeterminado se transforman al añadirlas, no otra vez al pintar, aunque la matriz del momento sí afecta al trazo, por ejemplo a su grosor. Con stroke(path), la geometría del Path2D proporcionado se transforma al pintar sin modificar el objeto. save() y restore() guardan y restauran el estado de dibujo, incluida la matriz, pero no el trazado predeterminado ni los píxeles.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D</title>
<canvas id="demo" width="32" height="24" hidden></canvas>
<script>
(() => {
  const canvas = document.getElementById('demo');
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D is unavailable');

  ctx.setTransform(1, 0, 0, 1, 8, 4);
  ctx.fillStyle = '#000';
  ctx.fillRect(0, 0, 16, 8);
  ctx.beginPath();
  ctx.moveTo(2, 12);
  ctx.lineTo(14, 12);
  ctx.clearRect(0, 0, 4, 8);

  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.strokeStyle = '#000';
  ctx.lineWidth = 4;
  ctx.stroke();

  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([alphaAt(9, 6), alphaAt(15, 6), alphaAt(15, 16), alphaAt(5, 12)].join(', '));
})();
</script>

Resultado

0, 255, 255, 0

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola. Los valores alfa esperados `0, 255, 255, 0` corresponden a la zona borrada, el relleno restante, la línea desplazada y un punto intacto en el sistema sin desplazamiento. `getImageData()` lee en coordenadas del mapa de bits. Los ajustes de privacidad pueden alterar el resultado; leer un lienzo contaminado por contenido de otro origen no autorizado puede lanzar `SecurityError`.

Lecciones relacionadas

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

Fuentes