napari-padbound 0.2.0__tar.gz

napari_padbound-0.2.0/.gitignore

@@ -0,0 +1 @@
+launch_napari.py

napari_padbound-0.2.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2024, Utz H. Ermel
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

napari_padbound-0.2.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: napari-padbound
+Version: 0.2.0
+Summary: A napari plugin for padbound
+Project-URL: Bug Tracker, https://github.com/uermel/napari-padbound/issues
+Project-URL: Documentation, https://github.com/uermel/napari-padbound#README.md
+Project-URL: Source Code, https://github.com/uermel/napari-padbound
+Author-email: "Utz H. Ermel" <utz@ermel.me>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: napari
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.9
+Requires-Dist: magicgui
+Requires-Dist: napari
+Requires-Dist: numpy
+Requires-Dist: padbound>=0.3.0
+Requires-Dist: qtpy
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: testing
+Requires-Dist: napari; extra == 'testing'
+Requires-Dist: pyqt5; extra == 'testing'
+Requires-Dist: pytest; extra == 'testing'
+Requires-Dist: pytest-cov; extra == 'testing'
+Requires-Dist: pytest-qt; extra == 'testing'
+Requires-Dist: tox; extra == 'testing'
+Description-Content-Type: text/markdown
+
+# napari-padbound
+
+[![License BSD-3](https://img.shields.io/pypi/l/napari-padbound.svg?color=green)](https://github.com/uermel/napari-padbound/raw/main/LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/napari-padbound.svg?color=green)](https://pypi.org/project/napari-padbound)
+[![Python Version](https://img.shields.io/pypi/pyversions/napari-padbound.svg?color=green)](https://python.org)
+[![napari hub](https://img.shields.io/endpoint?url=https://api.napari-hub.org/shields/napari-padbound)](https://napari-hub.org/plugins/napari-padbound)
+
+A [napari] plugin for controlling image annotation workflows with MIDI controllers via [padbound].
+
+Use physical pads, knobs, faders, and buttons to navigate slices, select labels, adjust brush size, zoom, undo/redo, and more &mdash; with real-time LED feedback showing your current label colors on the controller.
+
+## Features
+
+- **Auto-detection** &mdash; Automatically finds and connects to any [padbound]-supported MIDI controller
+- **Smart control mapping** &mdash; Automatically assigns available hardware controls to napari functions based on controller capabilities
+- **Slice navigation** &mdash; Coarse and fine navigation through 3D+ data volumes via faders or knobs
+- **Slice stepping** &mdash; Increment/decrement slices one at a time via navigation buttons
+- **Zoom control** &mdash; Logarithmic zoom mapping (0.01x&ndash;10x) via knobs or faders
+- **Brush size control** &mdash; Logarithmic brush size adjustment (1&ndash;100px) for label painting
+- **Label selection** &mdash; Select labels by pressing pads; pad 1 is the eraser, remaining pads map to labels 1, 2, 3, ...
+- **LED color feedback** &mdash; Pads display actual label colors from the napari colormap, with the selected label pulsing (on RGB-capable controllers)
+- **Dimension rolling** &mdash; Cycle through dimension views (XY, YZ, XZ) via navigation buttons
+- **Undo/redo** &mdash; Transport buttons for edit history on the active Labels layer
+- **Graceful degradation** &mdash; Three feedback strategies (RGB color, binary toggle, none) adapt automatically to controller capabilities
+
+## Supported Controllers
+
+Any controller with a [padbound] plugin works automatically. Currently supported:
+
+| Controller | Best for | Key controls |
+|---|---|---|
+| **AKAI APC mini MK2** | Full RGB feedback, many faders | 64 RGB pads, 9 faders, 17 buttons |
+| **AKAI LPD8 MK2** | Compact RGB + knobs | 8 RGB pads, 8 knobs, 4 banks |
+| **AKAI MPD218** | Velocity-sensitive pads | 16 pads, 6 encoders, 3 banks |
+| **PreSonus ATOM** | RGB pads + encoders + buttons | 16 RGB pads, 4 encoders, 20 buttons |
+| **Synido TempoPad P16** | RGB pads + transport | 16 RGB pads, 4 encoders, 6 buttons |
+| **Behringer X-Touch Mini** | Encoders with LED rings | 16 pads, 8 encoders, 1 fader |
+| **Xjam** | Budget option, multi-bank | 16 pads, 6 knobs, 3 banks |
+
+## How Control Mapping Works
+
+The plugin automatically discovers available controls and assigns them by priority:
+
+**Continuous controls** (assigned in order: faders first, then knobs, then encoders):
+1. First control &rarr; **Coarse slice** (full range of the data volume)
+2. Second control &rarr; **Fine slice** (&plusmn;64 slices around the coarse position)
+3. Third control &rarr; **Brush size** (logarithmic, 1&ndash;100px)
+4. Fourth control &rarr; **Zoom** (logarithmic, 0.01x&ndash;10x)
+
+**Pads** &rarr; **Label selection** (pad 1 = eraser, pad 2+ = labels)
+
+**Navigation buttons** &rarr; Up/Down = slice step, Left/Right = dimension roll
+
+**Transport buttons** &rarr; Stop = undo, Play = redo
+
+The widget displays the detected controller and its mapped controls so you can see what each physical control does.
+
+## Installation
+
+```bash
+pip install napari-padbound
+```
+
+For development:
+
+```bash
+git clone https://github.com/uermel/napari-padbound.git
+cd napari-padbound
+pip install -e ".[dev,testing]"
+```
+
+## Usage
+
+1. Connect a supported MIDI controller via USB
+2. Open [napari]
+3. Go to **Plugins > padbound** to open the widget
+4. Load a 3D image and create a Labels layer
+5. Use your controller to navigate slices, select labels, and annotate
+
+The widget shows the connected controller name and the mapping of physical controls to napari functions. If no controller is detected, the widget will indicate this.
+
+## Development
+
+```bash
+# Linting
+ruff check src/
+ruff format src/
+black src/
+
+# Run tests
+pytest
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+Distributed under the terms of the [BSD-3] license, napari-padbound is free and open source software.
+
+## Issues
+
+If you encounter any problems, please [file an issue] along with a detailed description.
+
+[napari]: https://github.com/napari/napari
+[padbound]: https://github.com/uermel/padbound
+[BSD-3]: http://opensource.org/licenses/BSD-3-Clause
+[file an issue]: https://github.com/uermel/napari-padbound/issues

napari_padbound-0.2.0/README.md

@@ -0,0 +1,109 @@
+# napari-padbound
+
+[![License BSD-3](https://img.shields.io/pypi/l/napari-padbound.svg?color=green)](https://github.com/uermel/napari-padbound/raw/main/LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/napari-padbound.svg?color=green)](https://pypi.org/project/napari-padbound)
+[![Python Version](https://img.shields.io/pypi/pyversions/napari-padbound.svg?color=green)](https://python.org)
+[![napari hub](https://img.shields.io/endpoint?url=https://api.napari-hub.org/shields/napari-padbound)](https://napari-hub.org/plugins/napari-padbound)
+
+A [napari] plugin for controlling image annotation workflows with MIDI controllers via [padbound].
+
+Use physical pads, knobs, faders, and buttons to navigate slices, select labels, adjust brush size, zoom, undo/redo, and more — with real-time LED feedback showing your current label colors on the controller.
+
+## Features
+
+- **Auto-detection** — Automatically finds and connects to any [padbound]-supported MIDI controller
+- **Smart control mapping** — Automatically assigns available hardware controls to napari functions based on controller capabilities
+- **Slice navigation** — Coarse and fine navigation through 3D+ data volumes via faders or knobs
+- **Slice stepping** — Increment/decrement slices one at a time via navigation buttons
+- **Zoom control** — Logarithmic zoom mapping (0.01x–10x) via knobs or faders
+- **Brush size control** — Logarithmic brush size adjustment (1–100px) for label painting
+- **Label selection** — Select labels by pressing pads; pad 1 is the eraser, remaining pads map to labels 1, 2, 3, ...
+- **LED color feedback** — Pads display actual label colors from the napari colormap, with the selected label pulsing (on RGB-capable controllers)
+- **Dimension rolling** — Cycle through dimension views (XY, YZ, XZ) via navigation buttons
+- **Undo/redo** — Transport buttons for edit history on the active Labels layer
+- **Graceful degradation** — Three feedback strategies (RGB color, binary toggle, none) adapt automatically to controller capabilities
+
+## Supported Controllers
+
+Any controller with a [padbound] plugin works automatically. Currently supported:
+
+| Controller | Best for | Key controls |
+|---|---|---|
+| **AKAI APC mini MK2** | Full RGB feedback, many faders | 64 RGB pads, 9 faders, 17 buttons |
+| **AKAI LPD8 MK2** | Compact RGB + knobs | 8 RGB pads, 8 knobs, 4 banks |
+| **AKAI MPD218** | Velocity-sensitive pads | 16 pads, 6 encoders, 3 banks |
+| **PreSonus ATOM** | RGB pads + encoders + buttons | 16 RGB pads, 4 encoders, 20 buttons |
+| **Synido TempoPad P16** | RGB pads + transport | 16 RGB pads, 4 encoders, 6 buttons |
+| **Behringer X-Touch Mini** | Encoders with LED rings | 16 pads, 8 encoders, 1 fader |
+| **Xjam** | Budget option, multi-bank | 16 pads, 6 knobs, 3 banks |
+
+## How Control Mapping Works
+
+The plugin automatically discovers available controls and assigns them by priority:
+
+**Continuous controls** (assigned in order: faders first, then knobs, then encoders):
+1. First control → **Coarse slice** (full range of the data volume)
+2. Second control → **Fine slice** (±64 slices around the coarse position)
+3. Third control → **Brush size** (logarithmic, 1–100px)
+4. Fourth control → **Zoom** (logarithmic, 0.01x–10x)
+
+**Pads** → **Label selection** (pad 1 = eraser, pad 2+ = labels)
+
+**Navigation buttons** → Up/Down = slice step, Left/Right = dimension roll
+
+**Transport buttons** → Stop = undo, Play = redo
+
+The widget displays the detected controller and its mapped controls so you can see what each physical control does.
+
+## Installation
+
+```bash
+pip install napari-padbound
+```
+
+For development:
+
+```bash
+git clone https://github.com/uermel/napari-padbound.git
+cd napari-padbound
+pip install -e ".[dev,testing]"
+```
+
+## Usage
+
+1. Connect a supported MIDI controller via USB
+2. Open [napari]
+3. Go to **Plugins > padbound** to open the widget
+4. Load a 3D image and create a Labels layer
+5. Use your controller to navigate slices, select labels, and annotate
+
+The widget shows the connected controller name and the mapping of physical controls to napari functions. If no controller is detected, the widget will indicate this.
+
+## Development
+
+```bash
+# Linting
+ruff check src/
+ruff format src/
+black src/
+
+# Run tests
+pytest
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+Distributed under the terms of the [BSD-3] license, napari-padbound is free and open source software.
+
+## Issues
+
+If you encounter any problems, please [file an issue] along with a detailed description.
+
+[napari]: https://github.com/napari/napari
+[padbound]: https://github.com/uermel/padbound
+[BSD-3]: http://opensource.org/licenses/BSD-3-Clause
+[file an issue]: https://github.com/uermel/napari-padbound/issues

napari_padbound-0.2.0/pyproject.toml

@@ -0,0 +1,96 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "napari-padbound"
+dynamic = ["version"]
+description = "A napari plugin for padbound"
+readme = "README.md"
+license = "BSD-3-Clause"
+requires-python = ">=3.9"
+authors = [
+    { name = "Utz H. Ermel", email = "utz@ermel.me" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: napari",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Image Processing",
+]
+dependencies = [
+    "napari",
+    "numpy",
+    "magicgui",
+    "qtpy",
+    "padbound>=0.3.0",
+]
+
+[project.optional-dependencies]
+testing = [
+    "tox",
+    "pytest",
+    "pytest-cov",
+    "pytest-qt",
+    "napari",
+    "pyqt5",
+]
+dev = [
+    "black",
+    "ruff",
+    "pre-commit",
+]
+
+[project.entry-points."napari.manifest"]
+napari-padbound = "napari_padbound:napari.yaml"
+
+[project.urls]
+"Bug Tracker" = "https://github.com/uermel/napari-padbound/issues"
+"Documentation" = "https://github.com/uermel/napari-padbound#README.md"
+"Source Code" = "https://github.com/uermel/napari-padbound"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/napari_padbound/_version.py"
+
+[tool.hatch.build.targets.sdist]
+include = ["/src"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/napari_padbound"]
+
+[tool.black]
+line-length = 120
+target-version = ["py311"]
+
+[tool.ruff]
+line-length = 120
+lint.select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # Pyflakes
+    "B",    # flake8-bugbear
+    "I",    # isort
+]
+lint.ignore = [
+    "E501",  # line too long (handled by black)
+]
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = "-v --color=yes"
+testpaths = ["src/napari_padbound/_tests"]
+filterwarnings = [
+    "ignore::DeprecationWarning",
+]

napari_padbound-0.2.0/src/napari_padbound/__init__.py

@@ -0,0 +1,27 @@
+try:
+    from ._version import version as __version__
+except ImportError:
+    __version__ = "unknown"
+
+from .control_mapper import ControlMapper, ControlMapping
+from .label_feedback import (
+    LabelFeedbackStrategy,
+    NoFeedbackStrategy,
+    RGBColorStrategy,
+    ToggleStrategy,
+    create_feedback_strategy,
+)
+from .viewer_controller import ViewerController
+from .widget import PadboundWidget
+
+__all__ = (
+    "ControlMapper",
+    "ControlMapping",
+    "LabelFeedbackStrategy",
+    "NoFeedbackStrategy",
+    "RGBColorStrategy",
+    "ToggleStrategy",
+    "create_feedback_strategy",
+    "ViewerController",
+    "PadboundWidget",
+)

napari_padbound-0.2.0/src/napari_padbound/_tests/test_widget.py

@@ -0,0 +1,7 @@
+def test_widget(make_napari_viewer):
+    from napari_padbound import PadboundWidget
+
+    viewer = make_napari_viewer()
+    widget = PadboundWidget(viewer)
+
+    assert widget is not None

napari_padbound-0.2.0/src/napari_padbound/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.2.0'
+__version_tuple__ = version_tuple = (0, 2, 0)
+
+__commit_id__ = commit_id = None

napari_padbound-0.2.0/src/napari_padbound/control_mapper.py

@@ -0,0 +1,155 @@
+"""Control mapping for auto-discovering and assigning MIDI controls to features."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from pydantic import BaseModel, Field
+
+if TYPE_CHECKING:
+    from padbound import Controller
+    from padbound.controls import ControlDefinition
+
+
+class ControlMapping(BaseModel):
+    """Mapping of physical controls to napari features."""
+
+    coarse_slice: str | None = None  # control_id for coarse slice
+    fine_slice: str | None = None  # control_id for fine slice
+    zoom: str | None = None  # control_id for zoom
+    brush_size: str | None = None  # control_id for brush size
+    label_pads: list[str] = Field(default_factory=list)  # control_ids for labels
+
+    # Navigation button mappings
+    slice_up: str | None = None  # +1 slice step
+    slice_down: str | None = None  # -1 slice step
+    roll_left: str | None = None  # Roll dims left
+    roll_right: str | None = None  # Roll dims right
+
+    # Transport button mappings
+    undo: str | None = None  # Undo action (stop button)
+    redo: str | None = None  # Redo action (play button)
+
+
+class ControlMapper:
+    """Discovers and maps controller controls to napari features.
+
+    Automatically assigns controls based on their type and capabilities:
+    - Faders preferred for coarse slice control
+    - Knobs/encoders for fine slice, brush size, zoom
+    - Pads for label selection
+    """
+
+    def __init__(self, controller: Controller) -> None:
+        """Initialize the control mapper.
+
+        Args:
+            controller: The padbound Controller instance.
+        """
+        self.controller = controller
+        self.controls: list[ControlDefinition] = controller.get_controls()
+
+    def create_mapping(self) -> ControlMapping:
+        """Auto-discover and map controls based on capabilities.
+
+        Priority for continuous controls: fader > knob > encoder
+        All mapped controls come from the same bank (for multi-bank controllers).
+
+        Returns:
+            ControlMapping with assigned control IDs.
+        """
+        mapping = ControlMapping()
+
+        # Group controls by category
+        faders = [c for c in self.controls if c.category == "fader"]
+        knobs = [c for c in self.controls if c.category == "knob"]
+        encoders = [c for c in self.controls if c.category == "encoder"]
+        pads = [c for c in self.controls if c.category == "pad"]
+
+        # Determine primary bank from first fader (or first continuous control)
+        all_continuous = faders + knobs + encoders
+        primary_bank = all_continuous[0].bank_id if all_continuous else None
+
+        # Filter to primary bank only (None matches None for bankless controllers)
+        faders = [c for c in faders if c.bank_id == primary_bank]
+        knobs = [c for c in knobs if c.bank_id == primary_bank]
+        encoders = [c for c in encoders if c.bank_id == primary_bank]
+        pads = [c for c in pads if c.bank_id == primary_bank]
+
+        # Assign continuous controls (priority: fader > knob > encoder)
+        continuous = faders + knobs + encoders
+        if len(continuous) >= 1:
+            mapping.coarse_slice = continuous[0].control_id
+        if len(continuous) >= 2:
+            mapping.fine_slice = continuous[1].control_id
+        if len(continuous) >= 3:
+            mapping.brush_size = continuous[2].control_id
+        if len(continuous) >= 4:
+            mapping.zoom = continuous[3].control_id
+
+        # Assign pads for label selection
+        mapping.label_pads = [p.control_id for p in pads]
+
+        # Discover navigation buttons (for slice stepping and dim rolling)
+        nav_controls = [
+            c for c in self.controls
+            if c.category == "navigation" and c.bank_id == primary_bank
+        ]
+        for c in nav_controls:
+            cid = c.control_id.lower()
+            if cid in ("up", "nav_up") and mapping.slice_up is None:
+                mapping.slice_up = c.control_id
+            elif cid in ("down", "nav_down") and mapping.slice_down is None:
+                mapping.slice_down = c.control_id
+            elif cid in ("left", "nav_left") and mapping.roll_left is None:
+                mapping.roll_left = c.control_id
+            elif cid in ("right", "nav_right") and mapping.roll_right is None:
+                mapping.roll_right = c.control_id
+
+        # Discover transport buttons (for undo/redo)
+        transport_controls = [
+            c for c in self.controls
+            if c.category == "transport" and c.bank_id == primary_bank
+        ]
+        for c in transport_controls:
+            cid = c.control_id.lower()
+            if cid == "stop" and mapping.undo is None:
+                mapping.undo = c.control_id
+            elif cid == "play" and mapping.redo is None:
+                mapping.redo = c.control_id
+
+        return mapping
+
+    def get_mapping_info(self) -> str:
+        """Get human-readable description of the control mapping.
+
+        Returns:
+            Multi-line string describing the mapping.
+        """
+        mapping = self.create_mapping()
+        lines = []
+
+        if mapping.coarse_slice:
+            lines.append(f"Coarse slice: {mapping.coarse_slice}")
+        if mapping.fine_slice:
+            lines.append(f"Fine slice: {mapping.fine_slice}")
+        if mapping.brush_size:
+            lines.append(f"Brush size: {mapping.brush_size}")
+        if mapping.zoom:
+            lines.append(f"Zoom: {mapping.zoom}")
+        if mapping.label_pads:
+            lines.append(f"Label pads: {len(mapping.label_pads)} pads")
+        if mapping.slice_up:
+            lines.append(f"Slice up: {mapping.slice_up}")
+        if mapping.slice_down:
+            lines.append(f"Slice down: {mapping.slice_down}")
+        if mapping.roll_left:
+            lines.append(f"Roll left: {mapping.roll_left}")
+        if mapping.roll_right:
+            lines.append(f"Roll right: {mapping.roll_right}")
+        if mapping.undo:
+            lines.append(f"Undo: {mapping.undo}")
+        if mapping.redo:
+            lines.append(f"Redo: {mapping.redo}")
+
+        return "\n".join(lines) if lines else "No controls mapped"