BlueGit

timfa questward

Files

questward / client / src / play / characterPreview.js

characterPreview.js

lots of things
timfa Tim Falken · pushed by timfa · 2 months ago
07a95f71 History
characterPreview.js 5.9 KiB Download Raw
1import { applyMagentaTintToImageData, applyDualChannelTintToImageData } from "/shared/render/tint.js";
2import { layersForHairPreview } from "/shared/appearance/hair.js";
3
4/**
5 * Draw stacked character layers (body + hair + optional gear) onto a canvas.
6 * Magenta hair/gear tints applied in 2D for UI previews.
7 */
8export async function paintCharacterPreview (canvas, {
9 sex,
10 bag = null,
11 hair = null,
12 hideHeadgear = true,
13 resolveSpriteUrl,
14 scale = 4
15} = {})
16{
17 if (!canvas)
18 { return; }
19 const layers = layersForHairPreview(sex, bag, hair, { hideHeadgear });
20 const images = [];
21 for (const layer of layers)
22 {
23 const url = resolveSpriteUrl?.(layer.sprite);
24 if (!url)
25 { continue; }
26 const img = await loadHtmlImage(url);
27 images.push({ img, tint: layer.tint ?? null });
28 }
29 if (!images.length)
30 { return; }
31 const w = images[0].img.naturalWidth || images[0].img.width;
32 const h = images[0].img.naturalHeight || images[0].img.height;
33 canvas.width = w * scale;
34 canvas.height = h * scale;
35 const ctx = canvas.getContext("2d");
36 ctx.imageSmoothingEnabled = false;
37 ctx.clearRect(0, 0, canvas.width, canvas.height);
38 for (const entry of images)
39 {
40 const source = entry.tint ? tintedCanvas(entry.img, entry.tint) : entry.img;
41 ctx.drawImage(source, 0, 0, canvas.width, canvas.height);
42 }
43}
44
45/**
46 * Sync composite of live `appearanceLayers` onto a fixed-size canvas.
47 * Crops a top-aligned square from each frame (e.g. 16×16 from a 16×24 body)
48 * then scales that crop up to `size` (e.g. 64) without squishing the tall frame.
49 * `resolveImage(name)` should return a Framework `image` (with `g_image` /
50 * `getSubImage`) or a plain HTMLImageElement / canvas already in memory.
51 */
52export function paintAppearanceSnapshot (canvas, layers, {
53 resolveImage,
54 size = 64,
55 frame = 0
56} = {})
57{
58 if (!canvas)
59 { return false; }
60 const draws = [];
61 for (const layer of layers ?? [])
62 {
63 const name = layer?.sprite;
64 if (!name)
65 { continue; }
66 const entry = resolveImage?.(name);
67 if (!entry)
68 { continue; }
69 draws.push({ entry, tint: layer.tint ?? null, frame });
70 }
71 return paintDrawListSnapshot(canvas, draws, { size });
72}
73
74/**
75 * Composite the live world render stack (body GameObject + overlays + tints).
76 * Matches what the player sees in-world, including hair overlays.
77 */
78export function paintLiveEntitySnapshot (canvas, entity, { size = 64 } = {})
79{
80 if (!canvas || !entity?.object?.renderer?.sprite)
81 { return false; }
82 const draws = [{
83 entry: entity.object.renderer.sprite,
84 tint: null,
85 frame: entity.object.renderer.subImage | 0
86 }];
87 const overlays = entity.overlays ?? [];
88 const tints = entity.overlayTints ?? [];
89 const dualTints = entity.overlayDualTints ?? [];
90 for (let index = 0; index < overlays.length; index++)
91 {
92 const sprite = overlays[index]?.renderer?.sprite;
93 if (!sprite)
94 { continue; }
95 draws.push({
96 entry: sprite,
97 tint: tints[index] ?? null,
98 dualTint: dualTints[index] ?? null,
99 frame: overlays[index].renderer.subImage | 0
100 });
101 }
102 return paintDrawListSnapshot(canvas, draws, { size });
103}
104
105function paintDrawListSnapshot (canvas, draws, { size = 64 } = {})
106{
107 if (!canvas || !draws?.length)
108 { return false; }
109 canvas.width = size;
110 canvas.height = size;
111 const ctx = canvas.getContext("2d");
112 ctx.imageSmoothingEnabled = false;
113 ctx.clearRect(0, 0, size, size);
114 let drew = false;
115 for (const draw of draws)
116 {
117 const entry = draw.entry;
118 const html = entry?.g_image ?? entry;
119 if (!html || !(html.naturalWidth || html.width))
120 { continue; }
121 let sx = 0;
122 let sy = 0;
123 let sw = html.naturalWidth || html.width;
124 let sh = html.naturalHeight || html.height;
125 if (typeof entry?.getSubImage === "function")
126 {
127 const sub = entry.getSubImage(draw.frame | 0);
128 sx = sub.sx;
129 sy = sub.sy;
130 sw = sub.sw;
131 sh = sub.sh;
132 }
133 // Top-aligned square crop of the frame (e.g. 16×16 from 16×24).
134 const crop = Math.min(sw, sh);
135 const cropSx = sx + Math.floor((sw - crop) / 2);
136 const cropSy = sy;
137 let source = null;
138 if (draw.dualTint)
139 { source = dualTintedSubCanvas(html, cropSx, cropSy, crop, crop, draw.dualTint); }
140 else if (draw.tint)
141 { source = tintedSubCanvas(html, cropSx, cropSy, crop, crop, draw.tint); }
142 if (source)
143 { ctx.drawImage(source, 0, 0, size, size); }
144 else
145 { ctx.drawImage(html, cropSx, cropSy, crop, crop, 0, 0, size, size); }
146 drew = true;
147 }
148 return drew;
149}
150
151function loadHtmlImage (url)
152{
153 return new Promise((resolve, reject) =>
154 {
155 const img = new Image();
156 img.onload = () => resolve(img);
157 img.onerror = () => reject(new Error(`Failed to load ${url}`));
158 img.src = url;
159 });
160}
161
162function tintedCanvas (sourceImg, tintRgb)
163{
164 const canvas = document.createElement("canvas");
165 canvas.width = sourceImg.naturalWidth || sourceImg.width;
166 canvas.height = sourceImg.naturalHeight || sourceImg.height;
167 const ctx = canvas.getContext("2d");
168 ctx.imageSmoothingEnabled = false;
169 ctx.drawImage(sourceImg, 0, 0);
170 const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
171 applyMagentaTintToImageData(imageData, tintRgb);
172 ctx.putImageData(imageData, 0, 0);
173 return canvas;
174}
175
176function tintedSubCanvas (sourceImg, sx, sy, sw, sh, tintRgb)
177{
178 const canvas = document.createElement("canvas");
179 canvas.width = sw;
180 canvas.height = sh;
181 const ctx = canvas.getContext("2d");
182 ctx.imageSmoothingEnabled = false;
183 ctx.drawImage(sourceImg, sx, sy, sw, sh, 0, 0, sw, sh);
184 const imageData = ctx.getImageData(0, 0, sw, sh);
185 applyMagentaTintToImageData(imageData, tintRgb);
186 ctx.putImageData(imageData, 0, 0);
187 return canvas;
188}
189
190function dualTintedSubCanvas (sourceImg, sx, sy, sw, sh, dualTint)
191{
192 const canvas = document.createElement("canvas");
193 canvas.width = sw;
194 canvas.height = sh;
195 const ctx = canvas.getContext("2d");
196 ctx.imageSmoothingEnabled = false;
197 ctx.drawImage(sourceImg, sx, sy, sw, sh, 0, 0, sw, sh);
198 const imageData = ctx.getImageData(0, 0, sw, sh);
199 applyDualChannelTintToImageData(imageData, dualTint);
200 ctx.putImageData(imageData, 0, 0);
201 return canvas;
202}