sd-context

SD 编辑器上下文查询

查询 Substance Designer 当前状态：包、图、节点、参数、连接关系。 所有操作为只读，不修改任何内容。

---

前置条件

run_python 已预注入以下变量，直接使用，无需 import：

• sd, app, graph, S, W, L
• SDPropertyCategory, float2, float3, float4, ColorRGBA
• SDValueFloat, SDValueInt, SDValueBool, SDValueString

# ✅ 直接使用预注入变量
pkg_mgr = app.getPackageMgr()
ui_mgr = app.getUIMgr()

# ❌ 禁止在 exec 中 import sd.api 子模块（会超时死锁）
# from sd.api.sdapplication import SDApplication  # 禁止！
# from sd.api.sdproperty import SDPropertyCategory  # 禁止！

---

1. 获取用户包列表

列出当前加载的所有用户包（排除系统/库包）：

pkg_mgr = app.getPackageMgr()

user_packages = pkg_mgr.getUserPackages()
result = []
for pkg in user_packages:
    file_path = pkg.getFilePath()
    pkg_id = pkg.getIdentifier() if hasattr(pkg, 'getIdentifier') else "N/A"
    resources = pkg.getChildrenResources(False)
    graph_count = len(resources) if resources else 0
    result.append({
        "identifier": pkg_id,
        "file_path": file_path,
        "graph_count": graph_count
    })
    print(f"包: {pkg_id} | 路径: {file_path} | 图数量: {graph_count}")

if not result:
    print("没有加载的用户包")

---

2. 获取包内图列表

列出指定包的所有子图（Substance Graph）：

pkg_mgr = app.getPackageMgr()

# 获取第一个用户包
user_packages = pkg_mgr.getUserPackages()
if not user_packages:
    print("没有加载的用户包")
else:
    pkg = user_packages[0]
    resources = pkg.getChildrenResources(False)
    for res in resources:
        res_id = res.getIdentifier()
        res_type = type(res).__name__
        print(f"资源: {res_id} | 类型: {res_type}")

---

3. 获取当前图信息

if graph is None:
    print("没有打开的图")
else:
    graph_id = graph.getIdentifier()
    nodes = graph.getNodes()
    node_count = nodes.getSize() if nodes else 0
    
    # 获取图的输出定义
    outputs = graph.getProperties(SDPropertyCategory.Output)
    output_count = len(outputs) if outputs else 0
    
    print(f"当前图: {graph_id}")
    print(f"节点数量: {node_count}")
    print(f"输出数量: {output_count}")