lannotex 0.1.0__tar.gz → 0.2.0__tar.gz

{lannotex-0.1.0 → lannotex-0.2.0}/CHANGELOG.md

@@ -6,6 +6,64 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.2.0] — 2026-10-14
+
+Viewing, speed and layout: sharp zoom on large images, instant navigation, and a
+workspace you can arrange yourself.
+
+### Added
+
+- **Full-resolution viewing.** Zooming in past the preview loads the original pixels in the
+  background, so large images stay sharp at any zoom. Only the visible region is drawn.
+  Detail decoding is capped at 64 MP to protect memory.
+- **Instant next/previous.** Neighbouring images are decoded ahead of time.
+- **Minimap** (`M`) for orientation and click-to-jump, and a **pixel grid** (`G`) from
+  1200% zoom upwards.
+- **Zoom controls:** actual pixels (`Ctrl+1`), zoom in/out (`Ctrl+=` / `Ctrl+-`) up to
+  6400%. The zoom readout now shows true pixel scale, so 100% means actual pixels.
+- **Image adjustments:** brightness, contrast and gamma in a new **Image view** panel. They
+  change the display only, never your files, and are applied just to the visible region, so
+  they stay fast on large images.
+- **Dockable panels:** Dataset, Inspector and Image view can be moved, tabbed, floated onto
+  another monitor, or closed. Your layout is remembered between sessions. Use
+  **View → Panels** to bring a panel back or apply a preset (default, or all panels on the
+  right). Focus mode hides every panel and restores your exact layout afterwards.
+- **Thumbnails in the image list**, generated in the background with the rows you can see
+  first. They're cached on disk in your user cache folder, not the project, so reopening a
+  project is instant. The cache is capped at 512 MB. Toggle them under **View → Show
+  thumbnails in image list**.
+- **Icons:** a consistent line-icon set for the toolbar, navigation and Home screen,
+  redrawn for light and dark themes, plus the Lannotex logo as the window icon. Icon-only
+  buttons have tooltips and screen-reader names.
+- **Command palette** (`Ctrl+K`): type part of any menu command, for example "zoom",
+  "export" or "layout", and press Enter to run it.
+- **Number keys 1–9** choose the drawing label, which relabels the selected shape, or
+  toggle classes in classification projects.
+- **Project → Import LabelMe folder…** imports a whole folder, including subfolders.
+
+### Changed
+
+- **LabelMe import keeps going.**
+  - Circles and rotated rectangles are converted to polygons.
+  - Points, lines and masks, which Lannotex can't draw yet, are skipped and counted in the
+    import summary instead of rejecting the whole file.
+  - Invalid shapes are dropped one at a time.
+  - A malformed JSON file no longer stops the rest of the folder.
+
+### Fixed
+
+- PySide6 6.12.0 is excluded. On Linux with Python 3.11 it over-releases references on every
+  background job, which made Lannotex abort on exit. Versions 6.8.3–6.11 are unaffected.
+
+## [0.1.1] — 2026-10-14
+
+### Changed
+
+- **YOLO export is ready to train with Ultralytics:** `images/` (hard-linked when
+  possible, otherwise copied), matching `labels/`, and a `data.yaml` with class names.
+  Images that haven't been annotated yet are left out, so they don't become false
+  negatives.
+
 ## [0.1.0] — 2026-10-14
 
 First public release on PyPI: `pip install lannotex` or `uv tool install lannotex`.

{lannotex-0.1.0 → lannotex-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lannotex
-Version: 0.1.0
+Version: 0.2.0
 Summary: Fast, offline-first image annotation for classifications, boxes, and polygons.
 Author: Lourdhu Raju
 Maintainer: Lourdhu Raju
@@ -30,7 +30,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSES/THIRD_PARTY_NOTICES.md
-Requires-Dist: PySide6-Essentials<7,>=6.8.3
+Requires-Dist: PySide6-Essentials!=6.12.0,<7,>=6.8.3
 Requires-Dist: Pillow>=11.1
 Provides-Extra: dev
 Requires-Dist: pytest>=8.3; extra == "dev"
@@ -131,9 +131,10 @@ Every shortcut can be remapped. See the [annotating guide](https://lourdhu02.git
 | | |
 | --- | --- |
 | **Annotate** | Bounding boxes · polygons with vertex drag, insert, and delete · multi-label image classes · "no target" negatives · 100-step undo/redo · zoom under the pointer, pan, arrow-key nudging · focus mode · light and dark themes |
+| **View** | Sharp full-resolution zoom up to 6400% · next/previous images decoded ahead · minimap · pixel grid · brightness, contrast and gamma · thumbnails · dockable panels you can float onto a second monitor, with saved layouts · `Ctrl+K` command palette |
 | **Stay safe** | SQLite projects with versioned migrations · recovery drafts and 700 ms autosave · transactional saves · geometry validation · backup and restore · relinking for moved images · EXIF orientation handled |
 | **Scale** | Virtualized image list (at most 1,024 records in memory) · background import and decoding · 96 MB preview cache · coordinates normalized to the original resolution |
-| **Export** | Labelme JSON · YOLO · COCO JSON · classification CSV · lossless native JSONL · each export reports anything it skipped |
+| **Export** | Labelme JSON · ready-to-train YOLO (`images/`, `labels/`, `data.yaml`) · COCO JSON · classification CSV · lossless native JSONL · each export reports anything it skipped |
 | **Automate** | `lannotex export` and `lannotex analyze` run headless in CI, with no display needed |
 | **Collaborate** | Optional LAN host with per-reviewer tokens, background sync, revision conflicts you resolve explicitly, revocation, and an audit history |
 
@@ -181,8 +182,8 @@ hashes. There is no telemetry, no external AI service, and no automatic upload.
 
 ## Roadmap
 
-Next up: a ready-to-train YOLO layout (`images/`, `labels/`, `data.yaml`), more LabelMe
-shape types, VOC and YOLO-seg export, and number-key label selection. See the
+Next up: point, line, rotated-box, keypoint and brush-mask tools, per-object attributes,
+and VOC, YOLO-seg and YOLO-OBB export. See the
 [roadmap](https://lourdhu02.github.io/Lannotex/ROADMAP/) and the
 [measured performance](https://lourdhu02.github.io/Lannotex/PERFORMANCE/).
 

{lannotex-0.1.0 → lannotex-0.2.0}/README.md

@@ -89,9 +89,10 @@ Every shortcut can be remapped. See the [annotating guide](https://lourdhu02.git
 | | |
 | --- | --- |
 | **Annotate** | Bounding boxes · polygons with vertex drag, insert, and delete · multi-label image classes · "no target" negatives · 100-step undo/redo · zoom under the pointer, pan, arrow-key nudging · focus mode · light and dark themes |
+| **View** | Sharp full-resolution zoom up to 6400% · next/previous images decoded ahead · minimap · pixel grid · brightness, contrast and gamma · thumbnails · dockable panels you can float onto a second monitor, with saved layouts · `Ctrl+K` command palette |
 | **Stay safe** | SQLite projects with versioned migrations · recovery drafts and 700 ms autosave · transactional saves · geometry validation · backup and restore · relinking for moved images · EXIF orientation handled |
 | **Scale** | Virtualized image list (at most 1,024 records in memory) · background import and decoding · 96 MB preview cache · coordinates normalized to the original resolution |
-| **Export** | Labelme JSON · YOLO · COCO JSON · classification CSV · lossless native JSONL · each export reports anything it skipped |
+| **Export** | Labelme JSON · ready-to-train YOLO (`images/`, `labels/`, `data.yaml`) · COCO JSON · classification CSV · lossless native JSONL · each export reports anything it skipped |
 | **Automate** | `lannotex export` and `lannotex analyze` run headless in CI, with no display needed |
 | **Collaborate** | Optional LAN host with per-reviewer tokens, background sync, revision conflicts you resolve explicitly, revocation, and an audit history |
 
@@ -139,8 +140,8 @@ hashes. There is no telemetry, no external AI service, and no automatic upload.
 
 ## Roadmap
 
-Next up: a ready-to-train YOLO layout (`images/`, `labels/`, `data.yaml`), more LabelMe
-shape types, VOC and YOLO-seg export, and number-key label selection. See the
+Next up: point, line, rotated-box, keypoint and brush-mask tools, per-object attributes,
+and VOC, YOLO-seg and YOLO-OBB export. See the
 [roadmap](https://lourdhu02.github.io/Lannotex/ROADMAP/) and the
 [measured performance](https://lourdhu02.github.io/Lannotex/PERFORMANCE/).
 

{lannotex-0.1.0 → lannotex-0.2.0}/docs/guide/annotating.md

@@ -8,7 +8,10 @@
 | Box | ++b++ | Drag from one corner to the opposite corner. |
 | Polygon | ++p++ | Click to add vertices; ++enter++ finishes, ++escape++ cancels. |
 
-The label selected in the **Labels & annotations** panel is applied to new shapes.
+The label selected in the **Labels & annotations** panel is applied to new shapes. Press
+++1++–++9++ to choose the first nine labels, in alphabetical order. If a shape is selected,
+it is relabelled. In classification projects, the number keys toggle classes on the
+current image instead.
 
 ### Editing polygons
 
@@ -22,16 +25,38 @@ The label selected in the **Labels & annotations** panel is applied to new shape
 
 | Action | Control |
 | --- | --- |
-| Zoom | Mouse wheel (zooms under the pointer) |
-| Pan | Hold ++space++ and drag |
+| Zoom | Mouse wheel (zooms under the pointer), ++ctrl+equal++ / ++ctrl+minus++ |
+| Actual pixels (100%) | ++ctrl+1++ |
+| Pan | Hold ++space++ and drag, or click and drag in the minimap |
 | Fit to window | ++f++ |
+| Minimap on/off | ++m++ |
+| Pixel grid on/off (from 1200%) | ++g++ |
 | Nudge selection | Arrow keys (hold ++shift++ for a 10× step) |
 | Focus mode (hide panels) | ++ctrl+shift+f++ |
 
+## Image adjustments
+
+The **Image view** panel has brightness, contrast and gamma sliders for dark, washed-out or
+low-contrast images. They change only what you see, never your files or the exported data.
+**Reset adjustments**, or **View → Reset image adjustments**, returns to the original.
+
+## Arranging the workspace
+
+The **Dataset**, **Inspector** and **Image view** panels are dockable:
+
+- Drag a panel's title bar to move it to another side, or onto another panel to tab them.
+- Use the float button to detach a panel, for example onto a second monitor.
+- Close panels you don't need. **View → Panels** lists them all so you can bring them back.
+- **View → Panels → Default layout** and **All panels on the right** are one-click presets.
+- **Focus mode** (++ctrl+shift+f++) hides every panel. Press it again to restore your layout.
+
+Your layout is saved when you close Lannotex.
+
 ## Keyboard reference
 
 | Action | Default |
 | --- | --- |
+| Command palette: search and run any command | ++ctrl+k++ |
 | Save | ++ctrl+s++ |
 | Save & next | ++ctrl+enter++ |
 | Previous / next image | ++alt+left++ / ++alt+right++ |
@@ -57,9 +82,11 @@ dataset:
 
 ## Coordinates
 
-Geometry is stored **normalized** (0–1) relative to the original image size. Large
-images are displayed as a preview capped at 2,560 px on the longest side, but stored
-coordinates and exports always use the original resolution. EXIF orientation is
-respected.
+Geometry is stored **normalized** (0–1) relative to the original image size. Images open
+as a fast preview (up to 2,560 px). When you zoom in past that, Lannotex loads the
+original pixels in the background, so the image stays sharp up to 6400%. The zoom
+readout shows true scale: 100% means one image pixel per screen pixel. Full-resolution
+detail is available for images up to 64 megapixels; larger images stay on the preview.
+EXIF orientation is respected.
 
 Undo history keeps the last 100 changes for the image you're working on.

{lannotex-0.1.0 → lannotex-0.2.0}/docs/guide/import-export.md

@@ -5,7 +5,7 @@
 | Format | Contains | Use it for |
 | --- | --- | --- |
 | **Labelme JSON** | One JSON per image: boxes as `rectangle`, polygons, classes as `flags` | LabelMe and tools that read its format |
-| **YOLO boxes** | One `.txt` per image: `class cx cy w h`, normalized | YOLO detection training |
+| **YOLO boxes** | Ready-to-train Ultralytics dataset: `images/`, `labels/`, `data.yaml` | YOLO detection training |
 | **COCO JSON** | One `coco.json` with boxes, polygon segmentations, and areas | Detection and instance segmentation |
 | **Classification CSV** | One row per image, one 0/1 column per class | Image classification |
 | **Native JSONL** | Every annotation with its ID and status | Lossless backup and round-trips |
@@ -24,10 +24,11 @@ Lannotex-export-1a2b3c4d/
 ├── classification.csv
 ├── images.jsonl
 ├── annotations.jsonl
-└── 00000001_street.json   # per-image files (Labelme JSON / YOLO .txt)
+└── 00000001_street.json   # per-image files (Labelme JSON)
 ```
 
-Images are **referenced, not copied**: exported records point to the original files.
+Images are **referenced, not copied**: exported records point to the original files. YOLO
+is the exception, described below.
 
 ### What gets skipped
 
@@ -39,11 +40,30 @@ An image is left out of the export, and listed in `manifest.json`, if:
 
 Run **View → Analysis** or `lannotex analyze` beforehand to find these images.
 
-!!! note "Training with Ultralytics YOLO"
-    The YOLO export writes label files named `<id>_<image name>.txt` plus `classes.json`.
-    Ultralytics expects `images/` and `labels/` folders with matching file names and a
-    `data.yaml`, so you currently have to arrange those yourself. A ready-to-train layout is
-    planned.
+### YOLO: ready to train
+
+The YOLO export is a complete [Ultralytics](https://docs.ultralytics.com/datasets/detect/)
+dataset:
+
+```text
+Lannotex-export-1a2b3c4d/
+├── data.yaml              # path, train/val, class names
+├── images/00000001_street.jpg
+└── labels/00000001_street.txt   # class cx cy w h, normalized
+```
+
+```bash
+yolo detect train data=Lannotex-export-1a2b3c4d/data.yaml model=yolo11n.pt
+```
+
+- Images are **hard-linked** into `images/` when the export is on the same drive, so they
+  take no extra space. Otherwise they're copied. Your originals are never modified.
+- Images marked **No target objects** get an empty label file, so YOLO learns them as
+  background.
+- Images you haven't annotated yet are **left out**. If they were included, YOLO would
+  treat them as "nothing here".
+- `train` and `val` point at the same images. Split them yourself for a real evaluation.
+- If you move the export folder, update `path:` in `data.yaml`.
 
 ## Importing annotations
 

{lannotex-0.1.0 → lannotex-0.2.0}/docs/migrate-from-labelme.md

@@ -6,8 +6,9 @@ and still hand files back to LabelMe users.
 ## Import a LabelMe folder
 
 1. Create a project (**Combined pipeline** enables every tool).
-2. Choose **Project → Import annotations…** and select the folder that contains your
-   LabelMe `.json` files.
+2. Choose **Project → Import LabelMe folder…** and select the folder that contains your
+   LabelMe `.json` files. Subfolders are included. Use **Import annotations…** for a single
+   file.
 3. Lannotex reads each file, finds the image through its `imagePath`, checks that the
    dimensions match, and creates any missing labels.
 
@@ -19,16 +20,19 @@ Your LabelMe JSON files and images are left untouched.
 | --- | --- |
 | `rectangle` shapes | Bounding boxes |
 | `polygon` shapes | Polygons |
+| `circle` shapes | Polygons (32 points around the circle) |
+| `rotation` (rotated rectangle) shapes | Polygons with the four corners |
 | `flags` set to `true` | Image classes |
 | Image files via `imagePath` | Referenced in place, not copied |
 
 !!! warning "Current limitations"
-    - Files containing `circle`, `line`, `linestrip`, `point`, or `mask` shapes are
-      rejected **as a whole file**, and the error list names them. Support for these
-      shapes is planned.
+    - `point`, `line`, `linestrip` and `mask` shapes are **skipped**. The rest of each file
+      still imports, and the import summary lists how many of each were skipped. Support
+      for these shapes is planned.
+    - Shapes with invalid geometry, such as a polygon with fewer than 3 points, are skipped
+      and listed the same way.
     - `imageData` embedded in the JSON isn't used. The image file must exist on disk.
     - `group_id`, `description`, and per-shape `flags` aren't imported.
-    - Only JSON files directly inside the chosen folder are read, not subfolders.
 
 ## Export back to LabelMe
 

{lannotex-0.1.0 → lannotex-0.2.0}/pyproject.toml

@@ -32,7 +32,9 @@ classifiers = [
 ]
 # Ranges, not pins: exact pins break installs on newer Pythons. Release binaries pin
 # their full set in requirements-windows-build.txt.
-dependencies = ["PySide6-Essentials>=6.8.3,<7", "Pillow>=11.1"]
+# PySide6 6.12.0 over-releases None/True on every QThreadPool job and worker-thread signal,
+# which aborts Python 3.11 on Linux at exit ("bool_dealloc"); 6.8.3-6.11.0 are unaffected.
+dependencies = ["PySide6-Essentials>=6.8.3,<7,!=6.12.0", "Pillow>=11.1"]
 
 [project.optional-dependencies]
 dev = [

{lannotex-0.1.0 → lannotex-0.2.0}/src/lannotex/__init__.py

@@ -1,2 +1,2 @@
 """Lannotex: offline-first image annotation."""
-__version__ = "0.1.0"
+__version__ = "0.2.0"