PixaromaHelp
Help › Nodes › Prompt & Text

Layout Boxes Pixaroma

Draw where things go in your picture, write what goes in each box, and FLUX.3 places them there. Works in the Classic and the Nodes 2.0 look.

In ComfyUI: double-click an empty spot on the canvas and type Layout Boxes Pixaroma.

How to use it

  • Set width and height to your picture size, or wire them from Sizes Pixaroma, so the canvas has the same shape as your latent.
  • Drag on the canvas to draw a box. The cursor jumps to its row: write what goes there, like a shiny red apple with a green leaf.
  • In your prompt, write <obj_1> for box 1, <obj_2> for box 2, and so on, like a still life with <obj_1> on the left and <obj_2> in the middle.
  • Wire elements into FLUX.3 Layout Prompt (element), with your prompt in its prompt, and its output into the text encode. Run.

Drawing the boxes

Draw
Drag on an empty part of the canvas.
Move
Drag a box. It stays inside the canvas.
Resize
Click a box to select it, then drag one of the eight white squares.
Order
The numbers follow the order you drew the boxes in. Draw the background parts first and the things in front last. In the big view, the arrows on a row move a box up or down the list, which changes its number.

Object or Text

Every box starts as an object (Obj). Click Obj to make it a Text box when it should hold exact words, like a shop sign, a book title or a poster headline. A text box gets a second field for the exact words, and its description says how they look (the lettering, the colour). The model is asked to write the words exactly as typed, so keep them short.

The canvas shape

The chip in the corner shows the size the canvas is drawn at. It follows width and height, or the size wired into them (Sizes Pixaroma and Resolution Pixaroma are read before you run). With a picture wired into background, the canvas takes the picture's shape instead.

Boxes are kept as parts of the canvas, not pixels, so changing the size keeps every box in its place. A yellow chip means a wired size can't be read before Run; the boxes are still right, the canvas just shows the node's own numbers until you run once.

What comes out

elements
Your boxes as prompt elements, the same form as ComfyUI's Create Bounding Boxes node. Wire it into FLUX.3 Layout Prompt. Build JSON Prompt (Ideogram) reads it too.
preview
A picture of your boxes with their numbers, over the background when one is wired.

The buttons on the node

Undo and Redo
Step back and forward through your boxes. Ctrl+Z on the canvas also undoes a box, like any change.
Clear
Removes every box. Undo brings them back.
Expand
Opens a big view for careful drawing. It edits the same boxes, so there is nothing to save: Done, Esc or a click outside closes it. There, Delete removes the selected box.
Gear
Settings: the button color.
× on a row
Deletes that one box. Hover a row to see which box it is.

Tips

  • Give each box one rich sentence: what it is, its colour and material. The prompt describes the whole scene and names each box by its tag.
  • Boxes may overlap. A later box (a higher number) is meant to be in front.
  • Leave a little room around each box: a box drawn tight on the edge of the canvas can crop the thing it holds.
  • Replacing Create Bounding Boxes in an existing workflow? Wire this node's elements where its elements went. The result is the same for the same boxes.

What you wire in

backgroundIMAGEoptional
Optional. A picture to draw your boxes over, for example the photo an edit model will change. The canvas then takes the picture's shape. From a Load Image it shows right away; from other nodes it shows after a run.

The settings on the node

widthnumberdefault 1024
The width of the picture you will make. With height it gives the canvas its shape. Wire the width of Sizes Pixaroma (or the node that sets your latent size) so they always match. Boxes stay in place when it changes.
heightnumberdefault 1024
The height of the picture you will make. Wire the height of Sizes Pixaroma so the canvas has the same shape as your latent.

This is the help that comes with Pixaroma 1.4.220. Inside ComfyUI, select the node and click the orange ? above it to read the same help there.