Settings & Shortcuts

The Annotation tool exposes two panels, from the right-side icon rail, dedicated to personalizing how you work: Settings, which holds your display and behavior preferences, and Shortcuts, which recaps the keyboard shortcuts currently active, whether at their default value or the one you personalized.

Access settings or shortcuts pages from Annotation tool

1. Settings panel

The Settings panel groups your personal preferences for the tool. They apply to your own account and persist across DatasetVersion. Once changed, click Update to save them.

📘

A setting enforced by your Organization

An Admin of your Organization can set a value for any of these preferences and mark it as Enforced from the Policy page of the Organization settings (see Organization policy). An enforced setting is displayed with the value chosen for the whole team and cannot be changed from this panel, which is how a Computer Vision team keeps every annotator on the same display rules.

Settings available in the Annotation tool

A. General

  • Auto move next on submit: automatically open the next Asset in the queue right after submitting or reviewing the current Annotation. It doesn't apply to Save.
  • Auto-enable draw after release: automatically re-enable the Draw mode after finishing a Shape, instead of falling back to Selection mode.
  • Lock shapes after creation: lock every Shape as soon as you validate it, so that a Shape you have already placed cannot be moved by mistake while you draw the next one. It is turned off by default, and a locked Shape can be unlocked at any time.
  • Default Zoom (%): the zoom level applied when opening an Asset or using Reset Zoom.
  • Display minimap: show or hide the minimap displayed above the zoom controls, which situates the part of the Asset you are looking at inside the whole image. It is turned on by default, and it is most useful on large images you annotate zoomed in. See Navigation.

B. Grid

An optional grid can be displayed over the Asset, under the Shape. Its cells are named A1, B3… (and AA1 once past Z), which gives you and your reviewers a shared vocabulary to point at a region of a large image instead of describing it:

  • Display grid: show or hide the grid. It is turned off by default, and the Shapes panel header also carries a button to turn it on for the current session only.
  • Per-pixel grid: draw one cell per pixel of the image instead, which is useful when you zoom all the way in on a mask.
  • Grid cells (longest side): the number of cells along the longest side of the image.
  • A toggle to hide the A1, B2… names of the cells, for when you use the grid to align Shape rather than to name a region of the image.

The lines are hidden when the zoom level makes the cells too small to be readable, and the cell names are only displayed when they fit.

C. Performances

  • Enable cache: cache the next images in the queue. This aims at speeding up the navigation across the Asset gallery, especially if the files to display are big or if you have a slow internet connection.
  • Cache size: the number of Asset kept in cache.

D. Shapes

  • Shape opacity (%): the fill opacity used to display all the Shape on the Asset.
  • Display the Shape opacity slider: show or hide the opacity slider displayed next to the zoom controls, which changes the same value without opening the Settings panel. It is turned on by default. See Actions on Shape.
  • Display each shape with a unique color: display every Shape of the Asset in its own color instead of the color of its Label, which is the way to tell apart Shape of the same Label that overlap. It is turned off by default. The Shapes panel header also carries a palette button to turn it on for the current session, with Shift + U as its default shortcut; the button is read-only when your Organization enforces the preference. The Shape list and the timeline keep the Label colors.
  • Polygon simplification factor: how aggressively a polygon Shape is simplified when using the Simplify action (see Polygon editing) — the higher the factor, the more points are removed.

E. Labels

  • Label Order: how Label are ordered in the Label dropdown and the Shapes panel (Default, Alphabetical, or Reverse Alphabetical).
  • Display Shape Labels: show or hide the Label name next to each Shape on the Asset.
  • Display Shape IDs: add the index of the Shape (#1, #2…) next to its Label on the Asset, the same index as the one displayed in the Shapes panel. It is turned off by default, and it is what lets you name the exact Shape you are discussing with a reviewer. The Shapes panel header also carries a button to turn it on and off for the current session, with Shift + I as its default shortcut.

F. Player

On a video DatasetVersion, an additional Player section configures the video player used to annotate:

  • Annotation Default Duration when created (timeline only): the default duration (in frames) given to a new Annotation when it is created. A Shape drawn in the Timelapse covers its step instead (see Annotate with the Timelapse).
  • Annotations last until the end of the video when created: a new Annotation runs to the last frame of the video instead of lasting the default duration.
  • Step (frames): the number of frames of a jump of the player, and the size of a step in the Timelapse. It is the same value as the Step selector of the player, and it is kept from one Asset to the next.
  • Display Skip to End / Beginning control: show or hide the buttons to jump to the start or end of the video.
  • Display Frame Step controls: show or hide the buttons to move frame by frame.
  • Enable Interpolation: automatically interpolate a Shape's position between two keyframes.
  • Display Interpolation's Motion Path: draw, on the video itself, the path followed by the selected Track between its keyframes. See Linear interpolation.
  • Track order: how the Track are listed in the Shapes panel and in the timeline — grouped by Label (the default), flat by creation date, or flat by first keyframe. The last one follows the chronology of the video, which helps when you work through a long sequence object after object.
  • Cursor out of Timeline behavior: how the timeline scrolls when the playback cursor reaches its edge (Stick to the Right, Stick to the Middle, or Moves back to the left).

2. Consult the active shortcuts

Most of the actions available in the Annotation tool can also be triggered through a keyboard shortcut. Shortcuts depend on the context you are in (the Annotation tool itself, an Assets overview, or globally across Picsellia) and, within the Annotation tool, on the Version Type of the DatasetVersion you are annotating.

The Shortcuts panel (right-side icon rail) displays a read-only, always up-to-date recap of every shortcut currently active for the DatasetVersion you are annotating, grouped into Tool, Annotation, and Queue Navigation sections, plus a Timeline section on video (see Video player).

Consult available shortcuts for Annotation tool

3. Personalize your shortcuts

Every shortcut of the Annotation tool can be personalized from the Shortcuts tab of your Personal Settings, under the Studio tab of the table. An Admin can also replace the default shortcuts for the whole Organization, and your personal shortcuts take precedence over them. Both are detailed in Customize your Keyboard Shortcuts.

4. Reference

The main shortcuts available by default are summarized below. Refer to the Shortcuts settings page for the exhaustive and always up-to-date list, including all the Version Type-specific variants.

A. Navigation

ActionDefault shortcut
Enable select modeEsc
PanSpace
ScrollShift + Space
Reset ZoomR
Zoom in / outCmd/Ctrl + = / -
Move to previous / next AssetShift + Tab / Tab
Save AnnotationCmd/Ctrl + S
Undo / RedoCmd/Ctrl + Z / Cmd/Ctrl + Shift + Z
Lock / unlock the selected ShapeF
Accept / Reject AnnotationCmd/Ctrl + Shift + Enter / Cmd/Ctrl + Shift + Delete
Change active Label0-9
Open a panel of the right-side railAlt + 1 … Alt + 0
Show / hide the Shape indexesShift + I
Display each Shape with a unique colorShift + U

The Alt + 1 to Alt + 0 shortcuts follow the display order of the icons in the right-side rail: Shapes, Selection, Data, Attributes, Instructions, History, Issues, Details, Settings, and Shortcuts. Each one is recalled in the tooltip of its button, and can be personalized like any other shortcut.

B. Drawing, by Version Type

Version TypeDraw actionDefault shortcut
ClassificationClassify AssetD
Object DetectionDraw rectangleD
Object DetectionDraw rectangles with exemplar box (SAM3)X
Object DetectionDraw rectangles with label prompts (SAM3)Shift + X
SegmentationDraw polygonD
SegmentationDraw polygon with pencilShift + D
SegmentationDraw polygon with points (SAM3)X
SegmentationDraw polygon with box (SAM3)X, 1
SegmentationEdit polygon with SAM (SAM3)E, X
SegmentationCut polygon with scissorsS
SegmentationAdd / remove points with pencilE / Shift + E
SegmentationDraw polygons with points (SAM3)Shift + X
SegmentationDraw polygons with exemplar box (SAM3)Shift + X, 1
SegmentationDraw polygons with label prompts (SAM3)Shift + X, 2
SegmentationDraw polygons with text prompts (SAM3)Shift + X, 3
MaskDraw mask with pencilD
MaskDraw mask with brushShift + D
MaskDraw mask with point (SAM3)X
MaskDraw mask with box (SAM3)X, 1
MaskAdd / remove pixels with pencilE / Shift + E
MaskAdd / remove pixels with brushCmd + E / Cmd + Shift + E
MaskEdit mask with SAM (SAM3)E, X
MaskDraw masks with points (SAM3)Shift + X
MaskDraw masks with exemplar box (SAM3)Shift + X, 1
MaskDraw masks with label prompts (SAM3)Shift + X, 2
MaskDraw masks with text prompts (SAM3)Shift + X, 3
PointDraw pointD
LineDraw lineD
KeypointDraw keypointD
KeypointDraw with template (Skeleton)T
📘

Version Type-specific keys

Several of these actions share the same default key (e.g. D) because only one Version Type is active at a time on a given DatasetVersion. The Shortcuts settings page also lists a distinct key mapping for a Multi Version Type, meant to make every Version Type's shortcuts active at once on the same key; as noted here, Multi cannot be selected yet, so this mapping is not usable in practice for now.

C. Video player

On a DatasetVersion that contains videos, the Annotation tool displays a player and a timeline (see Annotation tool for video). The group of the Shortcuts panel named Timeline lists the shortcuts of the player (which plays the video and moves along its frames) and the ones of the timeline (the grid that represents the Track along the frames):

ActionDefault shortcut
Play / PauseK
Previous / Next frameJ / L
Jump backward / forward (Step frames)Cmd/Ctrl + J / Cmd/Ctrl + L
Go to start / end frameAlt + J / Alt + L
Previous / Next keyframeAlt + Shift + J / Alt + Shift + L
Zoom the timeline in / outCmd/Ctrl + Wheel
Scroll the timeline horizontallyShift + Wheel

The number of frames of a jump is the Step value displayed on the right of the timeline. The Alt key is the Option key on a Mac. The two wheel gestures are listed with a + Wheel suffix, and the modifier they rely on can be rebound like any other shortcut. In the Timelapse tab, the four navigation shortcuts move between the steps instead of the frames, Shift + P propagates the selected Track to the next step, and Shift + N hides it on the current step only.

Working on a Track also comes with a few shortcuts:

ActionDefault shortcut
Copy / Paste a TrackCmd/Ctrl + C / Cmd/Ctrl + V
Paste a Track without its keyframesCmd/Ctrl + Shift + V
Duplicate a TrackCmd/Ctrl + B
Remove a TrackBackspace
Split the selected Track at the cursorShift + S
Cut the selected Track to the cursorShift + C
Join two sub-tracks (Join tracks)Shift + M
Expand to the first frame / the cursor / the last frameShift + J / Shift + K / Shift + L

The other actions of the video Annotation tool use the shortcuts of the tables above, for instance Draw rectangle, Undo, Save, or Change active label.


Did this page help you?