База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Canvas 2D: изчистване на област и рисуване на запълнен кръг

Разграничавай изчистването на пиксели от изпразването на контура. Създай окръжност с `arc()`, задай `fillStyle` и запълни вътрешността с `fill()`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const ctx = canvas.getContext("2d"); // CanvasRenderingContext2D or null

ctx.clearRect(x, y, width, height);
ctx.beginPath();
ctx.arc(x, y, radius, startAngle, endAngle);
ctx.arc(x, y, radius, startAngle, endAngle, counterclockwise);
ctx.fillStyle = style; // CSS color string, CanvasGradient, or CanvasPattern
ctx.fill();
ctx.fill(fillRule);
ctx.fill(path);
ctx.fill(path, fillRule); // path: Path2D; fillRule: "nonzero" or "evenodd"

clearRect(), beginPath(), arc() и fill() са методи на CanvasRenderingContext2D, а fillStyle е негово свойство. Те са част от уеб платформата, а не от ECMAScript 2024. Извикай canvas.getContext("2d") върху елемент canvas и провери дали резултатът е null; наличността зависи от средата за изпълнение.

clearRect(x, y, width, height) задава пикселите в правоъгълник като прозрачно черно, ако контекстът е с включен алфа канал. Методът отчита текущата трансформация и областта на изрязване, но не използва fillStyle и не премахва контура. За да изчистиш цялото платно с clearRect(0, 0, canvas.width, canvas.height), използвай тъждествена трансформация и се увери, че изрязването не изключва никоя част от платното.

beginPath() изпразва текущия контур, без да променя пикселите или стила. Извикай метода, преди да създадеш независима фигура, за да не запълни следващото fill() отново старата геометрия по погрешка.

arc(x, y, radius, startAngle, endAngle, counterclockwise) добавя дъга с център (x, y), без да я изрисува. Ъглите се измерват в радиани спрямо положителната полуос X. Посоката по подразбиране е по часовниковата стрелка; true я обръща в координатната система по подразбиране. Ъглите 0 и 2 * Math.PI в посоката по подразбиране образуват пълна окръжност. Ако контурът вече има крайна точка, arc() я свързва с началото на дъгата с права отсечка. Ако някой числов аргумент е NaN, Infinity или -Infinity, arc() приключва, без да променя контура. Ако всички числови аргументи са крайни, отрицателен радиус предизвиква изключение IndexSizeError.

Свойството fillStyle приема низ с CSS цвят, CanvasGradient или CanvasPattern. Цветът по подразбиране е черен; невалиден низ за цвят оставя предишния стил непроменен. Присвояването не пребоядисва вече изрисуваните пиксели.

fill() и fill(fillRule) запълват текущия контур с текущия стил. fill(path) и fill(path, fillRule) вместо него запълват подадения обект Path2D. Правилото по подразбиране "nonzero" проверява дали сборът на пресичанията на контура с лъч, отчетени със знак според посоката на пресичане, е различен от нула; "evenodd" проверява дали броят на пресичанията е нечетен. При запълване отворените части на контура се третират като затворени, без методът да ги променя или да изпразва контура.

Примери

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel samples</title>
<pre id="output"></pre>
<script>
  const canvas = document.createElement("canvas");
  canvas.width = 48;
  canvas.height = 24;
  const ctx = canvas.getContext("2d");
  if (!ctx) throw new Error("Canvas 2D is unavailable");

  const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(",");

  ctx.beginPath();
  ctx.arc(12, 12, 8, 0, 2 * Math.PI);
  ctx.fillStyle = "#ff0000";
  ctx.fill();
  const samples = [rgba(12, 12)];

  ctx.clearRect(0, 0, canvas.width, canvas.height);
  ctx.beginPath();
  ctx.arc(36, 12, 8, 0, 2 * Math.PI);
  ctx.fillStyle = "#0000ff";
  ctx.fill();
  samples.push(rgba(12, 12), rgba(36, 12));

  document.getElementById("output").textContent = samples.join("\n");
</script>

Резултат

255,0,0,255
0,0,0,0
0,0,255,255

Запази примера като HTML файл и го отвори в браузър. Трите показани RGBA проби съответстват на червения център на първия кръг, прозрачния пиксел на същата позиция след прерисуването и синия център на новия кръг. Платното не се добавя към страницата. `getImageData()` предизвиква `SecurityError`, ако платното вече няма статус `origin-clean`, например след изрисуване на изображение от друг източник без CORS разрешение; само `clearRect()` не възстановява този статус.

Свързани уроци

  • JavaScript · Урок 27 · Средно · Версия: 3

Източници