EasyLoader (SV3D)(sv3dLoader)

説明

EasyLoader (SV3D) は、ComfyUI-Easy-Use パッケージのローダーノードで、EasyUse/Loaders グループに属しています。チェックポイントと VAE を読み込み、初期画像を受け取り、被写体の周囲の一連のビューを生成するための潜在/バッチ設定を構築することで、SV3D の画像から3Dへの生成ワークフローを準備します。

また、このノードはカメラ軌道のコントロールとオプションのスケジューラー文字列も公開しており、後続のサンプリング処理やビデオ/3D生成ノードへの単一のエントリーポイントとなっています。

入力

ckpt_name

COMBO。読み込むチェックポイントモデルを選択します。利用可能なオプションはチェックポイントフォルダーから取得されます。

vae_name

COMBO。潜在変数のエンコード/デコードに使用する VAE を選択します。利用可能なオプションは VAE フォルダーから取得されます。

init_image

IMAGE。SV3D 生成の開始ビューとして使用されるソース画像です。この画像は潜在空間にエンコードされ、生成済みカメラパスの視覚的なアンカーとして使用されます。

empty_latent_width

INT。生成済みフレームに使用される空の潜在の幅です。SV3D シーケンスの目的の出力解像度に合わせて設定してください。

empty_latent_height

INT。生成済みフレームに使用される空の潜在の高さです。SV3D シーケンスの目的の出力解像度に合わせて設定してください。

batch_size

INT、デフォルト 21、最小 1、最大 4096。生成するフレーム数/潜在サンプル数です。SV3D はスタンダードな軌道ビューシーケンスで通常21フレームを使用するため、デフォルトは21に設定されています。値を大きくすると、メモリ使用量と生成時間が大幅に増加します。

interp_easing

COMBO、デフォルト linear。オプション: linear、ease_in、ease_out、ease_in_out。カメラパスに沿った補間に適用されるイージングを制御します:

• linear: フレーム間で一定の補間を行います。
• ease_in: ゆっくり開始して加速します。
• ease_out: 速く開始して減速します。
• ease_in_out: 最初に加速し、最後に減速します。

easing_mode

COMBO、デフォルト azimuth。オプション: azimuth、elevation、custom。SV3D シーケンスに使用するカメラモーションのタイプを選択します:

• azimuth: オブジェクトの周囲を水平に周回します。
• elevation: カメラを垂直に移動します。
• custom: カスタムのカメラ/スケジューラーパスを使用します。

scheduler

STRING、オプション、デフォルト ""。オプションのスケジューラー文字列です。空の場合、ローダーは組み込み/デフォルトのスケジューリング動作を使用します。指定した場合、スケジューラー値を受け取る後続ノードに渡すことができます。

出力

PIPE_LINE

読み込んだモデル、VAE、および関連する生成設定をバンドルした EasyUse パイプラインオブジェクトで、後続の EasyUse ノードへの便利な接続を提供します。

MODEL

読み込まれた SV3D ディフュージョンモデルで、サンプラーやその他のモデルを使用するノードで利用できます。

STRING

このローダー設定に関連付けられたスケジューラー文字列です。スケジューラー値を期待するノードに渡したり、デバッグやカスタムスケジューリングワークフローに使用できます。

使用上の注意

• このノードは SV3D の画像から3Dへの生成を目的としており、初期画像が生成済みビューのシーケンスのアンカーとして使用されます。
• デフォルトの batch_size 21 は SV3D のスタンダードなフレーム数と一致しています。変更する場合は、後続のモデルとサンプリング設定がそのフレーム数をサポートしていることを確認してください。
• empty_latent_width と empty_latent_height は通常、入力画像のサイズと同じ値、または SV3D モデルが期待するネイティブ解像度に設定してください。
• easing_mode と interp_easing は合わせて、バッチ全体でカメラがオブジェクトの周囲をどのように移動するかを定義します。シンプルな軌道の場合は、easing_mode を azimuth、interp_easing を linear のままにしてください。
• オプションの scheduler 入力は、ノードのデフォルトに頼らず、カメラ/スケジューリング動作を外部から制御したい場合に特に便利です。