Background Color Visualization¶

Apply a colored overlay to areas outside detected regions, effectively masking the background while preserving detected objects at their original appearance.

How This Block Works¶

This block takes an image and detection predictions and applies a colored overlay to all areas outside of the detected objects, leaving the detected regions unchanged. The block:

1. Takes an image and predictions as input
2. Creates a colored mask layer with the specified background color
3. Identifies detected regions from bounding boxes or segmentation masks (preserves detected objects)
4. Applies the colored overlay to all areas outside the detected regions with the specified opacity
5. Blends the colored overlay with the original image based on the opacity setting
6. Returns an annotated image where detected objects appear unchanged, while the background is filled with the specified color

The block works with both object detection predictions (using bounding boxes) and instance segmentation predictions (using masks). When masks are available, it preserves the exact shape of detected objects; otherwise, it uses bounding box regions. The opacity parameter controls how transparent or opaque the background overlay is, allowing you to create effects ranging from subtle background dimming (low opacity) to complete background replacement (high opacity). This creates a visual focus effect that highlights the detected objects by de-emphasizing or completely hiding the background.

Common Use Cases¶

• Object Focus and Highlighting: Highlight detected objects by dimming or replacing the background, making objects stand out for presentations, documentation, or user interfaces
• Background Removal Effects: Create images where backgrounds are replaced with solid colors or semi-transparent overlays for product photography, content creation, or design workflows
• Privacy and Anonymization: Mask backgrounds while preserving detected objects (e.g., people, vehicles) to anonymize images, protect privacy, or comply with data protection requirements
• Visual Debugging and Validation: Dim backgrounds to focus attention on detected regions when validating model performance, checking detection accuracy, or debugging detection results
• Presentation and Documentation: Create clean, professional visualizations for reports, presentations, or documentation where you want to emphasize detected objects without distracting backgrounds
• Content Creation and Editing: Prepare images for further processing, compositing, or editing by isolating detected objects with colored backgrounds for easier manipulation or integration into other workflows

Connecting to Other Blocks¶

The annotated image from this block can be connected to:

• Other visualization blocks (e.g., Label Visualization, Bounding Box Visualization, Polygon Visualization) to add additional annotations on top of the background-colored image for comprehensive visualization
• Data storage blocks (e.g., Local File Sink, CSV Formatter, Roboflow Dataset Upload) to save images with background coloring for documentation, reporting, or archiving
• Webhook blocks to send visualized results with background coloring to external systems, APIs, or web applications for display in dashboards or monitoring tools
• Notification blocks (e.g., Email Notification, Slack Notification) to send annotated images with background coloring as visual evidence in alerts or reports
• Video output blocks to create annotated video streams or recordings with background coloring for live monitoring, tracking visualization, or post-processing analysis

Type identifier¶

Use the following identifier in step "type" field: roboflow_core/background_color_visualization@v1to add the block as as step in your workflow.

Properties¶

The Refs column marks possibility to parametrise the property with dynamic values available in workflow runtime. See Bindings for more info.

Available Connections¶

Input and Output Bindings¶

The available connections depend on its binding kinds. Check what binding kinds Background Color Visualization in version v1 has.

{
    "name": "<your_step_name_here>",
    "type": "roboflow_core/background_color_visualization@v1",
    "image": "$inputs.image",
    "copy_image": true,
    "predictions": "$steps.object_detection_model.predictions",
    "color": "WHITE",
    "opacity": 0.5
}