Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Canvas 2D: mazání, kreslení a úpravy pixelů

Rozlište kreslicí operace v kontextu 2D od přímého čtení a zápisu jednotlivých pixelů bitmapy.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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 jsou metody instance kontextu získaného voláním canvas.getContext('2d'). Patří do webového API, nikoli do ECMAScriptu 2024. clearRect() respektuje aktuální transformaci a oblast ořezu. Nastaví pixely na průhlednou černou (při alpha: false na neprůhlednou černou), ale nezmění stav kreslení ani aktuální cestu. Novou cestu zahajte voláním beginPath().

drawImage() přijímá připravený zdroj typu CanvasImageSource, třeba obrázek nebo jiné plátno, nikoli ImageData. Varianta se 3 argumenty vykreslí celý zdroj v jeho přirozené velikosti, varianta s 5 určí cílovou velikost a varianta s 9 mapuje zdrojový obdélník na cílový. Záporné rozměry prodlužují obdélník opačným směrem, aniž by obraz převrátily. Kreslení respektuje transformaci, ořez a kompozici. Pokud se obrázek ještě načítá a není připravený k použití, drawImage() ho nevykreslí. Plně dostupný obrázek, který lze dekódovat, je možné vykreslit bez předchozího volání decode() nebo předem dekódovaného snímku. Zdrojové plátno s nulovým rozměrem vyvolá InvalidStateError.

getImageData() čte pixely bitmapy nezávisle na transformaci a ořezu. Vrací samostatnou kopii ImageData: úprava data plátno nezmění. Pole ukládá hodnoty RGBA po řádcích; první kanál pixelu (x, y) v kopii je na indexu (y * imageData.width + x) * 4. Mimo bitmapu čtení vrátí průhlednou černou. Záporné sw nebo sh prodlouží obdélník opačným směrem; nulový rozměr vyvolá IndexSizeError.

putImageData() nahrazuje pixely beze změny měřítka, transformace, ořezu kontextu či míchání. Varianta se 7 argumenty vybírá výřez uvnitř ImageData, nikoli v cíli: pixel (x, y) se zapíše na (dx + x, dy + y). Odpojený buffer vyvolá InvalidStateError. Převod barevného prostoru a přednásobení hodnotou alfa mohou při zpětném čtení změnit hodnoty, zejména u poloprůhledných pixelů.

Vykreslení prostředku z jiného původu bez povolení CORS může způsobit, že bitmapa ztratí stav origin-clean. Čtení pak vyvolá SecurityError i po clearRect(). Pro prostředky z jiného původu použijte požadavek CORS s odpovídajícím povolením serveru. Výchozí formát čtení rgba-unorm8 používá Uint8ClampedArray; podporu voleb jako display-p3 nebo rgba-float16 (Float16Array) ověřte v cílových prohlížečích.

Pří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ýsledek

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

První řádek ukazuje vymazaný levý pixel a červený pravý. Kód přebarví pravý pixel kopie na modro a zapíše pouze tento pixel s `dx = -1`. Druhý řádek ukazuje modrý levý pixel a stále červený pravý.

Související lekce

  • JavaScript · Lekce 33 · Pokročilá · Verze: 4

Zdroje