CKTIS / JavaScript
Canvas 2D : transformations, rectangles et tracés
Distinguez la transformation, les pixels et le tracé par défaut. Vous saurez quand les coordonnées sont transformées, quelles opérations modifient les pixels et ce que `stroke()` laisse en place.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform(matrix)
ctx.setTransform()
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.beginPath()
ctx.moveTo(x, y)
ctx.lineTo(x, y)
ctx.stroke()
ctx.stroke(path)CanvasRenderingContext2D relève d’une API Web, pas d’ECMAScript 2024. Appelez ces méthodes sur le contexte ctx obtenu avec canvas.getContext('2d'), qui peut renvoyer null. La prise en charge des différentes formes d’appel dépend de l’environnement d’exécution. Les sept méthodes renvoient undefined en cas d’appel normal.
setTransform(a, b, c, d, e, f) remplace la matrice courante, contrairement à transform(), qui la multiplie. Le point (x, y) devient (a*x + c*y + e, b*x + d*y + f). L’autre surcharge accepte un dictionnaire décrivant une matrice 2D (DOMMatrix2DInit). Les composantes omises prennent les valeurs de la matrice identité ; des valeurs contradictoires pour deux alias, comme a et m11, lèvent TypeError. Le standard autorise l’appel sans argument pour rétablir l’identité. Dans la surcharge à six nombres, un argument infini ou égal à NaN laisse la matrice courante inchangée. La surcharge avec dictionnaire construit une DOMMatrix à partir d’un dictionnaire valide et l’affecte comme matrice courante sans effectuer cette vérification.
fillRect(x, y, width, height) peint immédiatement un rectangle avec fillStyle. Avec les mêmes paramètres, clearRect() efface les pixels en noir transparent (noir opaque avec alpha: false), indépendamment du style de peinture, de globalAlpha et du mode de composition. Les deux méthodes respectent la transformation et la zone de découpage courantes, sans modifier le tracé. Une dimension nulle n’a aucun effet ; une dimension négative étend le rectangle dans le sens opposé à partir de (x, y).
beginPath() vide le tracé par défaut sans effacer de pixels. moveTo(x, y) commence un nouveau sous-tracé sans le relier au précédent. lineTo(x, y) ajoute un segment droit depuis le dernier point ; sans sous-tracé, il ne définit que le point de départ. Aucune de ces trois méthodes ne peint. moveTo(), lineTo() et les deux méthodes de rectangle ignorent les appels dont les coordonnées ou dimensions sont infinies ou égales à NaN.
stroke() peint le contour du tracé par défaut avec strokeStyle et les réglages de ligne tels que lineWidth. Il ne ferme pas les sous-tracés ouverts et ne vide pas le tracé. Les coordonnées du tracé par défaut sont transformées à l’ajout, pas une seconde fois lors du rendu, mais la matrice courante influe alors sur le trait, notamment sur son épaisseur. Avec stroke(path), la géométrie du Path2D fourni est transformée au moment du rendu sans modifier l’objet. save() et restore() enregistrent et rétablissent l’état de dessin, dont la matrice, mais ni le tracé par défaut ni les pixels.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D</title>
<canvas id="demo" width="32" height="24" hidden></canvas>
<script>
(() => {
const canvas = document.getElementById('demo');
const ctx = canvas.getContext('2d');
if (!ctx) throw new Error('Canvas 2D is unavailable');
ctx.setTransform(1, 0, 0, 1, 8, 4);
ctx.fillStyle = '#000';
ctx.fillRect(0, 0, 16, 8);
ctx.beginPath();
ctx.moveTo(2, 12);
ctx.lineTo(14, 12);
ctx.clearRect(0, 0, 4, 8);
ctx.setTransform(1, 0, 0, 1, 0, 0);
ctx.strokeStyle = '#000';
ctx.lineWidth = 4;
ctx.stroke();
const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
console.log([alphaAt(9, 6), alphaAt(15, 6), alphaAt(15, 16), alphaAt(5, 12)].join(', '));
})();
</script>Résultat
0, 255, 255, 0
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console. Les valeurs alpha attendues `0, 255, 255, 0` correspondent à la zone effacée, au remplissage restant, au segment translaté et à un point intact dans le repère non translaté. `getImageData()` lit aux coordonnées du bitmap. Les réglages de confidentialité peuvent modifier le résultat ; une lecture peut lever `SecurityError` si le canvas contient des données non autorisées d’une autre origine.
Leçons associées
- JavaScript · Leçon 34 · Avancé · Version : 4
Sources
- HTML Standard — The canvas settings
- HTML Standard — The canvas state
- HTML Standard — Building paths
- HTML Standard — Transformations
- HTML Standard — Drawing rectangles to the bitmap
- HTML Standard — Drawing paths to the canvas
- CanvasRenderingContext2D: setTransform() method
- CanvasRenderingContext2D: getImageData() method