Nodes/Comfyroll Studio/🌁 CR Overlay Transparent Image
ComfyUI Node Runs on cloud

🌁 CR Overlay Transparent Image

Paste a PNG onto a background with scale, rotate and position

By Suzie1Β·Created 3 years agoΒ·Updated 2 years agoΒ· 1,287
🌁 CR Overlay Transparent Image
  • back_image
  • overlay_image
  • IMAGE
β—„transparency0.0β–Ί
β—„offset_x0β–Ί
β—„offset_y0β–Ί
β—„rotation_angle0.0β–Ί
β—„overlay_scale_factor1.000β–Ί

You've got a background and you want to drop something on top of it - a logo, a cut-out subject, a generated sticker with a transparent PNG behind it - and you'd rather not bounce out to Photoshop for a two-second paste. That's this node. It takes two images, lays the second one over the first, and gives you knobs for where it sits, how big it is, how much it's rotated, and how see-through it is.

The key word in the name is transparent: the overlay's own alpha channel is respected. Feed it a PNG with a proper cut-out (say, the output of a background-removal node) and only the subject lands on the background, not a rectangular box around it. Feed it a flat image with no alpha and you'll get the whole rectangle, which is usually not what you want.

How it works

It's a straight PIL-style compositing paste under the hood - no model, no sampling, no GPU cost worth mentioning. The overlay gets scaled, rotated, and positioned, then alpha-blended onto the back image. It runs in the blink of an eye and slots anywhere you're assembling a final frame: thumbnails, banners, meme panels, product mockups, watermark-style logo stamps.

The inputs that matter

  • back_image and overlay_image (both IMAGE) - the base and the thing you're pasting. Order matters; overlay goes on top.
  • overlay_scale_factor (default 1.0) - resize the overlay. 0.5 is half size, 2.0 is double. This is the one you'll fiddle with most, since your logo is rarely the right size out of the box.
  • offset_x / offset_y (INT, Β±4096) - move the overlay around in pixels. Positive x is right, positive y is down.
  • rotation_angle (FLOAT, Β±360) - tilt it.
  • transparency (FLOAT 0–1, default 0) - extra transparency added on top of the overlay's own alpha. Note the default of 0 means fully opaque here; crank it toward 1 to fade the overlay into the background, which is handy for a subtle watermark.

Output is a single IMAGE you wire into a save or preview node. There's also a show_help string on most Comfyroll nodes - it just links the wiki, ignore it.

Installing it

Comfyroll Studio is one of the big, old, well-worn utility packs (co-authored by Suzie1 and RockOfFire, ~200 nodes), so it's almost certainly one search away in ComfyUI Manager - look for "Comfyroll Studio," install, restart. Manual route:

cd ComfyUI/custom_nodes
git clone https://github.com/Suzie1/ComfyUI_Comfyroll_CustomNodes.git

then restart ComfyUI. There are no models to download and no heavy dependencies - it's pure Python image work, which is part of why this pack rarely causes the version-conflict headaches that plague chunkier node suites.

Common issues

The number-one gotcha isn't the node, it's your overlay: if the pasted image shows up with an ugly rectangle around it, your "transparent" image doesn't actually have an alpha channel. Run it through a proper background remover first, or make sure you're loading a real RGBA PNG.

Positioning is relative to the top-left, so a big overlay with offsets at 0 can hang off the edge - nudge offset_x/offset_y and scale until it sits where you want. If the whole pack fails to load on startup (you'll see "Comfyroll Studio: Failed to load Graphics nodes" with a Python traceback), that's a botched or partial install rather than this node - delete the folder and reinstall cleanly through Manager, make sure ComfyUI is current, and do a full restart.

Category🧩 Comfyroll Studio/πŸ‘Ύ Graphics/🌁 Layout

Inputs (7)

NameTypeDefaultDescription
back_imageIMAGEβ€”
overlay_imageIMAGEβ€”
transparencyFLOAT0.00–1β€”
offset_xINT0-4096–4096β€”
offset_yINT0-4096–4096β€”
rotation_angleFLOAT0.0-360–360β€”
overlay_scale_factorFLOAT1.0000–100β€”

Outputs (1)

NameTypeDescription
IMAGEIMAGEβ€”