CKTIS / JavaScript
CanvasRenderingContext2D — tekenen op een bitmap
CanvasRenderingContext2D biedt een statusafhankelijke 2D-tekeninterface voor rechthoeken, paden, tekst, afbeeldingen en pixels. Maak onderscheid tussen de contextstatus, het huidige pad en de bitmapinhoud.
Versie: 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');Verkrijg CanvasRenderingContext2D via canvas.getContext('2d'); controleer of het resultaat null is. Dit is een Web-API uit de HTML-standaard, geen ECMAScript. Moderne browserengines ondersteunen deze basisbewerkingen; Node 24 toont niet aan dat ze daar beschikbaar zijn. Stel canvas.width en canvas.height in voordat je tekent: een toewijzing reset de bitmap en status.
fillRect vult een rechthoek, strokeRect tekent de omtrek en clearRect wist een gebied, normaal tot transparant zwart; met alpha: false tot ondoorzichtig zwart. Ze wijzigen het pad niet. beginPath verwerpt het huidige pad; moveTo begint een deelpad, lineTo voegt een segment toe en closePath sluit het deelpad. arc voegt een boog toe met hoeken in radialen; rect voegt een rechthoek toe. fill vult het pad en stroke tekent de omtrek.
fillStyle en strokeStyle bepalen kleuren, verlopen of patronen; lineWidth bepaalt de lijndikte. fillText vult tekst en strokeText tekent de omtrek; font kiest lettertype en grootte, terwijl textBaseline de referentiebasislijn kiest. measureText retourneert TextMetrics, inclusief width; de metrieken zijn afhankelijk van het lettertype.
save slaat de status op en restore herstelt die, zonder pixels of het pad ongedaan te maken. setTransform(a, b, c, d, e, f) vervangt de transformatie. clip snijdt het clipgebied met het pad; gebruik save/restore om het bereik te beperken. drawImage tekent een afbeeldingsbron, eventueel bijgesneden en geschaald.
getImageData leest pixels als ImageData, en putImageData schrijft ze; beide negeren de transformatie en bij schrijven wordt ook clipping genegeerd. Een afbeelding van een andere oorsprong zonder passende CORS kan de bitmap besmetten: lezen veroorzaakt SecurityError. Bied een toegankelijk alternatief voor de bitmapinhoud.
Referentie-identificatoren die in dit item worden behandeld: 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.
Voorbeelden
(() => {
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(','));
})();Resultaat
255,0,0,255 0,0,0,0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.