dsh-wtskin-project
English | 中文
战争雷霆用户涂装工作室，以 DSH 插件形式发布。把「量 UV → 逐面放角色 → 合成 → 导出 DDS + blk」这套流程变成模型可调用的工具，并内置了四点多边形取点器。本项目由大肥鱼在DSH上完成（这句是我加的）。
工具
| 工具 | 作用 |
|---|
dsh_wtskin_project | 创建 / 读取 / 更新 project.json（画布尺寸、底漆、输出设置） |
dsh_wtskin_layer | 增删改查图层：图片 + 4 点四边形 + 旋转 / 翻转 / 偏移 / 裁切线 |
dsh_wtskin_export | 合成底漆与全部图层，输出 PNG、DDS、预览图和 .blk |
dsh_wtskin_presets | 列出内置机型预设（贴图名与 blk 条目） |
dsh_wtskin_measure | 启动本地取点页（四点多边形模式）并返回 URL |
取点器
dsh_wtskin_measure 会在 127.0.0.1 上起一个只服务单页的本地服务器（随机端口），把内置的
assets/measure.html（基于 image-pixel-coords.html 扩展）发给你：
- 拖入 / 粘贴一张贴图预览
- 点「四点框选」，依次点 4 个点，自动画出四边形
- 「缩放 ×」默认取工程的
quadScale（比如 1600 预览对应 2.56）
- 保存到工程：直接把四边形写进
project.json 的指定图层（该图层带自己的 quadScale，不会被二次缩放）
- 复制：输出
[[x,y],[x,y],[x,y],[x,y]]，可以手动交给 dsh_wtskin_layer
页面只用原生 JS，不依赖网络。
快速开始
dsh_wtskin_project dir=D:/skins/q5l action=create data={"quadScale":2.56,"width":4096,"height":4096}
dsh_wtskin_measure dir=D:/skins/q5l id=wing_u scale=2.56
# 打开返回的 URL，量完点「保存到工程」
dsh_wtskin_layer dir=D:/skins/q5l action=update id=wing_u layer={"image":"p8.png","size":"chord","factor":1.3,"rotate180":true}
dsh_wtskin_export dir=D:/skins/q5l
尺寸模式
chord：按四边形前后缘中点距离缩放（最常用）quadHeight：按四边形包围盒高度height：直接给像素高度widthAdapt：窄条面板（翼根）用，按宽度适配
图层字段
{
"image": "path/to/character.png",
"quad": [[x0,y0],[x1,y1],[x2,y2],[x3,y3]],
"quadScale": 1,
"size": "chord",
"factor": 1.2,
"offset": [0, -40],
"rotate180": true,
"flip": false,
"clipLine": [[x0,y0],[x1,y1]],
"expand": 8,
"opacity": 1
}
前两个点是前缘，后两个点依次是后缘 —— 引擎用它算弦长和中点。quadScale 是该图层自己的坐标缩放，覆盖工程级设置。
安装
# 有 dsh CLI
dsh plugin --profile desktop add link:D:/path/to/dsh-wtskin-project
# 没有 CLI
node install.mjs --profile desktop
然后重启 DSH（工具在启动时注册）。卸载：删掉 profiles/<profile>/node_modules/dsh-wtskin-project 和 patch 里对应的行。
Python 环境
引擎需要 Python 3 + Pillow + numpy。DSH 自带运行时里就有：
C:\Users\<用户>\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\python\python.exe
查找顺序：调用参数 pythonPath → 插件配置 pythonPath → 环境变量 DSH_PYTHON → python。
建议在插件配置里写死一次：
- id: dsh-wtskin-project
name: dsh-wtskin-project
config:
pythonPath: C:/Users/you/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/python/python.exe
产物
out/
├── q_5l_c.png 合成结果（4096）
├── q_5l_c.dds 32 位未压缩 DDS（约 64MB）
├── preview.png 1600 预览
└── q_5l.blk 引导文件
整个 out 复制进 War Thunder/UserSkins/ 即可。
原理
- 底漆：读一张现有贴图做细节载体（铆钉、蒙皮线），按亮度映射到自定义色带，可选边缘发光与点阵。
- 图层：仿射变换（旋转 → 缩放 → 平移到四边形中心），再用四边形做 alpha 裁切，可选沿直线做半平面裁切。
- 导出：Pillow 写 32 位未压缩 DDS（BGRA），并生成 blk。
已知限制
- 不自动测量 UV：四边形要靠取点器人工量。
- DDS 未压缩：4K 约 64MB；需要 DXT5 请用 PS + NVIDIA DDS 插件另存。
- 法线贴图（
_n）不自动生成。
许可
MIT。用户素材（角色立绘等）的版权由使用者自行负责。
