sp-layer-ops

SP 层操作

Substance Painter 层管理：创建、删除、移动、复制层，设置混合模式和透明度，管理遮罩。

⚠️ 仅适用于 Substance Painter — 通过 run_python 执行 ⚠️ SP 无 Undo API — 破坏性操作前建议先保存项目（参见 sp-operation-rules）

---

前置：获取目标纹理集的层栈

所有层操作都需要先指定目标纹理集（Texture Set）和层栈（Stack）。

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

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    # 获取第一个纹理集（或按名称查找）
    ts = substance_painter.textureset.all_texture_sets()[0]
    stack = substance_painter.textureset.Stack.from_name(ts.name())
    print(f"目标纹理集: {ts.name()}")

---

添加层

添加 Fill Layer（填充层）

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

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    ts = substance_painter.textureset.all_texture_sets()[0]
    stack = substance_painter.textureset.Stack.from_name(ts.name())

    # 在层栈顶部插入一个填充层（只需 InsertPosition，不需要 stack 参数）
    root = substance_painter.layerstack.get_root_layer_nodes(stack)
    pos = substance_painter.layerstack.InsertPosition.above_node(root[-1]) if root else substance_painter.layerstack.InsertPosition.from_textureset_stack(stack)
    new_layer = substance_painter.layerstack.insert_fill(pos)
    new_layer.set_name("MyFillLayer")
    print(f"✅ 已添加填充层: {new_layer.get_name()}")

添加 Paint Layer（绘画层）

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

if not substance_painter.project.is_open():
    print("❌ 没有打开的项目")
else:
    ts = substance_painter.textureset.all_texture_sets()[0]
    stack = substance_painter.textureset.Stack.from_name(ts.name())

    root = substance_painter.layerstack.get_root_layer_nodes(stack)
    pos = substance_painter.layerstack.InsertPosition.above_node(root[-1]) if root else substance_painter.layerstack.InsertPosition.from_textureset_stack(stack)
    new_layer = substance_painter.layerstack.insert_paint(pos)
    new_layer.set_name("MyPaintLayer")
    print(f"✅ 已添加绘画层: {new_layer.get_name()}")