Nodes/IAMCCS-nodes/IAMCCS StoryboardFrame V2 + Image Canvas i2i
ComfyUI Node

IAMCCS StoryboardFrame V2 + Image Canvas i2i

A six-panel contact sheet prompt, with an actual image canvas for i2i

By IAMCCS·Created 11 months ago·Updated 7 days ago· 113
IAMCCS StoryboardFrame V2 + Image Canvas i2i
  • clip
  • source_image
  • IDEO_LINX
design_data{ "schema": "iamccs.ideogram_storyboard_frame_designer", "schema_version": 1, "preset_key": "storyboard", "workflow_mode": "storyboard_grid", "grid_key": "story_2x3", "target_resolution_key": "hd_720", "json_export_mode": "json_perfect", "brief_to_json": { "brief": "", "instruction": "Enhance the current Ideogram JSON without changing layout, bbox coordinates, visible text, or panel count." }, "gemma_assistant": { "enabled": false, "provider": "local_gemma", "mode": "full_json_enhance", "speed": "fast", "model": "text_encoders\\gemma4_e4b_it_fp8_scaled.safetensors", "selected_id": "", "target_field": "", "current_text": "", "brief": "", "request_ready": false }, "mask_paint": { "brush_size": 48, "strokes": [] }, "canvas": { "width": 2560, "height": 2160, "aspect_label": "1280 x 720 - HD 16:9 target / Storyboard 2x3 canvas 2560x2160", "target_resolution_key": "hd_720", "target_width": 1280, "target_height": 720 }, "scene": { "high_level_description": "A six-panel 2x3 cinematic storyboard contact sheet set on a frozen exoplanet, following one exhausted astronaut in a strange partly unsealed expedition suit crossing black ice plains, ruined research vehicles, and distant alien towers under two visible planets in the sky.", "aesthetics": "extremely photoreal live-action science fiction cinema, tactile frozen surfaces, strange worn astronaut suit, partly open asymmetric suit collar, visible inner thermal layers, practical space gear, believable human fatigue, cinematic continuity", "lighting": "cold blue planetary daylight, low amber rim light on ice crystals, breath vapor, long shadows, readable eyes, crisp silhouettes, clean subject separation in every panel", "photo": "35mm anamorphic film stills, varied shot scale, wide exoplanet landscape, tight medium portrait, top-down equipment detail, medium action frame, long telephoto silhouette, macro visor reflection, fine analog grain", "medium": "photograph", "art_style": "", "color_palette": [ "#06111A", "#557C8A", "#A8D8E8", "#E6E1C6", "#E87C45", "#07080A" ], "background": "Clean storyboard contact sheet with exactly two columns and three rows. Six separate 16:9 cinematic stills show different beats of the same frozen-planet sequence with thin panel borders, readable horizon lines, alien planets in the sky, and clear physical action." }, "i2i": { "enabled": false, "denoise": 0.28, "low_sigma_start_step": 12, "scheduler_hint": "Storyboard grid generation. Use AutoCropGrid with 2 columns and 3 rows.", "source_mode": "canvas_composite" }, "reference_mode": { "mode": "single", "label": "Single / Storyboard", "panel_count": 1, "target_index": 0, "locked_indices": [] }, "direct_prompt": { "enabled": false, "text": "" }, "json_override": { "enabled": false, "text": "" }, "items": [ { "id": "panel_01", "kind": "obj", "label": "Panel 1 - Ice Plain Arrival", "text": "", "x": 0, "y": 0, "w": 500, "h": 333, "desc": "ICE PLAIN ARRIVAL: wide establishing shot of a frozen exoplanet plain at sunrise, black ice road crossing toward ruined alien towers, one small astronaut figure walking alone, two planets hanging in the pale sky, long shadow, cold blue atmosphere.", "color_palette": [ "#557C8A", "#A8D8E8" ] }, { "id": "panel_02", "kind": "obj", "label": "Panel 2 - Broken Suit Collar", "text": "", "x": 500, "y": 0, "w": 500, "h": 333, "desc": "BROKEN SUIT COLLAR: tight medium portrait of the same exhausted astronaut pulling a frost-covered breathing scarf across the mouth, strange expedition suit partly unsealed at the collar, inner thermal fabric visible, breath vapor around focused eyes.", "color_palette": [ "#A8D8E8", "#E87C45" ] }, { "id": "panel_03", "kind": "obj", "label": "Panel 3 - Frozen Nav Module", "text": "", "x": 0, "y": 333, "w": 500, "h": 334, "desc": "FROZEN NAV MODULE: top-down close detail of a cracked wrist computer, circular oxygen gauge, folded star map, metal sample case, and frost crystals on white-blue ice, precise object clarity.", "color_palette": [ "#06111A", "#557C8A" ] }, { "id": "panel_04", "kind": "obj", "label": "Panel 4 - Rover Drag", "text": "", "x": 500, "y": 333, "w": 500, "h": 334, "desc": "ROVER DRAG: medium wide action frame of the astronaut dragging a broken rover battery sled across an ice trench, bent posture, boots cutting into snow crust, torn suit panels and loose cables moving in the wind.", "color_palette": [ "#557C8A", "#E6E1C6" ] }, { "id": "panel_05", "kind": "obj", "label": "Panel 5 - Footprints To Antenna", "text": "", "x": 0, "y": 667, "w": 500, "h": 333, "desc": "FOOTPRINTS TO ANTENNA: long telephoto silhouette of the astronaut walking along a frozen ridge toward a collapsed research antenna, clear footprints through powder snow, giant ringed planet low over the horizon.", "color_palette": [ "#A8D8E8", "#07080A" ] }, { "id": "panel_06", "kind": "obj", "label": "Panel 6 - Visor Planet Reflection", "text": "", "x": 500, "y": 667, "w": 500, "h": 333, "desc": "VISOR PLANET REFLECTION: extreme close-up of a cracked astronaut visor, twin planets and broken towers reflected in the glass, frost on eyelashes, skin dust, sweat, sharp helmet texture, cinematic macro detail.", "color_palette": [ "#07080A", "#A8D8E8" ] } ] }
ideoboard_input_signature
i2i_enabledfalse
i2i_denoise0.28
low_sigma_start_step12
ideoboard

IAMCCS_StoryboardFrameDesignerV2 is the upgraded storyboard node for Ideogram-style structured prompting: it turns a JSON design document - a full six-panel 2×3 cinematic contact sheet, with per-panel descriptions, colors, and layout - into the structured prompt that makes an Ideogram-class model render that sheet with text and layout intact. V2's new trick over the original is an Image Canvas i2i mode: instead of only producing a prompt, it can take an image canvas and run a low-denoise img2img pass over it so you can iterate on an existing board rather than regenerating from scratch.

Why structured JSON instead of just a prompt? Ideogram-class models are trained to respect a machine-readable layout - bbox coordinates, visible text, panel count - far better than a natural-language description. If you've ever watched an LLM-flavored prompt "put text in frame" and render gibberish, this is the discipline that fixes it: the model gets exact geometry, and the node keeps that geometry stable while you iterate on the content. (In this pack it feeds a larger Ideogram storyboard ecosystem; the IAMCCS_IdeoTranslate node produces these design packages, and this node consumes them.)

How it works

The design_data input is the editable working copy - a big JSON document holding the scene description, per-panel items (each with x, y, w, h, desc, and color_palette), the canvas size, and an i2i block. The optional ideoboard input can supply a newer design package; the ideoboard_input_signature guard exists so your manual canvas edits survive even while an IdeoTranslate input stays connected.

V2 adds the image side: i2i_enabled, i2i_denoise (default 0.28 - low, since you want to preserve the board and nudge details), and low_sigma_start_step (default 12, the step at which the low-sigma edit starts). Connect the optional source_image and V2 uses that IMAGE tensor directly as the i2i canvas guide instead of file-based layers. The output is a single IDEO_LINX - the pack's structured carrier that bundles the positive conditioning, the canvas image, i2i metadata, reference masks, and bounding boxes for the rest of the Ideogram generation chain (the scheduler hint in the design data even reminds you to use AutoCropGrid with 2 columns × 3 rows to crop the sheet back into panels).

Inputs and outputs

Required: clip, design_data (the JSON), ideoboard_input_signature, i2i_enabled, i2i_denoise, low_sigma_start_step. Optional: ideoboard, source_image. Output: IDEO_LINX.

Installing it

Part of the IAMCCS-nodes pack. ComfyUI Manager → search IAMCCS, or:

cd ComfyUI/custom_nodes
git clone https://github.com/IAMCCS/IAMCCS-nodes.git

Restart ComfyUI; it's under IAMCCS/Cine/Ideogram. No pip requirements. The optional "Gemma assistant" in the design JSON is a local gemma4 text-encoder model path - purely optional, and it only activates if you enable it. README floor: ComfyUI ≥ 0.3.0, Python ≥ 3.12, Torch ≥ 2.8.

Where people get burned

  • This node is one stage, not the whole pipeline. You still need the Ideogram-class model loaded, a CLIP to encode into, and the downstream grid-crop/decoding nodes. The IDEO_LINX output is designed for that chain - wiring it to a generic KSampler won't work as-is.
  • i2i_denoise at 0.28 is a nudge, not a rewrite. Crank it toward 1.0 and the canvas guide stops being a guide - you get a new board that merely rhymes with the old one.
  • Editing the JSON by hand is possible but easy to break; a malformed design_data silently falls back to defaults. Prefer the canvas UI if you're iterating, and treat direct JSON edits as an advanced move.
CategoryIAMCCS/Cine/Ideogram

Inputs (8)

NameTypeDefaultDescription
clipCLIP
design_dataSTRING{ "schema": "iamccs.ideogram_storyboard_frame_designer", "schema_version": 1, "preset_key": "storyboard", "workflow_mode": "storyboard_grid", "grid_key": "story_2x3", "target_resolution_key": "hd_720", "json_export_mode": "json_perfect", "brief_to_json": { "brief": "", "instruction": "Enhance the current Ideogram JSON without changing layout, bbox coordinates, visible text, or panel count." }, "gemma_assistant": { "enabled": false, "provider": "local_gemma", "mode": "full_json_enhance", "speed": "fast", "model": "text_encoders\\gemma4_e4b_it_fp8_scaled.safetensors", "selected_id": "", "target_field": "", "current_text": "", "brief": "", "request_ready": false }, "mask_paint": { "brush_size": 48, "strokes": [] }, "canvas": { "width": 2560, "height": 2160, "aspect_label": "1280 x 720 - HD 16:9 target / Storyboard 2x3 canvas 2560x2160", "target_resolution_key": "hd_720", "target_width": 1280, "target_height": 720 }, "scene": { "high_level_description": "A six-panel 2x3 cinematic storyboard contact sheet set on a frozen exoplanet, following one exhausted astronaut in a strange partly unsealed expedition suit crossing black ice plains, ruined research vehicles, and distant alien towers under two visible planets in the sky.", "aesthetics": "extremely photoreal live-action science fiction cinema, tactile frozen surfaces, strange worn astronaut suit, partly open asymmetric suit collar, visible inner thermal layers, practical space gear, believable human fatigue, cinematic continuity", "lighting": "cold blue planetary daylight, low amber rim light on ice crystals, breath vapor, long shadows, readable eyes, crisp silhouettes, clean subject separation in every panel", "photo": "35mm anamorphic film stills, varied shot scale, wide exoplanet landscape, tight medium portrait, top-down equipment detail, medium action frame, long telephoto silhouette, macro visor reflection, fine analog grain", "medium": "photograph", "art_style": "", "color_palette": [ "#06111A", "#557C8A", "#A8D8E8", "#E6E1C6", "#E87C45", "#07080A" ], "background": "Clean storyboard contact sheet with exactly two columns and three rows. Six separate 16:9 cinematic stills show different beats of the same frozen-planet sequence with thin panel borders, readable horizon lines, alien planets in the sky, and clear physical action." }, "i2i": { "enabled": false, "denoise": 0.28, "low_sigma_start_step": 12, "scheduler_hint": "Storyboard grid generation. Use AutoCropGrid with 2 columns and 3 rows.", "source_mode": "canvas_composite" }, "reference_mode": { "mode": "single", "label": "Single / Storyboard", "panel_count": 1, "target_index": 0, "locked_indices": [] }, "direct_prompt": { "enabled": false, "text": "" }, "json_override": { "enabled": false, "text": "" }, "items": [ { "id": "panel_01", "kind": "obj", "label": "Panel 1 - Ice Plain Arrival", "text": "", "x": 0, "y": 0, "w": 500, "h": 333, "desc": "ICE PLAIN ARRIVAL: wide establishing shot of a frozen exoplanet plain at sunrise, black ice road crossing toward ruined alien towers, one small astronaut figure walking alone, two planets hanging in the pale sky, long shadow, cold blue atmosphere.", "color_palette": [ "#557C8A", "#A8D8E8" ] }, { "id": "panel_02", "kind": "obj", "label": "Panel 2 - Broken Suit Collar", "text": "", "x": 500, "y": 0, "w": 500, "h": 333, "desc": "BROKEN SUIT COLLAR: tight medium portrait of the same exhausted astronaut pulling a frost-covered breathing scarf across the mouth, strange expedition suit partly unsealed at the collar, inner thermal fabric visible, breath vapor around focused eyes.", "color_palette": [ "#A8D8E8", "#E87C45" ] }, { "id": "panel_03", "kind": "obj", "label": "Panel 3 - Frozen Nav Module", "text": "", "x": 0, "y": 333, "w": 500, "h": 334, "desc": "FROZEN NAV MODULE: top-down close detail of a cracked wrist computer, circular oxygen gauge, folded star map, metal sample case, and frost crystals on white-blue ice, precise object clarity.", "color_palette": [ "#06111A", "#557C8A" ] }, { "id": "panel_04", "kind": "obj", "label": "Panel 4 - Rover Drag", "text": "", "x": 500, "y": 333, "w": 500, "h": 334, "desc": "ROVER DRAG: medium wide action frame of the astronaut dragging a broken rover battery sled across an ice trench, bent posture, boots cutting into snow crust, torn suit panels and loose cables moving in the wind.", "color_palette": [ "#557C8A", "#E6E1C6" ] }, { "id": "panel_05", "kind": "obj", "label": "Panel 5 - Footprints To Antenna", "text": "", "x": 0, "y": 667, "w": 500, "h": 333, "desc": "FOOTPRINTS TO ANTENNA: long telephoto silhouette of the astronaut walking along a frozen ridge toward a collapsed research antenna, clear footprints through powder snow, giant ringed planet low over the horizon.", "color_palette": [ "#A8D8E8", "#07080A" ] }, { "id": "panel_06", "kind": "obj", "label": "Panel 6 - Visor Planet Reflection", "text": "", "x": 500, "y": 667, "w": 500, "h": 333, "desc": "VISOR PLANET REFLECTION: extreme close-up of a cracked astronaut visor, twin planets and broken towers reflected in the glass, frost on eyelashes, skin dust, sweat, sharp helmet texture, cinematic macro detail.", "color_palette": [ "#07080A", "#A8D8E8" ] } ] }Editable working copy used by the IAMCCS StoryboardFrame canvas.
ideoboard_input_signatureSTRINGInternal guard that lets manual canvas edits survive while the same IdeoTranslate input remains connected.
i2i_enabledBOOLEANfalse
i2i_denoiseFLOAT0.280–1
low_sigma_start_stepINT120–1000
ideoboardoptSTRINGConnect IAMCCS_IdeoTranslate.design_data_json or an ideoboard package here.
source_imageoptIMAGEOptional direct image guide. When connected, V2 uses this IMAGE tensor as the i2i canvas guide instead of file-based image layers.

Outputs (1)

NameTypeDescription
IDEO_LINXIDEO_LINX