houdini-node-library 0.2.0__tar.gz → 0.3.0__tar.gz

{houdini_node_library-0.2.0 → houdini_node_library-0.3.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.3.0
+
+- 修正: テスト通し実行・終了時にまれに起きるアクセス違反（ワーカースレッドで走った GC が Qt オブジェクトを破棄）を、GC のメインスレッド限定化（`ui/worker.py`）と、ワーカー完了通知の寿命管理で解消。詳細は `docs/stability-notes.md`
+- 変更: **シーン全体は hip のまま保存する**。これまでシーン全体も Hscript（`nodes.cmd`）に変換していたが、大きなシーン（ノード約 2,400、ロックされた HDA の内部を含めると約 30 万）で書き出しに約 265 秒、読み込み（`source`）に約 68 秒かかっていた。0.3.0 では `scene.hip`（ライセンスに応じて `.hip` / `.hiplc` / `.hipnc`）として保存し、書き出しは数秒で終わる。ノード単体・ノード群は従来どおり Hscript。`item.json` に `payload`（`cmd` / `hip`）を追加。古いアイテム（`payload` が無い）は cmd として従来の経路で開ける
+- 追加: 書き出しは作業中のシーンの名前・保存状態・`$HIP`・undo を変えない（hscript `mwrite -n`）。`structure.json` は最上位ごとに件数を分け、時間でも打ち切る
+- 追加: 「シーンを開く」は、ライブラリのファイルを作業ファイルにしない。既定は「名前なしで開く」（保存していない新規シーン扱い）。「保存先を指定して開く」は、ライブラリのファイルを複製してから開く（既存のファイルは上書きしない）
+- 追加: **現在のシーンにマージ**（`hou.hipFile.merge`）。同名のノードは上書きせず、新しい側が改名される
+- 追加: hip の外部ファイル参照は、登録時の置き換え・収集の結果を `item.json` の `path_map`（ノードの絶対パス + パラメータ名 → 新しい値）に記録し、開いた後にパラメータを設定し直す。収集していない `$HIP` 相対のパスは、開くときに元の絶対パスへ展開できる（既定オン）
+- 追加: hip は中身を検査できないため、信頼しない場所のアイテムは開く前の確認ダイアログ内で 1 行の説明を出し、初回だけ承認を求める（承認の記憶は `scene.hip` と `path_map` を含む内容のハッシュ）。テキストコードの共有ではシーン全体を選べない（理由を表示）
+- 追加: 非商用・限定ライセンスで保存した hip の「お知らせ」（登録時、および開く側の Houdini のライセンスが上位のとき）
+- 追加: **長い処理の進行表示とキャンセル**。ブリッジに `progress` / `cancel` を追加。登録ダイアログの読み込み画面に段階と経過時間、キャンセルを出す。固定の 300 秒タイムアウトをやめた（最終上限 1 時間）。Houdini 側もステータスバーに段階を出す。キャンセルは確認点で止まり、Houdini のシーンは処理前のまま
+- 改善: ノード単体・ノード群の書き出しの高速化。同じ HDA 型の「出荷時の見本」を型ごとに 1 つだけ作る（インスタンスごとに作り直していた）、ファイル参照の列挙で `hou.fileReferences()`（シーン全体を走査）をやめて書き出し対象の下だけを調べる。ロックされた HDA を多用する大きなシーンから約 380 ノードを選択した書き出しが 47.3 秒から 3.7 秒になった。読み込みは hscript の `source` が支配的で変わらない（約 16 秒）
+- 変更: Houdini ブリッジのコマンド互換番号を `BRIDGE_VERSION = 5`、アプリの必要最小を `REQUIRED_BRIDGE_VERSION = 5` に上げた（`open_hip` / `progress` / `cancel` の追加、`export` の scope=scene の戻り値）。古いブリッジでは「Houdini を再起動してください」と案内する
 ## 0.2.0
 
 - 追加: **ライブラリに載せない直接共有**。Houdini のシェルフ Share Selection / Receive、ノードの右クリック HNL: Share、ブラウザのファイルメニューとアイテムの右クリック「共有コードを作成...」。方式はテキストコード（`HNL1:...`、設定不要、256 KB まで）、共有フォルダ（`K7Q2-M9XD`、既定 30 日で掃除）、SVN リビジョン（`r1234`）。アプリの引数 `--share <selection|network|scene> --session <pid>` と `--receive`。設定ダイアログに「共有」タブ、サイト設定に `share_dir` / `share_svn_url`

{houdini_node_library-0.2.0/src/houdini_node_library.egg-info → houdini_node_library-0.3.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: houdini-node-library
-Version: 0.2.0
-Summary: Houdini Node Library: save Houdini nodes as Hscript (cmd) and recall them from a standalone browser app
+Version: 0.3.0
+Summary: Houdini Node Library: save Houdini nodes as Hscript (cmd) and whole scenes as hip, and recall them from a standalone browser app
 Author: hamu-dev
 License-Expression: MIT
 Keywords: houdini,sidefx,node,library,hscript
@@ -30,7 +30,8 @@ Dynamic: license-file
 # Houdini Node Library (HNL)
 
 Houdini のノードを Hscript (`nodes.cmd`) として保存し、独立したブラウザアプリから呼び出すツールです。
-選択ノード、ネットワーク全体、シーン全体を登録できます。登録した内容は、現在のネットワークへの追加、新規シーンへのインポート、シーンを開く、のいずれかで復元します。
+選択ノード、ネットワーク全体、シーン全体を登録できます。登録した内容は、現在のネットワークへの追加、新規シーンへのインポート、シーンを開く、現在のシーンへのマージ、のいずれかで復元します。
+ノード単体・ノード群は Hscript（cmd）で、**シーン全体は hip のまま**保存します（大きなシーンでも数秒で登録・開けるため。0.3.0 から）。
 
 ## 必要環境
 

{houdini_node_library-0.2.0 → houdini_node_library-0.3.0}/README.md

@@ -1,7 +1,8 @@
 # Houdini Node Library (HNL)
 
 Houdini のノードを Hscript (`nodes.cmd`) として保存し、独立したブラウザアプリから呼び出すツールです。
-選択ノード、ネットワーク全体、シーン全体を登録できます。登録した内容は、現在のネットワークへの追加、新規シーンへのインポート、シーンを開く、のいずれかで復元します。
+選択ノード、ネットワーク全体、シーン全体を登録できます。登録した内容は、現在のネットワークへの追加、新規シーンへのインポート、シーンを開く、現在のシーンへのマージ、のいずれかで復元します。
+ノード単体・ノード群は Hscript（cmd）で、**シーン全体は hip のまま**保存します（大きなシーンでも数秒で登録・開けるため。0.3.0 から）。
 
 ## 必要環境
 

{houdini_node_library-0.2.0 → houdini_node_library-0.3.0}/docs/format.md

@@ -187,7 +187,7 @@ UTF-8 の JSON です。読むときは BOM があっても受け付けます。
 
 Houdini の `opscript -r -b -s` の出力（Hscript）です。UTF-8、改行は LF です。
 
-- 選択ノード、ネットワーク全体、シーン全体のどれも、同じ形式です。シーン全体は `/` を対象にします。
+- 選択ノード、ネットワーク全体は同じ形式です。シーン全体は 0.3.0 から hip（下の「シーン全体（hip）の形式」）で、`nodes.cmd` は旧形式（0.2.0 以前）のシーンだけが持ちます。旧形式のシーンは `/` を対象にした cmd で、従来どおり開けます。
 - ロックされた HDA の中身は出力されません（`opscript -r` が再帰しないため。HDA のパラメータと、編集可能ノードの中身だけが出ます）。標準ノード 4 個（grid / sphere / vellumconstraints / vellumsolver）の cmd は 79 行です。
 - 付箋を作る Python 行（`createStickyNote` / `findStickyNote`）は取り除き、付箋は `extras.json` に保存します。
 - 収集や検索置き換えをしたときは、登録時に cmd の値が書き換わります。
@@ -424,7 +424,7 @@ Houdini 側のブリッジ（`hnl_bridge/server.py`）は、待ち受けを始
 - 待ち受けは `127.0.0.1` だけです。
 - フレームは、4 バイトの長さ（ビッグエンディアン）の後ろに UTF-8 の JSON が続く形式です。1 フレームの上限は 64 MiB、無通信は 300 秒で切断します。
 - 要求は `{"token": ..., "cmd": ..., "args": {...}}`、応答は `{"ok": true, "result": ...}` または `{"ok": false, "error": ...}` です。トークンが合わない要求には応答せず、接続を切ります。
-- 受け付けるコマンドは、`ping`、`context`、`export`、`import`、`new_scene`、`capture`、`message` の 7 つだけです。任意のコードを実行する口はありません。
+- 受け付けるコマンドは、`ping`、`context`、`export`、`import`、`open_hip`、`new_scene`、`capture`、`message`、`progress`、`cancel` の 10 個だけです（`progress` / `cancel` は実行中のコマンドを待たずに答えます）。任意のコードを実行する口はありません。
 - Houdini の操作はすべてメインスレッドで、1 つずつ実行します。
 
 ### 起動時ジョブ
@@ -453,3 +453,26 @@ package（`hnl.json`）を導入した Houdini は、通常どおり GUI が立
 ### 履歴・キャッシュ
 
 設定フォルダの `share_history.json`（発行したコード・名前・日時・方式。最大 30 件）と `share_cache/`（受け取ったデータ。7 日で掃除）。
+
+## シーン全体（hip）の形式（0.3.0）
+
+`type` が `scene` で `payload` が `hip` のアイテムは、`nodes.cmd` と `extras.json` を持たず、次のファイルを持ちます。
+
+```
+scene.hipnc | scene.hiplc | scene.hip   シーンファイル（保存時のライセンスで拡張子が決まる。1 つだけ）
+structure.json, hda/, assets/ ...       従来どおり
+```
+
+`item.json` の追加項目（無ければ cmd 形式として読みます）:
+
+| キー | 型 | 内容 |
+|---|---|---|
+| `payload` | 文字列 | `cmd`（`nodes.cmd`）または `hip`（`scene.hip*`）。`scene` だけが `hip` になり得ます |
+| `path_map` | 配列 | 開いた後に設定し直すファイルパス `[{node, parm, raw, value}]`。`node` はノードの絶対パス、`parm` はパラメータ名、`raw` は登録時の生の値、`value` は新しい値（`$HNL_ITEM` は開くときに置換）。開くとき、現在の値が `raw` と同じものだけ設定します |
+| `scene_info` | オブジェクト | `fps`、`frame_range`、`playback_range`、`frame`、`top_counts`（最上位ごとのノード数） |
+| `hip_license` | オブジェクト | 保存時のライセンス `{category, ext}` |
+
+`file_refs` の各要素には、hip では `node`（ノードの絶対パス）と `parm_name` が入ります。`node_count_total` は 0（不明）です。`limitations`（既知の制限）は cmd 由来のものなので hip では空です。
+
+承認（信頼）のハッシュは、`nodes.cmd` + `extras.json` + `scene.hip*` + `path_map` + `hda/*` です（cmd 形式のアイテムのハッシュは変わりません）。
+

{houdini_node_library-0.2.0 → houdini_node_library-0.3.0}/docs/security.md

@@ -128,3 +128,14 @@
 - 送信者名・名前・メモは長さを制限し、制御文字・双方向制御文字を除く。
 - 受け取ったデータはローカルのキャッシュに置き（7 日で掃除）、ライブラリの一覧には出さない。
 - テキストコードは既定で信頼しない（HDA の承認が要る）。初回のみ「このコードは実行されるデータです」の注意を 1 行出す（「次回から表示しない」可）。
+
+## シーン全体（hip）は検査できない（0.3.0）
+
+シーン全体は hip のまま保存・共有します。hip は中身を検査できません。開くと、シーンに埋め込まれたスクリプト（`pythonscript` など）、HDA の読み込み時スクリプト（`OnLoaded` など）、パラメータのコールバックが動き得ます。cmd のような危険コマンド検査は使えません。
+
+- 信頼する場所のアイテム（ルート設定・共有方式の設定）は、確認なしで開きます。
+- そうでないものは、開く前の確認ダイアログに「このシーンファイルは内容を検査できません」を 1 行で出し、初回だけ承認を求めます（「停止」にはしません）。承認の記憶は、`scene.hip*` と `path_map`（開いた後に設定し直すパラメータ）を含む内容のハッシュです。内容が変わると未承認に戻ります。共有で届いたものは承認を記憶しません。
+- 開いた後に設定し直すパラメータ（`path_map`）は、文字列パラメータで、登録時の値と現在の値が同じときだけ、改行・バッククォート・`$(` を含まない値に限って設定します。ロックされた HDA の内部は触りません。
+- 受け取ったデータでは、`payload` が `hip` のアイテムはシーンファイルがちょうど 1 つあることを確認し、`nodes.cmd` は取り除きます。cmd のアイテムに付いていた `scene.hip*` も取り除きます。
+- テキストコードの共有では、シーン全体は扱えません（サイズ）。
+

{houdini_node_library-0.2.0 → houdini_node_library-0.3.0}/docs/user-guide.md

@@ -126,7 +126,7 @@
 
 - サムネイル: 右クリックで「画像ファイルから...」「クリップボードから貼り付け」「削除」を選べます。GIF は再生されます。
 - 名前、タイプのバッジ、「プロジェクト / 部署」（どちらも空なら出ません）、お気に入りの星があります。
-- ボタン: シーンは「シーンを開く」、それ以外は「現在のネットワークへ追加」と「新規シーンにインポート」が出ます。
+- ボタン: シーンは「シーンを開く」と「現在のシーンにマージ」（hip 形式のみ）、それ以外は「現在のネットワークへ追加」と「新規シーンにインポート」が出ます。
 
 ### タブ
 
@@ -293,14 +293,15 @@
 |---|---|---|
 | 現在のネットワークへ追加 | ノード、ノード群 | Houdini のネットワークエディタで開いているネットワークに、カーソル位置を中心に追加します。コンテキストが違うとエラーになります |
 | 新規シーンにインポート | ノード、ノード群 | コンテキストから読み込み先を自動で決めます。Object は `/obj`、Driver は `/out`、Lop は `/stage` です。Sop などは `/obj` に、アイテム名のコンテナ（Sop なら `geo`）を作ってその中へ入れます |
-| シーンを開く | シーン | 空のシーンに、シーン全体を読み込みます |
+| シーンを開く | シーン | 空のシーンに、シーン全体を読み込みます（hip 形式は「名前なしで開く」か「保存先を指定して開く」。下の「シーン全体（hip 形式）」を参照） |
+| 現在のシーンにマージ | シーン（hip 形式） | いま開いているシーンへ足します |
 
 - 「新規シーンにインポート」では、確認ダイアログの「この Houdini で新規シーンにする」で、実行先のシーンを空にしてから読み込めます。未保存の変更があると、Houdini 側に「保存」「破棄」「キャンセル」の確認が出ます。チェックしないと、現在のシーンにコンテナを作って読み込みます。
 - 「新しい Houdini を起動」を選ぶと、Houdini を起動して新規シーンに読み込みます。起動に 1 分ほどかかります。
 - シーンは、空のシーンにしか読み込めません。現在のシーンが空でないとエラーになります。
 - 名前が衝突したノードは自動で別名になり、完了ダイアログに「改名されたノード」として出ます。
 - インポートは 1 回の Undo にまとまります。途中で失敗したときは、作られたノードを取り消します。
-- 付箋、ネットワークボックス、ドット、シーン設定は `extras.json` から復元されます。
+- 付箋、ネットワークボックス、ドット、シーン設定は `extras.json` から復元されます（hip 形式のシーンは hip に含まれるので `extras.json` はありません）。
 
 ### 確認ダイアログの読み方
 
@@ -536,3 +537,20 @@ Houdini を起動したままアプリを更新すると、Houdini 側のブリ
 - 「Houdini 側のブリッジが古いバージョンです。Houdini を再起動すると最新になります（未保存のシーンは先に保存してください）」と表示します。
 - 新しいアプリと古いブリッジの組み合わせでも、アプリが使うコマンドが揃っていれば（必要バージョン 3 以上）案内は出ず、そのまま登録できます。
 - 登録するセッションの選択と、インポート確認の実行先一覧では、該当セッションに「【要再起動】」と付きます。
+
+## シーン全体（hip 形式）
+
+0.3.0 から、シーン全体の登録は Hscript に変換せず、Houdini のシーンファイルをそのまま保存します（ノード単体・ノード群は従来どおり cmd）。
+
+- **登録**: 作業中のシーンの名前・保存状態・`$HIP`・undo は変わりません（hscript `mwrite -n`）。保存先のファイルは `scene.hip` / `scene.hiplc` / `scene.hipnc`（Houdini のライセンスに応じた拡張子）です。`nodes.cmd` と `extras.json` は作りません。未保存の新しいシーンでも登録できます。登録画面の「依存・警告」タブには、cmd の検査結果の代わりに「hip は中身を検査できない」旨が出ます。詳細パネルの「cmd」タブには「このアイテムは hip 形式です」と出ます。
+- **要約**: FPS、フレーム範囲、最上位（`/obj` など）ごとのノード数、保存時のライセンスを `item.json` に持ち、詳細パネルの「情報」タブに出します。
+- **開く**: 「シーンを開く」は、ライブラリのファイルを作業ファイルにしません（Ctrl+S でライブラリのアイテムを上書きしないため）。
+  - 名前なしで開く（既定）: 読み込んだあと、保存していない新規シーン（`untitled.hip`）にします。`$HIP` は Houdini の既定の場所になります。
+  - 保存先を指定して開く: ライブラリのファイルを指定した場所へ複製してから、その複製を開きます。同名のファイルがあるときは上書きせず、別の名前を求めます。
+  - 現在のシーンが空でないときは、新規シーンにしてから開きます（未保存の変更があれば Houdini 側で保存の確認が出ます）。「新しい Houdini を起動して開く」も使えます。
+- **マージ**: 「現在のシーンにマージ」は `hou.hipFile.merge` で、いま開いているシーンへ足します。同名のノードは上書きせず、新しい側が改名されます。シーン設定（FPS など）は取り込みません。1 つの undo にまとまります。
+- **外部ファイル**: hip の中の参照はテキスト置換できないので、登録時の「外部パス」タブの検索置き換え・収集の結果を `path_map`（ノードの絶対パス + パラメータ名 → 新しい値）として記録し、開いた後にパラメータを設定し直します。ロックされた HDA の内部など設定できないものはスキップして「お知らせ」に出します。`$HIP` 相対で収集していない参照は、開くときに元の絶対パスへ展開して設定し直せます（確認ダイアログのチェック、既定オン）。
+- **安全性**: hip は中身を検査できません（開くと、埋め込まれたスクリプトや HDA の読み込み時スクリプト、パラメータのコールバックが動き得ます）。信頼する場所のアイテムは確認なしで開きます。そうでないものは、開く前の確認ダイアログに 1 行の説明が出て、初回だけ承認を求めます。テキストコードでの共有では、シーン全体は選べません。
+- **ライセンス**: `.hipnc`（非商用）/ `.hiplc`（Indie）のファイルを商用の Houdini で開くと、そのセッションが制限付きになります。登録時と、開く側のライセンスが上位のときに「お知らせ」を出します。この PC（Apprentice）以外のライセンスでの挙動は確認していません。
+- **長い処理**: 書き出し・開く処理中は、段階と経過時間を表示し、キャンセルできます。キャンセルは確認点で止まり、Houdini のシーンは処理前のままです（hip の読み込みやマージそのものは、始まったあとは途中で止められません）。
+

{houdini_node_library-0.2.0 → houdini_node_library-0.3.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "houdini-node-library"
-version = "0.2.0"
-description = "Houdini Node Library: save Houdini nodes as Hscript (cmd) and recall them from a standalone browser app"
+version = "0.3.0"
+description = "Houdini Node Library: save Houdini nodes as Hscript (cmd) and whole scenes as hip, and recall them from a standalone browser app"
 readme = "README.md"
 requires-python = ">=3.11"
 authors = [{ name = "hamu-dev" }]

{houdini_node_library-0.2.0 → houdini_node_library-0.3.0}/src/hnl/__init__.py

@@ -1,3 +1,3 @@
 """Houdini Node Library."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"