Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLCanvasElement: vykresľovací kontext a rozmery bitmapy

Vyber kontext pomocou `getContext()` a nastav rozmery bitmapy cez `width` a `height`. Na rozdiel od úpravy veľkosti v CSS priradenie v režime 2D vymaže bitmapu a obnoví predvolený stav kreslenia.

Verzia: Current web platform; runtime support varies

Syntax

canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeight

HTMLCanvasElement je rozhranie prehliadača definované štandardom HTML, nie ECMAScript 2024. canvas.getContext(contextId, options) prijíma identifikátor ako reťazec a voliteľné nastavenia podľa režimu. "2d" vyberá CanvasRenderingContext2D, "bitmaprenderer" vyberá ImageBitmapRenderingContext, "webgl" vyberá WebGLRenderingContext, "webgl2" vyberá WebGL2RenderingContext a "webgpu" vyberá GPUCanvasContext. Dostupnosť režimov a nastavení závisí od prostredia.

Prvé úspešné volanie určí režim prvku. Ďalšie volanie s rovnakým identifikátorom vráti ten istý objekt bez použitia nových nastavení. Nepodporovaný či nedostupný režim alebo požiadavka na iný režim vráti null. Po úspešnom volaní transferControlToOffscreen() prvok slúži ako zástupca: volanie getContext() alebo priradenie do width či height vyvolá InvalidStateError.

canvas.width a canvas.height odzrkadľujú rovnomenné atribúty HTML. Určujú šírku a výšku bitmapy ako nezáporné celé čísla. Ak atribút chýba alebo sa ho nepodarí spracovať, použije sa príslušná predvolená hodnota 300 alebo 150. Zmena iba canvas.style.width alebo canvas.style.height mení veľkosť zobrazenia, nie rozlíšenie bitmapy; zmena mierky môže obraz rozmazať.

V režime 2D priradenie ktoréhokoľvek rozmeru, aj na jeho aktuálnu hodnotu, vymaže bitmapu a obnoví predvolený stav kreslenia vrátane aktuálnej cesty, transformácie a štýlov. Objekt kontextu zostane rovnaký. Rozmery nastav pred kreslením; po zmene veľkosti obnov potrebný stav a scénu vykresli znova. Pri iných režimoch nepredpokladaj rovnaké správanie.

Vykreslenie obrázka z iného pôvodu bez príslušného povolenia CORS môže spôsobiť, že bitmapa stratí stav origin-clean. getImageData() potom vyvolá SecurityError; zmena veľkosti 2D bitmapy zahodí jej obsah a nesprístupní zablokované pixely.

Príklady

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
  const canvas = document.createElement("canvas");
  console.log(`${canvas.width}x${canvas.height}`);
  canvas.width = 4;
  canvas.height = 3;
  console.log(`${canvas.width}x${canvas.height}`);

  const ctx = canvas.getContext("2d");
  if (ctx === null) throw new Error("2D canvas context unavailable");

  ctx.fillRect(0, 0, 1, 1);
  ctx.globalAlpha = 0.5;
  const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
  console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);

  canvas.width = canvas.width;
  console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
  console.log(canvas.getContext("2d") === ctx);
  console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>

Výsledok

300x150
4x3
255 0.5
0 1
true
true

Ulož príklad ako súbor HTML, otvor ho v prehliadači a pozri si výstup vo vývojárskej konzole. Prvé dva riadky ukazujú rozmery. Opätovné priradenie rovnakej šírky zmení alfu pixela z `255` na `0` a vráti `globalAlpha` z `0.5` na `1`. Dva výsledky `true` ukazujú, že kontext zostáva rovnaký a iný režim je odmietnutý.

Súvisiace lekcie

  • JavaScript · Lekcia 12 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 33 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 34 · Pokročilá · Verzia: 4

Zdroje