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

CKTIS / JavaScript

Canvas 2D: transformace, obdélníky a cesty

Rozlišujte transformaci, pixely a výchozí cestu. Zjistěte, kdy se transformují souřadnice, které metody okamžitě mění pixely a co zůstane po volání `stroke()`.

Verze: 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 je rozhraní webového API, nikoli součást ECMAScriptu 2024. Metody volejte na kontextu ctx získaném pomocí canvas.getContext('2d'); výsledkem může být null. Podpora jednotlivých forem volání závisí na běhovém prostředí. Všech sedm metod při běžném volání vrací undefined.

setTransform(a, b, c, d, e, f) nahrazuje aktuální matici, na rozdíl od transform(), která ji násobí. Bod (x, y) se změní na (a*x + c*y + e, b*x + d*y + f). Přetížení s objektem přijímá slovník pro 2D matici (DOMMatrix2DInit): chybějící složky nabývají hodnot jednotkové matice a rozporné hodnoty aliasů, například a a m11, vyvolají TypeError. Podle standardu volání bez argumentů nastaví jednotkovou matici. U varianty se šesti čísly zůstane aktuální matice beze změny, pokud je některý argument nekonečný nebo NaN. Varianta se slovníkem z platného slovníku vytvoří DOMMatrix a bez této kontroly ji nastaví jako aktuální matici.

fillRect(x, y, width, height) okamžitě vykreslí obdélník pomocí fillStyle. Se stejnými parametry clearRect() nastaví pixely na průhlednou černou (při alpha: false na neprůhlednou černou) bez ohledu na styl, globalAlpha a režim kompozice. Obě metody respektují aktuální transformaci a oblast ořezu a nemění cestu. Nulový rozměr nemá účinek; záporný rozměr rozšiřuje obdélník od (x, y) opačným směrem.

beginPath() vyprázdní výchozí cestu, ale pixely nesmaže. moveTo(x, y) začne novou dílčí cestu bez spojení s předchozí. lineTo(x, y) přidá od posledního bodu přímou úsečku; bez dílčí cesty pouze nastaví počáteční bod. Žádná z těchto tří metod nekreslí. moveTo(), lineTo() a obě metody pro obdélníky ignorují volání s nekonečnými hodnotami nebo NaN v souřadnicích či rozměrech.

stroke() vykreslí aktuální výchozí cestu pomocí strokeStyle a nastavení čáry, jako je lineWidth. Otevřené dílčí cesty neuzavírá ani cestu nevyprazdňuje. Souřadnice výchozí cesty se transformují při přidání, ne znovu při vykreslení, ale aktuální matice při vykreslení přesto ovlivňuje samotný tah, například jeho tloušťku. U stroke(path) se geometrie předaného Path2D transformuje až při vykreslení, aniž se objekt změní. save() a restore() ukládají a obnovují stav kreslení včetně matice, nikoli výchozí cestu ani pixely.

Příklady

<!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>

Výsledek

0, 255, 255, 0

Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a zkontrolujte výstup v konzoli. Očekávané hodnoty alfa `0, 255, 255, 0` odpovídají vymazané oblasti, zbývající výplni, posunuté úsečce a nedotčenému bodu v neposunuté soustavě. `getImageData()` čte souřadnice bitmapy. Nastavení ochrany soukromí může výsledek změnit a čtení z plátna znečištěného nepovoleným obsahem z jiného zdroje může vyvolat `SecurityError`.

Související lekce

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

Zdroje