> ## 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.

# Preview3DAnimation - ComfyUI 組み込みノードのドキュメント

> ComfyUI の Preview3DAnimation ノードに関する完全なドキュメントです。入力、出力、パラメーターおよび使用方法について学びましょう。

Preview3DAnimation ノードは、主に 3D モデル出力をプレビューするために使用されます。このノードは 2 つの入力を受け取ります。1 つは Load3D ノードから得られる `camera_info`、もう 1 つは 3D モデルファイルのパスです。モデルファイルのパスは、`ComfyUI/output` フォルダー内にある必要があります。

**サポートされるフォーマット**\
現在、このノードでは `.gltf`、`.glb`、`.obj`、`.fbx`、`.stl` などの複数の 3D ファイルフォーマットがサポートされています。

**3D ノードの設定項目**\
3D ノードに関連するいくつかの設定項目は、ComfyUI の設定メニューで構成できます。対応する設定については、以下のドキュメントを参照してください：\
[設定メニュー](https://docs.comfy.org/interface/settings/3d)

## 入力

| パラメーター名      | 型              | 説明                             |
| ------------ | -------------- | ------------------------------ |
| camera\_info | LOAD3D\_CAMERA | カメラ情報                          |
| model\_file  | STRING         | `ComfyUI/output/` 内のモデルファイルのパス |

## キャンバス領域の説明

現在、ComfyUI のフロントエンドにおける 3D 関連ノードは、キャンバスコンポーネントを共用しています。そのため、一部の機能的差異を除けば、基本的な操作はほぼ同一です。

> 以下に示す内容およびインターフェースは、主に Load3D ノードを基準として作成されています。具体的な機能については、実際のノードインターフェースをご確認ください。

キャンバス領域には、以下のようなさまざまなビュー操作が含まれています：

* プレビュー表示設定（グリッド表示、背景色、プレビュービュー）
* カメラ制御：FOV（画角）、カメラタイプ
* グローバルイルミネーション強度：照明の調整
* モデルのエクスポート：`GLB`、`OBJ`、`STL` 形式に対応
* その他

<img src="https://mintcdn.com/dripart-docs-recommend-assets-api/lHvc-EW9wWg1OPFd/images/built-in-nodes/Preview3DAnimation/preview3d_canvas.jpg?fit=max&auto=format&n=lHvc-EW9wWg1OPFd&q=85&s=993a886b5eac153cc56f5c874dea55d0" alt="Load 3D ノード UI" width="976" height="739" data-path="images/built-in-nodes/Preview3DAnimation/preview3d_canvas.jpg" />

1. Load 3D ノードの複数のメニューおよび非表示メニューを含む
2. 3D ビュー操作用の座標軸

### 1. ビュー操作

<video controls width="640" height="360">
  <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/view_operations.mp4" type="video/mp4" />

  お使いのブラウザは動画再生をサポートしていません。
</video>

ビュー制御操作：

* 左クリック＋ドラッグ：ビューの回転
* 右クリック＋ドラッグ：ビューのパン（平行移動）
* マウスホイールスクロール、または中クリック＋ドラッグ：ズームイン／ズームアウト
* 座標軸：ビューの切り替え

### 2. 左側メニューの機能

![Menu](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu.webp)

プレビュー領域では、一部のビュー操作関連メニューが隠されており、メニューボタンをクリックすることで各メニューを展開できます。

* 1. **シーン（Scene）**：プレビューウィンドウのグリッド表示、背景色、サムネイル設定を含む
* 2. **モデル（Model）**：モデルのレンダリングモード、テクスチャ・マテリアル、上方向（Up direction）の設定
* 3. **カメラ（Camera）**：平行投影（オルソグラフィック）ビューと透視投影（パースペクティブ）ビューの切り替え、透視角度の設定
* 4. **ライト（Light）**：シーン全体のグローバルイルミネーション強度
* 5. **エクスポート（Export）**：モデルを他の形式（`GLB`、`OBJ`、`STL`）へエクスポート

#### シーン（Scene）

![scene menu](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp)

シーンメニューでは、シーンの基本設定機能を提供します：

1. グリッドの表示／非表示
2. 背景色の設定
3. 背景画像のアップロード（クリックで実行）
4. プレビューサムネイルの非表示

#### モデル（Model）

![Menu\_Scene](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp)

モデルメニューでは、モデルに関連する機能を提供します：

1. **上方向（Up direction）**：モデルの「上」方向を定義する軸を指定
2. **マテリアルモード（Material mode）**：モデルのレンダリングモードを切り替え — 「Original（オリジナル）」「Normal（法線）」「Wireframe（ワイヤーフレーム）」「Lineart（ラインアート）」

#### カメラ（Camera）

![menu\_modelmenu\_camera](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp)

このメニューでは、平行投影ビューと透視投影ビューの切り替え、および透視角度の設定が可能です：

1. **カメラ（Camera）**：平行投影ビューと透視投影ビューを素早く切り替え
2. **FOV（Field of View）**：FOV 角度を調整

#### ライト（Light）

![menu\_modelmenu\_camera](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp)

このメニューを通じて、シーン全体のグローバルイルミネーション強度を素早く調整できます。

#### エクスポート（Export）

![menu\_export](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp)

このメニューでは、モデルのフォーマット変換およびエクスポートを迅速に行うことができます。
