Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Canvas 2D: transformacje, stan, przycinanie i prostokąty

Oddziel stan rysowania od bieżącej ścieżki i pikseli, aby ograniczyć przycinanie do jednego etapu rysowania i wyczyścić tylko zamierzony obszar.

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

Składnia

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform()
ctx.setTransform(matrix2D)
ctx.save()
ctx.restore()
ctx.beginPath()
ctx.rect(x, y, width, height)
ctx.clip()
ctx.clip(fillRule)
ctx.clip(path)
ctx.clip(path, fillRule)
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.strokeRect(x, y, width, height)

Metody te należą do CanvasRenderingContext2D, interfejsu platformy WWW, a nie do ECMAScript 2024. Obsługa zależy od środowiska. setTransform(a, b, c, d, e, f) zastępuje macierz zamiast ją mnożyć: punkt (x, y) przechodzi w (a*x + c*y + e, b*x + d*y + f). Można też podać obiekt DOMMatrix2DInit: domyślnie a i d to 1, a pozostałe współczynniki to 0, więc wywołanie bez argumentów ustawia macierz jednostkową. Sprzeczne wartości synonimicznych pól, np. a i m11, powodują TypeError. Wariant z sześcioma liczbami nie zmienia macierzy, jeśli któraś jest nieskończona lub jest NaN.

save() odkłada na stos kopię stanu rysowania, w tym transformację, obszar przycinania i style. restore() zdejmuje i przywraca ostatni zapis; przy pustym stosie nic nie robi. Stos nie przechowuje bieżącej ścieżki ani pikseli. beginPath() opróżnia ścieżkę bez zmiany obszaru przycinania i bitmapy, a rect(x, y, width, height) dodaje do niej zamkniętą podścieżkę prostokątną bez rysowania pikseli. Transformacja działa na geometrię tej ścieżki w chwili jej tworzenia.

clip() zastępuje obszar przycinania jego częścią wspólną z wnętrzem bieżącej ścieżki lub przekazanego Path2D. W przypadku Path2D transformacja działa w chwili wywołania clip(), bez modyfikowania obiektu. Opcjonalna reguła 'nonzero' (domyślna) sprawdza, czy suma przekroczeń z uwzględnieniem kierunku jest niezerowa; 'evenodd' sprawdza, czy liczba przekroczeń jest nieparzysta. clip() nie rysuje pikseli, a kolejne wywołania nie poszerzają obszaru. Zapisz stan przed przycięciem i przywróć go po rysowaniu; do przeniesienia początku układu nie trzeba zmieniać przycięcia, a ustawienie macierzy jednostkowej go nie usuwa.

fillRect() wypełnia prostokąt za pomocą fillStyle, strokeRect() rysuje obrys za pomocą strokeStyle i ustawień linii, a clearRect() czyści do przezroczystej czerni (nieprzezroczystej czerni przy alpha: false) niezależnie od cieni, globalnej alfy i kompozycji. Wszystkie trzy działają bezpośrednio na bitmapie, stosują transformację i przycięcie oraz pozostawiają ścieżkę bez zmian. Dlatego fillRect() nie przygotowuje geometrii dla clip(). clearRect() nie odblokowuje odczytu z bitmapy oznaczonej jako zanieczyszczona danymi obcego pochodzenia: getImageData() nadal zgłasza SecurityError.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D clipping</title>
<canvas id="canvas" width="20" height="12"></canvas>
<script>
(() => {
  const canvas = document.getElementById('canvas');
  const ctx = canvas.getContext('2d', { alpha: true });
  if (!ctx) throw new Error('Canvas 2D unavailable');

  ctx.fillRect(0, 0, 12, 12);
  ctx.save();
  try {
    ctx.setTransform(1, 0, 0, 1, 4, 2);
    ctx.beginPath();
    ctx.rect(0, 0, 8, 8);
    ctx.clip();
    ctx.clearRect(-2, 2, 6, 4);
  } finally {
    ctx.restore();
  }

  ctx.lineWidth = 2;
  ctx.strokeRect(14, 2, 4, 8);
  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([3, 5, 9, 14, 16].map(x => alphaAt(x, 5)).join(', '));
})();
</script>

Wynik

255, 0, 255, 255, 0

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli deweloperskiej. Pięć wartości alfa pokazuje kolejno: wypełnienie chronione przez przycięcie, wyczyszczony piksel, nietknięte wypełnienie, obrys narysowany po przywróceniu stanu i przezroczyste wnętrze obrysu.

Powiązane lekcje

  • JavaScript · Lekcja 12 · Zaawansowany · Wersja: 4

Źródła