CKTIS / JavaScript
Canvas 2D : transformations, état de dessin, découpage et rectangles
Distinguez l’état de dessin du tracé courant et de l’image bitmap pour limiter le découpage à une étape du dessin et n’effacer que les pixels voulus.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform()
ctx.setTransform(matrix2D)
ctx.save()
ctx.restore()
ctx.beginPath()
ctx.rect(x, y, width, height)
ctx.clip()
ctx.clip(fillRule)
ctx.clip(path)
ctx.clip(path, fillRule)
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.strokeRect(x, y, width, height)Ces méthodes appartiennent à l’interface Web CanvasRenderingContext2D, et non à ECMAScript 2024. Leur prise en charge dépend de l’environnement d’exécution. setTransform(a, b, c, d, e, f) remplace la matrice au lieu de la multiplier : (x, y) devient (a*x + c*y + e, b*x + d*y + f). La méthode accepte aussi un objet DOMMatrix2DInit : a et d valent 1 par défaut, et les autres coefficients 0. Un appel sans argument rétablit donc la matrice identité. Des clés synonymes aux valeurs contradictoires, comme a et m11, déclenchent TypeError. La forme à six nombres laisse la matrice intacte si l’un des arguments est infini ou vaut NaN.
save() empile une copie de l’état de dessin, dont la transformation, la zone de découpage et les styles. restore() dépile et rétablit le dernier état enregistré ; si la pile est vide, il ne fait rien. Ni le tracé courant ni les pixels ne sont sauvegardés. beginPath() vide le tracé sans modifier la zone de découpage ni le bitmap. rect(x, y, width, height) ajoute un sous-tracé rectangulaire fermé sans peindre de pixels. La transformation s’applique à la géométrie de ce tracé au moment de sa construction.
clip() remplace la zone de découpage par son intersection avec l’intérieur du tracé courant ou du Path2D fourni. Pour un Path2D, la transformation s’applique à l’appel de clip(), sans modifier l’objet. La règle de remplissage facultative 'nonzero' (par défaut) teste si le décompte signé des franchissements est non nul ; 'evenodd' teste si leur nombre est impair. clip() ne peint rien et les appels successifs ne peuvent pas agrandir la zone. Sauvegardez l’état avant le découpage et restaurez-le après le dessin : la matrice identité ne supprime pas le découpage.
fillRect() remplit avec fillStyle, strokeRect() trace le contour avec strokeStyle et les réglages de ligne, et clearRect() efface en noir transparent (noir opaque avec alpha: false), sans tenir compte des ombres, de l’alpha global ni de la composition. Les trois agissent directement sur le bitmap, respectent la transformation et le découpage, et laissent le tracé intact. Ainsi, fillRect() ne fournit pas de géométrie à clip(). clearRect() ne lève pas les restrictions de lecture d’un bitmap contaminé par des données d’une autre origine : getImageData() déclenche toujours SecurityError.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D clipping</title>
<canvas id="canvas" width="20" height="12"></canvas>
<script>
(() => {
const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d', { alpha: true });
if (!ctx) throw new Error('Canvas 2D unavailable');
ctx.fillRect(0, 0, 12, 12);
ctx.save();
try {
ctx.setTransform(1, 0, 0, 1, 4, 2);
ctx.beginPath();
ctx.rect(0, 0, 8, 8);
ctx.clip();
ctx.clearRect(-2, 2, 6, 4);
} finally {
ctx.restore();
}
ctx.lineWidth = 2;
ctx.strokeRect(14, 2, 4, 8);
const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
console.log([3, 5, 9, 14, 16].map(x => alphaAt(x, 5)).join(', '));
})();
</script>Résultat
255, 0, 255, 255, 0
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console de développement. Les cinq valeurs alpha indiquent, dans l’ordre : le remplissage protégé par le découpage, un pixel effacé, le remplissage intact, le contour tracé après restauration de l’état et l’intérieur transparent de ce contour.
Leçons associées
- JavaScript · Leçon 12 · Avancé · Version : 4
Sources
- HTML Standard — The canvas state
- HTML Standard — Transformations
- HTML Standard — Drawing rectangles to the bitmap
- HTML Standard — Drawing paths to the canvas
- HTML Standard — The canvas settings
- CanvasRenderingContext2D: setTransform() method
- CanvasRenderingContext2D: rect() method
- CanvasRenderingContext2D: getImageData() method