BlueGit

timfa questward

Files

questward / shared / definitions / tileSprites.js

tileSprites.js

tileSprites.js 2.8 KiB Download Raw
1export function spriteImageName (layer, key, state)
2{
3 return `${layer}:${key}:${state}`;
4}
5
6export function bloomImageName (layer, key, state)
7{
8 return `${spriteImageName(layer, key, state)}:bloom`;
9}
10
11export function equipImageName (layer, key, state)
12{
13 return `${spriteImageName(layer, key, state)}:equip`;
14}
15
16export function equipBloomImageName (layer, key, state)
17{
18 return `${equipImageName(layer, key, state)}:bloom`;
19}
20
21/** Bloom companion for any registered image name (`item:stick:stick:equip` → `…:equip:bloom`). */
22export function palettePreviewImageName (layer, key)
23{
24 return spriteImageName(layer, key, `${key}-preview`);
25}
26
27/**
28 * Companion suffixes peel from the right in fixed order.
29 * `torch-equip-bloom` → base torch, equip + bloom.
30 * `torch-bloom` → base torch, bloom.
31 * `stick-equip` → base stick, equip.
32 */
33export function parseSpriteStem (stem)
34{
35 let rest = String(stem ?? "");
36 let bloom = false;
37 let equip = false;
38 let preview = false;
39 if (rest.endsWith("-preview") && rest.length > "-preview".length)
40 {
41 preview = true;
42 rest = rest.slice(0, -"-preview".length);
43 }
44 if (rest.endsWith("-bloom") && rest.length > "-bloom".length)
45 {
46 bloom = true;
47 rest = rest.slice(0, -"-bloom".length);
48 }
49 if (rest.endsWith("-equip") && rest.length > "-equip".length)
50 {
51 equip = true;
52 rest = rest.slice(0, -"-equip".length);
53 }
54 const companion = bloom || equip || preview;
55 return {
56 base: companion ? rest : String(stem ?? ""),
57 companion,
58 bloom,
59 equip,
60 preview
61 };
62}
63
64export function isCompanionSpriteStem (stem)
65{
66 return parseSpriteStem(stem).companion;
67}
68
69export function resolveState (states, requested)
70{
71 if (!states?.length)
72 { return null; }
73 if (requested && !isCompanionSpriteStem(requested) && states.includes(requested))
74 { return requested; }
75 return states[0];
76}
77
78export function cycleState (states, current, direction)
79{
80 if (!states?.length)
81 { return null; }
82 const resolved = resolveState(states, current);
83 const index = states.indexOf(resolved);
84 const step = direction < 0 ? -1 : 1;
85 return states[(index + step + states.length) % states.length];
86}
87
88export function catalogGroup (catalog, layer)
89{
90 if (layer === "ground")
91 { return catalog?.grounds; }
92 if (layer === "block")
93 { return catalog?.blocks; }
94 if (layer === "item")
95 { return catalog?.items; }
96 if (layer === "mob")
97 { return catalog?.mobs; }
98 if (layer === "character")
99 { return catalog?.characters; }
100 return null;
101}
102
103export function statesForType (catalog, layer, key)
104{
105 return (catalogGroup(catalog, layer)?.[key]?.states ?? [])
106 .filter((state) => !isCompanionSpriteStem(state));
107}
108
109export function defaultStateForType (catalog, layer, key)
110{
111 const group = catalogGroup(catalog, layer)?.[key];
112 return group?.defaultState ?? resolveState(statesForType(catalog, layer, key), null);
113}