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.