Apply a selection change that originated on the canvas (issue #75) and mirror it onto the annotation list so Delete / Merge / Change C

Return ``(image_rgb, [{"mask": bool HxW}, ...])``.

Step back one edit. Returns the snapshot to restore, or None. ``current_snapshot`` (the live state) is moved onto the redo stack so a

Advance an in-progress shape resize/move, mutating the annotation's geometry in place so the canvas + selection overlay redraw live.

A tiny annotation-dict snapshot keyed by class name.

Overlay pen width: ui-scaled, zoom-compensated (constant on screen).

Single choke-point for canvas-tool activation. Makes all six tools (manual + SAM) mutually exclusive and keeps ``current_tool``, the

Push the pre-mutation snapshot; clear redo; cap depth. Skips the push when ``before_snapshot`` equals the current undo top (deep valu

Arm a resize/move of one selected shape. `kind` picks the geometry the handles drive: a polygon ("seg") scales/translates its vertices, a

Finish a shape drag: clamp into the image and persist if it actually moved; otherwise treat the press as a plain click → select.

Hex colour for the index-th class, cycling through DEFAULT_CLASS_COLORS. Callers wrap the result in ``QColor(...)`` (kept out of this module so t

Snapshot the pre-mutation state of one image for undo. Call *before* a synchronous mutation. ``key`` defaults to the current image; p

Axis-aligned bounds (x0, y0, x1, y1) of an annotation, or None. Falls through to the bbox when segmentation is absent/None/empty (imported

Handle id under pos for a shape's bounding box, or None. Grab radius is zoom-compensated so it stays a constant on-screen target.

Set a spin box without re-entering the rebalance handlers.

The selected annotation iff exactly one shape is selected and it has a bounding box (segmentation or bbox) — the state in which the handles

Coerce any stored/passed value to a usable point size. QSettings round-trips values as strings on some backends, and a hand-edited registry/I

Normalize image array to 8-bit range.

Reduce the vertex count of a flat ``[x1, y1, ...]`` polygon (Douglas- Peucker via ``cv2.approxPolyDP``) so users can trade detail for smaller

Resolve a press→release in select mode into a selection change. Shift makes it additive (drag) / toggling (click).

True when the canvas is idle (no drawing/SAM tool, not editing, no temp review) — the only state where bare clicks/drags select existi

Smallest-area annotation containing pos, or None. Covers both segmentation and bbox annotations and skips hidden classes. Smallest win

Calculate distance between two points.

True if the image (or, for multi-dim images, any of its slices) has at least one annotation.

Populate image_list in alphabetical order (upstream issue #60). Sorts the model (`all_images`) and the view together so the `all_imag

QImage → RGB numpy array. Returned array is a fresh copy. The naive ``np.frombuffer(qimage.constBits().asarray(N))`` aliases the QImage's pix

Translate a ``[x, y, w, h]`` box back inside the image **preserving its size** (shrinking only if it is larger than the image). For the move path:

Tight ``[x1, y1, x2, y2]`` bounding box of a bool mask, or None if empty.

Return ``(device, warning)``. ``device`` is ``"cuda"`` or ``"cpu"``; ``warning`` is None or a human-readable explanation of why CUDA was reje

Resolve a (possibly list-copied) annotation to the live object inside ``self.annotations`` — what the canvas renders and ``save_curren

New [x, y, w, h] after dragging `handle` to `pos`, keeping the opposite edge/corner fixed. Normalised so width/height never go negativ

Clamp every vertex of a flat ``[x1, y1, x2, y2, ...]`` polygon into the image rectangle ``[0, width] x [0, height]``. Per-coordinate clamping

Clip a flat ``[x1, y1, ...]`` polygon to the image rectangle via a shapely intersection, returning the flat exterior of the largest resulting

Fine-tune and save. Returns a small result dict; raises on failure. ``groups`` is an iterable of :class:`SampleGroup`. ``batch_size`` is a

A flat [x1,y1,...] polygon approximating a circle with n vertices.

Run fn on a worker thread; pump the calling thread's event loop until done; return the result. Re-raises exceptions on the caller. Looks sync

Disable/enable SAM inference controls + the fine-tune menu so no concurrent inference, model swap, or second training run can start wh

Merge needs ≥2 annotations; Change Class needs ≥1. Shared by the list-driven and canvas-driven (issue #75) selection paths.

Trim a ``[x, y, w, h]`` box to the image rectangle by clamping each corner independently, keeping it rectangular and at least 1x1. This is the

Clear the current annotation.

Export annotations in YOLO v5+ format. Directory structure: output_dir/ ├── data.yaml ├── images/ │ ├── train/

Return (font_pt, dark_mode), with defaults (10, True).

Convert QPoint to tuple.

True if a tifffile read failed because the imagecodecs package is unavailable for the TIFF's compression — e.g. LZW (#56). Matches on

Col-0 items of the selected rows, deduped. The table selects whole rows, but selectedItems()/selectedIndexes() yield a cell per column.