CKTIS / JavaScript
Canvas 2D: mazanie, kreslenie a úprava pixelov
Rozlíšte kresliace operácie v kontexte 2D od priameho čítania a zápisu jednotlivých pixelov bitmapy.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const ctx = canvas.getContext('2d');
ctx.clearRect(x, y, width, height);
ctx.drawImage(image, dx, dy);
ctx.drawImage(image, dx, dy, dw, dh);
ctx.drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh);
const snapshot = ctx.getImageData(sx, sy, sw, sh);
const configuredSnapshot = ctx.getImageData(sx, sy, sw, sh, settings);
ctx.putImageData(imageData, dx, dy);
ctx.putImageData(imageData, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight);clearRect, drawImage, getImageData a putImageData sú metódy inštancie kontextu získaného volaním canvas.getContext('2d'). Patria do webového API, nie do ECMAScriptu 2024. clearRect() rešpektuje aktuálnu transformáciu a oblasť orezania. Nastaví pixely na priehľadnú čiernu (pri alpha: false na nepriehľadnú čiernu), ale nezmení stav kreslenia ani aktuálnu cestu. Novú cestu začnite volaním beginPath().
drawImage() prijíma pripravený zdroj typu CanvasImageSource, napríklad obrázok či iné plátno, nie ImageData. Variant s 3 argumentmi vykreslí celý zdroj v jeho prirodzenej veľkosti, variant s 5 určí cieľovú veľkosť a variant s 9 mapuje zdrojový obdĺžnik na cieľový. Záporné rozmery rozširujú obdĺžnik opačným smerom bez prevrátenia obrazu. Kreslenie rešpektuje transformáciu, orezanie a kompozíciu. Ak sa obrázok ešte načítava a nie je pripravený na použitie, drawImage() ho nevykreslí. Úplne dostupný obrázok, ktorý sa dá dekódovať, možno vykresliť bez predchádzajúceho volania decode() alebo vopred dekódovanej snímky. Zdrojové plátno s nulovým rozmerom vyvolá InvalidStateError.
getImageData() číta pixely bitmapy nezávisle od transformácie a orezania. Vracia samostatnú kópiu ImageData: úprava data plátno nezmení. Pole ukladá hodnoty RGBA po riadkoch; prvý kanál pixela (x, y) v kópii je na indexe (y * imageData.width + x) * 4. Mimo bitmapy sa načíta priehľadná čierna. Záporné sw alebo sh rozšíria obdĺžnik opačným smerom; nulový rozmer vyvolá IndexSizeError.
putImageData() nahrádza pixely bez zmeny mierky, transformácie, orezania kontextu či miešania. Variant so 7 argumentmi vyberá výrez v ImageData, nie v cieli: pixel (x, y) sa zapíše na (dx + x, dy + y). Odpojený buffer vyvolá InvalidStateError. Prevod farebného priestoru a prednásobenie hodnotou alfa môžu pri opätovnom čítaní zmeniť hodnoty, najmä pri polopriehľadných pixeloch.
Vykreslenie prostriedku z iného pôvodu bez povolenia CORS môže spôsobiť, že bitmapa stratí stav origin-clean. Čítanie potom vyvolá SecurityError aj po clearRect(). Pre prostriedky z iného pôvodu použite požiadavku CORS s príslušným povolením servera. Predvolený formát čítania rgba-unorm8 používa Uint8ClampedArray; podporu možností ako display-p3 alebo rgba-float16 (Float16Array) overte v cieľových prehliadačoch.
Príklady
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel readback</title>
<canvas id="source" width="2" height="1" hidden></canvas>
<canvas id="destination" width="2" height="1" hidden></canvas>
<script>
const source = document.getElementById('source');
const canvas = document.getElementById('destination');
const src = source.getContext('2d');
const ctx = canvas.getContext('2d');
src.fillStyle = '#ff0000';
src.fillRect(0, 0, 2, 1);
ctx.drawImage(source, 0, 0);
ctx.clearRect(0, 0, 1, 1);
const snapshot = ctx.getImageData(0, 0, 2, 1);
console.log(snapshot.data.join(','));
snapshot.data.set([0, 0, 255, 255], 4);
ctx.putImageData(snapshot, -1, 0, 1, 0, 1, 1);
console.log(ctx.getImageData(0, 0, 2, 1).data.join(','));
</script>Výsledok
0,0,0,0,255,0,0,255 0,0,255,255,255,0,0,255
Prvý riadok ukazuje vymazaný ľavý pixel a červený pravý. Kód prefarbí pravý pixel kópie na modro a zapíše iba tento pixel s `dx = -1`. Druhý riadok ukazuje modrý ľavý pixel a stále červený pravý.
Súvisiace lekcie
- JavaScript · Lekcia 33 · Pokročilá · Verzia: 4