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