CKTIS / JavaScript
HTMLCanvasElement: vykreslovací kontext a rozměry bitmapy
Vyber kontext pomocí `getContext()` a nastav rozměry bitmapy vlastnostmi `width` a `height`. Na rozdíl od změny velikosti v CSS přiřazení v režimu 2D vymaže bitmapu a obnoví výchozí stav vykreslování.
Verze: Current web platform; runtime support varies
Syntaxe
canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeightHTMLCanvasElement je rozhraní prohlížeče definované standardem HTML, nikoli ECMAScript 2024. canvas.getContext(contextId, options) přijímá identifikátor jako řetězec a volitelná nastavení podle režimu. "2d" vybírá CanvasRenderingContext2D, "bitmaprenderer" vybírá ImageBitmapRenderingContext, "webgl" vybírá WebGLRenderingContext, "webgl2" vybírá WebGL2RenderingContext a "webgpu" vybírá GPUCanvasContext. Dostupnost režimů a nastavení závisí na prostředí.
První úspěšné volání určí režim prvku. Další volání se stejným identifikátorem vrátí stejný objekt bez použití nového nastavení. Nepodporovaný či nedostupný režim nebo požadavek na jiný režim vrátí null. Po úspěšném volání transferControlToOffscreen() prvek slouží jako zástupce: volání getContext() nebo přiřazení do width či height vyvolá InvalidStateError.
canvas.width a canvas.height odrážejí stejnojmenné atributy HTML. Udávají šířku a výšku bitmapy jako nezáporná celá čísla. Pokud atribut chybí nebo ho nelze zpracovat, použije se příslušná výchozí hodnota 300 nebo 150. Změna pouze canvas.style.width nebo canvas.style.height ovlivní velikost zobrazení, nikoli rozlišení bitmapy; změna měřítka může obraz rozmazat.
V režimu 2D přiřazení kteréhokoli rozměru, byť na stejnou hodnotu, vymaže bitmapu a obnoví výchozí stav vykreslování včetně aktuální cesty, transformace a stylů. Objekt kontextu se nezmění. Rozměry nastav před kreslením; po změně velikosti obnov potřebný stav a scénu vykresli znovu. U ostatních režimů stejné chování nepředpokládej.
Vykreslení obrázku z jiného původu bez odpovídajícího povolení CORS může způsobit, že bitmapa přestane být origin-clean. getImageData() pak vyvolá SecurityError; změnou rozměrů bitmapy 2D se její obsah zahodí, nikoli zpřístupní zablokované pixely.
Pří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ýsledek
300x150 4x3 255 0.5 0 1 true true
Ulož příklad jako soubor HTML, otevři ho v prohlížeči a podívej se na výstup ve vývojářské konzoli. První dva řádky ukazují rozměry. Opětovné přiřazení stejné šířky změní alfu pixelu z `255` na `0` a vrátí `globalAlpha` z `0.5` na `1`. Dva výsledky `true` ukazují, že kontext zůstává stejný a jiný režim je odmítnut.
Související lekce
- JavaScript · Lekce 12 · Pokročilá · Verze: 4
- JavaScript · Lekce 33 · Pokročilá · Verze: 4
- JavaScript · Lekce 34 · Pokročilá · Verze: 4