wrong-nebula/hypbr
多媒体与设计用程序合成无缝、物理校准的 PBR 材质套装,并导出到主流游戏引擎与 3D 工具。
项目介绍
hypbr 是一个 Python 包,用于合成可无缝平铺的 PBR 材质套装,输出 15 张贴图(含 albedo、切线空间法线、ORM、16 位高度、曲率、空腔、弯曲法线、次表面厚度等),在任意分辨率下都不会出现接缝。它内置一套程序化材质目录:69 个精调旗舰生成器加 431 个参数化材质,覆盖砌体、木材、石材、瓷砖、金属、织物、地形、玻璃、橡胶和屋面/科技等类别;还可用 CC0 摄影测量扫描做参考校准。
合成核心采用循环填充的 FFT 与 FBM/Voronoi 微结构生成器,再送入一个 47 节点的可组合 PBR 图,支持解析倒角、RNM 混合和 8 方位 HBAO。材质可用 HeightLerp 或空腔模式混合、按预设做风化,并直接导出到 Unity、Unity HDRP、Godot、Unreal、Blender、Three.js、glTF/GLB、Vulkan、MaterialX 和 USD。本地有 Three.js 预览,线上提供覆盖 500 种材质的交互式浏览器工作室。目标用户是技术美术和图形开发者,需要免去手工找贴图即可得到引擎就绪的 PBR 套装。
安装与生成第一张材质
需要 Python 和 pip;核心安装只依赖 numpy 和 pillow,500 种材质、混合、风化、导出和校验都跑在纯 NumPy 上。PyTorch 是可选项(.[gpu] 提供 CUDA/MPS 内核,.[neural] 用于照片转 PBR)。
git clone https://github.com/wrong-nebula/hypbr.git
cd hypbr
pip install -e .
以 1024×1024 合成一张材质并查看结果:
hypbr list
hypbr synth patinated_verdigris_bronze --size 1024 --wear 0.35 --out ./output/pbr
hypbr preview ./output/pbr/patinated_verdigris_bronze
输出目录会包含 15 张 PNG 贴图。hypbr preview 启动本地交互工作室,可切换通道、平铺 UV、调整置换。若要一次导出到多个引擎:
hypbr synth patinated_verdigris_bronze --size 1024 --export unity,godot,unreal,blender,threejs,vulkan --out ./output/pbr
线上材质图集可直接打开 Three.js 工作室,或通过 Agent Atlas 端点获取机器可读的索引与规格卡,例如 llms.txt、atlas.json 和集成指南。
参考照片校准可用 hypbr atlas calibrate --refs <scan dirs> --baked <uncalibrated bake> 重新运行;README 没有说明参考扫描目录的具体布局,执行这一步需要额外查看拟合器实现。
使用约束
- 纯程序化路径采用 MIT 许可证;可选的
hypbr photo模式若使用 Apple Depth Pro 检查点,外部权重受 Apple 研究许可证约束,详见许可证。 - 性能数据为:512×512 每材质约 1 秒,2048×2048 在 CPU 上约 11–13 秒(Apple Silicon,4 线程)。分辨率越高耗时越长;高斯模糊走 FFT,因此模糊半径不影响开销。
- 材质是合成并经过参考校准的;除
hypbr.verify检查(接缝、法线有效性、ORM 打包、PBR 取值范围)外,README 未声称有超出校验范围的物理精度。 - 500 种材质的图集以 512px WebP 在线提供并启用 CORS;自定义分辨率和完整 15 张贴图需要 Python 合成器。
- torch 内核据称与 NumPy 路径输出逐位一致;
HYPBR_TORCH=0可强制使用 NumPy 回退。
HotRepo 点评
这是一个较新的仓库,已有初步热度信号:2026-11-22 出现在 Python 新项目榜,在较短窗口内新增 5 个 Star,总量 105,Fork 6 个;尚未记录到全语言日榜名次或讨论帖。技术上值得关注的是把精确周期性合成(声称零接缝)和供 Agent 读取的材质图集结合起来:规格卡给出真实世界平铺尺寸、适用物体、着色器接线和风化预设,这比单纯提供贴图包更适合编码 Agent 使用。采样窗口太短,Star 曲线尚不足以判断趋势,目前只是围绕程序化 PBR 制作这一细分方向获得的早期关注。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- storytold/materialcraft用纯 Rust 编写的节点式程序化 PBR 材质设计器,支持桌面端与浏览器。
- alla2001/material-painter一款面向游戏与影视资产的免费 PBR 纹理绘制工具,支持图层绘制、网格贴图烘焙和节点式材质设计,使用 Rust 与 wgpu 构建。
- dmitrykurash/holospot把物理计算的全息烫金、闪粉和立体全息材质接入 three.js 场景,并专为交给 AI Agent 配置而设计。
- AIRzZ90/study-materials-fork基于 Tauri 2 的跨平台音视频浏览与播放应用,使用 React 界面和 hls.js 播放。
- guzhezao/needle可交互的 3D 黑胶唱机展示,通过拖拽、换盘和变速探索四个章节,声音可选。