BlueGit

timfa questward

Files

questward / client / src / play / waterDebug.js

waterDebug.js

waterDebug.js 10.6 KiB Download Raw
1/**
2 * Temporary always-on fluid shader debug panel (water + lava tabs).
3 * Export JSON when you land on values you like.
4 */
5
6export const DEFAULT_WATER_DEBUG = Object.freeze({
7 flowX: 0.17,
8 flowY: 0.05,
9 flowZ: 0.91,
10 waveScale: 2.07,
11 fbmAmp: 0.15,
12 texAmp: 0.43,
13 distort: 0.09,
14 normalZ: 0.88,
15 waveGain: 0.62,
16 crestLo: 0.54,
17 crestHi: 0.67,
18 crestPow: 2.05,
19 glitterPow: 13.1,
20 crestGlitter: 1.3,
21 glitterCap: 1,
22 glitterMix: 1.24,
23 shadeLo: 1.06,
24 shadeHi: 1,
25 bodyLo: 0.41,
26 bodyHi: 0.85,
27 litLo: 0.5,
28 litHi: 0.86,
29 litMix: 0.46,
30 edgeDark: 0.37,
31 lightDirX: -0.48,
32 lightDirY: -0.63,
33 lightDirZ: 0.78,
34 normalEps: 0.21,
35 foamStrength: 1,
36 shoreClip: 0.55,
37 /** 0 = baseline deep end; 1 = much darker deep water. */
38 deepDark: 0.4,
39 /** <1 = more abrupt darkening toward deep (pow curve). */
40 deepAbrupt: 0.72
41});
42
43export const DEFAULT_LAVA_DEBUG = Object.freeze({
44 flowX: 0.08,
45 flowY: 0.04,
46 flowZ: 0.27,
47 waveScale: 1.83,
48 fbmAmp: 0.43,
49 texAmp: 0.3,
50 distort: 0.3,
51 normalZ: 1.07,
52 waveGain: 0.52,
53 crestLo: 0.57,
54 crestHi: 0.71,
55 crestPow: 1.15,
56 glitterPow: 7.5,
57 crestGlitter: 1.19,
58 glitterCap: 0.31,
59 glitterMix: 0.51,
60 shadeLo: 0.88,
61 shadeHi: 1.07,
62 bodyLo: 0.05,
63 bodyHi: 1,
64 litLo: 0.59,
65 litHi: 0.74,
66 litMix: 1,
67 edgeDark: 1,
68 lightDirX: -0.48,
69 lightDirY: -0.63,
70 lightDirZ: 0.78,
71 normalEps: 0.09,
72 bloomStrength: 0.9
73});
74
75const WATER_SLIDERS = [
76 { key: "flowX", label: "Flow X", min: 0, max: 1, step: 0.01 },
77 { key: "flowY", label: "Flow Y", min: 0, max: 1, step: 0.01 },
78 { key: "flowZ", label: "Flow Z", min: 0, max: 1.5, step: 0.01 },
79 { key: "waveScale", label: "Wave scale", min: 0.2, max: 2.5, step: 0.01 },
80 { key: "fbmAmp", label: "FBM amp", min: 0.1, max: 1.5, step: 0.01 },
81 { key: "glitterPow", label: "Glitter pow", min: 1, max: 16, step: 0.1 },
82 { key: "glitterMix", label: "Glitter mix", min: 0, max: 1.5, step: 0.01 },
83 { key: "bodyLo", label: "Body lo", min: 0, max: 0.5, step: 0.01 },
84 { key: "bodyHi", label: "Body hi", min: 0.3, max: 1, step: 0.01 },
85 { key: "litMix", label: "Lit mix", min: 0, max: 1, step: 0.01 },
86 { key: "deepDark", label: "Deep darker", min: 0, max: 1, step: 0.01 },
87 { key: "deepAbrupt", label: "Deep abrupt", min: 0.35, max: 1.4, step: 0.01 },
88 { key: "foamStrength", label: "Foam", min: 0, max: 1, step: 0.01 },
89 { key: "shoreClip", label: "Shore clip", min: 0.1, max: 0.9, step: 0.01 },
90 { key: "edgeDark", label: "Edge dark", min: 0, max: 1, step: 0.01 }
91];
92
93const LAVA_SLIDERS = [
94 { key: "flowX", label: "Flow X", min: 0, max: 1, step: 0.01 },
95 { key: "flowY", label: "Flow Y", min: 0, max: 1, step: 0.01 },
96 { key: "flowZ", label: "Flow Z", min: 0, max: 1.5, step: 0.01 },
97 { key: "waveScale", label: "Wave scale", min: 0.2, max: 2.5, step: 0.01 },
98 { key: "fbmAmp", label: "FBM amp", min: 0.1, max: 1.5, step: 0.01 },
99 { key: "distort", label: "Distort", min: 0, max: 0.5, step: 0.01 },
100 { key: "glitterPow", label: "Heat pow", min: 1, max: 16, step: 0.1 },
101 { key: "glitterMix", label: "Heat mix", min: 0, max: 1.5, step: 0.01 },
102 { key: "glitterCap", label: "Heat cap", min: 0.1, max: 1, step: 0.01 },
103 { key: "bodyLo", label: "Body lo", min: 0, max: 0.5, step: 0.01 },
104 { key: "bodyHi", label: "Body hi", min: 0.3, max: 1, step: 0.01 },
105 { key: "litMix", label: "Lit mix", min: 0, max: 1, step: 0.01 },
106 { key: "bloomStrength", label: "Bloom", min: 0, max: 2, step: 0.01 },
107 { key: "edgeDark", label: "Edge dark", min: 0, max: 1, step: 0.01 }
108];
109
110let waterParams = { ...DEFAULT_WATER_DEBUG };
111let lavaParams = { ...DEFAULT_LAVA_DEBUG };
112let activeTab = "water";
113let panelEl = null;
114
115export function getWaterDebugParams ()
116{
117 return { ...waterParams };
118}
119
120export function getLavaDebugParams ()
121{
122 return { ...lavaParams };
123}
124
125function uniformBagFrom (p, extras = {})
126{
127 return {
128 u_flowX: p.flowX,
129 u_flowY: p.flowY,
130 u_flowZ: p.flowZ,
131 u_waveScale: p.waveScale,
132 u_fbmAmp: p.fbmAmp,
133 u_texAmp: p.texAmp,
134 u_distort: p.distort,
135 u_normalZ: p.normalZ,
136 u_waveGain: p.waveGain,
137 u_crestLo: p.crestLo,
138 u_crestHi: p.crestHi,
139 u_crestPow: p.crestPow,
140 u_glitterPow: p.glitterPow,
141 u_crestGlitter: p.crestGlitter,
142 u_glitterCap: p.glitterCap,
143 u_glitterMix: p.glitterMix,
144 u_shadeLo: p.shadeLo,
145 u_shadeHi: p.shadeHi,
146 u_bodyLo: p.bodyLo,
147 u_bodyHi: p.bodyHi,
148 u_litLo: p.litLo,
149 u_litHi: p.litHi,
150 u_litMix: p.litMix,
151 u_edgeDark: p.edgeDark,
152 u_lightDirX: p.lightDirX,
153 u_lightDirY: p.lightDirY,
154 u_lightDirZ: p.lightDirZ,
155 u_normalEps: p.normalEps,
156 ...extras
157 };
158}
159
160/** Uniform bag for the water ground fragment shader. */
161export function waterDebugUniforms ()
162{
163 const p = waterParams;
164 return uniformBagFrom(p, {
165 u_foamStrength: p.foamStrength,
166 u_shoreClip: p.shoreClip,
167 u_deepDark: p.deepDark,
168 u_deepAbrupt: p.deepAbrupt
169 });
170}
171
172/** Uniform bag for lava ground / bloom shaders. */
173export function lavaDebugUniforms ()
174{
175 const p = lavaParams;
176 return uniformBagFrom(p, {
177 u_bloomStrength: p.bloomStrength
178 });
179}
180
181export function setWaterDebugParams (next)
182{
183 waterParams = { ...DEFAULT_WATER_DEBUG, ...waterParams, ...next };
184 syncInputs();
185}
186
187export function setLavaDebugParams (next)
188{
189 lavaParams = { ...DEFAULT_LAVA_DEBUG, ...lavaParams, ...next };
190 syncInputs();
191}
192
193function activeParams ()
194{
195 return activeTab === "lava" ? lavaParams : waterParams;
196}
197
198function activeSliders ()
199{
200 return activeTab === "lava" ? LAVA_SLIDERS : WATER_SLIDERS;
201}
202
203function syncInputs ()
204{
205 if (!panelEl)
206 { return; }
207 for (const { key } of activeSliders())
208 {
209 const input = panelEl.querySelector(`input[data-fluid-key="${key}"]`);
210 const valueEl = panelEl.querySelector(`[data-fluid-value="${key}"]`);
211 const params = activeParams();
212 if (input)
213 { input.value = String(params[key]); }
214 if (valueEl)
215 { valueEl.textContent = Number(params[key]).toFixed(3); }
216 }
217 for (const btn of panelEl.querySelectorAll("[data-fluid-tab]"))
218 {
219 const on = btn.getAttribute("data-fluid-tab") === activeTab;
220 btn.style.opacity = on ? "1" : "0.55";
221 btn.style.borderBottom = on ? "2px solid #9ec5ff" : "2px solid transparent";
222 }
223}
224
225function exportJson ()
226{
227 const isLava = activeTab === "lava";
228 const text = JSON.stringify(isLava ? getLavaDebugParams() : getWaterDebugParams(), null, 2);
229 void navigator.clipboard?.writeText(text).catch(() => { });
230 const blob = new Blob([text], { type: "application/json" });
231 const url = URL.createObjectURL(blob);
232 const a = document.createElement("a");
233 a.href = url;
234 a.download = isLava ? "lava-debug.json" : "water-debug.json";
235 a.click();
236 URL.revokeObjectURL(url);
237 const status = panelEl?.querySelector("[data-fluid-export-status]");
238 if (status)
239 {
240 status.textContent = "Exported";
241 setTimeout(() =>
242 {
243 if (status.textContent === "Exported")
244 { status.textContent = ""; }
245 }, 2000);
246 }
247}
248
249function rebuildSliderRows ()
250{
251 const scroll = panelEl?.querySelector(".fluid-debug-scroll");
252 if (!scroll)
253 { return; }
254 scroll.replaceChildren();
255 const params = activeParams();
256 for (const spec of activeSliders())
257 {
258 const row = document.createElement("label");
259 row.style.cssText = "display:grid;grid-template-columns:1fr 48px;gap:2px 6px;align-items:center;";
260 row.innerHTML = `
261 <span style="grid-column:1/-1;opacity:0.85">${spec.label}</span>
262 <input type="range" data-fluid-key="${spec.key}" min="${spec.min}" max="${spec.max}" step="${spec.step}" value="${params[spec.key]}">
263 <span data-fluid-value="${spec.key}" style="text-align:right;opacity:0.9">${Number(params[spec.key]).toFixed(3)}</span>
264 `;
265 const input = row.querySelector("input");
266 input.addEventListener("input", () =>
267 {
268 const bag = activeTab === "lava" ? lavaParams : waterParams;
269 bag[spec.key] = Number(input.value);
270 const valueEl = row.querySelector(`[data-fluid-value="${spec.key}"]`);
271 if (valueEl)
272 { valueEl.textContent = Number(bag[spec.key]).toFixed(3); }
273 });
274 scroll.appendChild(row);
275 }
276}
277
278function setTab (tab)
279{
280 activeTab = tab === "lava" ? "lava" : "water";
281 rebuildSliderRows();
282 syncInputs();
283}
284
285/**
286 * Always-visible temporary debug dock (pointer-events on panel only).
287 */
288export function initWaterDebugPanel ()
289{
290 if (panelEl)
291 { return panelEl; }
292
293 panelEl = document.createElement("aside");
294 panelEl.id = "fluid-debug-panel";
295 panelEl.innerHTML = `
296 <header style="display:flex;align-items:center;gap:8px;flex-wrap:wrap;">
297 <nav style="display:flex;gap:6px;">
298 <button type="button" data-fluid-tab="water">Water</button>
299 <button type="button" data-fluid-tab="lava">Lava</button>
300 </nav>
301 <span data-fluid-export-status style="margin-left:auto;opacity:0.75"></span>
302 </header>
303 <div class="fluid-debug-scroll"></div>
304 <footer style="display:flex;gap:6px;">
305 <button type="button" data-fluid-reset>Reset</button>
306 <button type="button" data-fluid-export>Export</button>
307 </footer>
308 `;
309 Object.assign(panelEl.style, {
310 position: "fixed",
311 top: "8px",
312 right: "8px",
313 width: "250px",
314 maxHeight: "calc(100vh - 16px)",
315 zIndex: "9999",
316 display: "flex",
317 flexDirection: "column",
318 gap: "4px",
319 padding: "8px",
320 background: "rgba(12, 16, 22, 0.92)",
321 color: "#e8eef5",
322 font: "11px/1.25 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
323 border: "1px solid rgba(255,255,255,0.18)",
324 borderRadius: "6px",
325 boxShadow: "0 8px 24px rgba(0,0,0,0.45)",
326 pointerEvents: "auto"
327 });
328
329 const scroll = panelEl.querySelector(".fluid-debug-scroll");
330 Object.assign(scroll.style, {
331 overflowY: "auto",
332 flex: "1 1 auto",
333 display: "flex",
334 flexDirection: "column",
335 gap: "3px",
336 paddingRight: "2px"
337 });
338
339 for (const btn of panelEl.querySelectorAll("button"))
340 {
341 Object.assign(btn.style, {
342 background: "transparent",
343 color: "inherit",
344 border: "1px solid rgba(255,255,255,0.22)",
345 borderRadius: "4px",
346 padding: "3px 8px",
347 cursor: "pointer",
348 font: "inherit"
349 });
350 }
351 for (const btn of panelEl.querySelectorAll("[data-fluid-tab]"))
352 {
353 btn.style.border = "none";
354 btn.style.borderRadius = "0";
355 btn.style.padding = "2px 4px";
356 btn.addEventListener("click", (event) =>
357 {
358 event.preventDefault();
359 event.stopPropagation();
360 setTab(btn.getAttribute("data-fluid-tab"));
361 });
362 }
363
364 panelEl.querySelector("[data-fluid-reset]").addEventListener("click", (event) =>
365 {
366 event.preventDefault();
367 event.stopPropagation();
368 if (activeTab === "lava")
369 { lavaParams = { ...DEFAULT_LAVA_DEBUG }; }
370 else
371 { waterParams = { ...DEFAULT_WATER_DEBUG }; }
372 rebuildSliderRows();
373 syncInputs();
374 });
375 panelEl.querySelector("[data-fluid-export]").addEventListener("click", (event) =>
376 {
377 event.preventDefault();
378 event.stopPropagation();
379 exportJson();
380 });
381
382 for (const type of ["mousedown", "mouseup", "click", "wheel", "contextmenu", "pointerdown"])
383 {
384 panelEl.addEventListener(type, (event) =>
385 {
386 event.stopPropagation();
387 });
388 }
389
390 rebuildSliderRows();
391 syncInputs();
392 document.body.appendChild(panelEl);
393 return panelEl;
394}