Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Canvas 2D: štýl výplne, štýl obrysu a hrúbka čiary

`fillStyle` určuje vzhľad výplne, `strokeStyle` vzhľad obrysu a `lineWidth` jeho hrúbku. Sú to tri samostatné vlastnosti stavu kreslenia v kontexte Canvas 2D.

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

Syntax

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 a lineWidth sú vlastnosti inštancie kontextu Canvas 2D, napríklad ctx získaného volaním canvas.getContext("2d"). Patria k API webovej platformy, nie k ECMAScriptu, preto ich neposkytuje každé prostredie JavaScriptu. Samotné priradenie nič nevykreslí.

fillStyle určuje výplň pre fill(), fillRect() a fillText(). strokeStyle určuje štýl obrysu pre stroke(), strokeRect() a strokeText(). Oba štýly sú spočiatku čierne a prijímajú reťazec s farbou CSS, objekt CanvasGradient alebo CanvasPattern. Neplatný reťazec s farbou ponechá predchádzajúcu hodnotu. Pri čítaní dostaneš serializovanú farbu (nie nevyhnutne pôvodný reťazec) alebo priradený objekt. Zmeny tohto objektu ovplyvnia ďalšie kreslenie.

lineWidth udáva celkovú hrúbku obrysu v jednotkách súradnicového priestoru, nie nevyhnutne v pixeloch obrazovky. Obrys je vycentrovaný vzhľadom na cestu a zmena mierky kontextu môže zmeniť jeho viditeľnú hrúbku. Počiatočná hodnota je 1. Použi konečné číslo väčšie ako nula: 0, záporné čísla, Infinity, -Infinity a NaN sa ignorujú.

Vlastnosti platia pre ďalšie kreslenie, kým sa nezmenia alebo kým sa stav neobnoví či nenastaví na predvolené hodnoty. save() a restore() ukladajú a obnovujú stav kreslenia, nie aktuálnu cestu ani pixely. Priradenie vzoru z obrázka iného pôvodu bez povolenia CORS môže zablokovať čítanie pixelov: getImageData() potom vyvolá SecurityError.

Príklady

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

Výsledok

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

Ulož príklad ako súbor HTML a otvor ho v prehliadači. Plátno sa nepridá na stránku: kód vypíše do konzoly prehliadača hrúbku a hodnoty RGBA vo výplni, na obryse a mimo kresby. Priradenie `0` ponechá hrúbku na hodnote `6`.

Súvisiace lekcie

  • JavaScript · Lekcia 12 · Pokročilá · Verzia: 4

Zdroje