WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

CanvasRenderingContext2D — Zeichnen auf einer Bitmap

CanvasRenderingContext2D bietet eine zustandsbehaftete 2D-Zeichenschnittstelle für Rechtecke, Pfade, Text, Bilder und Pixel. Unterscheide zwischen Kontextzustand, aktuellem Pfad und Bitmap-Inhalt.

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

Syntax

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

Du erhältst CanvasRenderingContext2D über canvas.getContext('2d'); prüfe auf null. Dies ist eine Web-API des HTML-Standards, nicht ECMAScript. Diese grundlegenden Operationen werden von modernen Browser-Engines unterstützt; Node 24 belegt ihre Verfügbarkeit nicht. Setze canvas.width und canvas.height vor dem Zeichnen: Eine Zuweisung setzt Bitmap und Zustand zurück.

fillRect füllt ein Rechteck, strokeRect zeichnet dessen Umriss und clearRect löscht einen Bereich, normalerweise zu transparentem Schwarz; mit alpha: false zu undurchsichtigem Schwarz. Sie ändern den Pfad nicht. beginPath verwirft den aktuellen Pfad; moveTo beginnt einen Teilpfad, lineTo fügt ein Segment hinzu und closePath schließt den Teilpfad. arc fügt einen Bogen mit Winkeln in Radiant hinzu; rect ein Rechteck. fill füllt den Pfad, stroke zeichnet dessen Umriss.

fillStyle und strokeStyle legen Farben, Verläufe oder Muster fest; lineWidth legt die Linienstärke fest. fillText füllt Text aus, strokeText zeichnet dessen Kontur; font wählt Schriftart und Größe, textBaseline die Referenzgrundlinie. measureText gibt TextMetrics einschließlich width zurück; die Metriken hängen von der Schriftart ab.

save speichert den Zustand und restore stellt ihn wieder her, ohne Pixel oder Pfad rückgängig zu machen. setTransform(a, b, c, d, e, f) ersetzt die Transformation. clip schneidet den Beschneidungsbereich mit dem Pfad; begrenze seine Wirkung mit save/restore. drawImage zeichnet eine Bildquelle, optional zugeschnitten und skaliert.

getImageData liest Pixel als ImageData, putImageData schreibt sie; beide ignorieren die Transformation, und beim Schreiben wird auch die Beschneidung ignoriert. Ein bildfremder Ursprung ohne geeignetes CORS kann die Bitmap verunreinigen: Beim Lesen wird SecurityError ausgelöst. Stelle eine zugängliche Entsprechung des Bitmap-Inhalts bereit.

In diesem Eintrag behandelte Referenzbezeichner: 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.

Beispiele

(() => {
  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(','));
})();

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen