Nodes/ComfyUI_HBH-image_overlay/HBH Image Overlay Preview
ComfyUI Node

HBH Image Overlay Preview

An overlay node waiting for a type nobody ships

By wings6407·Created about a year ago·Updated about a year ago· 1
HBH Image Overlay Preview
  • base_image
  • overlay_image
  • overlay_state
  • IMAGE

HBH_ImageOverlayPreview is meant to be a lightweight "show me the composite" node for the pack. Here's the problem, and it's a real one: it demands an input of the custom type OVERLAY_STATE, and no node in this pack emits that type. Nothing in the repo returns OVERLAY_STATE - not the overlay node, not the pickers, nothing. As shipped, there is no way to feed this node unless some other installed pack defines a node that outputs OVERLAY_STATE. In practice, that means this one usually sits in your node list doing nothing.

If you do manage to supply a state object, here's what the code does with it: it reads position_x, position_y, scale, rotation, blend_mode and opacity out of the state, resizes the overlay by scale, rotates it, applies opacity via alpha, pastes it onto the base, and alpha-composites the two. Notice what's missing: the flip flags aren't part of the state at all, and blend_mode is read but never actually applied - the preview always just alpha-composites. So even with a producer, you get a subset of what HBH_ImageOverlay does, without the mask output.

My honest take: this looks like unfinished scaffolding for an interactive preview UI that was never wired up. If you're evaluating the pack, skip it. Use HBH_ImageOverlay instead - it takes plain IMAGE inputs and a JSON string you can actually produce, does the same paste with flips and blend modes on top, and gives you the mask. The only scenario where this node becomes relevant is if a future update (or another pack) starts providing OVERLAY_STATE, at which point it'd be the cheap live-preview option.

If you still want it installed for that day, the pack install is the usual:

cd ComfyUI/custom_nodes
git clone https://github.com/wings6407/ComfyUI_HBH-image_overlay

or via ComfyUI Manager (search ComfyUI_HBH-image_overlay), then restart. No requirements.txt, no models, nothing extra to download.

And the standing pack caveats apply: solo author, single commit, no community threads about any of this. When a node in a pack like this is missing its input type, that's not a fixable problem you'll find discussed - it's just how the pack shipped.

Categoryimage/preview

Inputs (3)

NameTypeDefaultDescription
base_imageIMAGE
overlay_imageIMAGE
overlay_stateOVERLAY_STATE

Outputs (1)

NameTypeDescription
IMAGEIMAGE