napari_track_edit.data_views.keybindings_config
===============================================

.. py:module:: napari_track_edit.data_views.keybindings_config

.. autoapi-nested-parse::

   Unified keybindings configuration for both napari layers and Qt widgets.

   This module defines all keybindings in a unified way, specifying:
   - The action to perform (method name)
   - Keys for napari layers (string format)
   - Keys for Qt widgets (Qt.Key constants)
   - Optionally the Qt modifier that must be held ("qt_modifiers", default: none)
   - The target(s) for the action: "tracks_viewer", "tree_widget", or both

   An action can target multiple objects. It will be available in the following ways:
   - napari layers: if "tracks_viewer" is in targets
   - Qt table_widget: if "tracks_viewer" is in targets
   - Qt tree_widget: if "tree_widget" is in targets



Attributes
----------

.. autoapisummary::

   napari_track_edit.data_views.keybindings_config.KEYBINDINGS
   napari_track_edit.data_views.keybindings_config.SPECIAL_KEYBINDS
   napari_track_edit.data_views.keybindings_config.KEYMAP
   napari_track_edit.data_views.keybindings_config.GENERAL_KEY_ACTIONS
   napari_track_edit.data_views.keybindings_config.shift
   napari_track_edit.data_views.keybindings_config.TREE_WIDGET_SPECIFIC_ACTIONS
   napari_track_edit.data_views.keybindings_config.shift
   napari_track_edit.data_views.keybindings_config.TREE_WIDGET_MODIFIER_ACTIONS
   napari_track_edit.data_views.keybindings_config.TREE_WIDGET_NAVIGATION_KEYS


Functions
---------

.. autoapisummary::

   napari_track_edit.data_views.keybindings_config.bind_keymap
   napari_track_edit.data_views.keybindings_config.resolve_key_action


Module Contents
---------------

.. py:function:: bind_keymap(target: napari_track_edit.data_views.views.layers.track_points.TrackPoints | napari.layers.Points | napari_track_edit.data_views.views.layers.track_labels.TrackLabels | napari.layers.Labels, keymap: dict[str, str], tracks_viewer: napari_track_edit.data_views.views_coordinator.tracks_viewer.TracksViewer)

   Bind all keys in `keymap` to the corresponding methods on `tracks_viewer` to the
   target layer. This should be an instance of (Track)Labels or (Track)Points


.. py:data:: KEYBINDINGS

.. py:data:: SPECIAL_KEYBINDS

.. py:data:: KEYMAP

.. py:data:: GENERAL_KEY_ACTIONS

.. py:data:: shift

.. py:data:: TREE_WIDGET_SPECIFIC_ACTIONS

.. py:data:: shift

.. py:function:: resolve_key_action(actions: dict, event: qtpy.QtGui.QKeyEvent) -> str | None

   Look up the action name bound to a Qt key event in `actions`, which is keyed by
   (Qt key constant, whether shift is held).


.. py:data:: TREE_WIDGET_MODIFIER_ACTIONS

.. py:data:: TREE_WIDGET_NAVIGATION_KEYS