Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Canvas 2D: transformacije, pravokutnici i putanje

Razlikuj transformaciju, piksele i zadanu putanju. Saznaj kada se koordinate transformiraju, koji pozivi odmah mijenjaju piksele i što ostaje nakon poziva `stroke()`.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform(matrix)
ctx.setTransform()
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.beginPath()
ctx.moveTo(x, y)
ctx.lineTo(x, y)
ctx.stroke()
ctx.stroke(path)

CanvasRenderingContext2D sučelje je web API-ja, a ne dio ECMAScripta 2024. Metode pozivaj na kontekstu ctx koji vraća canvas.getContext('2d'); rezultat može biti null. Podrška za pojedine oblike poziva ovisi o izvršnom okruženju. Svih sedam metoda u uobičajenom pozivu vraća undefined.

setTransform(a, b, c, d, e, f) zamjenjuje trenutačnu matricu, za razliku od transform(), koji je množi. Točka (x, y) preslikava se u (a*x + c*y + e, b*x + d*y + f). Drugi oblik prima objekt s opisom 2D matrice (DOMMatrix2DInit): izostavljene komponente preuzimaju vrijednosti jedinične matrice, a proturječne vrijednosti za dva naziva iste komponente, kao što su a i m11, izazivaju TypeError. Standard dopušta poziv bez argumenata za postavljanje jedinične matrice. U obliku sa šest brojeva trenutačna matrica ostaje nepromijenjena ako je bilo koji argument NaN ili beskonačan. U obliku s rječnikom metoda iz valjanog rječnika stvara DOMMatrix i postavlja je kao trenutačnu matricu bez te provjere.

fillRect(x, y, width, height) odmah iscrtava pravokutnik s pomoću fillStyle. Uz iste parametre clearRect() briše piksele u prozirnu crnu (neprozirnu crnu uz alpha: false), neovisno o stilu, globalAlpha i načinu kompozicije. Obje metode poštuju trenutačnu transformaciju i područje izrezivanja te ne mijenjaju putanju. Nulta dimenzija nema učinka, a negativna proteže pravokutnik od (x, y) u suprotnom smjeru.

beginPath() prazni zadanu putanju, ali ne briše piksele. moveTo(x, y) započinje novu potputanju bez povezivanja s prethodnom. lineTo(x, y) dodaje ravnu dužinu od posljednje točke; ako potputanja ne postoji, samo postavlja početnu točku. Nijedna od tih triju metoda ne iscrtava piksele. moveTo(), lineTo() i obje metode za pravokutnike zanemaruju pozive s beskonačnim vrijednostima ili NaN u koordinatama ili dimenzijama.

stroke() iscrtava trenutačnu zadanu putanju koristeći strokeStyle i postavke linije kao što je lineWidth. Ne zatvara otvorene potputanje niti prazni putanju. Koordinate zadane putanje transformiraju se pri dodavanju, ne ponovno pri iscrtavanju, no trenutačna matrica i dalje utječe na potez, primjerice na njegovu debljinu. Uz stroke(path) geometrija predanog objekta Path2D transformira se pri iscrtavanju bez izmjene objekta. save() i restore() spremaju i vraćaju stanje crtanja, uključujući matricu, ali ne i zadanu putanju ili piksele.

Primjeri

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D</title>
<canvas id="demo" width="32" height="24" hidden></canvas>
<script>
(() => {
  const canvas = document.getElementById('demo');
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D is unavailable');

  ctx.setTransform(1, 0, 0, 1, 8, 4);
  ctx.fillStyle = '#000';
  ctx.fillRect(0, 0, 16, 8);
  ctx.beginPath();
  ctx.moveTo(2, 12);
  ctx.lineTo(14, 12);
  ctx.clearRect(0, 0, 4, 8);

  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.strokeStyle = '#000';
  ctx.lineWidth = 4;
  ctx.stroke();

  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([alphaAt(9, 6), alphaAt(15, 6), alphaAt(15, 16), alphaAt(5, 12)].join(', '));
})();
</script>

Rezultat

0, 255, 255, 0

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli. Očekivane alfa vrijednosti `0, 255, 255, 0` odgovaraju obrisanom području, preostaloj ispuni, pomaknutoj dužini i netaknutoj točki u koordinatnom sustavu bez pomaka. `getImageData()` čita u koordinatama bitmape. Postavke privatnosti mogu promijeniti rezultat, a čitanje platna onečišćenog nedopuštenim sadržajem drugog izvora može izazvati `SecurityError`.

Povezane lekcije

  • JavaScript · Lekcija 34 · Napredno · Verzija: 4

Izvori