Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Canvas 2D: transformacje, prostokąty i ścieżki

Rozróżnij macierz transformacji, piksele i ścieżkę domyślną. Ustal, kiedy współrzędne są przeliczane, które wywołania od razu zmieniają obraz i co pozostaje po `stroke()`.

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

Składnia

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 to interfejs Web API, a nie część ECMAScript 2024. Metody wywołujesz na kontekście ctx uzyskanym przez canvas.getContext('2d'); wynik może być null. Dostępność poszczególnych form wywołania zależy od środowiska. Wszystkie omawiane metody po prawidłowym wywołaniu zwracają undefined.

setTransform(a, b, c, d, e, f) zastępuje bieżącą macierz, zamiast ją mnożyć jak transform(). Punkt (x, y) przechodzi w (a*x + c*y + e, b*x + d*y + f). Druga forma przyjmuje obiekt opisujący macierz 2D (DOMMatrix2DInit); pominięte składowe mają wartości macierzy jednostkowej, a sprzeczne wartości aliasów, np. a i m11, powodują TypeError. Zgodnie ze standardem wywołanie bez argumentów ustawia macierz jednostkową. W formie z sześcioma liczbami argument równy NaN lub nieskończoności pozostawia dotychczasową macierz bez zmian. W formie słownikowej metoda tworzy i ustawia DOMMatrix z prawidłowo przekazanego słownika, bez tego sprawdzenia.

fillRect(x, y, width, height) od razu maluje prostokąt przy użyciu fillStyle. clearRect() z tymi samymi parametrami czyści piksele do przezroczystej czerni (nieprzezroczystej przy alpha: false), niezależnie od stylu, globalAlpha i trybu kompozycji. Obie metody uwzględniają bieżącą macierz i obszar przycinania oraz nie zmieniają ścieżki. Zerowy wymiar oznacza brak efektu; ujemny wymiar rozciąga prostokąt w przeciwnym kierunku od (x, y).

beginPath() opróżnia ścieżkę domyślną, ale nie usuwa pikseli. moveTo(x, y) zaczyna nową podścieżkę bez łączenia jej z poprzednią. lineTo(x, y) dokłada odcinek od ostatniego punktu; gdy nie ma podścieżki, tylko ustawia jej punkt początkowy. Żadna z tych metod nie maluje. moveTo(), lineTo() i obie metody prostokątne ignorują wywołania ze współrzędnymi lub wymiarami równymi NaN albo nieskończoności.

stroke() maluje obrys bieżącej ścieżki domyślnej za pomocą strokeStyle i ustawień takich jak lineWidth. Nie zamyka otwartych podścieżek ani nie opróżnia ścieżki. Jej współrzędne są transformowane podczas dodawania, nie ponownie podczas obrysowywania, choć bieżąca macierz nadal wpływa na obrys, np. jego grubość. W formie stroke(path) geometria obiektu Path2D jest transformowana w chwili malowania, bez zmiany obiektu. save() i restore() zachowują i odtwarzają stan rysowania, m.in. macierz, lecz nie ścieżkę domyślną ani piksele.

Przykłady

<!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>

Wynik

0, 255, 255, 0

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Oczekiwane wartości alfa `0, 255, 255, 0` odpowiadają kolejno wyczyszczonemu miejscu, zachowanemu wypełnieniu, przesuniętemu odcinkowi i nietkniętemu miejscu w układzie bez przesunięcia. `getImageData()` odczytuje współrzędne bitmapy; ustawienia prywatności mogą zmienić wynik, a odczyt z płótna skażonego danymi z innego źródła bez zezwolenia może zgłosić `SecurityError`.

Powiązane lekcje

  • JavaScript · Lekcja 34 · Zaawansowany · Wersja: 4

Źródła