Pixelate Visualization¶
Class: PixelateVisualizationBlockV1
Source: inference.core.workflows.core_steps.visualizations.pixelate.v1.PixelateVisualizationBlockV1
Apply a pixelated mosaic effect to detected objects, creating a blocky, pixelated appearance that obscures object details while maintaining recognizable shapes, useful for privacy protection and content anonymization.
How This Block Works¶
This block takes an image and detection predictions and applies a pixelation (mosaic) 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
- Divides the detected object regions into square blocks (pixels) of the specified size
- Replaces each block with a single color value (typically the average color of that block), creating a mosaic-like pixelated effect
- Preserves the background and areas outside detected objects unchanged
- Returns an annotated image where detected objects are pixelated with blocky, mosaic appearance, 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 pixelates the exact shape of detected objects; otherwise, it pixelates rectangular bounding box regions. The pixel size parameter controls how large each square block is, where larger pixel sizes create more pronounced pixelation with fewer, larger blocks (more obscured), while smaller pixel sizes create finer pixelation with more, smaller blocks (less obscured). Unlike blur visualization (which creates smooth, gradient-like obscuration), pixelation creates distinct, blocky squares that maintain a more stylized, mosaic appearance while still effectively obscuring details.
Common Use Cases¶
- Privacy Protection and Anonymization: Pixelate 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, using the distinctive pixelated mosaic effect
- Content Filtering and Censorship: Obscure inappropriate or sensitive content in images or videos for content moderation workflows, safe content previews, or user-generated content filtering, where the pixelated effect provides clear visual indication that content has been processed
- Stylized Content Anonymization: Create pixelated effects for artistic or stylized content anonymization where the mosaic appearance is preferred over smooth blur, useful for creative projects, stylized presentations, or distinctive visual effects
- Visual Emphasis and Focus: Pixelate detected objects to draw attention to other parts of the image, create visual contrast between pixelated foreground objects and sharp backgrounds, or emphasize specific elements in composition with a distinctive visual style
- Security and Surveillance: Anonymize people, vehicles, or other identifiable elements in security footage or surveillance images while preserving scene context, using pixelation as an alternative to blur for a more stylized anonymization effect
- Documentation and Reporting: Create pixelated, anonymized versions of images for reports, documentation, or case studies where sensitive information needs to be obscured but overall context should remain visible, with a distinctive mosaic aesthetic
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 pixelated objects for comprehensive visualization or to indicate what was pixelated
- Data storage blocks (e.g., Local File Sink, CSV Formatter, Roboflow Dataset Upload) to save pixelated images for documentation, reporting, or archiving privacy-protected content
- Webhook blocks to send pixelated 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 pixelated images as privacy-protected visual evidence in alerts or reports
- Video output blocks to create annotated video streams or recordings with pixelated objects for live monitoring, privacy-compliant video processing, or post-processing analysis
Type identifier¶
Use the following identifier in step "type" field: roboflow_core/pixelate_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.. | โ |
pixel_size |
int |
Size of each square pixel block in the pixelated effect, measured in pixels. Controls the granularity of the pixelation: larger values create bigger, more blocky pixels with stronger obscuration (fewer blocks, more abstract appearance), while smaller values create finer, more detailed pixelation (more blocks, less obscured). Typical values range from 10 to 50 pixels, with 20 being a good default that balances obscuration with recognizable object shape.. | โ |
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 Pixelate Visualization in version v1.
- inputs:
Icon Visualization,Moondream2,Roboflow Dataset Upload,Slack Notification,Label Visualization,Instance Segmentation Model,Object Detection Model,Dot Visualization,Camera Calibration,Polygon Zone Visualization,SIFT,Trace Visualization,Detections Stitch,Time in Zone,Morphological Transformation,Perspective Correction,Roboflow Custom Metadata,Dynamic Zone,SAM 3,Instance Segmentation Model,Detections Combine,Relative Static Crop,Image Slicer,Image Threshold,Keypoint Visualization,PTZ Tracking (ONVIF),Overlap Filter,Template Matching,Absolute Static Crop,Path Deviation,Blur Visualization,Circle Visualization,Email Notification,Keypoint Detection Model,Camera Focus,Crop Visualization,Email Notification,Classification Label Visualization,EasyOCR,Detections Merge,SAM 3,Gaze Detection,Polygon Visualization,Identify Outliers,VLM As Classifier,Color Visualization,Local File Sink,Twilio SMS Notification,Byte Tracker,Line Counter,YOLO-World Model,Twilio SMS/MMS Notification,Image Contours,Model Monitoring Inference Aggregator,Mask Area Measurement,Keypoint Detection Model,Roboflow Vision Events,Path Deviation,Image Convert Grayscale,Detections Filter,Time in Zone,Distance Measurement,VLM As Detector,Instance Segmentation Model,JSON Parser,Time in Zone,Triangle Visualization,Stability AI Inpainting,Pixel Color Count,Background Color Visualization,Identify Changes,Depth Estimation,S3 Sink,Line Counter,Model Comparison Visualization,Image Blur,Stitch Images,Byte Tracker,SAM2 Video Tracker,Motion Detection,Contrast Equalization,Corner Visualization,Detections Classes Replacement,Velocity,Detections List Roll-Up,Halo Visualization,Stability AI Image Generation,Detections Consensus,Reference Path Visualization,Dynamic Crop,Line Counter Visualization,Detection Offset,SAM 3,SIFT Comparison,ByteTrack Tracker,Keypoint Detection Model,Roboflow Dataset Upload,Detections Stabilizer,Heatmap Visualization,Text Display,Byte Tracker,VLM As Classifier,VLM As Detector,Segment Anything 2 Model,Grid Visualization,Polygon Visualization,Camera Focus,Webhook Sink,Seg Preview,Detections Transformation,Image Slicer,Image Preprocessing,SIFT Comparison,Bounding Rectangle,SORT Tracker,Bounding Box Visualization,Stability AI Outpainting,Halo Visualization,OC-SORT Tracker,OCR Model,Background Subtraction,Detection Event Log,Object Detection Model,Object Detection Model,QR Code Generator,Pixelate Visualization,Ellipse Visualization,Google Vision OCR,Mask Visualization - outputs:
Icon Visualization,Moondream2,Instance Segmentation Model,Label Visualization,Multi-Label Classification Model,Dot Visualization,Camera Calibration,Trace Visualization,SAM 3,Time in Zone,Semantic Segmentation Model,Relative Static Crop,Image Threshold,Keypoint Visualization,Template Matching,Single-Label Classification Model,Blur Visualization,Circle Visualization,Keypoint Detection Model,Crop Visualization,Email Notification,Classification Label Visualization,OpenAI,Google Gemini,OpenAI,YOLO-World Model,Twilio SMS/MMS Notification,Keypoint Detection Model,Anthropic Claude,Google Gemini,Image Convert Grayscale,Stability AI Inpainting,Depth Estimation,Model Comparison Visualization,SAM2 Video Tracker,Motion Detection,Google Gemini,CLIP Embedding Model,Florence-2 Model,LMM,Dynamic Crop,SAM 3,Barcode Detection,Clip Comparison,Perception Encoder Embedding Model,Detections Stabilizer,Byte Tracker,VLM As Detector,Multi-Label Classification Model,Polygon Visualization,Mask Visualization,Semantic Segmentation Model,Seg Preview,Image Slicer,SORT Tracker,OC-SORT Tracker,OCR Model,Qwen3-VL,Object Detection Model,Object Detection Model,GLM-OCR,Roboflow Dataset Upload,Object Detection Model,Polygon Zone Visualization,Detections Stitch,SIFT,Morphological Transformation,Instance Segmentation Model,Perspective Correction,Anthropic Claude,Image Slicer,Absolute Static Crop,SmolVLM2,EasyOCR,Camera Focus,SAM 3,Gaze Detection,Polygon Visualization,OpenAI,VLM As Classifier,Color Visualization,Image Contours,Roboflow Vision Events,OpenAI,Single-Label Classification Model,Llama 3.2 Vision,VLM As Detector,Instance Segmentation Model,Clip Comparison,LMM For Classification,Triangle Visualization,Pixel Color Count,Background Color Visualization,Qwen3.5-VL,CogVLM,Qwen2.5-VL,Image Blur,Anthropic Claude,Stitch Images,Dominant Color,Contrast Equalization,Corner Visualization,Stability AI Image Generation,Halo Visualization,Reference Path Visualization,QR Code Detection,Buffer,Line Counter Visualization,ByteTrack Tracker,Multi-Label Classification Model,Keypoint Detection Model,Roboflow Dataset Upload,Heatmap Visualization,Text Display,VLM As Classifier,Segment Anything 2 Model,Camera Focus,Single-Label Classification Model,Image Preprocessing,SIFT Comparison,Stability AI Outpainting,Bounding Box Visualization,Halo Visualization,Background Subtraction,Pixelate Visualization,Google Vision OCR,Ellipse Visualization,Florence-2 Model
Input and Output Bindings¶
The available connections depend on its binding kinds. Check what binding kinds
Pixelate 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[keypoint_detection_prediction,object_detection_prediction,rle_instance_segmentation_prediction,instance_segmentation_prediction]): Model predictions to visualize..pixel_size(integer): Size of each square pixel block in the pixelated effect, measured in pixels. Controls the granularity of the pixelation: larger values create bigger, more blocky pixels with stronger obscuration (fewer blocks, more abstract appearance), while smaller values create finer, more detailed pixelation (more blocks, less obscured). Typical values range from 10 to 50 pixels, with 20 being a good default that balances obscuration with recognizable object shape..
-
output
image(image): Image in workflows.
Example JSON definition of step Pixelate Visualization in version v1
{
"name": "<your_step_name_here>",
"type": "roboflow_core/pixelate_visualization@v1",
"image": "$inputs.image",
"copy_image": true,
"predictions": "$steps.object_detection_model.predictions",
"pixel_size": 20
}