Blur Visualization¶
Class: BlurVisualizationBlockV1
Source: inference.core.workflows.core_steps.visualizations.blur.v1.BlurVisualizationBlockV1
Apply blur effects to detected objects in an image, obscuring their details while preserving the background, useful for privacy protection, content filtering, or visual emphasis.
How This Block Works¶
This block takes an image and detection predictions and applies a blur effect to the detected objects, leaving the background unchanged. The block:
- Takes an image and predictions as input
- Identifies detected regions from bounding boxes or segmentation masks
- Applies a blur effect (using average pooling) to the detected object regions
- Preserves the background and areas outside detected objects unchanged
- Returns an annotated image where detected objects are blurred, while the rest of the image remains sharp
The block works with both object detection predictions (using bounding boxes) and instance segmentation predictions (using masks). When masks are available, it blurs the exact shape of detected objects; otherwise, it blurs rectangular bounding box regions. The blur intensity is controlled by the kernel size parameter, where larger kernel sizes create stronger blur effects. This creates a visual effect that obscures or anonymizes detected objects while maintaining context from the surrounding image, making it ideal for privacy protection, content filtering, or focusing attention on the background.
Common Use Cases¶
- Privacy Protection and Anonymization: Blur faces, people, license plates, or other sensitive information in images or videos to protect privacy, comply with data protection regulations, or anonymize content before sharing or publishing
- Content Filtering and Moderation: Obscure inappropriate or sensitive content in images or videos for content moderation workflows, safe content previews, or user-generated content filtering
- Visual Emphasis and Focus: Blur detected objects to draw attention to other parts of the image, create visual contrast between blurred foreground objects and sharp backgrounds, or emphasize specific elements in composition
- Product Photography and E-commerce: Blur detected distracting elements or secondary products in images to keep the main subject sharp and prominent for product photography, catalog creation, or e-commerce image preparation
- Security and Surveillance: Anonymize people, vehicles, or other identifiable elements in security footage or surveillance images while preserving scene context for analysis, reporting, or public sharing
- Documentation and Reporting: Create anonymized or censored versions of images for reports, documentation, or case studies where sensitive information needs to be obscured but overall context should remain visible
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 blurred objects for comprehensive visualization or to indicate what was blurred
- Data storage blocks (e.g., Local File Sink, CSV Formatter, Roboflow Dataset Upload) to save blurred images for documentation, reporting, or archiving privacy-protected content
- Webhook blocks to send blurred images to external systems, APIs, or web applications for content moderation, privacy-compliant sharing, or anonymized analysis
- Notification blocks (e.g., Email Notification, Slack Notification) to send blurred images as privacy-protected visual evidence in alerts or reports
- Video output blocks to create annotated video streams or recordings with blurred objects for live monitoring, privacy-compliant video processing, or post-processing analysis
Type identifier¶
Use the following identifier in step "type" field: roboflow_core/blur_visualization@v1to add the block as
as step in your workflow.
Properties¶
| Name | Type | Description | Refs |
|---|---|---|---|
name |
str |
Enter a unique identifier for this step.. | โ |
copy_image |
bool |
Enable this option to create a copy of the input image for visualization, preserving the original. Use this when stacking multiple visualizations.. | โ |
kernel_size |
int |
Size of the blur kernel used for average pooling. Larger values create stronger blur effects, making objects more obscured. Smaller values create subtle blur effects. Typical values range from 5 (light blur) to 51 (strong blur). Must be an odd number for optimal blurring performance.. | โ |
The Refs column marks possibility to parametrise the property with dynamic values available
in workflow runtime. See Bindings for more info.
Available Connections¶
Compatible Blocks
Check what blocks you can connect to Blur Visualization in version v1.
- inputs:
Detections Stitch,Detections Stabilizer,Roboflow Dataset Upload,Line Counter Visualization,Stability AI Outpainting,Email Notification,Object Detection Model,Mask Edge Snap,Image Slicer,OCR Model,Gaze Detection,Google Vision OCR,Identify Outliers,Image Preprocessing,Instance Segmentation Model,Distance Measurement,EasyOCR,Color Visualization,Detections Combine,Object Detection Model,SAM2 Video Tracker,Detection Event Log,Ellipse Visualization,Polygon Visualization,Byte Tracker,ByteTrack Tracker,Bounding Rectangle,Relative Static Crop,Byte Tracker,Detections Consensus,Detections Classes Replacement,Time in Zone,Webhook Sink,Model Comparison Visualization,Trace Visualization,Object Detection Model,Camera Focus,Roboflow Custom Metadata,YOLO-World Model,Detection Offset,SAM 3,Instance Segmentation Model,VLM As Classifier,Detections List Roll-Up,Image Threshold,Template Matching,Mask Area Measurement,Stitch Images,Heatmap Visualization,SORT Tracker,SIFT Comparison,Morphological Transformation,Halo Visualization,Detections Transformation,Instance Segmentation Model,Crop Visualization,Camera Calibration,Path Deviation,Time in Zone,Dot Visualization,OC-SORT Tracker,S3 Sink,Path Deviation,SAM 3,Twilio SMS Notification,Seg Preview,Icon Visualization,Model Monitoring Inference Aggregator,Local File Sink,Roboflow Dataset Upload,Detections Filter,Dynamic Zone,Image Contours,VLM As Classifier,JSON Parser,Pixelate Visualization,Keypoint Detection Model,Line Counter,Twilio SMS/MMS Notification,Time in Zone,Polygon Zone Visualization,Pixel Color Count,Reference Path Visualization,Motion Detection,Blur Visualization,Background Subtraction,Text Display,VLM As Detector,Stability AI Image Generation,Detections Merge,Perspective Correction,Overlap Filter,Line Counter,Bounding Box Visualization,Velocity,Depth Estimation,Identify Changes,Classification Label Visualization,Image Slicer,Absolute Static Crop,Image Blur,Stability AI Inpainting,Byte Tracker,Polygon Visualization,Image Convert Grayscale,SAM 3,SIFT,Roboflow Vision Events,VLM As Detector,Label Visualization,Corner Visualization,Grid Visualization,Dynamic Crop,Contrast Equalization,Keypoint Visualization,Triangle Visualization,Per-Class Confidence Filter,Moondream2,Keypoint Detection Model,QR Code Generator,Halo Visualization,Circle Visualization,Camera Focus,Segment Anything 2 Model,Mask Visualization,Morphological Transformation,Keypoint Detection Model,Contrast Enhancement,Background Color Visualization,Email Notification,PTZ Tracking (ONVIF),Slack Notification,SIFT Comparison - outputs:
Roboflow Dataset Upload,Line Counter Visualization,Mask Edge Snap,OCR Model,Image Slicer,Gaze Detection,Qwen2.5-VL,Instance Segmentation Model,Color Visualization,Multi-Label Classification Model,Ellipse Visualization,Polygon Visualization,ByteTrack Tracker,Single-Label Classification Model,Relative Static Crop,Barcode Detection,Trace Visualization,Object Detection Model,Qwen 3.5 API,Camera Focus,OpenAI,Buffer,SAM 3,Image Threshold,Heatmap Visualization,SORT Tracker,Florence-2 Model,Halo Visualization,GLM-OCR,Dot Visualization,Semantic Segmentation Model,Seg Preview,Google Gemini,Roboflow Dataset Upload,Clip Comparison,VLM As Classifier,Pixelate Visualization,Twilio SMS/MMS Notification,Polygon Zone Visualization,Motion Detection,Blur Visualization,Background Subtraction,Text Display,Stability AI Image Generation,Perspective Correction,Anthropic Claude,Bounding Box Visualization,Depth Estimation,Stability AI Inpainting,Polygon Visualization,SmolVLM2,SIFT,Roboflow Vision Events,VLM As Detector,Google Gemini,Label Visualization,Qwen3.5-VL,Contrast Equalization,Triangle Visualization,Halo Visualization,Circle Visualization,Segment Anything 2 Model,Mask Visualization,Dominant Color,OpenAI,MoonshotAI Kimi,Llama 3.2 Vision,Email Notification,CLIP Embedding Model,Detections Stabilizer,Detections Stitch,Object Detection Model,Stability AI Outpainting,Google Gemma API,Google Vision OCR,Google Gemini,Image Preprocessing,EasyOCR,Object Detection Model,OpenAI,SAM2 Video Tracker,Byte Tracker,Anthropic Claude,Qwen3-VL,Model Comparison Visualization,YOLO-World Model,Instance Segmentation Model,Perception Encoder Embedding Model,Semantic Segmentation Model,Single-Label Classification Model,VLM As Classifier,Template Matching,Stitch Images,Qwen 3.6 API,SIFT Comparison,Morphological Transformation,Instance Segmentation Model,CogVLM,Crop Visualization,Florence-2 Model,Camera Calibration,Multi-Label Classification Model,Time in Zone,OC-SORT Tracker,SAM 3,QR Code Detection,Icon Visualization,Image Contours,Keypoint Detection Model,Reference Path Visualization,Anthropic Claude,Clip Comparison,VLM As Detector,LMM,Pixel Color Count,Multi-Label Classification Model,Image Slicer,Absolute Static Crop,Classification Label Visualization,Image Blur,Image Convert Grayscale,SAM 3,Single-Label Classification Model,OpenAI,Corner Visualization,Dynamic Crop,Keypoint Detection Model,Moondream2,Keypoint Visualization,Camera Focus,LMM For Classification,Morphological Transformation,Keypoint Detection Model,Contrast Enhancement,Background Color Visualization
Input and Output Bindings¶
The available connections depend on its binding kinds. Check what binding kinds
Blur Visualization in version v1 has.
Bindings
-
input
image(image): The image to visualize on..copy_image(boolean): Enable this option to create a copy of the input image for visualization, preserving the original. Use this when stacking multiple visualizations..predictions(Union[object_detection_prediction,rle_instance_segmentation_prediction,keypoint_detection_prediction,instance_segmentation_prediction]): Model predictions to visualize..kernel_size(integer): Size of the blur kernel used for average pooling. Larger values create stronger blur effects, making objects more obscured. Smaller values create subtle blur effects. Typical values range from 5 (light blur) to 51 (strong blur). Must be an odd number for optimal blurring performance..
-
output
image(image): Image in workflows.
Example JSON definition of step Blur Visualization in version v1
{
"name": "<your_step_name_here>",
"type": "roboflow_core/blur_visualization@v1",
"image": "$inputs.image",
"copy_image": true,
"predictions": "$steps.object_detection_model.predictions",
"kernel_size": 15
}