DeepBump ONNX 法线贴图生成模型
本仓库提供 deepbump_normal.onnx,用于从材质纹理图像预测切线空间法线贴图,让平面材质在光照下呈现凹凸细节。适合石材、砖墙、木纹、织物等纹理的辅助制作,可接入 Blender、游戏材质和其他 PBR 贴图工作流。
该模型面向材质表面细节推断,不应作为人物、产品或完整场景的精确三维几何重建工具。输出是法线通道,不是深度图,也不是三维网格。
仓库文件
| 文件 | 说明 |
|---|---|
deepbump_normal.onnx |
ONNX 模型,26,706,979 字节,约 26.71 MB |
LICENSE |
随原模型附带的 GNU GPL v3 许可证文本 |
输入与输出
以下接入约定来自随模型提供的本地说明:
- 输入:256 × 256 的单通道亮度图,NCHW 排列,数值范围
[0,1]。 - 输出:三个法线通道,编码范围
[0,1]。 - 对大图使用重叠分块推理,在拼接时进行混合及法线向量归一化,再编码为 PNG。
- 模型默认采用 DirectX 法线方向约定。转换到 OpenGL 时翻转绿色通道;对
[0,1]编码可使用G_new = 1 - G。
可在兼容的 ONNX Runtime 环境中运行;本地应用通过 ONNX Runtime Web 集成。输入输出节点名称与数据类型请以模型元数据为准。图片读取、亮度转换、分块、拼接和 PNG 导出由调用程序完成。
使用建议与限制
优先使用清晰、光照均匀的材质纹理。明显的阴影、高光、透视和颜色花纹可能影响凹凸预测。生成结果是对表面细节的估计,不能保证对应真实几何;建议在目标渲染器中检查法线方向、强度及接缝。本次上传未重新执行推理质量评测。
来源与许可
本仓库为用户提供文件的镜像存档,未修改模型权重。来源信息根据随附 README 记录:
- 模型来源:Wszelkiebro/reliquary-deepbump-normal
- 来源修订:
cbf0e32e7d72a0025d682b361156098a026f361b - 上游项目:HugoTini/DeepBump
- 上游作者:Hugo Tini
- 许可:GPL-3.0,沿用随附说明中的上游许可;完整文本见
LICENSE。
本仓库不代表上游作者官方发布。使用和再分发请遵守上游许可证。
文件校验
SHA256:
3a2ababc5fa652b19040a0f3d639b71826368e52ad805cf70ffb0e7c96a54d67