ComfyUI Node

⚡| Image Filter

A three-layer color grade in one node — Z-Image's answer to 'it's almost right'

By martin-rizzo·Created 8 months ago·Updated 7 days ago· 357
⚡| Image Filter
  • images
  • divider1
  • divider2
  • divider3
  • IMAGE
enable_auto_contrast
enable_effects
effect_1
effect_1_tweak0.0
effect_2
effect_2_tweak0.0
effect_3
effect_3_tweak0.0

Image Filter is the "finish the job" node in the Z-Image Power Nodes pack. Z-Image Turbo gets you 90% of the way in 8 steps, and this is for the other 10%: a compact color-grading box you drop between the decoder and the save/preview node. It stacks up to three filter layers with individual intensity controls, plus an optional auto-contrast pass that fixes washed-out output.

It's worth being clear about what it is not. It's not a photo editor, and it's not an upscaler - it's a handful of opinionated color/tone corrections tuned for the look that Z-Image tends to produce (a bit flat, occasionally washed out, especially at lower steps). If your pipeline already has a favorite post-processing chain (Color Match, Image Adjust, whatever), you probably don't need this. If you just want "slightly punchier and it's done," this is the one-button version.

How it works

The node runs each layer in sequence: pick an effect, nudge its tweak between −0.5 and 0.5 (0 is the author's stated baseline), and it applies. Then the next layer applies on top. The available effects are deliberately short: bw (black & white), color (color level), color_pop (punch up color), color_twist (hue twist), and contrast (brightness curve). There are also enable_auto_contrast and enable_effects master switches, so you can A/B your whole grade against the untouched image without rewiring anything.

The inputs that matter

  • images (IMAGE) - the decoded output, e.g. from AdvancedVAEDecoder or plain VAEDecode.
  • enable_effects (BOOL) - master bypass for the three layers.
  • enable_auto_contrast (BOOL) - automatic dynamic-range fix for washed-out tones. This one's the sleeper; it alone fixes a lot of low-step Z-Image flatness.
  • effect_1 / effect_2 / effect_3 (COMBO) - choose from the five effects above per layer.
  • effect_1_tweak / effect_2_tweak / effect_3_tweak (FLOAT, −0.5…0.5) - per-layer intensity. Zero is neutral, so "no tweak" just means "leave it at 0."

Output is a single IMAGE with all layers applied, in the same shape as the input batch.

Install

It ships in the Z-Image Power Nodes pack, so the routine is the same as every node in it:

cd ComfyUI/custom_nodes
git clone https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes

Restart ComfyUI (or ComfyUI Manager → "Z-Image Power Nodes"). No pip dependencies; pure ComfyUI.

Tips from real use

Layers compose, so the classic starter grade is contrast with a small positive tweak plus color_pop - it adds snap without going crunchy. Keep tweaks small; the range is −0.5 to 0.5 and it's genuinely sensitive past ±0.3. And use enable_auto_contrast as your first test before touching layers, because on many Z-Image outputs it does 80% of the work by itself. The one trap: it's sequential, not parallel - layer order changes the result, so if a grade looks muddy, reorder the layers before you start fighting individual tweaks.

Category⚡Z-Image/utils

Inputs (12)

NameTypeDefaultDescription
imagesIMAGE
enable_auto_contrastBOOLEANWhen enabled, automatically adjusts the dynamic range of the image to fix washed-out tones and optimize contrast boundaries.
enable_effectsBOOLEANWhen enabled, applies the color correction effects configured below. If disabled, all effect selections and adjustments are bypassed.
divider1ZIPN_SEPARATOR
effect_1COMBOThe first color correction effect to apply to the resulting image.
effect_1_tweakFLOAT0.0-0.5–0.5The fine-tuning control for the filter effect. Range is -0.5 to 0.5, with 0.0 as the ideal baseline balance.
divider2ZIPN_SEPARATOR
effect_2COMBOThe second color correction effect to apply to the resulting image.
effect_2_tweakFLOAT0.0-0.5–0.5The fine-tuning control for the filter effect. Range is -0.5 to 0.5, with 0.0 as the ideal baseline balance.
divider3ZIPN_SEPARATOR
effect_3COMBOThe third color correction effect to apply to the resulting image.
effect_3_tweakFLOAT0.0-0.5–0.5The fine-tuning control for the filter effect. Range is -0.5 to 0.5, with 0.0 as the ideal baseline balance.

Outputs (1)

NameTypeDescription
IMAGEIMAGEThe final filtered image.