BlueGit

timfa questward

Files

questward / shared / render / tint.js

tint.js

tint.js 4.2 KiB Download Raw
1import { MaterialTier, MATERIAL_TIER_ORDER } from "../definitions/materialTiers.js";
2import { itemDefinition } from "../definitions/items.js";
3
4/**
5 * Artist convention for tintable pixels (source sprites):
6 * - Tintable when R == B and G < R (magenta family).
7 * - Lightness L = R (= B): (50,0,50) dark … (255,0,255) max light.
8 * - G > 0 (still G < R) desaturates toward white/gray: mix(tint, white, G/R) * L.
9 * - Otherwise leave RGB as-is. World shaders apply darkness after this pass.
10 */
11
12export const MAGENTA_CHANNEL_EPS = 1 / 255;
13
14/** Display tint colors per material tier (0–1 RGB). */
15export const TIER_TINT_COLOR = Object.freeze({
16 [MaterialTier.bronze]: Object.freeze({ r: 0.72, g: 0.48, b: 0.28 }),
17 [MaterialTier.iron]: Object.freeze({ r: 0.62, g: 0.64, b: 0.68 }),
18 [MaterialTier.steel]: Object.freeze({ r: 0.78, g: 0.80, b: 0.84 }),
19 [MaterialTier.mithril]: Object.freeze({ r: 0.45, g: 0.55, b: 0.85 }),
20 [MaterialTier.adamantium]: Object.freeze({ r: 0.35, g: 0.75, b: 0.45 }),
21 [MaterialTier.orichalcum]: Object.freeze({ r: 0.85, g: 0.35, b: 0.55 })
22});
23
24export function normalizeRgb (color, fallback = { r: 0.7, g: 0.7, b: 0.7 })
25{
26 if (!color)
27 { return { r: fallback.r, g: fallback.g, b: fallback.b }; }
28 return {
29 r: clamp01(color.r ?? fallback.r),
30 g: clamp01(color.g ?? fallback.g),
31 b: clamp01(color.b ?? fallback.b)
32 };
33}
34
35export function tierTintColor (tier)
36{
37 return normalizeRgb(TIER_TINT_COLOR[tier] ?? TIER_TINT_COLOR[MaterialTier.bronze]);
38}
39
40/**
41 * Resolve tint for an inventory/ground stack or item def.
42 * Priority: potion instance.color → def.tint → tintFromTier + tier.
43 */
44export function resolveItemTint (stackOrDef, def = null)
45{
46 const stack = stackOrDef?.itemId != null ? stackOrDef : null;
47 const definition = def
48 ?? (stack ? itemDefinition(stack.itemId) : stackOrDef)
49 ?? null;
50 if (stack?.instance?.kind === "potion" && stack.instance.color)
51 { return normalizeRgb(stack.instance.color); }
52 if (definition?.tint)
53 { return normalizeRgb(definition.tint); }
54 const tier = resolveTintTier(definition);
55 if (tier)
56 { return tierTintColor(tier); }
57 return null;
58}
59
60export function resolveEquipTint (itemIdOrDef)
61{
62 const definition = typeof itemIdOrDef === "number"
63 ? itemDefinition(itemIdOrDef)
64 : itemIdOrDef;
65 if (!definition)
66 { return null; }
67 if (definition.tint)
68 { return normalizeRgb(definition.tint); }
69 const tier = resolveTintTier(definition);
70 if (tier)
71 { return tierTintColor(tier); }
72 return null;
73}
74
75function resolveTintTier (definition)
76{
77 if (!definition)
78 { return null; }
79 if (typeof definition.tintFromTier === "string")
80 { return definition.tintFromTier; }
81 if (definition.tintFromTier === true)
82 { return definition.equipment?.tier ?? definition.tier ?? null; }
83 if (definition.equipment?.tintFromTier)
84 { return definition.equipment.tier ?? null; }
85 return null;
86}
87
88/** Pure pixel transform (channels 0–1). Returns null if pixel is not tintable. */
89export function magentaTintedRgb (r, g, b, tintRgb)
90{
91 if (!isMagentaTintable(r, g, b))
92 { return null; }
93 const L = r;
94 const gBlend = r > 0 ? Math.min(1, Math.max(0, g / r)) : 0;
95 const tint = normalizeRgb(tintRgb);
96 return {
97 r: clamp01(mix(tint.r, 1, gBlend) * L),
98 g: clamp01(mix(tint.g, 1, gBlend) * L),
99 b: clamp01(mix(tint.b, 1, gBlend) * L)
100 };
101}
102
103export function isMagentaTintable (r, g, b, eps = MAGENTA_CHANNEL_EPS)
104{
105 return Math.abs(r - b) <= eps && g < r - eps;
106}
107
108/** Mutate ImageData in place with magenta→tint (alpha unchanged). */
109export function applyMagentaTintToImageData (imageData, tintRgb)
110{
111 const data = imageData.data;
112 const tint = normalizeRgb(tintRgb);
113 for (let i = 0; i < data.length; i += 4)
114 {
115 if (data[i + 3] < 8)
116 { continue; }
117 const r = data[i] / 255;
118 const g = data[i + 1] / 255;
119 const b = data[i + 2] / 255;
120 const next = magentaTintedRgb(r, g, b, tint);
121 if (!next)
122 { continue; }
123 data[i] = Math.round(next.r * 255);
124 data[i + 1] = Math.round(next.g * 255);
125 data[i + 2] = Math.round(next.b * 255);
126 }
127 return imageData;
128}
129
130export function listTierTintPreview ()
131{
132 return MATERIAL_TIER_ORDER.map((tier) => ({ tier, color: tierTintColor(tier) }));
133}
134
135function clamp01 (n)
136{
137 return Math.min(1, Math.max(0, Number(n) || 0));
138}
139
140function mix (a, b, t)
141{
142 return a + (b - a) * t;
143}