> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Load3D - ComfyUI 組み込みノードのドキュメント
> ComfyUI の Load3D ノードに関する完全なドキュメントです。入力、出力、パラメーターおよび使用方法について学びましょう。
Load3D ノードは、3D モデルファイルを読み込んで処理するためのコアノードです。このノードを読み込むと、`ComfyUI/input/3d/` から利用可能な 3D リソースが自動的に取得されます。また、サポートされている 3D ファイルをアップロード機能を使ってアップロードし、プレビュー表示することもできます。
**サポートされるフォーマット**\
現在、このノードでは `.gltf`、`.glb`、`.obj`、`.fbx`、`.stl` などの複数の 3D ファイル形式がサポートされています。
**3D ノードの設定（プリファレンス）**\
3D ノードに関連するいくつかの設定は、ComfyUI の設定メニューで行うことができます。対応する設定については、以下のドキュメントをご参照ください：
[設定メニュー](https://docs.comfy.org/interface/settings/3d)
通常のノード出力に加えて、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` 形式に対応
* その他
1. Load 3D ノードの複数のメニューおよび非表示メニューを含む
2. 「プレビューウィンドウのサイズ変更」と「キャンバス動画録画」のメニュー
3. 3D 表示操作用の座標軸
4. プレビューのサムネイル
5. プレビューのサイズ設定：サイズを指定してウィンドウをリサイズすることで、プレビュー表示の拡大・縮小が可能
### 1. 表示操作
表示制御操作：
* 左クリック＋ドラッグ：視点の回転
* 右クリック＋ドラッグ：視点の平行移動（パン）
* マウスホイールのスクロール、または中ボタンクリック＋ドラッグ：ズームイン／ズームアウト
* 座標軸：表示方向の切り替え
### 2. 左側メニューの機能
キャンバス上では、一部の設定がメニュー内に隠されています。メニューのボタンをクリックすると、異なるメニューが展開されます。
* 1. **シーン（Scene）**: プレビューウィンドウのグリッド表示、背景色、プレビュー設定を含む
* 2. **モデル（Model）**: モデルの描画モード、テクスチャ・マテリアル、上方向（Up direction）の設定
* 3. **カメラ（Camera）**: 平行投影（オルソグラフィック）と透視投影（パースペクティブ）の切り替え、および透視角度の設定
* 4. **ライト（Light）**: シーン全体のグローバルイルミネーション強度
* 5. **エクスポート（Export）**: モデルを他の形式（GLB、OBJ、STL）へエクスポート
#### シーン（Scene）
シーンメニューでは、シーンの基本設定機能が提供されます。
1. グリッドの表示／非表示
2. 背景色の設定
3. クリックして背景画像をアップロード
4. プレビューの非表示
#### モデル（Model）
モデルメニューでは、モデルに関連する機能が提供されます。
1. **上方向（Up direction）**: モデルの「上」方向を定義する軸を指定
2. **マテリアルモード（Material mode）**: モデルの描画モードを切り替え — 「オリジナル（Original）」「法線（Normal）」「ワイヤーフレーム（Wireframe）」「線画（Lineart）」
#### カメラ（Camera）
このメニューでは、平行投影と透視投影の切り替え、および透視角度（FOV）の設定が可能です。
1. **カメラ（Camera）**: 平行投影と透視投影を素早く切り替え
2. **FOV（視野角）**: FOV 角度を調整
#### ライト（Light）
このメニューを通じて、シーン全体のグローバルイルミネーション強度を迅速に調整できます。
#### エクスポート（Export）
このメニューでは、モデル形式の変換およびエクスポートを迅速に行うことができます。
### 3. 右側メニューの機能
右側メニューには、以下の2つの主な機能があります：
1. **表示比率のリセット**: ボタンをクリックすると、設定された幅と高さに基づいてキャンバスの描画領域の比率が自動調整されます。
2. **動画録画**: 現在の 3D 表示操作を動画として録画でき、録画した動画は後続ノードへ `recording_video` として出力可能です。