Nodes/ComfyUI-Apt_Preset/color_RadiaBrightGradient
ComfyUI Node

color_RadiaBrightGradient

A radial gradient / spotlight generator

By cardenluo·Created 2 years ago·Updated 18 days ago· 309
color_RadiaBrightGradient
  • image
  • radial_gradient_image
center_x0.50
center_y0.50
circle_radius0.20
center_bright1.50
edge_bright1.00
overlay_color#FFFFFF
center_alpha0.00
edge_alpha0.00
falloff_modelinear
soft_edgetrue

Same family as this pack's linear gradient tools (color_brightGradient, color_lineGradient_visual), but radial instead of straight-line. color_RadiaBrightGradient places a center point and a radius, and brightness - plus an optional color tint - falls off from center to edge. Depending on how you set the two brightness ends, that reads as a spotlight, a vignette, or a soft glow. It's under Apt_Preset/image/color_adjust.

Out of the box the defaults already give you a usable soft spotlight: center brighter than edge, small radius, soft-edged transition. Move circle_radius and the center position to frame it, and you're most of the way there without touching anything else.

How it works

center_x/center_y place the origin, circle_radius sets how far the effect reaches (as a fraction of the image), and brightness interpolates from center_bright at the origin to edge_bright at the radius boundary - falloff_mode shapes that interpolation as a straight ramp (linear) or an eased curve (ease_out, ease_in), and soft_edge feathers the transition at the radius boundary rather than cutting hard.

The inputs and outputs that matter

  • center_x / center_y (0-1, default 0.5/0.5) - dead center by default.
  • circle_radius (0-1, default 0.2) - a fraction of the image; small by default, so the effect starts tight.
  • center_bright (0-5, default 1.5) and edge_bright (0-5, default 1) - center brighter than edge out of the box, a spotlight look by default. Swap which is higher to invert it toward a vignette instead.
  • overlay_color (hex, default #FFFFFF) with center_alpha/edge_alpha (0-1, default 0) - same opt-in tint mechanism as the linear gradient nodes.
  • falloff_mode (linear / ease_out / ease_in) - the shape of the brightness curve from center to edge.
  • soft_edge (boolean, default true) - turn off for a hard-edged circle instead of a feathered one.
  • image in, radial_gradient_image out.

How to install it

Through ComfyUI Manager: search "ComfyUI-Apt_Preset", install, restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/cardenluo/ComfyUI-Apt_Preset.git

then run install.bat (Windows) or install requirements manually on Linux/Mac, and restart. No model downloads for this node.

Common issues & troubleshooting

Effect looks invisible or too small. circle_radius defaults to a small 0.2 fraction of the frame - push it up if the effect isn't reaching far enough.

Want a vignette instead of a spotlight. Set center_bright lower than edge_bright to invert the direction of the falloff.

Edges look harsh. Check soft_edge - it's true by default, so a hard edge means either you turned it off deliberately or circle_radius is large enough that the feathering is less noticeable relative to the image.

Need a live preview while dialing this in? color_RadiaGradient_visual has the exact same parameter set, flagged as an output node.

IMPORT FAILED on the pack. ComfyUI-Apt_Preset is large and updates often; users have reported import failures after some updates. Reinstall via Manager before assuming it's this node.

CategoryApt_Preset/image/color_adjust

Inputs (11)

NameTypeDefaultDescription
imageIMAGE
center_xFLOAT0.500–1
center_yFLOAT0.500–1
circle_radiusFLOAT0.200–1
center_brightFLOAT1.500–5
edge_brightFLOAT1.000–5
overlay_colorSTRING#FFFFFF
center_alphaFLOAT0.000–1
edge_alphaFLOAT0.000–1
falloff_modeCOMBOlinear3 options: linear, ease_out, ease_in
soft_edgeBOOLEANtrue

Outputs (1)

NameTypeDescription
radial_gradient_imageIMAGE