Image Convert
Flatten alpha, force RGB, or drop an Instagram filter
- images
- images
Image Convert is the node you reach for when an image is in the wrong shape for what's next. Not the wrong resolution - the wrong channel layout. A load-from-folder or a pipeline might hand you an RGBA image with an alpha channel, and the model or save node downstream either chokes on 4 channels or composites the transparency wrong. This node fixes that, and it's also the place Eclipse hides a handful of "Instagram filter" style presets if you're into that.
Three toggles, three jobs:
- to_rgb - force 3-channel RGB. When a node downstream insists on RGB, this is the blunt instrument that guarantees it.
- to_grayscale - drop to grayscale. Handy for line-art or mask-adjacent work, and for feeding something that genuinely wants single-channel input.
- composite_alpha + background_color - this is the one that earns its keep. Straight-alpha images are fine until you save them or composite them, at which point the transparent areas turn into black or garbage. Compositing the alpha onto a solid background (default
#000000, any hex works) flattens the transparency deterministically. It's the exact fix for "my PNG with transparency came out with a black box" - and the node's own changelog notes it replaced a plain remove-alpha toggle, because compositing onto a chosen color is what you actually wanted all along.
The style combo (default none) applies an Instagram-like filter preset. That's the pilgram library doing the work - and pilgram is the one dependency in this pack's requirements.txt that isn't already sitting in ComfyUI's stack, so if you get an import error, pip install pilgram is the fix. Honestly, the styles are a novelty next to the channel fixes. Use them for a quick mood pass if you like; the alpha compositing is the reason to keep the node around.
How it fits
This is classic plumbing in the KB's post-processing sense - deterministic, millisecond, no model runs. It slots in wherever formats fight: before a save node that's misreading alpha, before a detector that wants RGB, or as a guard when you're mixing loaders that return different channel counts. It also lands in the conversion-adjacent territory of "make the pipeline type-safe."
Installing
ComfyUI_Eclipse, r-vage's all-in-one pack. Manager β search ComfyUI_Eclipse, or:
cd ComfyUI/custom_nodes
git clone https://github.com/r-vage/ComfyUI_Eclipse
Restart; find it under Eclipse β Image β FX & Color. If the style filters error, install pilgram. The pack targets current ComfyUI (frontend 1.51.2+) and v4.0 removed legacy RvTools_v2 nodes, with a Migration Tool for old saves.
The one thing to remember: the toggles don't auto-arrange themselves. to_rgb and to_grayscale are independent booleans, so if you flip both, the later one in the chain wins - set the one you mean and leave the other off.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| images | IMAGE | β | |
| to_rgbopt | BOOLEAN | false | Convert to RGB (3 channels) |
| to_grayscaleopt | BOOLEAN | false | Convert to grayscale |
| composite_alphaopt | BOOLEAN | false | Composite transparency onto the background color |
| background_coloropt | STRING | #000000 | Background color used for alpha compositing (hex) |
| styleopt | COMBO | none | Instagram-like style filter to apply |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | β |