lazylabel-gui 1.1.6__py3-none-any.whl → 1.1.7__py3-none-any.whl

lazylabel/ui/main_window.py

@@ -587,7 +587,7 @@ class MainWindow(QMainWindow):
         self.viewer.setFocus()
 
     def _load_selected_image(self, index):
-        """Load the selected image."""
+        """Load the selected image. Auto-saves previous work if enabled."""
 
         if not index.isValid() or not self.file_model.isDir(index.parent()):
             return
@@ -599,6 +599,12 @@ class MainWindow(QMainWindow):
             if path == self.current_image_path:  # Only reset if loading a new image
                 return
 
+            # Auto-save if enabled and we have a current image (not the first load)
+            if self.current_image_path and self.control_panel.get_settings().get(
+                "auto_save", True
+            ):
+                self._save_output_to_npz()
+
             self.current_image_path = path
             pixmap = QPixmap(self.current_image_path)
             if not pixmap.isNull():
@@ -634,12 +640,9 @@ class MainWindow(QMainWindow):
             self.model_manager.sam_model.set_image_from_path(self.current_image_path)
 
     def _load_next_image(self):
-        """Load next image in the file list, with auto-save if enabled."""
+        """Load next image in the file list."""
         if not self.current_file_index.isValid():
             return
-        # Auto-save if enabled
-        if self.control_panel.get_settings().get("auto_save", True):
-            self._save_output_to_npz()
         parent = self.current_file_index.parent()
         row = self.current_file_index.row()
         # Find next valid image file
@@ -651,12 +654,9 @@ class MainWindow(QMainWindow):
                 return
 
     def _load_previous_image(self):
-        """Load previous image in the file list, with auto-save if enabled."""
+        """Load previous image in the file list."""
         if not self.current_file_index.isValid():
             return
-        # Auto-save if enabled
-        if self.control_panel.get_settings().get("auto_save", True):
-            self._save_output_to_npz()
         parent = self.current_file_index.parent()
         row = self.current_file_index.row()
         # Find previous valid image file

lazylabel/ui/widgets/settings_widget.py

@@ -22,7 +22,7 @@ class SettingsWidget(QWidget):
         # Auto-save
         self.chk_auto_save = QCheckBox("Auto-Save on Navigate")
         self.chk_auto_save.setToolTip(
-            "Automatically save work when using arrow keys to change images."
+            "Automatically save work when switching to any new image (navigation keys, double-click, etc.)"
         )
         self.chk_auto_save.setChecked(True)
         layout.addWidget(self.chk_auto_save)

lazylabel_gui-1.1.7.dist-info/METADATA

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: lazylabel-gui
+Version: 1.1.7
+Summary: An image segmentation GUI for generating ML ready mask tensors and annotations.
+Author-email: "Deniz N. Cakan" <deniz.n.cakan@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Deniz N. Cakan
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/dnzckn/lazylabel
+Project-URL: Bug Tracker, https://github.com/dnzckn/lazylabel/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Environment :: X11 Applications :: Qt
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyQt6>=6.9.0
+Requires-Dist: pyqtdarktheme==2.1.0
+Requires-Dist: torch>=2.7.1
+Requires-Dist: torchvision>=0.22.1
+Requires-Dist: segment-anything==1.0
+Requires-Dist: numpy>=2.1.2
+Requires-Dist: opencv-python>=4.11.0.86
+Requires-Dist: scipy>=1.15.3
+Requires-Dist: requests>=2.32.4
+Requires-Dist: tqdm>=4.67.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.2.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Dynamic: license-file
+
+# <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo2.png" alt="LazyLabel Logo" style="height:60px; vertical-align:middle;" /> <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo_black.png" alt="LazyLabel Cursive" style="height:60px; vertical-align:middle;" />
+
+**AI-Assisted Image Segmentation Made Simple**
+
+LazyLabel combines Meta's Segment Anything Model (SAM) with intuitive editing tools for fast, precise image labeling. Perfect for machine learning datasets, computer vision research, and annotation workflows.
+
+![LazyLabel Screenshot](https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/gui.PNG)
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+```bash
+pip install lazylabel-gui
+lazylabel-gui
+```
+
+### Usage
+1. **Open Folder** → Select your image directory
+2. **Click on image** → AI generates instant masks  
+3. **Fine-tune** → Edit polygons, merge segments, adjust classes
+4. **Export** → Clean `.npz` files ready for ML training
+
+---
+
+## ✨ Key Features
+
+### **🧠 AI-Powered Segmentation**
+- **One-click masking** with Meta's SAM model
+- **Smart prompting** via positive/negative points
+- **Fragment filtering** to remove small artifacts
+- **Multiple model support** (VIT-H, VIT-L, VIT-B)
+
+### **🎨 Advanced Editing**
+- **Polygon drawing** with full vertex control
+- **Bounding box** annotation mode
+- **Shape merging** and class assignment
+- **Edit mode** for precision adjustments
+
+### **⚡ Productivity Tools**
+- **Image adjustments** (brightness, contrast, gamma) 
+- **Customizable hotkeys** for all functions
+- **Undo/redo** with full history
+- **Auto-save** and session persistence
+
+### **📊 ML-Ready Outputs**
+- **One-hot encoded** `.npz` format
+- **Clean class separation** with shape `(H, W, Classes)`
+- **Batch processing** support
+- **Existing mask loading** for iterative work
+
+---
+
+## ⌨️ Essential Controls
+
+| Mode | Key | Action |
+|------|-----|--------|
+| **AI Segmentation** | `1` | Point mode for SAM |
+| | `Left Click` | Add positive point |
+| | `Right Click` | Add negative point |
+| | `Space` | Save segment |
+| **Manual Drawing** | `2` | Polygon mode |
+| | `Left Click` | Add vertex |
+| | `Enter` | Close polygon |
+| **Editing** | `E` | Selection mode |
+| | `R` | Edit selected shapes |
+| | `M` | Merge selected segments |
+| **Navigation** | `Q` | Pan mode |
+| | `W/A/S/D` | Pan image |
+| | `Scroll` | Zoom in/out |
+
+**💡 All hotkeys are customizable** - Click "Hotkeys" button to personalize shortcuts
+
+---
+
+## 📦 Output Format
+
+LazyLabel exports clean, ML-ready data:
+
+```python
+import numpy as np
+
+# Load your labeled data
+data = np.load('your_image.npz')
+mask = data['mask']  # Shape: (height, width, num_classes)
+
+# Each channel is a binary mask for one class
+class_0_mask = mask[:, :, 0]  # Binary mask for class 0
+class_1_mask = mask[:, :, 1]  # Binary mask for class 1
+# ... and so on
+```
+
+**Perfect for:**
+- Semantic segmentation training
+- Instance segmentation datasets  
+- Computer vision research
+- Automated annotation pipelines
+
+---
+
+## 🛠️ Advanced Features
+
+### **Image Enhancement**
+- **Brightness/Contrast** adjustment sliders
+- **Gamma correction** for better visibility
+- **Live preview** of adjustments
+- **SAM integration** with adjusted images
+
+### **Smart Filtering**
+- **Fragment threshold** removes small segments
+- **Size-based filtering** (0-100% of largest segment)
+- **Quality control** for clean annotations
+
+### **Professional Workflow**
+- **Class management** with custom aliases
+- **Segment organization** with sortable tables
+- **Batch export** for large datasets
+- **Model switching** without restart
+
+---
+
+## 🏗️ Development
+
+### Installation from Source
+```bash
+git clone https://github.com/dnzckn/LazyLabel.git
+cd LazyLabel
+pip install -e .
+lazylabel-gui
+```
+
+### Code Quality & Testing
+```bash
+# Linting & formatting
+ruff check . && ruff format .
+
+# Run tests with coverage
+python -m pytest --cov=lazylabel --cov-report=html
+
+# All tests pass with 60%+ coverage
+```
+
+### Architecture
+- **Modular design** with clean separation of concerns
+- **Signal-based communication** between components  
+- **Extensible model system** for new SAM variants
+- **Comprehensive test suite** with 95% speed optimization
+
+---
+
+## 📋 Requirements
+
+- **Python 3.10+**
+- **OpenCV** for image processing
+- **PyQt6** for GUI
+- **NumPy** for data handling
+- **2.5GB** disk space for SAM model (auto-downloaded)
+
+---
+
+## 🤝 Contributing
+
+LazyLabel welcomes contributions! Check out our:
+- [Architecture Guide](src/lazylabel/ARCHITECTURE.md) for technical details
+- [Hotkey System](src/lazylabel/HOTKEY_FEATURE.md) for customization
+- Issues page for feature requests and bug reports
+
+---
+
+## 🙏 Acknowledgments
+
+LazyLabel was inspired by and builds upon the excellent work of:
+- [LabelMe](https://github.com/wkentaro/labelme) - The pioneering open-source image annotation tool
+- [Segment-Anything-UI](https://github.com/branislavhesko/segment-anything-ui) - Early SAM integration concepts
+
+---
+
+## ☕ Support
+
+If LazyLabel saves you time on annotation tasks, [consider supporting the project!](https://buymeacoffee.com/dnzckn)
+
+---
+
+**Made with ❤️ for the computer vision community**

{lazylabel_gui-1.1.6.dist-info → lazylabel_gui-1.1.7.dist-info}/RECORD

@@ -17,7 +17,7 @@ lazylabel/ui/editable_vertex.py,sha256=nAFC2UuFfbvMbGBbAiLWA77cS5-Hn3a08xe1_QLz2
 lazylabel/ui/hotkey_dialog.py,sha256=U_B76HLOxWdWkfA4d2XgRUaZTJPAAE_m5fmwf7Rh-5Y,14743
 lazylabel/ui/hoverable_pixelmap_item.py,sha256=kJFOp7WXiyHpNf7l73TZjiob85jgP30b5MZvu_z5L3c,728
 lazylabel/ui/hoverable_polygon_item.py,sha256=aclUwd0P8H8xbcep6GwhnfaVs1zSkqeZKAL-xeDyMiU,1222
-lazylabel/ui/main_window.py,sha256=zuszmw41849OXjBwVBc0TnBeuU4HZOJsJEurrzb_qbI,83764
+lazylabel/ui/main_window.py,sha256=7i0SQ3gX8RsRcnyrX2F9vaiKMigLU4iWApCQcVKgIqo,83728
 lazylabel/ui/numeric_table_widget_item.py,sha256=dQUlIFu9syCxTGAHVIlmbgkI7aJ3f3wmDPBz1AGK9Bg,283
 lazylabel/ui/photo_viewer.py,sha256=f93Mn9ajR2CYakJbbhhHvD5blKrwiGq3ZYgro-k2npc,4217
 lazylabel/ui/reorderable_class_table.py,sha256=sxHhQre5O_MXLDFgKnw43QnvXXoqn5xRKMGitgO7muI,2371
@@ -25,15 +25,15 @@ lazylabel/ui/right_panel.py,sha256=-PeXcu7Lr-xhZniBMvWLDPiFb_RAHYAcILyw8fPJs6I,1
 lazylabel/ui/widgets/__init__.py,sha256=bYjLRTqWdi4hcPfSSXmXuT-0c5Aee7HnnQurv_k5bfY,314
 lazylabel/ui/widgets/adjustments_widget.py,sha256=CJXtq19hfy12ggCA3_RMwETKNnVAQsn-rT_lIYxpAT4,13458
 lazylabel/ui/widgets/model_selection_widget.py,sha256=kMPaBMfdfnEVH-Be1d5OxLEuioO0c04FZT1Hr904axM,3497
-lazylabel/ui/widgets/settings_widget.py,sha256=qxVCiTYMQee95pE_FkFUXMCsmuo85LYdKeQYaCTrRVc,4829
+lazylabel/ui/widgets/settings_widget.py,sha256=ShTaLJeXxwrSuTV4kmtV2JiWjfREil2D1nvPUIfAgDs,4859
 lazylabel/ui/widgets/status_bar.py,sha256=wTbMQNEOBfmtNj8EVFZS_lxgaemu-CbRXeZzEQDaVz8,4014
 lazylabel/utils/__init__.py,sha256=V6IR5Gim-39HgM2NyTVT-n8gy3mjilCSFW9y0owN5nc,179
 lazylabel/utils/custom_file_system_model.py,sha256=-3EimlybvevH6bvqBE0qdFnLADVtayylmkntxPXK0Bk,4869
 lazylabel/utils/logger.py,sha256=R7z6ifgA-NY-9ZbLlNH0i19zzwXndJ_gkG2J1zpVEhg,1306
 lazylabel/utils/utils.py,sha256=sYSCoXL27OaLgOZaUkCAhgmKZ7YfhR3Cc5F8nDIa3Ig,414
-lazylabel_gui-1.1.6.dist-info/licenses/LICENSE,sha256=kSDEIgrWAPd1u2UFGGpC9X71dhzrlzBFs8hbDlENnGE,1092
-lazylabel_gui-1.1.6.dist-info/METADATA,sha256=6zAAWlFPc61dOus5FGTAeEp4AlwNnbUjQsmHHwSgATQ,9546
-lazylabel_gui-1.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-lazylabel_gui-1.1.6.dist-info/entry_points.txt,sha256=Hd0WwEG9OPTa_ziYjiD0aRh7R6Fupt-wdQ3sspdc1mM,54
-lazylabel_gui-1.1.6.dist-info/top_level.txt,sha256=YN4uIyrpDBq1wiJaBuZLDipIzyZY0jqJOmmXiPIOUkU,10
-lazylabel_gui-1.1.6.dist-info/RECORD,,
+lazylabel_gui-1.1.7.dist-info/licenses/LICENSE,sha256=kSDEIgrWAPd1u2UFGGpC9X71dhzrlzBFs8hbDlENnGE,1092
+lazylabel_gui-1.1.7.dist-info/METADATA,sha256=9C9ppy_0pAwHmlNKlP5_0i1mkqNLABpskyuRtRjxEwo,8064
+lazylabel_gui-1.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lazylabel_gui-1.1.7.dist-info/entry_points.txt,sha256=Hd0WwEG9OPTa_ziYjiD0aRh7R6Fupt-wdQ3sspdc1mM,54
+lazylabel_gui-1.1.7.dist-info/top_level.txt,sha256=YN4uIyrpDBq1wiJaBuZLDipIzyZY0jqJOmmXiPIOUkU,10
+lazylabel_gui-1.1.7.dist-info/RECORD,,

lazylabel_gui-1.1.6.dist-info/METADATA

@@ -1,244 +0,0 @@
-Metadata-Version: 2.4
-Name: lazylabel-gui
-Version: 1.1.6
-Summary: An image segmentation GUI for generating ML ready mask tensors and annotations.
-Author-email: "Deniz N. Cakan" <deniz.n.cakan@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2025 Deniz N. Cakan
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/dnzckn/lazylabel
-Project-URL: Bug Tracker, https://github.com/dnzckn/lazylabel/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Scientific/Engineering :: Image Processing
-Classifier: Environment :: X11 Applications :: Qt
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: PyQt6>=6.9.0
-Requires-Dist: pyqtdarktheme==2.1.0
-Requires-Dist: torch>=2.7.1
-Requires-Dist: torchvision>=0.22.1
-Requires-Dist: segment-anything==1.0
-Requires-Dist: numpy>=2.1.2
-Requires-Dist: opencv-python>=4.11.0.86
-Requires-Dist: scipy>=1.15.3
-Requires-Dist: requests>=2.32.4
-Requires-Dist: tqdm>=4.67.1
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
-Requires-Dist: pytest-qt>=4.2.0; extra == "dev"
-Requires-Dist: ruff>=0.8.0; extra == "dev"
-Dynamic: license-file
-
-# <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo2.png" alt="LazyLabel Logo" style="height:60px; vertical-align:middle;" /> <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo_black.png" alt="LazyLabel Cursive" style="height:60px; vertical-align:middle;" />
-
-LazyLabel is an intuitive, AI-assisted image segmentation tool built with a modern, modular architecture. It uses Meta's Segment Anything Model (SAM) for quick, precise mask generation, alongside advanced polygon editing for fine-tuned control. Features comprehensive model management, customizable hotkeys, and outputs in clean, one-hot encoded `.npz` format for easy machine learning integration.
-
-Inspired by [LabelMe](https://github.com/wkentaro/labelme?tab=readme-ov-file#installation) and [Segment-Anything-UI](https://github.com/branislavhesko/segment-anything-ui/tree/main).
-
-![LazyLabel Screenshot](https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/gui.PNG)
-
----
-
-## ✨ Core Features
-
-### **AI-Powered Segmentation**
-* Generate masks with simple left-click (positive) and right-click (negative) interactions
-* Multiple SAM model support with easy switching
-* Custom model loading from any directory
-
-### **Advanced Editing Tools**
-* **Vector Polygon Tool**: Full control to draw, edit, and reshape polygons
-* **Vertex Editing**: Drag vertices or move entire shapes with precision
-* **Selection & Merging**: Select, merge, and re-order segments intuitively
-
-### **Professional Workflow**
-* **Customizable Hotkeys**: Personalize keyboard shortcuts for all functions
-* **Advanced Class Management**: Assign multiple segments to single class IDs
-* **Smart I/O**: Load existing `.npz` masks; save as clean, one-hot encoded outputs
-* **Interactive UI**: Color-coded segments, sortable lists, and hover highlighting
-
-### **Modern Architecture**
-* **Modular Design**: Clean, maintainable codebase with separated concerns
-* **Model Management**: Dedicated model storage and switching system
-* **Persistent Settings**: User preferences saved between sessions
-
----
-
-## 🚀 Getting Started
-
-### Prerequisites
-**Python 3.10+**
-
-### Installation
-
-#### For Users [via PyPI](https://pypi.org/project/lazylabel-gui/)
-1.  Install LazyLabel directly:
-    ```bash
-    pip install lazylabel-gui
-    ```
-2.  Run the application:
-    ```bash
-    lazylabel-gui
-    ```
-
-#### For Developers (from Source)
-1.  Clone the repository:
-    ```bash
-    git clone https://github.com/dnzckn/LazyLabel.git
-    cd LazyLabel
-    ```
-2.  Install in editable mode:
-    ```bash
-    pip install -e .
-    ```
-3.  Run the application:
-    ```bash
-    lazylabel-gui
-    ```
-
-### Model Management
-* **Default Storage**: Models are stored in `src/lazylabel/models/` directory
-* **Custom Models**: Click "Browse Models" to select custom model folders  
-* **Model Switching**: Use the dropdown to switch between available models
-* **Auto-Detection**: Application automatically detects all `.pth` files in selected directories
-
-**Note**: On the first run, the application will automatically download the SAM model checkpoint (~2.5 GB) from Meta's repository to the models directory. This is a one-time download.
-
----
-
-## ⌨️ Controls & Keybinds
-
-> **💡 Tip**: All hotkeys are fully customizable! Click the "Hotkeys" button in the control panel to personalize your shortcuts.
-
-### Modes
-| Key | Action |
-|---|---|
-| `1` | Enter **Point Mode** (for AI segmentation). |
-| `2` | Enter **Polygon Drawing Mode**. |
-| `3` | Enter **Bounding Box Mode**. |
-| `E` | Toggle **Selection Mode** to select existing segments. |
-| `R` | Enter **Edit Mode** for selected polygons (drag shape or vertices). |
-| `Q` | Toggle **Pan Mode** (click and drag the image). |
-
-### Actions
-| Key(s) | Action |
-|---|---|
-| `L-Click` | Add positive point (Point Mode) or polygon vertex. |
-| `R-Click` | Add negative point (Point Mode). |
-| `Ctrl + Z` | Undo last action. |
-| `Ctrl + Y` / `Ctrl + Shift + Z` | Redo last action. |
-| `Spacebar` | Finalize and save current AI segment. |
-| `Enter` | **Save final mask for the current image to a `.npz` file.** |
-| `M` | **Merge** selected segments into a single class. |
-| `V` / `Delete` / `Backspace`| **Delete** selected segments. |
-| `C` | Clear temporary points/vertices. |
-| `W/A/S/D` | Pan image. |
-| `Scroll Wheel` | Zoom-in or -out. |
-
----
-
-## 📦 Output Format
-
-LazyLabel saves your work as a compressed NumPy array (`.npz`) with the same name as your image file.
-
-The file contains a single data key, `'mask'`, holding a **one-hot encoded tensor** with the shape `(H, W, C)`:
-* `H`: Image height.
-* `W`: Image width.
-* `C`: Total unique classes.
-
-Each channel is a binary mask for a class, combining all assigned segments into a clean, ML-ready output.
-
----
-
-## 🏗️ Architecture
-
-LazyLabel features a modern, modular architecture designed for maintainability and extensibility:
-
-* **Modular Design**: Clean separation between UI, business logic, and configuration
-* **Signal-Based Communication**: Loose coupling between components using PyQt signals
-* **Persistent Configuration**: User settings and preferences saved between sessions
-* **Extensible Model System**: Easy integration of new SAM models and types
-
-For detailed technical documentation, see [ARCHITECTURE.md](src/lazylabel/ARCHITECTURE.md).
-
----
-
-## ⌨️ Hotkey Customization
-
-LazyLabel includes a comprehensive hotkey management system:
-
-* **Full Customization**: Personalize keyboard shortcuts for all 27+ functions
-* **Category Organization**: Hotkeys organized by function (Modes, Actions, Navigation, etc.)
-* **Primary & Secondary Keys**: Set multiple shortcuts for the same action
-* **Persistent Settings**: Custom hotkeys saved between sessions
-* **Conflict Prevention**: System prevents duplicate key assignments
-
-For complete hotkey documentation, see [HOTKEY_FEATURE.md](src/lazylabel/HOTKEY_FEATURE.md).
-
-## Development
-
-### Code Quality
-This project uses Ruff for linting and formatting:
-
-```bash
-# Activate virtual environment first
-& e:\venv\lazylabel\Scripts\Activate.ps1
-
-# Run linter
-ruff check .
-
-# Fix auto-fixable issues
-ruff check --fix .
-
-# Format code
-ruff format .
-
-# Check if code is properly formatted
-ruff format --check .
-```
-
-### Testing
-
-Run tests using pytest:
-
-```bash
-# Run all tests
-python -m pytest
-
-# Run tests with coverage
-python -m pytest --cov=lazylabel --cov-report=html --cov-report=term-missing
-
-# Run specific test file
-python -m pytest tests/unit/ui/test_undo_redo.py -v
-```
-
-The HTML coverage report will be generated in `htmlcov/` directory.
-
----
-
-## ☕ Support LazyLabel
-[If you found LazyLabel helpful, consider supporting the project!](https://buymeacoffee.com/dnzckn)