Nodes/MachinePainting Nodes/πŸ‘Ύ Color Wheel View
ComfyUI Node

πŸ‘Ύ Color Wheel View

A vectorscope for your ComfyUI graph

By machinepaintingΒ·Created 10 months agoΒ·Updated 4 months agoΒ· 9
πŸ‘Ύ Color Wheel View
  • image
    β—„intensity1.0β–Ί
    β—„show_skin_linetrueβ–Ί
    β—„show_color_targetstrueβ–Ί

    Your phone's photo editor has a histogram. Professional colorists have a vectorscope - the circular display that shows, at a glance, which hues dominate your image and how saturated they are. Color Wheel View is exactly that, rendered in the node itself: feed it an image and it draws a color wheel showing your image's color distribution. It's a look-at-this node, not a process-this node, and it's the difference between guessing "is this too orange?" and seeing it.

    What you're actually looking at

    The node computes a vectorscope-style projection: each pixel's hue and saturation maps onto the wheel (hue = angle, saturation = distance from center), and the density of that mapping becomes brightness on the wheel. So:

    • A concentrated blob means your image is dominated by one hue family.
    • A bright blob near the rim means high saturation in that hue.
    • The distribution's symmetry (or lack of it) is your cast detector - skin-heavy shots pile up along the skin-tone line, and a heavy grade like teal-orange shows up as two lobes on opposite sides.

    The controls

    • intensity (0.2–3, default 1) - brightens or dims the density render. Crank it when a subtle palette is being lost in the noise floor.
    • show_skin_line (default on) - overlays the classic skin-tone line (the diagonal band colorists use to judge whether skin hues are correct). Probably the single most useful toggle for portrait work.
    • show_color_targets (default on) - overlays reference hue markers so you can judge how far your colors sit from pure primaries.

    There are no outputs - this is a terminal preview node (is_output_node), so it lives at the end of a chain that's about looking. Wire your image in, watch the wheel update, and use the insight to drive your grade. The usual pairing: run Color Wheel View next to Histogram View from the same pack (luminance + color distribution), tune with Curves Adjust Pro or Color Adjust Blend, and re-check.

    Install

    It's in the MachinePainting Nodes pack:

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

    or ComfyUI Manager β†’ "MachinePaintingNodes" β†’ install β†’ restart.

    Gotchas

    Because it's a preview node, it won't appear in batch outputs - check the node body in the UI rather than your output folder. And a common reading error: the wheel shows which hues dominate, not how much of each. For the "how much" you still want the histogram. Also, the density projection is normalized, so a slightly-off balance can look dramatic on the wheel - that's a feature, but don't panic-fix a cast the wheel is simply amplifying; cross-check against the image itself.

    CategoryMachinePaintingNodes/Analysis

    Inputs (4)

    NameTypeDefaultDescription
    imageIMAGEβ€”
    intensityoptFLOAT1.00.2–3β€”
    show_skin_lineoptBOOLEANtrueβ€”
    show_color_targetsoptBOOLEANtrueβ€”

    Outputs (0)

    No outputs