houdini-context

Houdini 编辑器上下文查询

获取当前 Houdini 编辑器状态、选中节点、场景信息、节点网络结构等。

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

---

调用方式

通过 MCP 工具 run_python 执行 Python 代码来获取 Houdini 编辑器上下文。

---

1. 获取选中节点

import hou

selected = hou.selectedNodes()
if selected:
    for node in selected:
        print(f"名称: {node.name()}")
        print(f"  路径: {node.path()}")
        print(f"  类型: {node.type().name()}")
        print(f"  分类: {node.type().category().name()}")
        print("---")
else:
    print("没有选中任何节点")

---

2. 获取场景信息

import hou

# Hip 文件路径
hip_path = hou.hipFile.path()
hip_name = hou.hipFile.basename()
print(f"文件路径: {hip_path}")
print(f"文件名: {hip_name}")

# 是否有未保存的修改
has_changes = hou.hipFile.hasUnsavedChanges()
print(f"有未保存修改: {has_changes}")

# 帧率
fps = hou.fps()
print(f"帧率: {fps} FPS")

# 帧范围
start = hou.playbar.playbackRange()[0]
end = hou.playbar.playbackRange()[1]
current = hou.frame()
print(f"帧范围: {start} - {end}")
print(f"当前帧: {current}")

# Houdini 版本
version = hou.applicationVersionString()
print(f"Houdini 版本: {version}")

---

3. 获取 /obj 下的节点树结构

import hou

def print_node_tree(node, indent=0):
    """递归打印节点树"""
    prefix = "  " * indent
    type_name = node.type().name()
    flags = []
    # SOP 节点才有 display/render flag
    if hasattr(node, 'isDisplayFlagSet') and node.isDisplayFlagSet():
        flags.append("D")
    if hasattr(node, 'isRenderFlagSet') and node.isRenderFlagSet():
        flags.append("R")
    flag_str = f" [{','.join(flags)}]" if flags else ""
    print(f"{prefix}{node.name()} ({type_name}){flag_str}")
    for child in node.children():
        print_node_tree(child, indent + 1)

obj = hou.node("/obj")
if obj:
    print("=== /obj 节点树 ===")
    for child in obj.children():
        print_node_tree(child)
else:
    print("未找到 /obj 节点")

---

4. 获取节点参数列表

import hou

node = hou.node("/obj/geo1/box1")  # 替换为目标节点路径
if node:
    print(f"节点: {node.path()} ({node.type().name()})")
    print("--- 参数列表 ---")
    for parm in node.parms():
        try:
            val = parm.eval()
        except:
            val = "<无法求值>"
        print(f"  {parm.name()} = {val}")
else:
    print("未找到目标节点")