Supervisely
AboutAPI ReferenceSDK Reference
  • 🤖What's Supervisely
  • 🚀Ecosystem of Supervisely Apps
  • 💡FAQ
  • 📌Getting started
    • How to import
    • How to annotate
    • How to invite team members
    • How to connect agents
    • How to train models
  • 🔁Import and Export
    • Import
      • Overview
      • Import using Web UI
      • Supported annotation formats
        • Images
          • 🤖Supervisely JSON
          • 🤖Supervisely Blob
          • COCO
          • Yolo
          • Pascal VOC
          • Cityscapes
          • Images with PNG masks
          • Links from CSV, TXT and TSV
          • PDF files to images
          • Multiview images
          • Multispectral images
          • Medical 2D images
          • LabelMe
          • LabelStudio
          • Fisheye
          • High Color Depth
        • Videos
          • Supervisely
        • Pointclouds
          • Supervisely
          • .PCD, .PLY, .LAS, .LAZ pointclouds
          • Lyft
          • nuScenes
          • KITTI 3D
        • Pointcloud Episodes
          • Supervisely
          • .PCD, .PLY, .LAS, .LAZ pointclouds
          • Lyft
          • nuScenes
          • KITTI 360
        • Volumes
          • Supervisely
          • .NRRD, .DCM volumes
          • NIfTI
      • Import sample dataset
      • Import into an existing dataset
      • Import using Team Files
      • Import from Cloud
      • Import using API & SDK
      • Import using agent
    • Migrations
      • Roboflow to Supervisely
      • Labelbox to Supervisely
      • V7 to Supervisely
      • CVAT to Supervisely
    • Export
  • 📂Data Organization
    • Core concepts
    • MLOps Workflow
    • Projects
      • Datasets
      • Definitions
      • Collections
    • Team Files
    • Disk usage & Cleanup
    • Quality Assurance & Statistics
      • Practical applications of statistics
    • Operations with Data
      • Data Filtration
        • How to use advanced filters
      • Pipelines
      • Augmentations
      • Splitting data
      • Converting data
        • Convert to COCO
        • Convert to YOLO
        • Convert to Pascal VOC
    • Data Commander
      • Clone Project Meta
  • 📝Labeling
    • Labeling Toolboxes
      • Images
      • Videos 2.0
      • Videos 3.0
      • 3D Point Clouds
      • DICOM
      • Multiview images
      • Fisheye
    • Labeling Tools
      • Navigation & Selection Tools
      • Point Tool
      • Bounding Box (Rectangle) Tool
      • Polyline Tool
      • Polygon Tool
      • Brush Tool
      • Mask Pen Tool
      • Smart Tool
      • Graph (Keypoints) Tool
      • Frame-based tagging
    • Labeling Jobs
      • Labeling Queues
      • Labeling Consensus
      • Labeling Statistics
    • Labeling with AI-Assistance
  • 🤝Collaboration
    • Admin panel
      • Users management
      • Teams management
      • Server disk usage
      • Server trash bin
      • Server cleanup
      • Server stats and errors
    • Teams & workspaces
    • Members
    • Issues
    • Guides & exams
    • Activity log
    • Sharing
  • 🖥️Agents
    • Installation
      • Linux
      • Windows
      • AMI AWS
      • Kubernetes
    • How agents work
    • Restart and delete agents
    • Status and monitoring
    • Storage and cleanup
    • Integration with Docker
  • 🔮Neural Networks
    • Overview
    • Inference & Deployment
      • Overview
      • Supervisely Serving Apps
      • Deploy & Predict with Supervisely SDK
      • Using trained models outside of Supervisely
    • Model Evaluation Benchmark
      • Object Detection
      • Instance Segmentation
      • Semantic Segmentation
      • Custom Benchmark Integration
    • Custom Model Integration
      • Overview
      • Custom Inference
      • Custom Training
    • Legacy
      • Starting with Neural Networks
      • Train custom Neural Networks
      • Run pre-trained models
  • 👔Enterprise Edition
    • Get Supervisely
      • Installation
      • Post-installation
      • Upgrade
      • License Update
    • Kubernetes
      • Overview
      • Installation
      • Connect cluster
    • Advanced Tuning
      • HTTPS
      • Remote Storage
      • Single Sign-On (SSO)
      • CDN
      • Notifications
      • Moving Instance
      • Generating Troubleshoot Archive
      • Storage Cleanup
      • Private Apps
      • Data Folder
      • Firewall
      • HTTP Proxy
      • Offline usage
      • Multi-disk usage
      • Managed Postgres
      • Scalability Tuning
  • 🔧Customization and Integration
    • Supervisely .JSON Format
      • Project Structure
      • Project Meta: Classes, Tags, Settings
      • Tags
      • Objects
      • Single-Image Annotation
      • Single-Video Annotation
      • Point Cloud Episodes
      • Volumes Annotation
    • Developer Portal
    • SDK
    • API
  • 💡Resources
    • Changelog
    • GitHub
    • Blog
    • Ecosystem
Powered by GitBook
On this page
  • What is Brush Annotation Tool?
  • Brush Tool Modes
  • Video Tutorial
  • How to use the Brush Tool
  • Create class with Mask shape
  • Manual Annotation Guide
  • Pro Tips
  • Hotkeys

Was this helpful?

  1. Labeling
  2. Labeling Tools

Brush Tool

Learn how to annotate objects of any complexity by creating freeform outlines using the Brush annotation tool.

PreviousPolygon ToolNextMask Pen Tool

Last updated 7 months ago

Was this helpful?

What is Brush Annotation Tool?

The Brush tool is an essential image segmentation tool, specifically designed for creating free-form and independent segmentation masks. With flexible customizable parameters such as size scaling, this tool is ideal for a wide range of segmentation tasks, from outlining complex objects to simpler selections.

The Brush tool is ideal for scenarios involving atypical shapes, such as the decay of a leaf, as well as more straightforward tasks, such as selecting circular objects, like road signs.

Also noteworthy is the benefit of collaboration with other tools, such as the Pen tool. Each tool can complement the functionality of the other, maximizing the ease and accuracy of the segmentation process.

Brush Tool Modes

The Brush Tool offers three different modes to provide flexibility in how you annotate and edit objects in an image:

  1. Overlay (Default Mode)

    In this mode, you can draw on top of existing masks without altering them. The new brush strokes will be layered over the current segmentation, allowing you to create additional details or overlapping annotations without changing the original mask.

  2. Overwrite

    This mode replaces the pixels of existing masks with any overlapping brush strokes. When you draw over an area already covered by another mask, the Brush Tool will overwrite it, making it ideal for correcting or refining existing segmentations.

  3. Preserve

    In Preserve mode, the Brush Tool only allows you to draw on unpainted areas, leaving the existing masks untouched. This mode is perfect for adding new segments without modifying or interfering with the current annotations, ensuring that previously annotated objects remain intact.

By choosing the appropriate mode, you can control how new annotations interact with existing masks.

Video Tutorial

Learn how to effectively use the Brush tool in a 5-minute tutorial. Get hands-on experience with the new interface and explore the advanced features in our labeling toolbox.

How to use the Brush Tool

Follow these step-by-step instructions to effectively use the Brush tool for image segmentation.

Create class with Mask shape

  1. Click the Brush Icon in the toolbar of the labeling interface.

  2. Or select an existing object class or add a new class by clicking Add new class definition.

  3. In the modal window, enter the class name, choose the Mask or Any shape, and configure additional settings (e.g., color, hotkeys).

  4. Click the Create button to add the new class to the definitions list.

  5. Select the newly created class and segment the object with the mask in the image or video.

Manual Annotation Guide

  1. Customize the brush size using the slider in the settings tab or by pressing the hotkeys [ to decrease and ] to increase the brush size.

  2. Move the cursor to the area you want to segment. Click and drag to draw the outline of the object or region you want to annotate.

  3. Continue drawing until you have covered the desired area. You can adjust the brush size dynamically during this process to achieve more accurate segmentation.

  4. To remove unwanted parts of the mask, hold down the SHIFT key and draw over the area to erase. You can also use the Eraser Tool or switch to the Pen Tool for finer edits.

Use bucket fill for gaps

Click the Bucket Fill Tool to quickly fill any gaps or holes in the segmentation with a single click. This will save time by automatically filling in areas that are not fully covered. The selected object is highlighted with a grid of dots.

Split the mask

Use the Polygon Split Tool to divide the current mask into two separate objects. Start drawing around the desired area and close the contour by clicking at the starting point. The selected area will be separated as a new object in the objects list.

Segmenting object presented by separate parts

Draw the first segment of the object by clicking and dragging over the area you want to annotate. Move to the next area that is also part of the same object or class, and draw another segment using the Brush Tool. Continue this process for all the separate parts that belong to the same object. All the segments will automatically be grouped into a single object mask. When you have finished annotating all parts, press the SPACE key to finalize the annotation and create a new object.

Pro Tips

  • Use the Object Color Randomizer to instantly change the color of any object with a single click, as often as you like. This is particularly useful if you have many objects of the same class, or if they are close together, so you can easily differentiate between masks.

Hotkeys

Control the Brush tool more efficiently with HOTKEYS.

Brush Tool
8

Draw pixel mask

Erase

Hold Shift

Decrease brush size

[

Increase brush size

]

Finish & start new

Space

Use Polygon Split (to cut mask into two figures) and Bucket Fill (to fill holes) in the tool subpanel

Scene Navigation

Zoom with MOUSE WHEEL. Hold RIGHT MOUSE BUTTON to move scene.

You can create a new class directly from the . To do this:

Discover all the advanced features and unique applications of the Brush Tool in our .

+ Draw

Finish area using SPACE or the first point.

📝
Annotation Toolbox
comprehensive blog post
Brush Annotation Tool: your must-have for Object Segmentation - SuperviselySupervisely
Logo