houdini-operation-rules

Houdini 操作通用规则

所有涉及 Houdini 场景修改的操作都必须遵守以下规则。

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

---

🌐 规则 0：坐标系

Houdini 使用 Y-Up 右手坐标系（与 Maya 一致）：

轴	方向	说明
X	右 (Right)	屏幕右侧
Y	上 (Up)	垂直向上
Z	前/外 (Forward)	朝向屏幕外（面向你）

右手系判定：右手拇指指向 X（右），食指指向 Y（上），中指指向 Z（屏幕外）。

与其他 DCC 的换算：

• 与 Maya：坐标轴方向一致，无需转换
• 到 UE (Z-Up 左手系)：Houdini Y → UE Z，Houdini Z → UE -Y
• 到 3ds Max (Z-Up 右手系)：Houdini Y → Max Z，Houdini Z → Max -Y

import hou

# Houdini 坐标示例
node = hou.node("/obj/geo1")
node.parm("tx").set(100)  # X = 右 100
node.parm("ty").set(50)   # Y = 上 50
node.parm("tz").set(0)    # Z = 前 0

---

🔄 规则 1：Undo 包装（强制）

所有修改操作必须包裹在 undo group 中，确保用户可以一次 Ctrl+Z 撤销整个操作。

import hou

with hou.undos.group("ArtClaw: 操作描述"):
    # ... 所有修改操作放在这里 ...
    geo = hou.node("/obj").createNode("geo", "my_geo")
    box = geo.createNode("box", "my_box")

⚠️ 禁止在 undo group 外直接执行场景修改操作。

---

🔗 规则 2：节点操作基础

Houdini 以节点网络为核心，几乎所有操作都是创建/连接/设置节点参数。

获取节点

node = hou.node("/obj/geo1")          # 通过完整路径获取
children = node.children()             # 获取子节点列表
child = node.node("box1")             # 获取相对路径子节点

创建节点

parent = hou.node("/obj/geo1")
box = parent.createNode("box", "my_box")       # (节点类型, 节点名称)
xform = parent.createNode("xform", "move_up")  # 创建 Transform 节点

连接节点

# xform 的第 0 个输入 ← box 的第 0 个输出
xform.setInput(0, box, 0)

# 多输入节点（如 merge）
merge = parent.createNode("merge")
merge.setInput(0, box, 0)
merge.setInput(1, sphere, 0)

设置参数

box.parm("sizex").set(2.0)            # 标量参数
box.parm("scale").set(1.5)
xform.parmTuple("t").set((0, 5, 0))   # 向量参数（translate）

布局节点

parent.layoutChildren()               # 自动排列所有子节点

设置显示/渲染标记

node.setDisplayFlag(True)             # 蓝色显示标记
node.setRenderFlag(True)              # 紫色渲染标记

---

🍳 规则 3：Cook 机制

• Houdini 的节点修改后需要 cook 才能计算出结果
• 大部分参数修改会自动触发 cook，无需手动干预
• 需要强制 cook 时：node.cook(force=True)