houdini-node-ops

Houdini 节点操作指南

节点创建、连接、参数设置和常见 SOP 工作流模板。

⚠️ 仅适用于 Houdini — 通过 run_python 执行，使用 hou 模块

📌 前置依赖: 执行任何修改操作前，请先阅读 houdini-operation-rules Skill

---

1. 创建常用 SOP 节点

基本几何体

import hou

with hou.undos.group("ArtClaw: 创建几何体"):
    geo = hou.node("/obj").createNode("geo", "my_geo")

    # 删除默认的 file 节点（新建 geo 会自带）
    for child in geo.children():
        child.destroy()

    # 创建基本几何体
    box = geo.createNode("box", "my_box")
    sphere = geo.createNode("sphere", "my_sphere")
    tube = geo.createNode("tube", "my_tube")
    torus = geo.createNode("torus", "my_torus")
    grid = geo.createNode("grid", "my_grid")
    circle = geo.createNode("circle", "my_circle")

    # 设置 box 为显示节点
    box.setDisplayFlag(True)
    box.setRenderFlag(True)

    geo.layoutChildren()

print("创建几何体完成")

Transform 节点

import hou

with hou.undos.group("ArtClaw: 创建 Transform"):
    geo = hou.node("/obj/geo1")
    box = geo.node("box1")

    xform = geo.createNode("xform", "move_up")
    xform.setInput(0, box)

    # 设置变换参数
    xform.parmTuple("t").set((0, 5, 0))    # 平移 Y=5
    xform.parmTuple("r").set((0, 45, 0))   # 旋转 Y=45°
    xform.parmTuple("s").set((2, 2, 2))    # 缩放 2x

    xform.setDisplayFlag(True)
    xform.setRenderFlag(True)
    geo.layoutChildren()

print("Transform 创建完成")

Merge 合并节点

import hou

with hou.undos.group("ArtClaw: 合并节点"):
    geo = hou.node("/obj/geo1")

    box = geo.createNode("box", "box1")
    sphere = geo.createNode("sphere", "sphere1")
    sphere.parmTuple("t").set((3, 0, 0))

    merge = geo.createNode("merge", "merge_all")
    merge.setInput(0, box)
    merge.setInput(1, sphere)

    merge.setDisplayFlag(True)
    merge.setRenderFlag(True)
    geo.layoutChildren()

print("Merge 完成")

Group 节点

import hou

with hou.undos.group("ArtClaw: 创建 Group"):
    geo = hou.node("/obj/geo1")
    box = geo.node("box1")

    # 按表达式分组
    group = geo.createNode("groupcreate", "top_faces")
    group.setInput(0, box)
    group.parm("groupname").set("top_group")
    group.parm("grouptype").set(0)          # 0=Points, 1=Prims, 2=Edges
    group.parm("grouptype").set(1)          # Primitives
    group.parm("groupbounding").set(1)      # 启用包围盒过滤
    group.parm("boundtype").set(0)          # Bounding Box
    group.parmTuple("size").set((10, 0.1, 10))
    group.parmTuple("t").set((0, 0.5, 0))   # 只选择顶部

    group.setDisplayFlag(True)
    group.setRenderFlag(True)
    geo.layoutChildren()

print("Group 创建完成")