houdini-node-library 0.1.0__py3-none-any.whl

hnl/__init__.py

@@ -0,0 +1,3 @@
+"""Houdini Node Library."""
+
+__version__ = "0.1.0"

hnl/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .app import main
+
+sys.exit(main())

hnl/_houdini/OPmenu.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Houdini drops non-ASCII characters in menu/shelf XML, so keep labels ASCII-only. -->
+<menuDocument>
+  <menu>
+    <separatorItem/>
+    <scriptItem id="hnl_register_selection">
+      <label>HNL: Register to Library</label>
+      <scriptCode><![CDATA[
+import hnl_bridge.launcher as launcher
+launcher.run_tool("selection")
+]]></scriptCode>
+      <language>python</language>
+    </scriptItem>
+  </menu>
+</menuDocument>

hnl/_houdini/python/hnl_bridge/__init__.py

@@ -0,0 +1,2 @@
+"""HNL Houdini ブリッジ（標準ライブラリと hou のみ）。"""
+__version__ = "0.1.0"

hnl/_houdini/python/hnl_bridge/autostart.py

@@ -0,0 +1,12 @@
+"""GUI 起動時の自動起動（python3.13libs/uiready.py から呼ぶ）。"""
+from __future__ import annotations
+
+
+def on_ui_ready() -> None:
+    from . import server
+    server.start()
+    try:
+        import hdefereval
+        hdefereval.executeDeferred(server.run_startup_job)
+    except Exception:
+        server.run_startup_job()

hnl/_houdini/python/hnl_bridge/cmdio.py

@@ -0,0 +1,98 @@
+r"""Hscript cmd テキストの読み書きと文（論理行）分割。標準ライブラリのみ（hou 不要）。
+
+opscript はキーフレーム式の改行を \n（バックスラッシュ + n）にエスケープするが、CR は生のまま出す
+（CRLF の式 = 生の CR + \n）。ファイルをテキストモードの既定（universal newlines）で読むと生の CR が LF に
+化けて、クォートの途中に実改行が入り、hscript が読めなくなる。cmd は必ず改行変換なしで読み書きすること。
+cmd の加工は物理行ではなく、クォートを考慮した split_statements() の単位で行うこと。"""
+from __future__ import annotations
+
+_QUOTES = "\"'`"
+_LF = "\n"
+_BS_N = "\\n"          # バックスラッシュ + n の 2 文字
+
+
+def read_cmd(path, repair: bool = True) -> str:
+    """cmd を改行変換なしで読む。repair=True なら repair_broken() も適用する。"""
+    with open(path, "rb") as f:
+        text = f.read().decode("utf-8-sig")
+    return repair_broken(text) if repair else text
+
+
+def write_cmd(path, text: str) -> None:
+    """cmd を改行変換なしで書く（Windows でも LF を CRLF にしない）。"""
+    with open(path, "wb") as f:
+        f.write(text.encode("utf-8"))
+
+
+def _skip_comment(text: str, i: int, n: int) -> int:
+    """行頭の # から行末（LF の位置）までを飛ばした位置。コメント中の ' は引用符ではない。"""
+    j = text.find(_LF, i)
+    return n if j < 0 else j
+
+
+def split_statements(text: str) -> list[str]:
+    r"""LF 区切りで分けるが、クォート内の LF と、バックスラッシュ + LF（行継続）では切らない。
+    _LF.join(戻り値) == text が常に成り立つ。閉じていないクォートがあれば、全体を物理行で分け直す。"""
+    out: list[str] = []
+    n = len(text)
+    start = i = 0
+    quote = ""
+    while i < n:
+        c = text[i]
+        if c == "\\" and i + 1 < n:
+            i += 2
+            continue
+        if quote:
+            if c == quote:
+                quote = ""
+        elif c == "#" and (i == 0 or text[i - 1] == _LF):
+            i = _skip_comment(text, i, n)
+            continue
+        elif c in _QUOTES:
+            quote = c
+        elif c == _LF:
+            out.append(text[start:i])
+            start = i + 1
+        i += 1
+    if quote:
+        out.extend(text[start:].split(_LF))
+        return out
+    out.append(text[start:])
+    return out
+
+
+def join_statements(parts: list[str]) -> str:
+    return _LF.join(parts)
+
+
+def repair_broken(text: str) -> str:
+    r"""旧版が壊した cmd を元に戻す。単一引用符の中の「実改行 + \n（バックスラッシュ + n）」は、元は
+    「生の CR + \n」（opscript の出力そのまま）だったので、実改行を CR に戻す。正しい cmd には現れない並び。"""
+    if _LF + _BS_N not in text:
+        return text
+    out: list[str] = []
+    n = len(text)
+    i = last = 0
+    quote = ""
+    while i < n:
+        c = text[i]
+        if c == "\\" and i + 1 < n:
+            i += 2
+            continue
+        if quote:
+            if c == quote:
+                quote = ""
+            elif c == _LF and quote == "'" and text.startswith(_BS_N, i + 1):
+                out.append(text[last:i])
+                out.append("\r")
+                last = i + 1
+        elif c == "#" and (i == 0 or text[i - 1] == _LF):
+            i = _skip_comment(text, i, n)
+            continue
+        elif c in _QUOTES:
+            quote = c
+        i += 1
+    if quote:                                   # 閉じていないクォートがある = 判断できない。そのまま返す
+        return text
+    out.append(text[last:])
+    return "".join(out)

hnl/_houdini/python/hnl_bridge/export.py

@@ -0,0 +1,292 @@
+"""シーン / ネットワーク / 選択ノードの書き出し（作業中のシーンは変更しない）。"""
+from __future__ import annotations
+
+import json
+import os
+import posixpath
+import re
+
+import hou
+
+from . import cmdio
+from . import extras as ex_mod
+from . import hdas
+from . import structure as structure_mod
+from . import userset
+
+_VAR = re.compile(r"\$\{?([A-Za-z_]\w*)")
+_CH_FUNC = re.compile(r"\bch[a-z]*\(\s*[\"']([^\"']+)[\"']")
+MAX_LISTED = 20          # 警告に 1 件ずつ並べる上限
+_HOU_NODE = re.compile(r"\bhou\.(node|parm|evalParm|ch\w*)\(\s*[\"']([^\"']+)[\"']")
+
+
+def _run_opscript(cwd: str, args: str) -> tuple[str, str]:
+    old = hou.hscript("oppwf")[0].strip()
+    try:
+        hou.hscript("opcf " + cwd)
+        return hou.hscript("opscript -r -b -s " + args)       # -s: キー時刻をフレーム単位に（FPS ずれ対策）
+    finally:
+        hou.hscript("opcf " + (old or "/"))
+
+
+_STICKY_PREFIX = ("python -c 'hou.pwd().createStickyNote(", "python -c 'hou.pwd().findStickyNote(")
+# ネットワークボックスの入れ子を作る python 行（ロック解除した HDA の中身などで出る）。実行しない
+_NETBOX_PREFIX = 'python -c "hou.pwd().findNetworkBox('
+
+
+
+def _strip_stickies(cmd: str) -> str:
+    """opscript が付箋・ネットワークボックスの入れ子用に出す python 行を除く（付箋・ボックスは extras.json で保存する）。"""
+    keep = [ln for ln in cmdio.split_statements(cmd)
+            if not (ln.startswith(_STICKY_PREFIX) and ln.rstrip().endswith("'"))
+            and not (ln.startswith(_NETBOX_PREFIX) and ln.rstrip().endswith('"'))]
+    return "\n".join(keep)
+
+
+_OPCF = re.compile(r"^opcf\s+(\S+)\s*$")
+_OPADD = re.compile(r"^opadd((?:\s+-\w+)*)\s+(\S+)\s+(\S+)\s*$")
+
+
+def _drop_shipped_opadd(cmd: str, start: str, scope) -> str:
+    """ロックされた HDA の出荷時の中身（編集可能ノードの中を含む）を作る opadd 行を除く。
+
+    HDA は作成された時点で同じ中身を持っているので、読み込み側で opadd すると同名の衝突で別名のノードが増える
+    （force_output1 など）。以降の oplocate / opparm / opwire 行は既存のノードに対して効く。"""
+    cwd, out = start or "/", []
+    for ln in cmdio.split_statements(cmd):
+        m = _OPCF.match(ln)
+        if m:
+            tok = m.group(1).strip("\"'")
+            if tok.startswith("$"):
+                pass                                    # $saved_path（最後の復帰）
+            else:
+                cwd = posixpath.normpath(tok if tok.startswith("/") else cwd.rstrip("/") + "/" + tok)
+        else:
+            m = _OPADD.match(ln)
+            if m and "u" not in m.group(1) and scope.is_shipped(cwd.rstrip("/") + "/" + m.group(3), m.group(2)):
+                continue
+        out.append(ln)
+    return "\n".join(out)
+
+
+def _quote_bare_backticks(cmd: str) -> str:
+    """opparm の値が `@pdg_input` のようにバッククォートだけで書かれていると、読み込み時に hscript が式として評価して
+    しまう（値が失われ、警告が出る）。他の文字列と同じく単一引用符で包んで、文字列のまま設定させる。"""
+    out = []
+    for ln in cmdio.split_statements(cmd):
+        out.append(_quote_line(ln) if ln.startswith("opparm ") and "`" in ln else ln)
+    return "\n".join(out)
+
+
+def _quote_line(ln: str) -> str:
+    toks, cur, q, i = [], "", False, 0
+    while i < len(ln):
+        c = ln[i]
+        if c == "\\" and i + 1 < len(ln):
+            cur += ln[i:i + 2]
+            i += 2
+            continue
+        if c == "'":
+            q = not q
+        if c == " " and not q:
+            toks.append(cur)
+            cur = ""
+        else:
+            cur += c
+        i += 1
+    toks.append(cur)
+    return " ".join(("'%s'" % t) if ("`" in t and "'" not in t and "\\" not in t and "\"" not in t
+                                     and not t.startswith("-")) else t for t in toks)
+
+
+def _parm_texts(p) -> list[str]:
+    out: list[str] = []
+    try:
+        for k in p.keyframes():
+            try:
+                out.append(k.expression())
+            except hou.Error:
+                pass
+    except hou.Error:
+        pass
+    try:
+        if p.parmTemplate().type() == hou.parmTemplateType.String:
+            out.append(p.unexpandedString())
+    except hou.Error:
+        pass
+    return out
+
+
+def _scan_parms(visible, inside: set, parent, scope) -> tuple[list, list, dict]:
+    """利用者が設定したパラメータだけを調べ、(選択外チャンネル参照, 警告, 環境変数の使用箇所) を返す。"""
+    refs, warns, seen, usage = [], [], set(), {}
+    for n in visible:
+        for p in n.parms():
+            if not scope.user_parm(p):
+                continue
+            where = ex_mod.rel_path(p, parent)
+            for text in _parm_texts(p):
+                for name in _VAR.findall(text):
+                    usage.setdefault(name, set()).add(where)
+                cands = [(m.group(1), m.group(1).rsplit("/", 1)[0] if "/" in m.group(1) else "")
+                         for m in _CH_FUNC.finditer(text)]
+                for m in _HOU_NODE.finditer(text):
+                    path = m.group(2)
+                    cands.append((path, path if m.group(1) == "node" else (path.rsplit("/", 1)[0] if "/" in path else "")))
+                for path, cand in cands:
+                    if cand:
+                        _check(n, p, path, cand, inside, parent, refs, warns, seen)
+    return refs, warns, usage
+
+
+def _check(n, p, path, cand, inside, parent, refs, warns, seen):
+    try:
+        target = n.node(cand)
+    except hou.Error:
+        target = None
+    key = (n.path(), p.name(), path)
+    if target is None or key in seen:
+        return
+    seen.add(key)
+    rel = ex_mod.rel_path(n, parent)
+    if target not in inside:
+        refs.append({"kind": "channel", "node": rel, "parm": p.name(), "target": path,
+                     "detail": "%s -> %s" % (p.name(), path)})
+    elif path.startswith("/"):
+        warns.append("%s の %s は絶対パス %s で参照しており、読み込み後も元のパスを指します" % (rel, p.name(), path))
+
+
+def _file_refs(inside_prefix: tuple, parent, scope) -> list[dict]:
+    hfs = _hfs_lower()
+    out = []
+    for p, raw in hou.fileReferences():
+        if p is None or not raw or not p.path().startswith(inside_prefix):
+            continue
+        if not scope.user_parm(p):
+            continue
+        try:
+            exp = p.evalAsString() if p.parmTemplate().type() == hou.parmTemplateType.String else raw
+        except hou.Error:
+            exp = hou.text.expandString(raw)
+        if os.path.realpath(exp).lower().startswith(hfs):
+            continue
+        try:
+            ntype = p.node().type().name()
+        except Exception:
+            ntype = ""
+        out.append({"parm": ex_mod.rel_path(p, parent), "node_type": ntype,
+                    "raw": raw, "expanded": exp, "exists": os.path.exists(exp),
+                    "kind": "output" if userset.is_output_parm(p) else "input"})
+    return out
+
+
+def _hfs_lower() -> str:
+    return os.path.realpath(hou.text.expandString("$HFS")).lower()
+
+
+def _env_for(cmd: str) -> dict:
+    names = set(_VAR.findall(cmd))
+    allv = ex_mod.all_vars()
+    return {n: allv[n] for n in sorted(names)
+            if n in allv and (n in ("HIP", "JOB") or n not in ex_mod.BUILTIN_VARS)}
+
+
+def export(scope: str, staging_dir: str, node_paths=None, parent_path=None) -> dict:
+    """scope: "selection" | "network" | "scene"。staging_dir に nodes.cmd / extras.json / hda/ を書く。"""
+    warns: list[str] = []
+    if scope == "selection":
+        nodes = [hou.node(p) for p in (node_paths or [])]
+        if not nodes or any(n is None for n in nodes):
+            raise ValueError("選択ノードが見つかりません")
+        parent = nodes[0].parent()
+        if any(n.parent() != parent for n in nodes):
+            raise ValueError("選択ノードは同じ親を持つ必要があります")
+        kind, whole = ("node" if len(nodes) == 1 else "nodes"), False
+        opargs = "-N " + " ".join(n.name() for n in nodes)
+    elif scope == "network":
+        parent = hou.node(parent_path or "")
+        if parent is None:
+            raise ValueError("ネットワークが見つかりません: %s" % parent_path)
+        nodes, kind, whole = list(parent.children()), "nodes", True
+        opargs = ("-N " + " ".join(n.name() for n in nodes)) if nodes else ""
+    elif scope == "scene":
+        parent = hou.node("/")
+        nodes, kind, whole = list(parent.children()), "scene", True
+        opargs = "/"
+    else:
+        raise ValueError("不明な scope: %s" % scope)
+
+    scope_ = userset.Scope(parent)
+    try:
+        return _export_body(scope, staging_dir, parent, nodes, kind, whole, opargs, warns, scope_)
+    finally:
+        scope_.close()
+
+
+def _export_body(scope, staging_dir, parent, nodes, kind, whole, opargs, warns, scope_) -> dict:
+    # opscript を最初に実行する。scope_.visible() / user_parm() は HDA の「出荷時の見本」を親の中に一時ノードとして
+    # 作るので、先に呼ぶと見本まで cmd に書き出され、同じ内容が二重に出力される
+    cmd, err = _run_opscript(parent.path(), opargs) if opargs else ("", "")
+    total = scope_.total(nodes)
+    visible = scope_.visible(nodes)
+    if scope == "scene":
+        total = [n for n in total if n.parent() != parent]
+        visible = [n for n in visible if n.parent() != parent]
+    inside = set(total) | set(nodes)
+
+    cmd = _quote_bare_backticks(_strip_stickies(cmd))
+    cmd = _drop_shipped_opadd(cmd, parent.path(), scope_)
+    removed = scope_.removed_shipped(nodes, parent)
+    wires = scope_.editable_wires(nodes, parent)
+    if err.strip():
+        warns.append("opscript がエラーを返しました: " + err.strip().splitlines()[0])
+    for n in visible:
+        if getattr(n, "isHardLocked", lambda: False)():
+            warns.append("%s はハードロックされており、ジオメトリは保存されません（復元後は空になります）" % n.path())
+    if scope != "scene" and parent.nodeGroups():
+        warns.append("ノードグループは保存されません")
+
+    ext = [{"kind": "input", "node": ex_mod.rel_path(n, parent), "detail": "入力%d <- %s" % (i, src.path())}
+           for n in visible for i, src in enumerate(n.inputs()) if src is not None and src not in inside]
+    if ext:
+        warns.append("選択外のノードからの入力接続が %d 件あり、読み込み後は失われます" % len(ext))
+    crefs, cwarns, usage = _scan_parms(visible, inside, parent, scope_)
+    ext += crefs
+    warns += cwarns
+    for c in crefs[:MAX_LISTED]:
+        warns.append("%s の %s が選択外 %s を参照しており、読み込み後は参照切れになります" % (c["node"], c["parm"], c["target"]))
+    if len(crefs) > MAX_LISTED:
+        warns.append("選択外へのチャンネル参照はほか %d 件あります" % (len(crefs) - MAX_LISTED))
+
+    os.makedirs(staging_dir, exist_ok=True)
+    deps = hdas.collect_hdas(total, staging_dir)
+    extras = ex_mod.collect(parent, nodes, whole, scope_)
+    if removed:
+        extras["removed_nodes"] = removed
+    if wires:
+        extras["editable_wires"] = wires
+    if scope == "scene":
+        extras["scene"] = ex_mod.collect_scene()
+    prefix = tuple(n.path() + "/" for n in nodes) if scope != "scene" else ("/",)
+    frefs = _file_refs(prefix, parent, scope_)
+    scope_.close()                                    # 一時ノード（HDA の見本）を先に片付ける
+    env = _env_for(cmd)
+
+    cmdio.write_cmd(os.path.join(staging_dir, "nodes.cmd"), cmd)
+    with open(os.path.join(staging_dir, "extras.json"), "w", encoding="utf-8") as f:
+        json.dump(extras, f, ensure_ascii=False, indent=1)
+    try:                                              # 表示用の構造情報。失敗しても登録は妨げない
+        tree = structure_mod.build(scope, parent, nodes)
+        with open(os.path.join(staging_dir, "structure.json"), "w", encoding="utf-8") as f:
+            json.dump(tree, f, ensure_ascii=False, indent=1)
+    except Exception as e:  # noqa: BLE001
+        warns.append("構造情報を作れませんでした: %s" % e)
+    return {
+        "type": kind, "context": parent.childTypeCategory().name(), "source_parent": parent.path(),
+        "source_nodes": [n.path() for n in nodes] if scope == "selection" else [],
+        "node_count": len(visible), "node_count_total": len(total),
+        "node_types": sorted({n.type().name() for n in visible}),
+        "houdini_version": hou.applicationVersionString(), "file_refs": frefs, "hda_deps": deps,
+        "external_refs": ext, "warnings": warns, "env": env,
+        "env_usage": {k: sorted(usage.get(k, ())) for k in env},
+    }