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:
Local File Sink,Background Color Visualization,Overlap Filter,OCR Model,Bounding Box Visualization,Roboflow Dataset Upload,Gaze Detection,Polygon Zone Visualization,Line Counter Visualization,Path Deviation,Ellipse Visualization,Image Preprocessing,Triangle Visualization,Keypoint Detection Model,SAM 3,Instance Segmentation Model,SIFT Comparison,Segment Anything 2 Model,Absolute Static Crop,Detections Stitch,Camera Focus,Keypoint Detection Model,YOLO-World Model,Stability AI Outpainting,Heatmap Visualization,EasyOCR,Mask Visualization,Text Display,VLM As Detector,Detection Event Log,SORT Tracker,Image Slicer,Label Visualization,Stitch Images,OC-SORT Tracker,Time in Zone,Roboflow Custom Metadata,Image Contours,Time in Zone,PTZ Tracking (ONVIF),Email Notification,Blur Visualization,Icon Visualization,Stability AI Image Generation,Velocity,Detections Combine,SAM 3,Time in Zone,Image Convert Grayscale,Background Subtraction,QR Code Generator,Distance Measurement,Byte Tracker,Mask Area Measurement,Moondream2,Crop Visualization,Object Detection Model,Webhook Sink,Corner Visualization,SAM 3,Twilio SMS Notification,Detections Stabilizer,S3 Sink,Detection Offset,Line Counter,Byte Tracker,Polygon Visualization,Detections Transformation,Bounding Rectangle,Model Monitoring Inference Aggregator,SIFT,VLM As Classifier,Circle Visualization,Relative Static Crop,Polygon Visualization,Slack Notification,Byte Tracker,Trace Visualization,Camera Calibration,Camera Focus,Pixelate Visualization,Pixel Color Count,Identify Changes,Detections Filter,Object Detection Model,Stability AI Inpainting,Reference Path Visualization,Keypoint Visualization,Contrast Equalization,Twilio SMS/MMS Notification,Line Counter,Classification Label Visualization,Detections Merge,Dot Visualization,Identify Outliers,Color Visualization,Dynamic Crop,Halo Visualization,Dynamic Zone,Image Threshold,Detections Classes Replacement,Detections List Roll-Up,Perspective Correction,JSON Parser,Grid Visualization,Template Matching,Morphological Transformation,SIFT Comparison,Email Notification,Depth Estimation,VLM As Classifier,Image Slicer,Detections Consensus,Model Comparison Visualization,Instance Segmentation Model,Image Blur,ByteTrack Tracker,VLM As Detector,Seg Preview,Halo Visualization,Path Deviation,Roboflow Dataset Upload,Motion Detection,Google Vision OCR - outputs:
Background Color Visualization,OCR Model,Bounding Box Visualization,Roboflow Dataset Upload,Gaze Detection,Polygon Zone Visualization,Line Counter Visualization,Ellipse Visualization,Image Preprocessing,Triangle Visualization,Keypoint Detection Model,SAM 3,Instance Segmentation Model,Florence-2 Model,SIFT Comparison,Qwen3.5-VL,Segment Anything 2 Model,Absolute Static Crop,Llama 3.2 Vision,Detections Stitch,LMM,Camera Focus,Keypoint Detection Model,Clip Comparison,YOLO-World Model,Stability AI Outpainting,Anthropic Claude,EasyOCR,Heatmap Visualization,Mask Visualization,Text Display,VLM As Detector,SORT Tracker,Image Slicer,Label Visualization,Stitch Images,Barcode Detection,OC-SORT Tracker,Florence-2 Model,Image Contours,Time in Zone,OpenAI,Blur Visualization,SmolVLM2,Icon Visualization,Multi-Label Classification Model,Stability AI Image Generation,SAM 3,GLM-OCR,Anthropic Claude,Image Convert Grayscale,Perception Encoder Embedding Model,Google Gemini,Background Subtraction,Google Gemini,Multi-Label Classification Model,Moondream2,Crop Visualization,Qwen2.5-VL,Object Detection Model,Corner Visualization,OpenAI,SAM 3,Semantic Segmentation Model,Dominant Color,CogVLM,Detections Stabilizer,Polygon Visualization,Qwen3-VL,SIFT,VLM As Classifier,Single-Label Classification Model,Circle Visualization,Byte Tracker,Polygon Visualization,Relative Static Crop,Trace Visualization,Pixel Color Count,Camera Focus,Pixelate Visualization,Camera Calibration,OpenAI,LMM For Classification,Object Detection Model,Reference Path Visualization,Stability AI Inpainting,Keypoint Visualization,Contrast Equalization,Twilio SMS/MMS Notification,Classification Label Visualization,Dot Visualization,CLIP Embedding Model,Color Visualization,Dynamic Crop,Halo Visualization,Buffer,Anthropic Claude,Image Threshold,Perspective Correction,QR Code Detection,Template Matching,Morphological Transformation,Email Notification,Depth Estimation,VLM As Classifier,Single-Label Classification Model,Image Slicer,Model Comparison Visualization,Instance Segmentation Model,Image Blur,Google Gemini,Clip Comparison,VLM As Detector,Seg Preview,OpenAI,Halo Visualization,ByteTrack Tracker,Roboflow Dataset Upload,Motion Detection,Google Vision OCR
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[rle_instance_segmentation_prediction,keypoint_detection_prediction,instance_segmentation_prediction,object_detection_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
}