Tutorial: Segmentation Workflow
================================

This hands-on tutorial walks through a complete segmentation workflow
using MouseMaster to streamline your mouse button mappings.

Prerequisites
-------------

- 3D Slicer installed with MouseMaster extension
- A multi-button mouse (this tutorial uses the Logitech MX Master 3S)

Step 1: Load Sample Data
------------------------

Load MRHead from Sample Data module for segmentation practice.

.. figure:: _generated/001_step1_data_loaded.png
   :width: 100%
   :alt: Load Sample Data

*Loaded volume: MRHead*


Step 2: Open MouseMaster
------------------------

Navigate to Modules > Utilities > MouseMaster.

.. figure:: _generated/002_step2_mousemaster.png
   :width: 100%
   :alt: Open MouseMaster


Step 3: Select Mouse
--------------------

Choose your mouse model from the dropdown. We'll use the Logitech MX Master 3S.

.. figure:: _generated/003_step3_mouse_selected.png
   :width: 100%
   :alt: Select Mouse

*Selected mouse: Logitech MX Master 3S*


Step 4: Select Preset
---------------------

Choose a preset configuration for your workflow.

.. figure:: _generated/004_step4_preset_selected.png
   :width: 100%
   :alt: Select Preset

*Applied preset: Segmentation Workflow*


Step 5: Review Button Mappings
------------------------------

Review the button mappings for your mouse. The MX Master 3S has 4 remappable buttons.

.. figure:: _generated/005_step5_button_mappings.png
   :width: 100%
   :alt: Review Button Mappings

**Current button mappings:**

- **Middle Click** → Center view on crosshair position
- **Back** → Select previous segment
- **Forward** → Select next segment
- **Thumb Button** → Activate Paint effect


Step 6: Enable MouseMaster
--------------------------

Click Enable Mouse Master to activate button remapping.

.. figure:: _generated/006_step6_enabled.png
   :width: 100%
   :alt: Enable MouseMaster

*MouseMaster status: active*


Step 7: Open Segment Editor
---------------------------

Open Segment Editor and create a segment to start painting.

.. figure:: _generated/007_step7_segment_editor.png
   :width: 100%
   :alt: Open Segment Editor


Step 8: Test Your Mappings
--------------------------

Paint on the slice, then press Back button to Undo. Press Forward to Redo.

.. figure:: _generated/008_step8_ready_to_paint.png
   :width: 100%
   :alt: Test Your Mappings


What's Next?
------------

Now that you've completed the basic workflow:

- :doc:`button-mapping` - Customize your button assignments
- :doc:`presets` - Save and share your configurations
- :doc:`context-bindings` - Create module-specific mappings

Tips
----

- Use **Back/Forward** buttons for Undo/Redo in any module
- Create module-specific bindings for Segment Editor effects
- Export your presets to share with colleagues

----

*This tutorial was auto-generated on 2026-01-29.*
*Screenshots reflect the current UI.*