CKTIS / JavaScript
CanvasRenderingContext2D — desenhar numa bitmap
CanvasRenderingContext2D disponibiliza uma interface de desenho 2D com estado para retângulos, trajetos, texto, imagens e píxeis. Distingue o estado do contexto, o trajeto atual e o conteúdo da bitmap.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const ctx = canvas.getContext('2d');Obtém CanvasRenderingContext2D através de canvas.getContext('2d'); verifica se o resultado é null. Esta é uma API Web do padrão HTML, não de ECMAScript. Estas operações básicas são suportadas pelos motores modernos dos navegadores; o Node 24 não comprova a sua disponibilidade. Define canvas.width e canvas.height antes de desenhar: atribuir-lhes valores repõe a bitmap e o estado.
fillRect preenche um retângulo, strokeRect desenha o contorno e clearRect limpa uma área, normalmente para preto transparente; com alpha: false, para preto opaco. Não alteram o trajeto. beginPath descarta o trajeto atual; moveTo inicia um subtrajeto, lineTo acrescenta um segmento e closePath fecha o subtrajeto. arc acrescenta um arco com ângulos em radianos; rect acrescenta um retângulo. fill preenche o trajeto e stroke desenha o respetivo contorno.
fillStyle e strokeStyle especificam cores, gradientes ou padrões; lineWidth especifica a espessura da linha. fillText preenche texto e strokeText desenha o contorno; font seleciona o tipo e o tamanho de letra, enquanto textBaseline seleciona a linha de base de referência. measureText devolve TextMetrics, incluindo width; as métricas dependem do tipo de letra.
save guarda o estado e restore repõe-no, sem desfazer píxeis nem o trajeto. setTransform(a, b, c, d, e, f) substitui a transformação. clip intersecta a região de recorte com o trajeto; usa save/restore para limitar o seu âmbito. drawImage desenha uma origem de imagem, com recorte e escala opcionais.
getImageData lê píxeis como ImageData e putImageData escreve-os; ambos ignoram a transformação e a escrita também ignora o recorte. Uma imagem de outra origem sem CORS adequado pode contaminar a bitmap: a leitura gera SecurityError. Disponibiliza uma alternativa acessível ao conteúdo da bitmap.
Identificadores de referência abrangidos por 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.
Exemplos
(() => {
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.