sp-bake-export

SP 烘焙与导出

Substance Painter 贴图烘焙（Baking）和纹理导出（Export）工作流。

⚠️ 仅适用于 Substance Painter — 通过 run_python 执行

---

贴图烘焙

烘焙所有纹理集的所有贴图

import substance_painter.project
import substance_painter.baking

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    # 异步烘焙所有已选中的纹理集贴图
    # 返回一个可调用的 stop 函数，用于中止烘焙
    substance_painter.baking.bake_selected_textures_async()
    print("✅ 已启动所有纹理集烘焙（异步）")

烘焙指定纹理集

import substance_painter.project
import substance_painter.textureset
import substance_painter.baking

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    # 获取指定纹理集
    ts = substance_painter.textureset.all_texture_sets()[0]

    # 异步烘焙该纹理集
    substance_painter.baking.bake_async(ts)
    print(f"✅ 纹理集 '{ts.name()}' 已启动烘焙（异步）")

烘焙贴图类型

SP 支持烘焙的常见贴图类型：

贴图类型	说明
Normal	法线贴图（从高模到低模）
AO (Ambient Occlusion)	环境光遮蔽
Curvature	曲率贴图
World Space Normal	世界空间法线
Position	位置贴图
Thickness	厚度贴图
ID	材质 ID 贴图

配置烘焙参数

import substance_painter.project
import substance_painter.textureset
import substance_painter.baking

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    # 通过 BakingParameters.from_texture_set() 获取烘焙参数
    ts = substance_painter.textureset.all_texture_sets()[0]
    params = substance_painter.baking.BakingParameters.from_texture_set(ts)
    print(f"当前烘焙参数: {params}")

    # 修改烘焙参数 — 使用 BakingParameters 对象的方法
    # 具体可用方法取决于 SP 版本

---

纹理导出

列出导出预设

import substance_painter.project
import substance_painter.export

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    # 列出所有用户自定义的资源导出预设
    resource_presets = substance_painter.export.list_resource_export_presets()
    print("用户资源导出预设:")
    for preset in resource_presets:
        print(f"  {preset}")

    # 列出所有预定义的导出预设（如 UE4、Unity 等内置预设）
    predefined_presets = substance_painter.export.list_predefined_export_presets()
    print("预定义导出预设:")
    for preset in predefined_presets:
        print(f"  {preset}")