Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Canvas 2D: slog polnila, slog obrobe in debelina črte

`fillStyle` določa videz polnila, `strokeStyle` videz obrobe, `lineWidth` pa njeno debelino. To so tri ločene lastnosti stanja risanja v kontekstu Canvas 2D.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

ctx.fillStyle = paint;
ctx.strokeStyle = paint;
ctx.lineWidth = width;
// paint: CSS color string, CanvasGradient, or CanvasPattern
// width: finite number greater than 0, in canvas coordinate-space units

fillStyle, strokeStyle in lineWidth so lastnosti primerka konteksta Canvas 2D, na primer ctx, ki ga vrne canvas.getContext("2d"). Spadajo v API spletne platforme, ne v ECMAScript, zato niso na voljo v vsakem okolju JavaScript. Sama prireditev ne nariše ničesar.

fillStyle določa polnilo za fill(), fillRect() in fillText(). strokeStyle določa slog obrobe za stroke(), strokeRect() in strokeText(). Oba sloga sta sprva črna in sprejmeta niz z barvo CSS, objekt CanvasGradient ali CanvasPattern. Neveljaven barvni niz ne spremeni prejšnje vrednosti. Branje vrne serializirano barvo (ne nujno prvotnega niza) ali prirejeni objekt. Spremembe tega objekta vplivajo na nadaljnje risanje.

lineWidth določa celotno debelino obrobe v enotah koordinatnega sistema, ne nujno v zaslonskih slikovnih pikah. Obroba je sredinsko poravnana s potjo, sprememba merila konteksta pa lahko spremeni njeno vidno debelino. Začetna vrednost je 1. Uporabi končno število, večje od nič: 0, negativna števila, Infinity, -Infinity in NaN se prezrejo.

Lastnosti veljajo za nadaljnje risanje, dokler jih ne spremeniš ali se stanje ne obnovi oziroma ponastavi. save() in restore() shranita in obnovita stanje risanja, ne pa trenutne poti ali slikovnih pik. Prireditev vzorca iz slike z drugega izvora brez dovoljenja CORS lahko prepreči branje slikovnih pik: getImageData() takrat sproži SecurityError.

Primeri

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D fill and stroke</title>
<script>
(() => {
  const canvas = document.createElement("canvas");
  canvas.width = canvas.height = 32;
  const ctx = canvas.getContext("2d");
  if (!ctx) throw new Error("Canvas 2D is unavailable");

  ctx.fillStyle = "#ff0000";
  ctx.strokeStyle = "#0000ff";
  ctx.lineWidth = 6;
  ctx.lineWidth = 0;
  ctx.fillRect(8, 8, 16, 16);
  ctx.strokeRect(8, 8, 16, 16);

  const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(", ");
  console.log(`width: ${ctx.lineWidth}`);
  console.log(`fill: ${rgba(16, 16)}`);
  console.log(`stroke: ${rgba(6, 16)}`);
  console.log(`outside: ${rgba(2, 16)}`);
})();
</script>

Rezultat

width: 6
fill: 255, 0, 0, 255
stroke: 0, 0, 255, 255
outside: 0, 0, 0, 0

Shrani primer kot datoteko HTML in jo odpri v brskalniku. Koda platna ne doda na stran: v konzolo brskalnika izpiše debelino ter vrednosti RGBA v polnilu, na obrobi in zunaj risbe. Prireditev `0` ohrani debelino `6`.

Povezane lekcije

  • JavaScript · Lekcija 12 · Napredna · Različica: 4

Viri