SD Forge Attention Couple

This is an Extension for the Forge Webui, which allows you to generate couples target conditioning at different regions. No more color bleeds or mixed features!

This does not work with Automatic1111 Webui

As shown in the examples below, even if a region only contains 1 subject, it's usually still better to prompt for the total amount of subjects first.

How to Use

Lines Parsing

This Extension works by dividing the image into multiple tiles, each corresponding to one line in the prompt. So if you want more characters, just prompt more lines! Empty lines are skipped.

[high quality, best quality], 2girls, blonde twintails, cyan eyes, white dress, looking at viewer, smile, blush
2girls, white long hair, red eyes, black dress, looking at viewer, frown

[high quality, best quality], 3girls, blonde twintails, cyan eyes, white dress, looking at viewer, smile, blush
3girls, white long hair, red eyes, black dress, looking at viewer, frown
3girls, black ponytail, closed eyes, t-shirt, jeans, looking at viewer, sleepy

Tile Direction

Choose between dividing the image into columns or rows

• Horizontal: Tiles from left to right
• Vertical: Tiles from top to bottom

Direction:Vertical

[high quality, best quality], galaxy, stars, milky way
blue sky, clouds
sunrise, lens flare
ocean, waves
beach, sand
pavement, road

Global Effect

Set either the first line or the last line of the Positive prompts to affect the entire image instead of also being divided. Useful for specifying style, quality, or background, etc. (Negative prompt is always global regardless of settings.)

[high quality, best quality], (cinematic), 2girls, beach, summer, day, sky, (bloom, hdr)
2girls, white dress, standing, wind, floating hair, looking at viewer, smile, blush
2girls, frills swimsuit, sitting, chair, knees up, smile, blush

a cinematic photo of 2 men arguing, indoors, court room
2 men, jesus christ, white robe, looking at each other, shouting
2 men, santa claus, looking at each other, shouting

a pencil drawing of scenery
mountains
river
tree
forest

Couple Separator

By default, this Extension uses newline (\n) as the separator between tiles. You can also specify any keyword as the separator instead.

Separator:~BA DUM TSS~

masterpiece, white themed
heaven, clouds, bright, glowing
~BA DUM TSS~
illustration, red themed
hell, volcano, dark, dim

LoRA Support

Using multiple LoRAs also works to a degree, depending on how well each LoRA works together...

LoRA with multiple subjects works better in my experience.

2girls, nagase kotono, serafuku, looking at viewer, shy, blush, <lora:ktn:0.64>
2girls, kawasaki sakura, casual, looking at viewer, smile, blush, <lora:skr:0.64>
[high quality, best quality], 2girls, park, outdoors

[high quality, best quality], 2girls, on stage, backlighting, [bloom, hdr], <lora:suzurena:0.72>
2girls, miyama suzune, pink idol costume, feather hair ornament, holding hands, looking at viewer, smile, blush
2girls, hanaoi rena, blue idol costume, feather hair ornament, holding hands, looking at viewer, shy, blush

Advanced Mapping

Were these automated equally-sized tiles not sufficient for your needs? Now you can manually specify each regions! The mapping logic is the same: one line corresponds to one entry.

• Note:

  • You must have values in the entire mask
    • The simplest way would be adding a global entry
  • Rows with empty x column are ignored

• Entry:

  • Each row contains a range for x axis, a range for y axis, and a weight
  • The x and y columns are in the syntax of from:to
  • The range should be within 0.0 ~ 1.0, representing the percentage of the full width/height
    • eg. 0.0:1.0 would span across the entire axis
  • x axis is from left to right; y axis is from top to bottom

• Control:

  • Click the New Row button to append a new row at the end
  • Click the Default Mapping button to reset the mapping to defaults
  • Click on a row to select it; click on the same row again to deselect it
  • Click the 🆕 button above/below to insert a new row above/below the selected row
  • Click the ❌ button to delete the selected row

• Draggable Region:

  • When a row is selected, its corresponding region would be highlighted
  • Simply drag the box around to reposition the region
  • Use the edges / corners to resize the region

• Prompt Hint:

  • When hovering a row, it will show the corresponding prompt or if the prompt is missing
  • Only works when the positive prompt is not empty
  • Ctrl + Right Click on the table to toggle the display

• Background:

  • Click the 📂 button to load a image as the background of the mapping
    • eg. Load a preprocessed image for ControlNet
  • In img2img, you can also click the ⏏ button to load the current input image as the background
  • Click the ❌ button to revert back to the black background

a cinematic photo of a couple, from side, outdoors
couple photo, man, black tuxedo
couple photo, woman, white dress
wedding photo, holding flower bouquet together
sunset, golden hour, lens flare

API

For usage with API, please refer to the Wiki

---

TypeError: 'NoneType'

For people that get the following error:

RuntimeError: shape '[X, Y, 1]' is invalid for input of size Z
shape '[X, Y, 1]' is invalid for input of size Z
*** Error completing request
    ...
    Traceback (most recent call last):
        ...
        res = list(func(*args, **kwargs))
    TypeError: 'NoneType' object is not iterable

1. Go to Settings -> Optimizations, and enable Pad prompt/negative prompt
2. Set the Width and Height to multiple of 64

---

Special Thanks

• Credits to the original author, laksjdjf, whose original ComfyUI Node I used to port into Forge
• Example images were generated with Animagine XL V3.1 and juggernautXL v7
• Also check out arcusmaximus's alternative approach to draggable-box-ui