When to Use
Use segmentation when:- You need pixel-precise object boundaries
- The task requires semantic segmentation (every pixel labeled) or instance segmentation (separate mask per object)
- Objects have complex, irregular shapes that polygons cannot capture efficiently
- You are training models like DeepLab, U-Net, Mask R-CNN, or similar architectures
- You only need rough localization — use the Bounding Box tool
- Object boundaries are simple enough for polygon outlines — use the Polygon tool (faster for simple shapes)
- You need 3D annotations — use the 3D Cuboid tool
Usage
- Press
Mor select the Segmentation tool from the toolbar - Choose a label from the label panel
- Use one of the sub-tools:
Brush
- Click and drag to paint a mask region
- Adjust brush size with
[(smaller) and](larger) - Hold
Shiftto paint in a straight line between two clicks
Eraser
- Press
Xto toggle eraser mode - Click and drag to erase mask pixels
- Same size controls as the brush
Fill
- Click inside an enclosed region to flood-fill it with the current label
- Useful for filling the interior of a polygon outline quickly
SAM Assist
- Press
Sto activate SAM mode within the segmentation tool - Click on the object to generate a mask automatically
- Refine with positive clicks (include region) and negative clicks (exclude region)
- Press
Enterto apply the mask
Shortcuts
| Shortcut | Action |
|---|---|
M | Activate the Segmentation tool |
S | Switch to SAM assist mode |
X | Toggle eraser mode |
[ / ] | Decrease / Increase brush size |
H | Toggle mask visibility |
Shift + click | Paint straight line to click location |
Enter | Apply SAM mask |
Delete / Backspace | Delete selected mask |
Ctrl+Z / ⌘Z | Undo |
Ctrl+Shift+Z / ⌘⇧Z | Redo |
Recommended Workflow
The fastest approach for most objects is:- Start with SAM: Click on the object to get an initial mask
- Refine with positive/negative clicks: Add or remove regions as needed
- Apply the mask: Press
Enter - Clean up edges: Switch to the brush or eraser at a small size for precise edge cleanup
- Zoom in: Use
+or scroll to zoom into boundary areas for fine detail work
Common Mistakes
- Jagged edges from large brush size: Use a smaller brush near object boundaries for cleaner results
- Missing thin features: Thin parts of objects (legs, antennae, poles) are easy to miss — zoom in to verify
- Overlapping labels: When two labels overlap, the last painted label takes priority — be intentional about overlap order
- Not using SAM: Manually painting an entire mask from scratch is much slower than starting with SAM and refining
Advanced Tips
- Start with SAM for the initial mask, then refine edges with the brush and eraser
- Use the eraser at a small size for precise edge cleanup
- Zoom in (
+or scroll) for fine detail work along object boundaries - Each label gets a distinct color overlay, configurable in the label panel
- Toggle mask visibility with
Hto see the underlying image and verify boundaries - For batch labeling of similar objects, SAM assist can dramatically speed up the process
Segmentation masks are stored as run-length encoded (RLE) data for efficient storage. The viewer handles encoding and decoding automatically.
Related Tools
- Polygon — For vector-based outlines (faster for simple shapes)
- Bounding Box — For quick rectangular localization
- Classification — For image-level labels without geometry
- Keypoint — For pose estimation skeletons