4.7 KiB
4.7 KiB
ComfyUI-ProportionChanger
日本語 | English README
注意: このREADMEはClaude Code AI支援開発ツールを使用して自動生成されました。
このカスタムノードは、kijai氏のComfyUI-WanVideoWrapperのWanVideo UniAnimate DWPose Detectorノードを分解してポーティングしたものです。違いは、画像で入力していたところをDWPoseのKeyPointで入力できるようになったことで、これによりDWPoseでKeyPointが推定できないような体型でも操作ができるようになっています。
さらに、toyxyz/ComfyUI-ultimate-openpose-editorのOpenpose Editorノードも同様に分解してポーティングしています。これにより、各パーツ微調整が可能になっています。
機能
ノード紹介
- ProportionChanger DWPose Detector: 画像からDWPoseのKeyPointを検出する
- ProportionChanger Reference: 参照用ポーズにプロポーションを変換する
- ProportionChanger DWPose Render: KeyPointを画像に変換する
- ProportionChanger Params: KeyPointの各パーツのパラメータを調整する
- ProportionChanger Interpolator: KeyPoint動画を中割りして補間する
- PoseData to pose_keypoint: WanAnimateの
POSEDATAをPOSE_KEYPOINTに変換する - pose_keypoint input: JSONテキストからKeyPointに変換する
- pose_keypoint preview: KeyPointからJSONに変換する
インストール
ComfyUI Managerでインストール
-
ComfyUI MangerのCustom Nodes Mangagerから「ComfyUI-ProportionChanger」を検索してインストール
-
ComfyUIを再起動
手動インストール
custom_nodesフォルダにこのリポジトリをクローン：
cd ComfyUI/custom_nodes
git clone https://github.com/grmchn/ComfyUI-ProportionChanger.git
- 依存関係をインストール：
cd ComfyUI-ProportionChanger
pip install -r requirements.txt
- ComfyUIを再起動
使用方法
基本ワークフロー
example_workflowsを参照してください。
WanAnimate POSEDATAの変換
- WanAnimatePreprocessの「Pose and Face Detection」で
POSEDATAを取得 - PoseData to pose_keypointノードに
POSEDATAとキャンバスのwidth/heightを入力 - 出力された
pose_keypointをProportionChanger Reference / Renderノードに接続 - サンプルワークフロー:
example_workflows/proportion_changer_pose_data_to_pose_keypoint.json
トラブルシューティング
よくある問題
- モデル読み込みエラー: HuggingFaceから自動ダウンロードされるはずです。DWPoseモデルが正しいディレクトリにあることを確認してください。
- リファレンス画像ありでプロポーション変換した後の体型がおかしい:リファレンス画像のサイズをポーズ画像側と同じにしてください。体の各パーツの微調整は、「ProportionChanger Params」ノードで行ってください。
- リファレンス画像ありでプロポーション変換した後に何も表示されない:リファレンス画像のDWPoseによる姿勢推定が失敗しています。OpenposeEditorなどを利用してパラメータの数値を入力してください。
帰属とクレジット
Special Thanks
ライセンス
このプロジェクトは、異なるライセンスのソース素材を組み合わせているため、GPL 3.0でライセンスされています：
- 主要ソース: kijai/ComfyUI-WanVideoWrapper (Apache 2.0)
- 二次ソース: toyxyz/ComfyUI-ultimate-openpose-editor (GPL 3.0)
Apache 2.0とGPL 3.0ライセンスのプロジェクトからコードを組み合わせる場合、ライセンス互換性ルールに従って結果の派生作品はGPL 3.0で配布する必要があります。
著作権表示
- オリジナルWanVideo UniAnimate DWPose Detector: Copyright by kijai
- ProportionChanger Params機能: Copyright by toyxyz
- 修正・統合: このプロジェクトの貢献者
完全なGPL 3.0ライセンス条項についてはLICENSEファイルを参照してください。