Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

HTMLCanvasElement 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

Izvori