Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

HTMLCanvasElement 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

Viri