Cubemap Preview

The CUBEMAP type is a black box in the ComfyUI graph - you can't see inside it, and neither can any node that isn't from this pack. Cubemap Preview is the window: it lays all six faces out into a single normal image you can look at, save, or pipe through anything that takes an IMAGE.

You'll use this constantly while debugging, because most things that go wrong with 360° depth are visible. Seams where two faces disagree, a face that came back upside down, a depth layer where the model clearly choked on one direction - all of it shows up the instant you actually look at the faces instead of the flattened result. The show_depth toggle is the killer feature here: flip it on and the node renders the depth layer (if there is one) instead of the RGB, so you can check the depth in isolation without running the whole Extract Depth Channel detour. If you've just done Batch Cubemap Depth, preview with show_depth on and you'll see exactly what's wrong before you convert.

The layout options are cosmetic but useful:

• cross (default) - the classic cubemap unfolding, faces around a central square. Best for spotting adjacent-face continuity.
• horizontal, vertical - the six faces in a row or column. Compact, good for a quick sanity check.
• grid - 2×3 or similar arrangement, nice for eyeballing all faces at equal size.

Inputs and outputs

• cubemap - any CUBEMAP from this pack.
• layout - cross, horizontal, vertical, or grid, default cross.
• show_depth - render depth instead of RGB, default off.

Output is a single IMAGE you can hook into any preview or save node.

How to install it

ComfyUI Manager, search "DreamCube", install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/cedarconnor/ComfyUI-DreamCube.git
cd ComfyUI-DreamCube
pip install -r requirements.txt

No models, no keys - it's just a NumPy layout job.

Gotchas

Faces that were never set render as black (or get skipped), so an all-black preview often means your cubemap was only partially populated - check with Cubemap Info before assuming the pack is broken. And don't mistake the cross layout for an equirectangular image; it's a diagnostic view, not an output format. For the actual panorama, convert with Cubemap to Equirect.