CozyBlanket ネットワーク API
CozyBlanket のネットワーク機能を組み合わせて、ワークフローを効率化する方法をご紹介します。
CozyBlanket のネットワーク機能
CozyBlanket のリモートネットワーク機能では、デスクトップの DCC ソフトウェア、サーバー、パイプラインツールから CozyBlanket を操作し、既存のソフトウェアと連携できます。
CozyBlanket でネットワーク機能を有効にしてください。この機能は Standard ライセンスでのみ利用できます。
ネットワークスクリプトをダウンロード
cozyblanket_network_utils.zipパッケージの内容:
- ✓ CLI 付き Python モジュール
- ✓ Blender アドオン(Windows、Mac、Linux)
- ✓ ZBrush プラグイン(Windows) 実験的機能
ソフトウェア連携
コマンドラインインターフェース
CLI を使うと、ターミナルやスクリプトから CozyBlanket を手軽に操作できます。
python cli.py --help # List all supported commands
python -m cozyblanket.cli --help # If installed via pip Blender アドオン
Blender アドオンにより、リトポロジーの作業で CozyBlanket とスムーズに連携できます。
Blender 3.0 以降が必要です。
インストール
Edit > Preferences > Add-ons > Install を開き、cozyblanket_remote_blender.zip ファイルを選択してアドオンをインストールします。
機能
- 1 つまたは複数のターゲットオブジェクトを CozyBlanket に送信
- 1 つ以上のターゲットオブジェクトと EditMesh を CozyBlanket に送信
- 現在の CozyBlanket EditMesh をアクティブオブジェクトに取得
- EditMesh と CozyBlanket のカメラ位置を Blender とリアルタイム同期
アドオンの操作は N Panel から利用できます。
ZBrush プラグイン(実験的機能)
実験的な ZBrush プラグインにより、スカルプトの作業で CozyBlanket と連携できます。
Windows 版 Maxon ZBrush 2022 が必要です。
インストール
付属の ZBrush フォルダーの内容を C:/Program Files/Maxon/ZBrush2022/ZStartup/ZPlugs64 にコピーします。
機能
- 現在の SubTool を CozyBlanket に送信
- CozyBlanket EditMesh を現在の SubTool に取得
ツールは ZPlugins > CozyBlanket メニューから利用できます。
Python モジュールによる連携
付属の Python モジュールには、CozyBlanket ネットワーク API のリファレンス実装が含まれています。パイプラインスクリプトの作成時に .obj ファイルを直接インポートするためのユーティリティ関数も用意されています。
pip でモジュールをインストール: pip install cozyblanket
使用例
from cozyblanket import CozyBlanketConnection
# Connect to a running instance
CB = CozyBlanketConnection() # Optional device_id argument
CB.connect()
# Close current document and clear scene
CB.document_close()
CB.scene_clear()
# Push new retopology target from OBJ
CB.target_push_obj("target.obj", "named_target")
CB.target_load("named_target")
# Save current mesh to OBJ
CB.editmesh_pull_obj("editmesh.obj")
# Add remote action button
CB.remote_actions_add(
"Example Button",
lambda: print("The user pressed the button!")
)
# Process remote actions
while True:
CB.remote_actions_process()
# Cleanup connection
CB.disconnect() 注意:受信イベントを処理するには、クライアントアプリケーションから remote_actions_process() メソッドを定期的に呼び出す必要があります。
*CozyBlanket を有効にするにはアプリ内課金が必要です。CozyBlanket には 2 つのエディションがあります。お住まいの地域の価格は CozyBlanket アプリ内でご確認ください。