fix(thumbnail): 缩略图采样 baseColorTexture,修复 MMD 模型显示为白模
现象(用户反馈):导入 PMX 转换出的 GLB 后,列表页/审核面板里的模型是白模, 脸部颜色信息全部丢失。 定位过程(本地装真 Assimp 6.0.4 + 该模型完整复现): 1. 转换本身正常:23.7MB GLB、643 骨骼、93,350 面; 2. 18 张贴图逐字节与压缩包原图一致;用一个权威 PMX 解析器比对后确认 39 个材质 -> 贴图的对应关系与 PMX 完全一致(不是映射错); 3. UV 采样也正确:脸部材质取到的就是皮肤色 (246,221,216); 4. 真正的问题在**我们自己的缩略图渲染器**:它刻意不解码 baseColorTexture, 只用 baseColorFactor 上色(见文件头取舍说明);而 MMD 模型的 baseColorFactor 基本都是白色 -> 缩略图必然全白。管理端 3D 预览有贴图, 只有列表/审核的缩略图是白的。 修复: 1. model-thumbnail.ts 内置极简 PNG 解码器(zlib inflate + 逐行反滤波, 8 位非隔行,colorType 0/2/3/4/6),按 baseColorFactor x 贴图逐像素采样, 透视校正 UV;解码失败/非 PNG/隔行扫描回退纯色,绝不抛错; 2. 按 alphaMode 处理透明度:OPAQUE 忽略贴图 alpha(MMD 语义)、 MASK 按 alphaCutoff 丢弃、BLEND 做 source-over; 3. 取景收紧 FRAMING 1.6 -> 1.3,40px 列表缩略图主体更清楚; 4. 新增 test/model-thumbnail-texture.spec.ts 6 项(含白模回归: baseColorFactor 全白 + 红贴图必须输出偏红,以及 MASK/OPAQUE/坏图回退); 5. 版本 0.2.4,README(.md/.txt)/DSH.md 补修订说明与 FAQ(含重新生成缩略图 的 reanalyze-models.mjs --force 命令)。
This commit is contained in:
@@ -160,7 +160,7 @@ node scripts/import-default-model.mjs --write-source-only --model-id 22 --dry-ru
|
||||
|
||||
```bash
|
||||
cd web-server
|
||||
npx vitest run # 13 个文件 / 205 项通过
|
||||
npx vitest run # 14 个文件 / 211 项通过
|
||||
npm run test:smoke # 冒烟 [4] 段落
|
||||
```
|
||||
|
||||
|
||||
@@ -86,7 +86,7 @@ draft ──submit──▶ pending ──approve──▶ published
|
||||
|
||||
```bash
|
||||
cd web-server
|
||||
npx vitest run # 13 个文件 / 205 项通过(含 admin-bone-filter 8 项、.env 预检 12 项、Assimp 13 项)
|
||||
npx vitest run # 14 个文件 / 211 项通过(含 admin-bone-filter 8 项、.env 预检 12 项、Assimp 13 项、缩略图贴图 6 项)
|
||||
npm run test:smoke
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user