Keep a stored bbox key consistent with an edited segmentation. Imported annotations carry both (the bbox feeds export / SAM training);

Hover feedback in select mode: resize cursors over a selected shape's handles, a move cursor over its interior, arrow otherwise.

All annotations whose bounds intersect the rubber-band rect. rect is (x0, y0, x1, y1) in image coords (any corner order).

Hide image-list rows that don't match the annotation-status filter (upstream issue #27). Rows are hidden via setRowHidden, never remo

Wipe all stored phrases. Used by clear_all / new project.

Turn off SAM box / points and clear any pending SAM state. Called before YOLO predictions overlay their own temp results and when the

Build a fine-tuned checkpoint path under ``SAM_CUSTOM_DIR``. Ultralytics' ``build_sam`` selects the architecture by ``ckpt.endswith(token)``

Set the pixmap and update the scaled version.

Hit-test a single annotation (segmentation polygon or bbox). Falls through to the bbox when segmentation is absent/None/empty — an imported

Handle id -> (x, y) for the 8 resize handles of an AABB (x0, y0, x1, y1). Shared by the selection overlay (draw) and the handle hit-te

SAM's mask supervision: focal + dice, ≈20:1 (focal:dice). ``logits`` and ``target`` are ``(1, 1, H, W)`` on the same device; target is float

Canonical local install path for a Grounding DINO model.

Append one annotation as a table row. valueChanged is connected *after* the initial setValue so building the table never fires the sim

Overlay label font: ui-scaled, zoom-compensated (constant on screen).

Navigate to first image with batch results for review. If the next entry refers to an image/slice that's no longer in the project (e.

Live project annotations → ``list[SampleGroup]``. Images load lazily (one at a time during training) to bound memory; in-RAM slice QImages ar

Calculate the centroid of a polygon.

Push the baseline captured by capture_edit_baseline onto the undo stack. Called when a deferred gesture actually commits. The history

Draw all annotations on the image.

Handle mouse movement during polygon editing.

Show the CUDA-incompatibility warning as a dialog, once per session. No-op when the device resolved cleanly (CUDA usable, or no GPU at all —

Flat ``[x1,y1,x2,y2,...]`` polygon → bool mask (inverse of ``sam_utils._mask_to_polygon``).

Reset the annotation state.

Called by ImageAnnotator when the user switches tools. Gives the previous handler a chance to clean up (default no-op preserves the ex

Build class_configs from threshold table + phrase panel.

Escape during a shape drag: restore the original geometry, drop it.

Commit DINO+SAM results to annotations for a single image. If image_name is the currently-displayed image, route through image_label.

If the preset model isn't on disk yet, download it. Returns success.

Sync ``image_label.temp_annotations`` to whatever the currently-displayed image/slice has stored in ``dino_batch_results``. Called fro

Return the canonical local path for a preset DINO model, or None if unknown.

Apply a whole-image snapshot back onto the live model and refresh the canvas + list. Independent deep copies break the shallow-copy al

Map every canvas tool name to its toolbar button. SAM tools share the same exclusive set as the manual tools (only one is ever active).

Shift every vertex by (dx, dy).

Undo/redo are no-ops while a project loads, a modal is open, a text field has focus, or an edit/draw gesture is in flight.

``[x, y, w, h]`` → bool mask.

Read a folder produced by ``export_sam_dataset`` → ``list[SampleGroup]``. Expects ``<folder>/manifest.json`` with entries ``{"image": "images