ComfyUI/input/3d/ ディレクトリから利用可能な 3D リソースが自動的に取得されます。また、サポートされている 3D ファイルをアップロード機能でアップロードし、プレビュー表示することもできます。
サポートされるフォーマット
- このノードの機能の大部分は Load 3D ノードと同じですが、本ノードはアニメーション付きモデルの読み込みをサポートしており、ノード内で対応するアニメーションをプレビュー表示できます。
- 本ドキュメントの内容は Load3D ノードのものと同一です。なぜなら、アニメーションのプレビューおよび再生機能を除けば、両者の機能は完全に同一であるためです。
現在、本ノードでは
.gltf、.glb、.obj、.fbx、.stl などの複数の 3D ファイルフォーマットがサポートされています。
3D ノードの設定（プリファレンス）3D ノードに関連するいくつかの設定は、ComfyUI の設定メニューで行うことができます。対応する設定については、以下のドキュメントをご参照ください： 設定メニュー 通常のノード出力に加えて、Load3D ノードにはキャンバスメニュー内に多数の 3D 表示関連設定が用意されています。
入力
| パラメーター名 | 型 | 説明 | 初期値 | 範囲 |
|---|---|---|---|---|
| model_file | ファイル選択 | 3D モデルファイルのパス。アップロードに対応。デフォルトでは ComfyUI/input/3d/ からモデルファイルを読み込みます | - | サポート対象フォーマット |
| width | INT | キャンバス描画の幅 | 1024 | 1–4096 |
| height | INT | キャンバス描画の高さ | 1024 | 1–4096 |
出力
| パラメーター名 | データ型 | 説明 |
|---|---|---|
| image | IMAGE | キャンバスで描画された画像 |
| mask | MASK | 現在のモデル位置を含むマスク |
| mesh_path | STRING | モデルファイルのパス |
| normal | IMAGE | 法線マップ（ノーマルマップ） |
| lineart | IMAGE | 線画（ラインアート）出力。対応する edge_threshold は、キャンバスのモデルメニューで調整可能です |
| camera_info | LOAD3D_CAMERA | カメラ情報 |
| recording_video | VIDEO | 録画動画（録画が存在する場合のみ出力） |
キャンバス領域の説明
Load3D ノードのキャンバス領域には、以下のような多様な表示操作が含まれています：- プレビュー表示設定（グリッド表示、背景色、プレビュー表示）
- カメラ制御：FOV（画角）およびカメラ種別の制御
- グローバルイルミネーション強度：照明の強さを調整
- 動画録画：動画の録画およびエクスポート
- モデルのエクスポート：
GLB、OBJ、STL形式をサポート - その他
- Load 3D ノードの複数のメニューおよび非表示メニューを含む
- 「プレビューウィンドウのサイズ変更」と「キャンバス動画録画」のメニュー
- 3D 表示操作用の座標軸
- プレビューのサムネイル
- プレビューのサイズ設定：サイズを指定してウィンドウをリサイズすることで、プレビュー表示の拡大・縮小が可能
1. 表示操作
表示制御操作：- 左クリック＋ドラッグ：視点の回転
- 右クリック＋ドラッグ：視点の平行移動（パン）
- マウスホイールのスクロール、または中ボタンクリック＋ドラッグ：ズームイン／ズームアウト
- 座標軸：表示方向の切り替え
2. 左側メニューの機能
キャンバス上では、一部の設定がメニュー内に隠されています。メニューボタンをクリックすると、さまざまなメニューが展開されます。
-
- シーン（Scene）: プレビューウィンドウのグリッド表示、背景色、プレビュー設定を含む
-
- モデル（Model）: モデルの描画モード、テクスチャ・マテリアル、上方向（Up direction）の設定
-
- カメラ（Camera）: 平行投影（オルソグラフィック）と透視投影（パースペクティブ）の切り替え、および透視角度の設定
-
- ライト（Light）: シーン全体の照明強度（グローバルイルミネーション）
-
- エクスポート（Export）: モデルを他の形式（GLB、OBJ、STL）へエクスポート
シーン（Scene）
シーンメニューでは、シーンの基本設定が可能です。
- グリッドの表示／非表示
- 背景色の設定
- 背景画像のアップロード（クリックで実行）
- プレビューの非表示
モデル（Model）
モデルメニューでは、モデルに関連する各種機能が提供されます。
- 上方向（Up direction）: モデルの「上」方向を定義する軸を選択
- マテリアルモード（Material mode）: モデルの描画モードを切り替え（オリジナル／法線／ワイヤーフレーム／ラインアート）
カメラ（Camera）
このメニューでは、平行投影と透視投影の切り替え、および透視角度（FOV）の設定が可能です。
- カメラ（Camera）: 平行投影と透視投影を素早く切り替え
- FOV（Field of View）: FOV 角度を調整
ライト（Light）
このメニューにより、シーン全体のグローバルイルミネーション強度を迅速に調整できます。
エクスポート（Export）
このメニューでは、モデルを他の形式へ迅速に変換・エクスポートできます。
3. 右側メニューの機能
右側メニューには主に以下の2つの機能があります：- ビュー比率のリセット: ボタンをクリックすると、設定した幅と高さに基づいてキャンバス描画領域のアスペクト比が自動調整されます。
- 動画録画: 現在の3Dビュー操作を動画として録画でき、録画済み動画のインポートも可能。録画動画は
recording_videoとして後続ノードへ出力できます。