Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes