import { applyMagentaTintToImageData, applyDualChannelTintToImageData } from "/shared/render/tint.js"; import { layersForHairPreview } from "/shared/appearance/hair.js"; import { PIVOT_FROM_BOTTOM_PX } from "/shared/protocol/constants.js"; /** * Draw stacked character layers (body + hair + optional gear) onto a canvas. * Magenta hair/gear tints applied in 2D for UI previews. * Layers may differ in size (e.g. body 16×24, shirt equip 20×24); they share * the world pivot (horizontal centre, `PIVOT_FROM_BOTTOM_PX` from the bottom). */ export async function paintCharacterPreview (canvas, { sex, bag = null, hair = null, hideHeadgear = true, resolveSpriteUrl, scale = 4 } = {}) { if (!canvas) { return; } const layers = layersForHairPreview(sex, bag, hair, { hideHeadgear }); const images = []; for (const layer of layers) { const url = resolveSpriteUrl?.(layer.sprite); if (!url) { continue; } const img = await loadHtmlImage(url); images.push({ img, tint: layer.tint ?? null, dualTint: layer.dualTint ?? null }); } if (!images.length) { return; } let maxW = 1; let maxH = 1; for (const entry of images) { maxW = Math.max(maxW, entry.img.naturalWidth || entry.img.width || 1); maxH = Math.max(maxH, entry.img.naturalHeight || entry.img.height || 1); } canvas.width = maxW * scale; canvas.height = maxH * scale; const ctx = canvas.getContext("2d"); ctx.imageSmoothingEnabled = false; ctx.clearRect(0, 0, canvas.width, canvas.height); const pivotX = maxW * 0.5; const pivotY = maxH - PIVOT_FROM_BOTTOM_PX; for (const entry of images) { const source = entry.dualTint ? dualTintedCanvas(entry.img, entry.dualTint) : (entry.tint ? tintedCanvas(entry.img, entry.tint) : entry.img); const sw = source.naturalWidth || source.width || 1; const sh = source.naturalHeight || source.height || 1; const ox = (pivotX - sw * 0.5) * scale; const oy = (pivotY - (sh - PIVOT_FROM_BOTTOM_PX)) * scale; ctx.drawImage(source, ox, oy, sw * scale, sh * scale); } } /** * Sync composite of live `appearanceLayers` onto a fixed-size canvas. * Crops a top-aligned square from each frame (e.g. 16×16 from a 16×24 body) * then scales that crop up to `size` (e.g. 64) without squishing the tall frame. * `resolveImage(name)` should return a Framework `image` (with `g_image` / * `getSubImage`) or a plain HTMLImageElement / canvas already in memory. */ export function paintAppearanceSnapshot (canvas, layers, { resolveImage, size = 64, frame = 0 } = {}) { if (!canvas) { return false; } const draws = []; for (const layer of layers ?? []) { const name = layer?.sprite; if (!name) { continue; } const entry = resolveImage?.(name); if (!entry) { continue; } draws.push({ entry, tint: layer.tint ?? null, dualTint: layer.dualTint ?? null, frame }); } return paintDrawListSnapshot(canvas, draws, { size }); } /** * Offline / list UI portrait from public appearance layers (hair + clothing tints). * Prefers in-memory Framework images; falls back to loading catalog URLs. * @returns {HTMLDivElement} */ export function mountLayerPreview (layers, { resolveImage = null, resolveSpriteUrl = null, size = 48, className = "char-preview" } = {}) { const wrap = document.createElement("div"); wrap.className = className; const canvas = document.createElement("canvas"); canvas.width = size; canvas.height = size; canvas.style.width = "100%"; canvas.style.height = "100%"; canvas.style.imageRendering = "pixelated"; wrap.append(canvas); const list = layers ?? []; const allInMemory = list.length > 0 && list.every((layer) => !layer?.sprite || !!resolveImage?.(layer.sprite)); const painted = allInMemory ? paintAppearanceSnapshot(canvas, list, { resolveImage, size }) : false; if (!painted && resolveSpriteUrl) { void paintLayersFromUrls(canvas, list, { resolveSpriteUrl, size }).catch(() => { /* preview is best-effort */ }); } return wrap; } /** * Load layer sprites by URL and composite with magenta tints (async fallback). */ export async function paintLayersFromUrls (canvas, layers, { resolveSpriteUrl, size = 48 } = {}) { if (!canvas) { return false; } const draws = []; for (const layer of layers ?? []) { const url = resolveSpriteUrl?.(layer?.sprite); if (!url) { continue; } try { const img = await loadHtmlImage(url); draws.push({ entry: img, tint: layer.tint ?? null, dualTint: layer.dualTint ?? null, frame: 0 }); } catch { /* skip missing art */ } } return paintDrawListSnapshot(canvas, draws, { size }); } /** * Composite the live world render stack (body GameObject + overlays + tints). * Matches what the player sees in-world, including hair overlays. */ export function paintLiveEntitySnapshot (canvas, entity, { size = 64 } = {}) { if (!canvas || !entity?.object?.renderer?.sprite) { return false; } const draws = [{ entry: entity.object.renderer.sprite, tint: null, frame: entity.object.renderer.subImage | 0 }]; const overlays = entity.overlays ?? []; const tints = entity.overlayTints ?? []; const dualTints = entity.overlayDualTints ?? []; for (let index = 0; index < overlays.length; index++) { const sprite = overlays[index]?.renderer?.sprite; if (!sprite) { continue; } draws.push({ entry: sprite, tint: tints[index] ?? null, dualTint: dualTints[index] ?? null, frame: overlays[index].renderer.subImage | 0 }); } return paintDrawListSnapshot(canvas, draws, { size }); } function paintDrawListSnapshot (canvas, draws, { size = 64 } = {}) { if (!canvas || !draws?.length) { return false; } canvas.width = size; canvas.height = size; const ctx = canvas.getContext("2d"); ctx.imageSmoothingEnabled = false; ctx.clearRect(0, 0, size, size); let drew = false; for (const draw of draws) { const entry = draw.entry; const html = entry?.g_image ?? entry; if (!html || !(html.naturalWidth || html.width)) { continue; } let sx = 0; let sy = 0; let sw = html.naturalWidth || html.width; let sh = html.naturalHeight || html.height; if (typeof entry?.getSubImage === "function") { const sub = entry.getSubImage(draw.frame | 0); sx = sub.sx; sy = sub.sy; sw = sub.sw; sh = sub.sh; } // Top-aligned square crop of the frame (e.g. 16×16 from 16×24). const crop = Math.min(sw, sh); const cropSx = sx + Math.floor((sw - crop) / 2); const cropSy = sy; let source = null; if (draw.dualTint) { source = dualTintedSubCanvas(html, cropSx, cropSy, crop, crop, draw.dualTint); } else if (draw.tint) { source = tintedSubCanvas(html, cropSx, cropSy, crop, crop, draw.tint); } if (source) { ctx.drawImage(source, 0, 0, size, size); } else { ctx.drawImage(html, cropSx, cropSy, crop, crop, 0, 0, size, size); } drew = true; } return drew; } function loadHtmlImage (url) { return new Promise((resolve, reject) => { const img = new Image(); img.onload = () => resolve(img); img.onerror = () => reject(new Error(`Failed to load ${url}`)); img.src = url; }); } function dualTintedCanvas (sourceImg, dualTint) { const canvas = document.createElement("canvas"); canvas.width = sourceImg.naturalWidth || sourceImg.width; canvas.height = sourceImg.naturalHeight || sourceImg.height; const ctx = canvas.getContext("2d"); ctx.imageSmoothingEnabled = false; ctx.drawImage(sourceImg, 0, 0); const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height); applyDualChannelTintToImageData(imageData, dualTint); ctx.putImageData(imageData, 0, 0); return canvas; } function tintedCanvas (sourceImg, tintRgb) { const canvas = document.createElement("canvas"); canvas.width = sourceImg.naturalWidth || sourceImg.width; canvas.height = sourceImg.naturalHeight || sourceImg.height; const ctx = canvas.getContext("2d"); ctx.imageSmoothingEnabled = false; ctx.drawImage(sourceImg, 0, 0); const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height); applyMagentaTintToImageData(imageData, tintRgb); ctx.putImageData(imageData, 0, 0); return canvas; } function tintedSubCanvas (sourceImg, sx, sy, sw, sh, tintRgb) { const canvas = document.createElement("canvas"); canvas.width = sw; canvas.height = sh; const ctx = canvas.getContext("2d"); ctx.imageSmoothingEnabled = false; ctx.drawImage(sourceImg, sx, sy, sw, sh, 0, 0, sw, sh); const imageData = ctx.getImageData(0, 0, sw, sh); applyMagentaTintToImageData(imageData, tintRgb); ctx.putImageData(imageData, 0, 0); return canvas; } function dualTintedSubCanvas (sourceImg, sx, sy, sw, sh, dualTint) { const canvas = document.createElement("canvas"); canvas.width = sw; canvas.height = sh; const ctx = canvas.getContext("2d"); ctx.imageSmoothingEnabled = false; ctx.drawImage(sourceImg, sx, sy, sw, sh, 0, 0, sw, sh); const imageData = ctx.getImageData(0, 0, sw, sh); applyDualChannelTintToImageData(imageData, dualTint); ctx.putImageData(imageData, 0, 0); return canvas; }