Nodes/Ideogram 4 Quad Storyboard/Ideogram 4 Quad Layout
ComfyUI Node

Ideogram 4 Quad Layout

One knob for the whole quad's geometry — stop typing the same six numbers everywhere

By reality-comes·Created 2 months ago·Updated 2 months ago· 1
Ideogram 4 Quad Layout
    • layout
    • width
    • height
    • frame_width
    • frame_height
    • gutter
    • margin
    width2656
    height1504
    frame_width1280
    frame_height704
    gutter32
    margin32

    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.

    Categoryimage/ideogram4

    Inputs (6)

    NameTypeDefaultDescription
    widthINT265616–16384
    heightINT150416–16384
    frame_widthINT128016–16384
    frame_heightINT70416–16384
    gutterINT320–1024
    marginINT320–1024

    Outputs (7)

    NameTypeDescription
    layoutQUAD_LAYOUT
    widthINT
    heightINT
    frame_widthINT
    frame_heightINT
    gutterINT
    marginINT