KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Canvas 2D: een gebied wissen en een gevulde cirkel tekenen

Houd pixels wissen en het pad leegmaken uit elkaar. Maak een cirkel met `arc()`, stel `fillStyle` in en vul de cirkel met `fill()`.

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

Syntax

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() en fill() zijn methoden van CanvasRenderingContext2D; fillStyle is een eigenschap. Ze horen bij het webplatform en niet bij ECMAScript 2024. Roep op een canvas-element canvas.getContext("2d") aan en controleer op null; de beschikbaarheid hangt af van de uitvoeromgeving.

clearRect(x, y, width, height) zet de pixels in een rechthoek op transparant zwart als het alfakanaal is ingeschakeld. De huidige transformatie en het huidige knipgebied zijn van toepassing, maar de methode gebruikt fillStyle niet en laat het pad intact. Gebruik voor clearRect(0, 0, canvas.width, canvas.height) een identiteitstransformatie en zorg dat het knipgebied niets van het canvas uitsluit om het hele canvas te wissen.

beginPath() maakt het huidige pad leeg zonder pixels of tekenstijlen te wijzigen. Roep de methode aan voordat je een afzonderlijke vorm opbouwt, zodat de volgende fill() niet per ongeluk ook oude vormen opnieuw vult.

arc(x, y, radius, startAngle, endAngle, counterclockwise) voegt een cirkelboog met middelpunt (x, y) toe zonder te tekenen. Hoeken worden in radialen gemeten vanaf de positieve x-as. De standaardrichting is met de klok mee; true keert de richting om in het standaardcoördinatenstelsel. Met 0 en 2 * Math.PI in de standaardrichting krijg je een volledige cirkel. Als het pad al een eindpunt heeft, trekt arc() een rechte lijn van dat punt naar het begin van de boog. Als een numeriek argument NaN, Infinity of -Infinity is, stopt arc() zonder het pad te wijzigen. Als alle numerieke argumenten eindig zijn, veroorzaakt een negatieve straal IndexSizeError.

De eigenschap fillStyle accepteert een CSS-kleur als tekenreeks, een CanvasGradient of een CanvasPattern. De standaardkleur is zwart; een ongeldige kleurtekenreeks laat de vorige stijl ongewijzigd. Een toewijzing verandert de kleur van bestaande pixels niet.

fill() en fill(fillRule) vullen het huidige pad met de huidige stijl. fill(path) en fill(path, fillRule) vullen in plaats daarvan het meegegeven Path2D-object. De standaardregel "nonzero" kijkt of de som van de kruisingen van een halfrechte met het pad, met een teken per kruisingsrichting, ongelijk aan nul is; "evenodd" kijkt of het aantal kruisingen oneven is. Bij het vullen tellen open deelpaden als gesloten, zonder dat de methode ze wijzigt of het pad leegmaakt.

Voorbeelden

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

Resultaat

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

Sla het voorbeeld op als HTML-bestand en open het in een browser. De drie weergegeven RGBA-metingen tonen het rode middelpunt van de eerste cirkel, de transparante pixel op dezelfde positie na het opnieuw tekenen en het blauwe middelpunt van de nieuwe cirkel. Het canvas wordt niet aan de pagina toegevoegd. `getImageData()` veroorzaakt `SecurityError` als het canvas niet meer `origin-clean` is, bijvoorbeeld na het tekenen van een afbeelding van een andere origin zonder CORS-toestemming; `clearRect()` alleen herstelt die status niet.

Gerelateerde lessen

  • JavaScript · Les 27 · Gemiddeld · Versie: 3

Bronnen