CKTIS / JavaScript
HTMLCanvasElement: kontekst iscrtavanja i dimenzije bitmape
Odaberi kontekst metodom `getContext()` i postavi dimenzije bitmape svojstvima `width` i `height`. Za razliku od promjene veličine u CSS-u, dodjela u načinu 2D briše bitmapu i vraća početno stanje crtanja.
Verzija: Current web platform; runtime support varies
Sintaksa
canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeightHTMLCanvasElement je sučelje preglednika definirano standardom HTML, a ne standardom ECMAScript 2024. canvas.getContext(contextId, options) prima identifikator u obliku niza znakova i neobavezne postavke za odabrani način. "2d" odabire CanvasRenderingContext2D, "bitmaprenderer" odabire ImageBitmapRenderingContext, "webgl" odabire WebGLRenderingContext, "webgl2" odabire WebGL2RenderingContext, a "webgpu" odabire GPUCanvasContext. Dostupnost načina i postavki ovisi o okruženju izvođenja.
Prvi uspješan poziv određuje način rada elementa. Ponovni poziv s istim identifikatorom vraća isti objekt bez primjene novih postavki. Nepodržan ili nedostupan način, odnosno zahtjev za drugim načinom, daje null. Nakon uspješnog poziva transferControlToOffscreen() element služi kao rezervirano mjesto: poziv getContext() ili dodjela vrijednosti svojstvu width ili height izaziva InvalidStateError.
canvas.width i canvas.height odražavaju istoimene atribute HTML-a. Određuju širinu i visinu bitmape kao nenegativne cijele brojeve. Ako atribut nedostaje ili se njegova vrijednost ne može raščlaniti, primjenjuje se zadana vrijednost 300 odnosno 150. Promjena samo canvas.style.width ili canvas.style.height mijenja veličinu prikaza, a ne razlučivost bitmape; skaliranje može zamutiti sliku.
U načinu 2D dodjela bilo koje dimenzije, čak i na trenutačnu vrijednost, briše bitmapu i vraća zadano stanje crtanja, uključujući trenutačnu putanju, transformaciju i stilove, ali ne zamjenjuje objekt konteksta. Dimenzije postavi prije crtanja; nakon promjene veličine obnovi potrebno stanje i ponovno iscrtaj sadržaj. Ne pretpostavljaj isto ponašanje u drugim načinima.
Iscrtavanje slike s drugog izvora bez odgovarajućeg CORS dopuštenja može bitmapu lišiti statusa origin-clean. Tada getImageData() izaziva SecurityError; promjena veličine 2D bitmape odbacuje njezin sadržaj umjesto da otkrije blokirane piksele.
Primjeri
<!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>Rezultat
300x150 4x3 255 0.5 0 1 true true
Spremi primjer kao HTML datoteku, otvori je u pregledniku i pogledaj ispis u razvojnoj konzoli. Prva dva retka prikazuju dimenzije. Ponovna dodjela iste širine mijenja alfu piksela s `255` na `0` i vraća `globalAlpha` s `0.5` na `1`. Dva rezultata `true` pokazuju da kontekst ostaje isti i da je drugi način odbijen.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredno · Verzija: 4
- JavaScript · Lekcija 33 · Napredno · Verzija: 4
- JavaScript · Lekcija 34 · Napredno · Verzija: 4