Adjust Colors

This function block lets you fine-tune color balance by adding or subtracting bias to each RGB channel. Use it to correct white balance, emphasize a color tint, or tweak the overall color cast of an image in an intuitive way.

📥 Inputs (sockets)

Image Input socket Accepts any image (grayscale or color). Grayscale inputs are converted to color for per-channel adjustments.

📤 Outputs (sockets)

Image Any Output socket Returns the color-adjusted image with the modified RGB channels.

🕹️ Controls (widgets)

Red Bias Slider Adjusts the red channel bias. Move right to increase red, left to decrease red.

Green Bias Slider Adjusts the green channel bias. Move right to increase green, left to decrease green.

Blue Bias Slider Adjusts the blue channel bias. Move right to increase blue, left to decrease blue.

🎨 Features

• Per-channel bias sliders for quick and visible color correction.

• Accepts grayscale images and converts them to color so you can apply channel-wise adjustments.

• Works live with incoming images for immediate visual feedback.

⚙️ How it works (running mechanism)

When the block runs, it ensures the input is in color format, then adjusts each color channel independently according to the slider values. The resulting image is produced through a per-channel modification and emitted via the output socket so downstream blocks can use the adjusted image.

📝 Usage instructions

1. Connect an image-producing block to the Image input socket.

2. Move the Red Bias, Green Bias, and Blue Bias sliders until the image looks correct.

3. Use the output from this block as the input for visualization, saving, or further processing.

💡 Tips and Tricks

• Preview changes live by connecting the output to Show Image.

• For global contrast improvements before color tweaking, try Auto Contrast then feed its output into this block.

• If the image is very large, use Image Resizer first to speed up interactive adjustments.

• To inspect individual channels before/after adjustment, use Split Image and view channels separately; then Merge Channels if you need to reconstruct.

• Use Image ROI Select to crop a representative area (for example a gray card) and tune biases based on that region.

• Combine with Color Density Percentage to measure channel distributions and guide bias values quantitatively.

• To save results for documentation or dataset creation, follow this block with Image Logger or Image Write.

• If your scene has noise that affects color perception, add a Blur or Denoising block before adjusting colors.

🛠️ Troubleshooting

• If adjustments look too strong, reduce slider magnitudes or apply smaller tweaks and preview with Show Image.

• If input appears grayscale after adjusting, ensure the source is color or let the block convert grayscale to color (it will do this automatically).

• If results vary across the image, try adjusting on a cropped area using Image ROI Select and then apply the same settings globally.