CKTIS / JavaScript
HTMLCanvasElement: kontekst izrisa in mere bitne slike
Izberi kontekst z `getContext()` ter nastavi mere bitne slike z `width` in `height`. V nasprotju s spremembo velikosti v CSS prireditev v načinu 2D počisti bitno sliko in ponastavi stanje risanja.
Različica: 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 vmesnik brskalnika, ki ga določa standard HTML, ne ECMAScript 2024. canvas.getContext(contextId, options) sprejme identifikator v obliki niza in neobvezne nastavitve za izbrani način. "2d" izbere CanvasRenderingContext2D, "bitmaprenderer" izbere ImageBitmapRenderingContext, "webgl" izbere WebGLRenderingContext, "webgl2" izbere WebGL2RenderingContext in "webgpu" izbere GPUCanvasContext. Razpoložljivost načinov in nastavitev je odvisna od izvajalnega okolja.
Prvi uspešni klic določi način elementa. Ponovni klic z istim identifikatorjem vrne isti objekt in ne uporabi novih nastavitev. Če način ni podprt ali ni na voljo oziroma če zahtevaš drug način, dobiš null. Po uspešnem klicu transferControlToOffscreen() element služi kot označba mesta: klic getContext() ali prireditev vrednosti lastnosti width ali height sproži InvalidStateError.
canvas.width in canvas.height odražata istoimenska atributa HTML. Določata širino in višino bitne slike kot nenegativni celi števili. Če atribut manjka ali njegove vrednosti ni mogoče razčleniti, se uporabi privzeta vrednost 300 oziroma 150. Sprememba samo canvas.style.width ali canvas.style.height vpliva na velikost prikaza, ne na ločljivost bitne slike; zaradi spreminjanja merila je lahko slika zamegljena.
V načinu 2D prireditev katere koli mere, tudi če vrednost ostane enaka, počisti bitno sliko in ponastavi stanje risanja, vključno s trenutno potjo, transformacijo in slogi. Objekt konteksta ostane isti. Mere nastavi pred risanjem; po spremembi velikosti obnovi potrebno stanje in znova nariši vsebino. Pri drugih načinih ne predpostavljaj enakega vedenja.
Če narišeš sliko z drugega izvora brez ustreznega dovoljenja CORS, lahko bitna slika izgubi stanje origin-clean. Tedaj getImageData() sproži SecurityError; sprememba velikosti bitne slike 2D zavrže njeno vsebino, ne da bi razkrila blokirane slikovne pike.
Primeri
<!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
Shrani primer kot datoteko HTML, odpri jo v brskalniku in si oglej izpis v razvijalski konzoli. Prvi dve vrstici pokažeta mere. Ponovna prireditev iste širine spremeni alfo slikovne pike iz `255` v `0` in ponastavi `globalAlpha` iz `0.5` na `1`. Rezultata `true` pokažeta, da kontekst ostane isti in da je drug način zavrnjen.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredna · Različica: 4
- JavaScript · Lekcija 33 · Napredna · Različica: 4
- JavaScript · Lekcija 34 · Napredna · Različica: 4