Ideogram 4 Quad Layout
One knob for the whole quad's geometry — stop typing the same six numbers everywhere
- layout
- width
- height
- frame_width
- frame_height
- gutter
- margin
Every node in this pack that cares about position takes the same six integers: width, height, frame_width, frame_height, gutter, margin. That's fine until you change the frame size, forget to update one of the four nodes that use it, and suddenly your keyframe, your split crops, and your release rectangles all disagree. Ideogram4QuadLayout is the fix: define the geometry once, and let every other node read the same values from it.
What it does
It's the single source of truth for quad geometry. Set the six numbers, and it outputs the raw ints - width, height, frame_width, frame_height, gutter, margin - which you wire straight into Ideogram4QuadKeyframe, Ideogram4QuadSplit, and Ideogram4QuadKeyframeRelease. Edit one node instead of four, and the whole workflow stays aligned.
It also emits a layout output, the pack's custom QUAD_LAYOUT object. That object carries the per-cell bounding boxes, computed in Ideogram 4's own coordinate space: 0–1000 on both axes, the same space the model expects for the bbox fields in its structured JSON prompts. That's the piece that lets the Prompt Builder place each frame's text into the correct panel without you hand-rolling coordinates.
The defaults are sensible
The out-of-box geometry is a 2656×1504 canvas holding four 1280×704 frames with a 32px gutter and 32px margin. All multiples of 16, which is what Ideogram 4 wants - its native resolutions run 256–2048px per axis in steps of 16, and a 2×2 of 1280px frames lands you in a comfortable spot for a wide storyboard aspect. If you change anything, keep the numbers on 16-step boundaries and make sure width ≥ 2×frame_width + gutter + 2×margin, or the math quietly fails to place cells.
Installing
cd ComfyUI/custom_nodes
git clone https://github.com/reality-comes/comfyui-ideogram4-quad-storyboard
Restart ComfyUI; the node appears under image/ideogram4 (ComfyUI Manager: search "Ideogram 4 Quad Storyboard"). No extra dependencies - the pack uses ComfyUI's bundled torch and comfy, and this node is pure integer plumbing on top of that.
How you actually use it
Wire the six int outputs into the keyframe, split, and release nodes. Wire the layout into the Prompt Builder. That's the whole job. It looks like a trivial pass-through node, and honestly it is - but it's the difference between a workflow that stays coherent when you tweak the canvas and one where you're chasing a one-pixel misalignment across four nodes at 2 a.m. Set it once, feed it everywhere, and treat it as the single place geometry lives.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| width | INT | 265616–16384 | — |
| height | INT | 150416–16384 | — |
| frame_width | INT | 128016–16384 | — |
| frame_height | INT | 70416–16384 | — |
| gutter | INT | 320–1024 | — |
| margin | INT | 320–1024 | — |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| layout | QUAD_LAYOUT | — |
| width | INT | — |
| height | INT | — |
| frame_width | INT | — |
| frame_height | INT | — |
| gutter | INT | — |
| margin | INT | — |