BlueGit

timfa questward

Files

questward / client / src / play / characterPreview.js

characterPreview.js

characterPreview.js 5.2 KiB Download Raw
1import { applyMagentaTintToImageData } 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 for (let index = 0; index < overlays.length; index++)
90 {
91 const sprite = overlays[index]?.renderer?.sprite;
92 if (!sprite)
93 { continue; }
94 draws.push({
95 entry: sprite,
96 tint: tints[index] ?? null,
97 frame: overlays[index].renderer.subImage | 0
98 });
99 }
100 return paintDrawListSnapshot(canvas, draws, { size });
101}
102
103function paintDrawListSnapshot (canvas, draws, { size = 64 } = {})
104{
105 if (!canvas || !draws?.length)
106 { return false; }
107 canvas.width = size;
108 canvas.height = size;
109 const ctx = canvas.getContext("2d");
110 ctx.imageSmoothingEnabled = false;
111 ctx.clearRect(0, 0, size, size);
112 let drew = false;
113 for (const draw of draws)
114 {
115 const entry = draw.entry;
116 const html = entry?.g_image ?? entry;
117 if (!html || !(html.naturalWidth || html.width))
118 { continue; }
119 let sx = 0;
120 let sy = 0;
121 let sw = html.naturalWidth || html.width;
122 let sh = html.naturalHeight || html.height;
123 if (typeof entry?.getSubImage === "function")
124 {
125 const sub = entry.getSubImage(draw.frame | 0);
126 sx = sub.sx;
127 sy = sub.sy;
128 sw = sub.sw;
129 sh = sub.sh;
130 }
131 // Top-aligned square crop of the frame (e.g. 16×16 from 16×24).
132 const crop = Math.min(sw, sh);
133 const cropSx = sx + Math.floor((sw - crop) / 2);
134 const cropSy = sy;
135 const source = draw.tint
136 ? tintedSubCanvas(html, cropSx, cropSy, crop, crop, draw.tint)
137 : null;
138 if (source)
139 { ctx.drawImage(source, 0, 0, size, size); }
140 else
141 { ctx.drawImage(html, cropSx, cropSy, crop, crop, 0, 0, size, size); }
142 drew = true;
143 }
144 return drew;
145}
146
147function loadHtmlImage (url)
148{
149 return new Promise((resolve, reject) =>
150 {
151 const img = new Image();
152 img.onload = () => resolve(img);
153 img.onerror = () => reject(new Error(`Failed to load ${url}`));
154 img.src = url;
155 });
156}
157
158function tintedCanvas (sourceImg, tintRgb)
159{
160 const canvas = document.createElement("canvas");
161 canvas.width = sourceImg.naturalWidth || sourceImg.width;
162 canvas.height = sourceImg.naturalHeight || sourceImg.height;
163 const ctx = canvas.getContext("2d");
164 ctx.imageSmoothingEnabled = false;
165 ctx.drawImage(sourceImg, 0, 0);
166 const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
167 applyMagentaTintToImageData(imageData, tintRgb);
168 ctx.putImageData(imageData, 0, 0);
169 return canvas;
170}
171
172function tintedSubCanvas (sourceImg, sx, sy, sw, sh, tintRgb)
173{
174 const canvas = document.createElement("canvas");
175 canvas.width = sw;
176 canvas.height = sh;
177 const ctx = canvas.getContext("2d");
178 ctx.imageSmoothingEnabled = false;
179 ctx.drawImage(sourceImg, sx, sy, sw, sh, 0, 0, sw, sh);
180 const imageData = ctx.getImageData(0, 0, sw, sh);
181 applyMagentaTintToImageData(imageData, tintRgb);
182 ctx.putImageData(imageData, 0, 0);
183 return canvas;
184}