Skip to content

Commit 3ff6fbe

Browse files
committed
Add CONDITIONING_AREAS output, ConditioningAreaPreview node, and bump version to 1.1.0
- ConditioningPipelineCombine now exposes areas_out (CONDITIONING_AREAS), providing the list of configured region coordinates and strengths as a structured output for downstream consumers. - New ConditioningAreaPreview node renders a visual overlay of the conditioning areas on a blank canvas, useful for debugging region layout before generation. - English README documents areas_out: what it outputs, how to use it, and its integration with ComfyUI-OpenPose-Studio for automatic pose alignment. - All localized READMEs (de, es, fr, ja, ko, pt, ru, zh, zh-TW) updated to match the English documentation for areas_out. - Version bumped to 1.1.0 in pyproject.toml. - AGENTS.md version-tagging rules synced.
1 parent 8b66a51 commit 3ff6fbe

14 files changed

Lines changed: 312 additions & 19 deletions

AGENTS.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@ Operational Rules for AI Coding Agents
2424
## Version Tagging
2525

2626
- When a commit bumps the version in `pyproject.toml`, create and push the matching Git tag targeting that exact commit before doing anything else.
27-
- The tag name must exactly match the version string in `pyproject.toml` (e.g., `1.0.0`, `1.0.1`, `1.2.3`). No `v` prefix, no other format.
27+
- The tag name must exactly match the version string in `pyproject.toml` (e.g., `1.0.0`, `1.0.1`, `1.2.3`). **No `v` prefix, no other format.** This repo uses plain numeric tags only (e.g., `1.2.0`, never `v1.2.0`).
28+
- Before creating a release tag, inspect the existing tags in the repo (`git tag --list`) to confirm the naming convention in use. For this repo the required format is always plain numeric (e.g., `1.2.0`).
29+
- The README version badge (`shields.io github/v/tag`) may render the tag with a `v` prefix (e.g., display `v1.2.0`) even when the actual Git tag is `1.2.0`. This is normal shields.io display behaviour — do **not** create a `v`-prefixed tag to match the badge display.
2830
- Do not create GitHub releases unless explicitly requested.
2931
- Never move, overwrite, recreate, or retag an existing version tag to point to a different commit.
3032
- Each version tag is immutable: it must permanently point to the commit where that version was published.

docs/README.de.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@ Kombinieren Sie globale positive/negative Konditionierung mit der Bereichspipeli
124124
**Ausgaben:**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
128+
129+
**Details zu `areas_out`:**
130+
131+
`areas_out` gibt die Liste der konfigurierten Bereichsregionen als strukturierte Datenausgabe aus. Jeder Eintrag enthält die normalisierten Koordinaten (`x`, `y`, `width`, `height`) und `strength`, die über `Conditioning Pipeline (Set Area)` in der Pipeline definiert wurden. Verbinden Sie `areas_out` mit [ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio), um Ihre Konditionierungsbereiche automatisch in den OpenPose-Editor zu spiegeln — die Pose-Platzierung wird sich an den genau konditionierten Regionen ausrichten. Dieser Ausgang kann auch von anderen Erweiterungen oder Knoten verwendet werden, die Bereichsmetadaten für die Maskengenerierung oder bereichsbewusste nachgelagerte Verarbeitung akzeptieren.
127132

128133
**Hinweise zum Verhalten:**
129-
- Wenn die Pipeline leer/ungültig ist, greifen die Ausgaben auf die globalen Eingaben zurück.
134+
- Wenn die Pipeline leer/ungültig ist, greifen die Ausgaben auf die globalen Eingaben zurück, und `areas_out` ist eine leere Liste.
130135
- Wendet regionale Einträge an und anschließend einen Standard-Kombinationsdurchgang für nicht abgedeckte Regionen.
131136
- `global_strength` steuert, wie stark der globale Kontext mit lokalen Bereichen konkurriert.
132137
- Wenn Sie global_strength zu hoch einstellen, kann dies den Einfluss der bereichsspezifischen Konditionierung verringern und sich negativ auf die Bildqualität auswirken.

docs/README.es.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@ Combinar el condicionamiento global positivo/negativo con el pipeline del área
124124
**Salidas:**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
128+
129+
**Detalles de `areas_out`:**
130+
131+
`areas_out` expone la lista de regiones de área configuradas como una salida de datos estructurada. Cada entrada contiene las coordenadas normalizadas (`x`, `y`, `width`, `height`) y `strength` que se definieron en la canalización mediante `Conditioning Pipeline (Set Area)`. Conecte `areas_out` a [ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio) para reflejar automáticamente sus áreas de condicionamiento en el editor de OpenPose — la colocación de poses se alineará con las regiones exactas que condicionó. Esta salida también puede ser consumida por cualquier otra extensión o nodo que acepte metadatos de área para generación de máscaras o procesamiento posterior consciente de regiones.
127132

128133
**Notas de comportamiento:**
129-
- Si la canalización está vacía o no es válida, las salidas vuelven a las entradas globales.
134+
- Si la canalización está vacía o no es válida, las salidas vuelven a las entradas globales y `areas_out` es una lista vacía.
130135
- Aplica entradas regionales, luego un pase combinado predeterminado para regiones no cubiertas.
131136
- `global_strength` controla la fuerza con la que el contexto global compite con las áreas locales.
132137
- Presionar global_strength demasiado alto puede reducir la influencia del acondicionamiento por área y afectar negativamente la calidad de la imagen.

docs/README.fr.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@ Combinez le conditionnement global positif/négatif avec le pipeline régional p
124124
**Sorties :**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
127128

128-
**Remarques sur le comportement :**
129-
- Si le pipeline est vide/invalide, les sorties reviennent aux entrées globales.
129+
**Détails sur `areas_out` :**
130+
131+
`areas_out` expose la liste des régions de zone configurées sous forme de sortie de données structurées. Chaque entrée contient les coordonnées normalisées (`x`, `y`, `width`, `height`) et `strength` définies dans le pipeline via `Conditioning Pipeline (Set Area)`. Connectez `areas_out` à [ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio) pour refléter automatiquement vos zones de conditionnement dans l'éditeur OpenPose — le placement des poses s'alignera sur les régions exactes que vous avez conditionnées. Cette sortie peut également être consommée par toute autre extension ou nœud acceptant des métadonnées de zone pour la génération de masques ou le traitement en aval sensible aux régions.
132+
133+
**Remarques sur le comportement :**
134+
- Si le pipeline est vide/invalide, les sorties reviennent aux entrées globales et `areas_out` est une liste vide.
130135
- Applique les entrées régionales, puis une passe de combinaison par défaut pour les régions non couvertes.
131136
- `global_strength` contrôle la mesure dans laquelle le contexte mondial entre en concurrence avec les zones locales.
132137
- Pousser global_strength trop haut peut réduire l'influence du conditionnement par zone et avoir un impact négatif sur la qualité de l'image.

docs/README.ja.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@
124124
**出力:**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
128+
129+
**`areas_out` の詳細:**
130+
131+
`areas_out` は、設定されたエリア領域のリストを構造化データ出力として公開します。各エントリには、`Conditioning Pipeline (Set Area)` を通じてパイプラインで定義された正規化座標(`x``y``width``height`)と `strength` が含まれています。`areas_out`[ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio) に接続すると、コンディショニングエリアを OpenPose エディターに自動的にミラーリングできます。ポーズの配置は、コンディショニングした正確な領域に合わせて整列されます。この出力は、マスク生成や領域認識型のダウンストリーム処理のためにエリアメタデータを受け入れる他の拡張機能やノードでも使用できます。
127132

128133
**行動メモ:**
129-
- パイプラインが空または無効な場合、出力はグローバル入力にフォールバックします
134+
- パイプラインが空または無効な場合、出力はグローバル入力にフォールバックし、`areas_out` は空のリストになります
130135
- 地域エントリを適用してから、カバーされていない地域のデフォルトの結合パスを適用します。
131136
- `global_strength` は、グローバル コンテキストがローカル エリアとどの程度競合するかを制御します。
132137
- global_strength を高くしすぎると、エリアごとのコンディショニングの影響が減少し、画質に悪影響を及ぼす可能性があります。

docs/README.ko.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@ ComfyUI에 대한 영역 기반 LoRA 조절 래퍼 및 LoRA 예약 노드.
124124
**출력:**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
128+
129+
**`areas_out` 세부사항:**
130+
131+
`areas_out`은 구성된 영역 목록을 구조화된 데이터 출력으로 노출합니다. 각 항목에는 `Conditioning Pipeline (Set Area)`를 통해 파이프라인에서 정의된 정규화된 좌표(`x`, `y`, `width`, `height`)와 `strength`가 포함됩니다. `areas_out`[ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio)에 연결하면 조건화 영역을 OpenPose 편집기에 자동으로 미러링할 수 있습니다. 포즈 배치는 조건화한 정확한 영역에 맞게 정렬됩니다. 이 출력은 마스크 생성 또는 영역 인식 다운스트림 처리를 위한 영역 메타데이터를 허용하는 다른 확장 또는 노드에서도 사용할 수 있습니다.
127132

128133
**행동 참고사항:**
129-
- 파이프라인이 비어 있거나 유효하지 않은 경우 출력은 전역 입력으로 대체됩니다.
134+
- 파이프라인이 비어 있거나 유효하지 않은 경우 출력은 전역 입력으로 대체되고 `areas_out`은 빈 목록이 됩니다.
130135
- 지역 항목을 적용한 다음, 발견되지 않은 지역에 대한 기본 통합 패스를 적용합니다.
131136
- `global_strength`은 글로벌 컨텍스트가 로컬 영역과 얼마나 강력하게 경쟁하는지 제어합니다.
132137
- global_strength을(를) 너무 높이면 영역별 조정 영향이 줄어들고 이미지 품질에 부정적인 영향을 미칠 수 있습니다.

docs/README.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@ Combine global positive/negative conditioning with the area pipeline for region-
124124
**Outputs:**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
128+
129+
**`areas_out` details:**
130+
131+
`areas_out` exposes the list of configured area regions as a structured data output. Each entry contains the normalized coordinates (`x`, `y`, `width`, `height`) and `strength` that were defined in the pipeline via `Conditioning Pipeline (Set Area)`. Connect `areas_out` to [ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio) to automatically mirror your conditioning areas into the OpenPose editor — pose placement will align with the exact regions you conditioned. This output can also be consumed by any other extension or node that accepts area metadata for mask generation or region-aware downstream processing.
127132

128133
**Behavior notes:**
129-
- If the pipeline is empty/invalid, outputs fall back to the global inputs.
134+
- If the pipeline is empty/invalid, outputs fall back to the global inputs and `areas_out` is an empty list.
130135
- Applies regional entries, then a default combine pass for uncovered regions.
131136
- `global_strength` controls how strongly global context competes with local areas.
132137
- Pushing global_strength too high can reduce per-area conditioning influence and negatively impact image quality.

docs/README.pt.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@ Combine o condicionamento positivo/negativo global com o pipeline de área para
124124
**Saídas:**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
128+
129+
**Detalhes sobre `areas_out`:**
130+
131+
`areas_out` expõe a lista de regiões de área configuradas como uma saída de dados estruturada. Cada entrada contém as coordenadas normalizadas (`x`, `y`, `width`, `height`) e `strength` definidas no pipeline via `Conditioning Pipeline (Set Area)`. Conecte `areas_out` ao [ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio) para espelhar automaticamente suas áreas de condicionamento no editor OpenPose — o posicionamento das poses se alinhará com as regiões exatas que você condicionou. Esta saída também pode ser consumida por qualquer outra extensão ou nó que aceite metadados de área para geração de máscaras ou processamento posterior com reconhecimento de região.
127132

128133
**Notas de comportamento:**
129-
- Se o pipeline estiver vazio/inválido, as saídas voltam para as entradas globais.
134+
- Se o pipeline estiver vazio/inválido, as saídas voltam para as entradas globais e `areas_out` é uma lista vazia.
130135
- Aplica entradas regionais e, em seguida, um passe combinado padrão para regiões descobertas.
131136
- `global_strength` controla a intensidade com que o contexto global compete com as áreas locais.
132137
- Pressionar global_strength muito alto pode reduzir a influência do condicionamento por área e impactar negativamente a qualidade da imagem.

docs/README.ru.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,14 @@
124124
**Выходы:**
125125
- `positive_out` (`CONDITIONING`)
126126
- `negative_out` (`CONDITIONING`)
127+
- `areas_out` (`CONDITIONING_AREAS`)
128+
129+
**Подробности об `areas_out`:**
130+
131+
`areas_out` предоставляет список настроенных областных регионов в виде структурированных выходных данных. Каждая запись содержит нормализованные координаты (`x`, `y`, `width`, `height`) и `strength`, определённые в конвейере через `Conditioning Pipeline (Set Area)`. Подключите `areas_out` к [ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio), чтобы автоматически отобразить ваши области обусловливания в редакторе OpenPose — расположение поз будет совпадать с теми самыми регионами, которые вы обусловили. Этот выход также может быть использован любым другим расширением или узлом, принимающим метаданные областей для генерации масок или регионально-ориентированной нисходящей обработки.
127132

128133
**Примечания к поведению:**
129-
- Если конвейер пуст/недействителен, выходные данные возвращаются к глобальным входам.
134+
- Если конвейер пуст/недействителен, выходные данные возвращаются к глобальным входам, а `areas_out` является пустым списком.
130135
- Применяет региональные записи, а затем комбинированный проход по умолчанию для непокрытых регионов.
131136
- `global_strength` контролирует, насколько сильно глобальный контекст конкурирует с локальными областями.
132137
- Слишком высокое значение global_strength может уменьшить влияние обработки каждой области и отрицательно повлиять на качество изображения.

docs/README.zh-TW.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,9 +125,14 @@
125125
**輸出:**
126126
- `positive_out` (`CONDITIONING`)
127127
- `negative_out` (`CONDITIONING`)
128+
- `areas_out` (`CONDITIONING_AREAS`)
129+
130+
**`areas_out` 詳情:**
131+
132+
`areas_out` 將已配置的區域清單作為結構化資料輸出公開。每個條目包含透過 `Conditioning Pipeline (Set Area)` 在管道中定義的歸一化座標(`x``y``width``height`)和 `strength`。將 `areas_out` 連接到 [ComfyUI-OpenPose-Studio](https://github.com/andreszs/comfyui-openpose-studio),即可將您的調節區域自動鏡像到 OpenPose 編輯器中——姿態放置將與您調節的確切區域對齊。此輸出也可被接受區域元資料的任何其他擴充功能或節點使用,用於遮罩生成或區域感知的下游處理。
128133

129134
**行為注意事項:**
130-
- 如果管道為空/無效,輸出將回落到全域輸入。
135+
- 如果管道為空/無效,輸出將回落到全域輸入,且 `areas_out` 為空清單
131136
- 套用區域條目,然後對未覆蓋區域套用預設組合通道。
132137
- `global_strength` 控制全球背景與局部區域競爭的強度。
133138
- 將 global_strength 推得太高會減少每個區域的調節效果並對影像品質產生負面影響。

0 commit comments

Comments
 (0)