Keyboard Shortcuts
==================

CellPick provides keyboard shortcuts for common actions. On macOS, use **⌘** (Command) instead of **Ctrl**.

.. raw:: html

   <div style="margin-bottom: 2em;"></div>

File Operations
---------------

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - Shortcut
     - Action
   * - ⌘/Ctrl + Shift + S
     - Save Screenshot

.. raw:: html

   <div style="margin-bottom: 2em;"></div>

View Controls
-------------

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - Shortcut
     - Action
   * - ⌘/Ctrl + Shift + L
     - Toggle shape visibility (show/hide all shapes)
   * - ⌘/Ctrl + Shift + G
     - Toggle between label colors and gradient colors

.. raw:: html

   <div style="margin-bottom: 2em;"></div>

Navigation
----------

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - Shortcut
     - Action
   * - ⌘/Ctrl + F
     - Open search dialog
   * - Scroll wheel
     - Zoom in/out
   * - Click + Drag
     - Pan the image

.. raw:: html

   <div style="margin-bottom: 2em;"></div>

Mouse Controls
--------------

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - Action
     - Effect
   * - Left-click + Drag
     - Pan the image view
   * - Scroll wheel
     - Zoom in/out (centered on cursor)
   * - Right-click (selection mode)
     - Add point to landmark, active region, or calibration
   * - Right-click (add shapes mode)
     - Add shape to selection
   * - Right-click (delete mode)
     - Delete clicked landmark, AR, or shape from selection

.. raw:: html

   <div style="margin-bottom: 2em;"></div>

Menu Bar
--------

CellPick also provides a comprehensive menu bar for all operations:

**File Menu**

- Add Spatial Data
- Add Channel
- Load Shapes
- Load Labels
- Export Selected Shapes
- Export to SpatialData
- Save Screenshot... (⌘/Ctrl + Shift + S)
- Exit

**View Menu**

- Refresh
- Reset View
- Show Shapes (⌘/Ctrl + Shift + L)
- Show Gradient (⌘/Ctrl + Shift + G)
- Next Page

**Calibration Menu**

- Load Calibration File
- Manual Calibration
- Confirm Calibration

**Landmarks Menu**

- Add Landmark
- Confirm Landmark
- Delete Landmark
- Delete Last Point
- Load Landmarks from File

**Active Regions Menu**

- Add Active Region
- Confirm Active Region
- Delete Active Region
- Delete Last Point
- Load Active Regions from File

**Shapes Menu**

- Select Shapes
- Add Shapes
- Remove Shapes

**Help Menu**

- Search... (⌘/Ctrl + F)
- Visit Website
- Documentation
- About CellPick