SuperAPI AI 工具集

designer-session

设计与创作

查看项目

更新于 10-15 20:35

技能介绍

用途:在修改 Substance 3D Designer 会话与图之前先读取当前状态,并以受限方式编写图、管理包和导出产物。

主要能力:公开工具仅创建内置的 sbs:: 节点类型,按显式节点与属性标识寻址,只接受白名单内的标量与向量值类型;不提供 eval、脚本、shell 或通用动作接口。支持创建图、创建节点、连接节点、设置或暴露参数、添加输出与设置输出用途、另存包,以及导出图状态。包工具使用 Designer 的包管理器;位图与 SVG 导入会校验声明的资源类型,默认使用链接资源,除非显式指定 embed=true。export_sbsar 使用官方 SBSAR 导出器并验证产物存在;export_maps 仅调用宿主环境发现的官方 sbsrender 可执行文件,且必须显式指定格式、位深与色彩空间,该可执行文件不可用时失败关闭。参数暴露受能力门控,若当前 Designer 构建不提供受支持的绑定 API,会返回 EXPOSE_API_UNAVAILABLE,而不会创建未绑定属性。宿主 API 调用通过适配器的 Core 执行桥保持在 Designer 主线程。

使用方式:典型序列为 create_graph → create_node → connect_nodes → set_parameter/expose_parameter → add_output/set_output_usage → save_package_as → export_graph_state;每次编写序列后可用 export_graph_state 验证节点数量、类型 URL、位置、参数、拓扑与输出用途。

适用场景:需要逐步控制并验证图拓扑或包生命周期的任务;常见材质配方也可使用更高层的程序化与导入 PBR 工具。

限制:仅限内置节点类型与白名单值类型,无通用脚本接口;参数暴露依赖运行构建的 API 支持;导出地图依赖官方 sbsrender 且需显式格式、位深与色彩空间。其他收费、平台与效果信息暂未提供。