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

CKTIS / JavaScript

CanvasRenderingContext2D — dibujar en un bitmap

CanvasRenderingContext2D ofrece una interfaz de dibujo 2D con estado para rectángulos, trazados, texto, imágenes y píxeles. Distingue entre el estado del contexto, el trazado actual y el contenido del bitmap.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

const ctx = canvas.getContext('2d');

Obtén CanvasRenderingContext2D mediante canvas.getContext('2d'); comprueba si el resultado es null. Es una API web del estándar HTML, no de ECMAScript. Los motores modernos de navegador admiten estas operaciones básicas; Node 24 no demuestra que estén disponibles. Asigna canvas.width y canvas.height antes de dibujar: al hacerlo se restablecen el bitmap y el estado.

fillRect rellena un rectángulo, strokeRect dibuja su contorno y clearRect borra una zona, normalmente dejándola en negro transparente; con alpha: false, en negro opaco. No modifican el trazado. beginPath descarta el trazado actual; moveTo inicia un subtrazado, lineTo añade un segmento y closePath cierra el subtrazado. arc añade un arco cuyos ángulos se expresan en radianes; rect añade un rectángulo. fill rellena el trazado y stroke dibuja su contorno.

fillStyle y strokeStyle especifican colores, degradados o patrones; lineWidth especifica el grosor de línea. fillText rellena el texto y strokeText dibuja su contorno; font selecciona el tipo de letra y el tamaño, mientras que textBaseline selecciona la línea de base de referencia. measureText devuelve TextMetrics, incluido width; las métricas dependen de la fuente.

save guarda el estado y restore lo restaura, sin deshacer los píxeles ni el trazado. setTransform(a, b, c, d, e, f) sustituye la transformación. clip intersecta la región de recorte con el trazado; usa save/restore para limitar su alcance. drawImage dibuja una fuente de imagen, con recorte y escalado opcionales.

getImageData lee píxeles como ImageData y putImageData los escribe; ambos ignoran la transformación y la escritura también ignora el recorte. Una imagen de otro origen sin CORS adecuado puede contaminar el bitmap: la lectura lanza SecurityError. Proporciona una alternativa accesible al contenido del bitmap.

Identificadores de referencia incluidos en esta entrada: CanvasRenderingContext2D.clearRect, CanvasRenderingContext2D.fillRect, CanvasRenderingContext2D.strokeRect, CanvasRenderingContext2D.beginPath, CanvasRenderingContext2D.moveTo, CanvasRenderingContext2D.lineTo, CanvasRenderingContext2D.closePath, CanvasRenderingContext2D.stroke, CanvasRenderingContext2D.arc, CanvasRenderingContext2D.fill, CanvasRenderingContext2D.fillText, CanvasRenderingContext2D.strokeText, CanvasRenderingContext2D.lineWidth, CanvasRenderingContext2D.strokeStyle, CanvasRenderingContext2D.fillStyle, CanvasRenderingContext2D.font, CanvasRenderingContext2D.textBaseline, CanvasRenderingContext2D.save, CanvasRenderingContext2D.restore, CanvasRenderingContext2D.measureText, CanvasRenderingContext2D.setTransform, CanvasRenderingContext2D.rect, CanvasRenderingContext2D.clip, CanvasRenderingContext2D.drawImage, CanvasRenderingContext2D.getImageData, CanvasRenderingContext2D.putImageData.

Ejemplos

(() => {
  const canvas = document.createElement('canvas');
  canvas.width = 64;
  canvas.height = 48;
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D unavailable');
  document.body.append(canvas);

  ctx.clearRect(0, 0, 64, 48);
  ctx.save();
  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.beginPath();
  ctx.rect(0, 0, 32, 48);
  ctx.clip();
  ctx.fillStyle = '#ff0000';
  ctx.fillRect(0, 0, 64, 48);
  ctx.restore();
  ctx.beginPath();

  const pixel = ctx.getImageData(8, 8, 1, 1);
  ctx.putImageData(pixel, 48, 8);
  console.log(Array.from(ctx.getImageData(48, 8, 1, 1).data).join(','));
  console.log(Array.from(ctx.getImageData(40, 8, 1, 1).data).join(','));
})();

Resultado

255,0,0,255
0,0,0,0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes