sp-context

SP 项目上下文查询

获取当前 Substance Painter 项目状态、纹理集信息、层栈结构、通道列表等。

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

---

项目信息

获取当前项目的基本信息：文件路径、保存状态等。

import substance_painter.project

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    file_path = substance_painter.project.file_path()
    needs_saving = substance_painter.project.needs_saving()
    print(f"项目路径: {file_path}")
    print(f"需要保存: {'是' if needs_saving else '否'}")

---

纹理集列表与分辨率

列出所有纹理集及其分辨率。

import substance_painter.project
import substance_painter.textureset

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    all_ts = substance_painter.textureset.all_texture_sets()
    print(f"纹理集总数: {len(all_ts)}")
    for ts in all_ts:
        res = ts.get_resolution()
        print(f"  {ts.name()} — 分辨率: {res.width}x{res.height}")

---

层栈遍历（递归打印层树）

递归遍历层栈，打印完整层树结构。

import substance_painter.project
import substance_painter.textureset
import substance_painter.layerstack

def print_layer_tree(nodes, indent=0):
    """递归打印层树"""
    prefix = "  " * indent
    # 获取第一个可用通道用于查询透明度
    ch = substance_painter.textureset.ChannelType.BaseColor
    for node in nodes:
        name = node.get_name()
        # get_opacity 需要传 channel_type（mask 层除外）
        try:
            opacity = node.get_opacity(ch)
        except Exception:
            opacity = node.get_opacity()  # mask 层不需要 channel
        node_type = type(node).__name__
        print(f"{prefix}├─ {name} ({node_type}, opacity={opacity:.0%})")
        # 如果是组层，递归打印子层
        if hasattr(node, 'sub_layers'):
            children = node.sub_layers()
            if children:
                print_layer_tree(children, indent + 1)

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    all_ts = substance_painter.textureset.all_texture_sets()
    for ts in all_ts:
        print(f"\n=== 纹理集: {ts.name()} ===")
        stack = substance_painter.textureset.Stack.from_name(ts.name())
        root_layers = substance_painter.layerstack.get_root_layer_nodes(stack)
        if root_layers:
            print_layer_tree(root_layers)
        else:
            print("  (空层栈)")