Nodes/ComfyUI-MaxedOut/Image and Mask Preview MXD
ComfyUI Node

Image and Mask Preview MXD

See your mask tinted over the image before you waste a sample

By Maxed-Out-99·Created about a year ago·Updated 21 days ago· 9
Image and Mask Preview MXD
  • image
  • mask
  • composite
mask_opacity1.00
mask_color255, 255, 255
pass_throughtrue

The classic inpainting failure isn't the generation - it's the mask. Too tight, too loose, shifted a few pixels, or sitting on the wrong side of the image. Image and Mask Preview MXD exists to catch that before you spend minutes of GPU time: it composites your mask over your image as a colored overlay and hands back a single IMAGE you can look at.

It does this without creating a node preview or saving a file - the pack description is explicit: "Return an image with a mask composited over it without creating a node preview." In older builds it doubled as a preview/save node, and that's what the pass_through toggle is about: it's flagged in the tooltip as a legacy option, kept for workflow compatibility. Ignore it; the node now always just returns the composite.

What you set

The three controls are the fun part because they're all cosmetic:

  • mask_opacity (0–1, default 1) - how strongly the color tint replaces the underlying image. Dial it to ~0.4 and you can see the image through the mask, which is the best way to spot a mask that's slightly off.
  • mask_color - the tint color, as RGB/RGBA CSV (255, 0, 0), hex (#ff0000), or a color name (red). White is the default; red reads better on most images.
  • pass_through - legacy, leave it on.

Plug in image and/or mask (either alone works - mask-only gives you the colored mask as a standalone image), and the composite output is ready for a Preview node.

Why you'll actually use it

Mask visualization is the difference between trusting the mask and knowing it. In regional pipelines - inpainting, outpainting, the mask-driven compositing the pack's Place Image by Mask MXD does - a bad mask propagates silent errors through every downstream node. A 30-second look at the overlay catches the inverted alpha, the offset mask, or the mask that was generated at a different resolution than the image (the node silently resizes masks to match the image, so a mismatch here is usually a workflow bug, not a crash - worth knowing).

Install

ComfyUI Manager, search Maxed Out, install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/Maxed-Out-99/ComfyUI-MaxedOut

The pack has no requirements.txt and downloads no models - pure Python. The node shows up under MXD/Image. It's a small thing, but it's the small thing you'll reach for every single time a mask feels wrong, and it beats routing your mask through a color-mat and blend chain to see the same thing.

CategoryMXD/Image

Inputs (5)

NameTypeDefaultDescription
mask_opacityFLOAT1.000–1
mask_colorSTRING255, 255, 255RGB/RGBA CSV, hex, or color name.
pass_throughBOOLEANtrueLegacy option. This node now always returns the composite without creating a preview.
imageoptIMAGE
maskoptMASK

Outputs (1)

NameTypeDescription
compositeIMAGE