CKTIS / JavaScript
Canvas 2D: stil ispune, stil obrisa i debljina crte
`fillStyle` određuje izgled ispune, `strokeStyle` izgled obrisa, a `lineWidth` njegovu debljinu. To su tri zasebna svojstva stanja crtanja u kontekstu Canvas 2D.
Verzija: 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 unitsfillStyle, strokeStyle i lineWidth svojstva su instance konteksta Canvas 2D, primjerice ctx dobivenog pozivom canvas.getContext("2d"). Pripadaju API-ju web-platforme, a ne ECMAScriptu, pa nisu dostupna u svakom JavaScript okruženju. Sama dodjela ne crta ništa.
fillStyle određuje ispunu za fill(), fillRect() i fillText(). strokeStyle određuje stil obrisa za stroke(), strokeRect() i strokeText(). Oba su stila u početku crna i prihvaćaju niz znakova koji predstavlja CSS boju, objekt CanvasGradient ili CanvasPattern. Nevaljani niz znakova za boju ne mijenja prethodnu vrijednost. Čitanje vraća serijaliziranu boju (ne nužno izvorni niz znakova) ili dodijeljeni objekt. Promjene tog objekta utječu na sljedeće crtanje.
lineWidth određuje ukupnu debljinu obrisa u jedinicama koordinatnog sustava, ne nužno u zaslonskim pikselima. Obris je centriran na putanji, a promjena mjerila konteksta može promijeniti njegovu vidljivu debljinu. Početna vrijednost je 1. Upotrijebi konačan broj veći od nule: 0, negativni brojevi, Infinity, -Infinity i NaN se zanemaruju.
Svojstva vrijede za sljedeće crtanje dok se ne promijene ili dok se stanje ne vrati odnosno ponovno postavi na početne vrijednosti. save() i restore() spremaju i vraćaju stanje crtanja, a ne trenutačnu putanju ili piksele. Dodjela uzorka iz slike drugog podrijetla bez dopuštenja CORS može blokirati čitanje piksela: getImageData() tada baca SecurityError.
Primjeri
<!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
Spremi primjer kao HTML datoteku i otvori je u pregledniku. Kôd ne dodaje platno na stranicu: u konzoli preglednika ispisuje debljinu i vrijednosti RGBA u ispuni, na obrisu i izvan crteža. Dodjela vrijednosti `0` ostavlja debljinu na `6`.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredno · Verzija: 4