Reference Images

Reference Image Nodes allow you to influence the visual style or content of your generated scenes. They act as visual anchors, ensuring consistency across your video project.

Inspector Controls

When you select a Reference Image Node, the Inspector Panel on the right provides the following controls:

1. Generation Prompt

• Input: A text area to describe the image you want to generate.
• Linked Prompt: If you have connected a Text Node to this Reference Node, this area will show the linked content. You can click Detach to break the link and edit the prompt manually.

2. Output Settings

• Aspect Ratio: Choose the dimensions of the generated image (e.g., 16:9 Landscape, 9:16 Portrait, 1:1 Square).
• Resolution: Select the quality (1K, 2K, 4K).

3. Context Settings

• Global Context Source: A checkbox to mark this image as Global. When enabled, this image is automatically used as a reference for every other scene in the project (unless they opt-out). Use this for main characters or consistent environments.
• Use Project Global Context: A checkbox to determine if this image generation should respect other global text/images in the project.

4. Source Images

• If you want to create a variation of another image (Image-to-Image), you can connect up to 3 source images to this node. They will appear here with options to remove them.

5. Actions

• Regenerate / Cancel: Start or stop the image generation process.
• Delete Reference: Removes the node from the canvas.

Connecting to Scenes

To use a reference image in a video scene:

1. Drag from the Right (+) handle of the Reference Image Node.
2. Drop the connection onto the Left (+) handle of a Scene Node.
3. The scene will now use this image as a style/content guide.

Tip: You can also connect a Reference Image to another Reference Image Node to create variations or refine a style.