Color Visualization¶

Fill detected objects with solid colors using customizable color palettes, creating color-coded overlays that distinguish different objects or classes while preserving image details through opacity blending.

How This Block Works¶

This block takes an image and detection predictions and fills the detected object regions with solid colors. The block:

1. Takes an image and predictions as input
2. Identifies detected regions from bounding boxes or segmentation masks
3. Applies color styling based on the selected color palette, with colors assigned by class, index, or track ID
4. Fills detected object regions with solid colors using Supervision's ColorAnnotator
5. Blends the colored overlay with the original image based on the opacity setting
6. Returns an annotated image where detected objects are filled with colors, while the rest of the image remains unchanged

The block works with both object detection predictions (using bounding boxes) and instance segmentation predictions (using masks). When masks are available, it fills the exact shape of detected objects; otherwise, it fills rectangular bounding box regions. Colors are assigned from the selected palette based on the color axis setting (class, index, or track ID), allowing different objects or classes to be distinguished by color. The opacity parameter controls how transparent the color overlay is, allowing you to create effects ranging from subtle color tinting (low opacity) where original image details remain visible, to solid color fills (high opacity) that completely replace object appearance.

Common Use Cases¶

• Color-Coded Object Classification: Fill detected objects with different colors based on their class, category, or classification results to create intuitive color-coded visualizations for quick object identification and categorization
• Multi-Object Tracking Visualization: Color-code tracked objects with distinct colors based on their tracking IDs to visualize object trajectories, track persistence, or distinguish multiple tracked objects across frames
• Visual Category Distinction: Use different colors for different object categories or types (e.g., vehicles, people, products) to create clear visual distinctions in monitoring, surveillance, or inventory management workflows
• Mask-Based Segmentation Display: Fill segmented regions with colors to visualize instance segmentation results, highlight segmented objects, or create colored mask overlays for analysis or presentation
• Interactive Visualization and UI: Create color-coded visualizations for user interfaces, dashboards, or interactive applications where color-coding provides intuitive visual feedback or object grouping
• Presentation and Reporting: Generate color-filled visualizations for reports, documentation, or presentations where color-coding helps distinguish object types, highlight specific categories, or create visually appealing detection displays

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 combine color fills with additional annotations (labels, outlines) for comprehensive visualization
• Data storage blocks (e.g., Local File Sink, CSV Formatter, Roboflow Dataset Upload) to save color-coded images for documentation, reporting, or analysis
• Webhook blocks to send color-coded visualizations to external systems, APIs, or web applications for display in dashboards or monitoring tools
• Notification blocks (e.g., Email Notification, Slack Notification) to send color-coded images as visual evidence in alerts or reports
• Video output blocks to create color-coded video streams or recordings for live monitoring, tracking visualization, or post-processing analysis

Type identifier¶

Use the following identifier in step "type" field: roboflow_core/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 Color Visualization in version v1 has.

{
    "name": "<your_step_name_here>",
    "type": "roboflow_core/color_visualization@v1",
    "image": "$inputs.image",
    "copy_image": true,
    "predictions": "$steps.object_detection_model.predictions",
    "color_palette": "DEFAULT",
    "palette_size": 10,
    "custom_colors": [
        "#FF0000",
        "#00FF00",
        "#0000FF"
    ],
    "color_axis": "CLASS",
    "opacity": 0.5
}