SuperAPI AI 工具集

blockbench-albedo-to-pbr

通用与其它

查看项目

更新于 10-15 22:41

技能介绍

用途:为 Blockbench PBR 材质从反照率贴图推导高度、切线空间法线和打包 MER(R 金属度、G 自发光、B 粗糙度)贴图。PBR 通道是推导而非手绘:反照率→高度场→法线,再由反照率、高度和法线曲率推断金属度、自发光与粗糙度并打包为一张 MER。两套脚本共用同一 CLI 与数学逻辑,按运行时选择。先加载 blockbench-use 做发现与验证,再用 blockbench-pbr-materials 分配结果;本技能只产出图像文件。

主要能力:输出 <name>_height.png(灰度,亮=高)、<name>_normal.png(RGB 不透明)、<name>_mer.png,并打印 JSON 报告。高度来源可选亮度(默认,适合像素画与平涂)、Depth Anything V2 深度(适合照片/绘画质感)或外部高度文件。支持 --wrap、--strength、--operator、--convention(directx/opengl)、--alpha-threshold、--soften、--levels、--flatten、--high-pass、--normalize、--invert-height、--seam offset、--no-height、--no-mer、--metal、--emissive、--roughness、--palette 及粗糙度/金属/自发光相关参数。

使用方式:Python 需 pip install pypbr(深度另需 transformers);Node 需 npm install vgpu pngjs(深度另需 @huggingface/transformers)。示例:python scripts/albedo_to_normal.py block.png --out ./pbr --wrap --strength 1;node scripts/albedo_to_normal.mjs planks.png --out ./pbr --height-source depth --high-pass 32 --seam offset --wrap --soften 1。随后用 create_texture、create_pbr_material、assign_texture_channel、get_material_info 导入并分配,再用 capture_screenshot 从多角度验证方向与尺度。

适用场景与限制:适合为 Blockbench 材质生成 PBR 贴图,尤其像素画、平涂与绘画质感贴图。亮度高度是艺术近似,不适合照片来源;深度估计只是合理而非实测,需用 --flatten/--high-pass/--seam 清理。MER 推断为颜色与形状启发式,浅色低饱和易误判为金属、亮饱和易误判为发光,需用统一值或调色板覆盖修正。报告只说明编码正确,不保证浮雕方向、尺度或材质分配正确。Bedrock 纹理集法线与高度图不可同时使用。具体收费、价格与平台信息暂未提供。