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 = bitmapHeightHTMLCanvasElement 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