Hugging Face's logo

ehristoforu
/
extensions

Model card Files Community
extensions / sd-webui-openpose-editor /README.ja.md
ehristoforu's picture
ehristoforu
Upload folder using huggingface_hub
0163a2c verified
preview code
|
raw
history blame contribute delete
6.76 kB

Stable Diffusion WebUIのためのControlNet内Openposeエディタ

この拡張機能は、特にStable Diffusion WebUIのControlNet拡張機能に統合するために開発されました。

editor_in_modal

前提条件

ControlNet 1.1.216以上が必要です。

インストール

ControlNet拡張v1.1.411から、ユーザーはこの拡張をローカルにインストールする必要はありません。ControlNet拡張は、ローカルのエディタのインストールが検出されない場合、https://huchenlei.github.io/sd-webui-openpose-editor/ というリモートエンドポイントを使用します。インターネット接続が不安定、またはgithub.ioドメインへの接続に問題がある場合は、ローカルインストールを推奨します。

ローカルインストール

installation_guide restart_ui_guide

UI再起動時、拡張機能はコンパイル済みのVueアプリをGithubからダウンロードしようとします。stable-diffusion-webui\extensions\sd-webui-openpose-editor\distが存在し、中に内容があるかどうかを確認してください。

中国の一部のユーザーは、autoupdateスクリプトでdistのダウンロードに問題があると報告しています。そのような状況では、ユーザーは次の2つのオプションからdistを手動で取得することができます：

オプション1：アプリケーションのビルド

nodeJS環境が準備できていることを確認し、Developmentセクションに従ってください。アプリケーションをコンパイルするためにnpm run buildを実行します。

オプション2：コンパイル済みアプリケーションのダウンロード

リリースページからコンパイル済みアプリケーション（dist.zip）をダウンロードできます。リポジトリのルートでパッケージを解凍し、解凍したディレクトリがdistという名前であることを確認してください。

使用法

OpenposeエディタのコアはVue3で構築されています。Gradio拡張スクリプトは、/openpose_editor_index上にVue3アプリケーションをマウントする薄いラッパーです。

必要であれば、ユーザーはlocalhost:7860/openpose_editor_indexでエディタに直接アクセスできますが、主なエントリーポイントはControlNet拡張機能内でエディタを呼び出すことです。ControlNet拡張機能で、任意のopenpose前処理器を選択し、前処理器実行ボタンを押します。前処理結果のプレビューが生成されます。生成された画像の右下隅の編集ボタンをクリックすると、モーダル内にopenposeエディタが表示されます。編集後、ControlNetにポーズを送信ボタンをクリックすると、ポーズがControlNetに送り返されます。

以下のデモは基本的なワークフローを示しています：

基本的なワークフロー

特長

  1. controlnetで使用される顔/手のサポート。
    • 拡張機能はcontrolnetの前処理結果で顔/手のオブジェクトを認識します。
    • ユーザーは、前処理結果がそれらを欠落している場合に顔/手を追加することができます。これは以下のどちらかで行うことができます。
      • デフォルトの手を追加する（顔はキーポイントが多すぎる（70キーポイント）ため、手動でそれらを調整することは非常に困難なため、サポートされていません。）
      • ポーズJSONをアップロードしてオブジェクトを追加する。最初の人の対応するオブジェクトが使用されます。
  2. 可視性の切り替え
    • キーポイントがControlNet前処理器に認識されない場合、その座標は(-1, -1)になります。このような無効なキーポイントはエディタで不可視に設定されます。
    • ユーザーがキーポイントを不可視に設定し、ポーズをcontrolnetに戻すと、キーポイントが接続する肢節はレンダリングされません。実質的に、これがエディタで肢節を削除する方法です。
  3. グループ切り替え
    • キャンバスオブジェクト（手/顔/体）のキーポイントを誤って選択して変更することを避けたい場合、それらをグループ化できます。グループ化されたオブジェクトは一つのオブジェクトのように動作します。グループを拡大、回転、歪ませることができます。

Development

Recommended IDE Setup

VSCode + Volar (and disable Vetur) + TypeScript Vue Plugin (Volar).

Type Support for .vue Imports in TS

TypeScript cannot handle type information for .vue imports by default, so we replace the tsc CLI with vue-tsc for type checking. In editors, we need TypeScript Vue Plugin (Volar) to make the TypeScript language service aware of .vue types.

If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a Take Over Mode that is more performant. You can enable it by the following steps:

  1. Disable the built-in TypeScript Extension
    1. Run Extensions: Show Built-in Extensions from VSCode's command palette
    2. Find TypeScript and JavaScript Language Features, right click and select Disable (Workspace)
  2. Reload the VSCode window by running Developer: Reload Window from the command palette.

Customize configuration

See Vite Configuration Reference.

Project Setup 

npm install

Compile and Hot-Reload for Development 

npm run dev

Type-Check, Compile and Minify for Production 

npm run build

Run Unit Tests with Vitest 

npm run test:unit

Lint with ESLint 

npm run lint