From ba8e766fe8bfc96bb461322d83c52ef1e35d34f4 Mon Sep 17 00:00:00 2001 From: bchanot Date: Tue, 17 Nov 2026 19:33:14 +0100 Subject: [PATCH] docs(docs): editor overlay zone handles, cap, redraw old outline --- docs/ANNOTATION-RENDERING.md | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/docs/ANNOTATION-RENDERING.md b/docs/ANNOTATION-RENDERING.md index abc42594..8a1a9c7f 100644 --- a/docs/ANNOTATION-RENDERING.md +++ b/docs/ANNOTATION-RENDERING.md @@ -177,6 +177,20 @@ The point handle covers the selected point's own circle (at least the hit radius), so the whole marker can be held. A chosen vertex is drawn bigger, filled and ringed, never by colour alone. +A selected polygon (zone, or a link traced as a polygon) gets its handles in +the same layer, in this order: one « + » at the midpoint of each segment +(wrapping from the last vertex to the first), then one vertex handle per +vertex, then the « − » bubble of the chosen vertex, drawn above that vertex +with a short stem. Each is a `role="button"` with `tabindex="0"`, so Tab and +Shift+Tab walk them in document order. A « + » is not drawn while its segment +is shorter than two hit radii on screen at the current zoom (R-9); Insert on +a vertex still reaches it. The « − » bubble is `aria-disabled` and greyed +while the polygon has three vertices. Above 40 vertices (`HANDLE_CAP`, T18) +the layer draws no handle at all: the overlay keeps the selection outline. +No handle covers the polygon's interior: a press inside it still reads the +core's markers, so an annotation drawn on top is the one a click reaches. A +path, or an annotation without geometry, gets no handle. + Marks of a gesture in progress, drawn by the overlay: - the old place: grey dashes of the stored shape while a drag, a move mode, a @@ -184,8 +198,11 @@ Marks of a gesture in progress, drawn by the overlay: - the preview itself: the selection outline at its new place or size; - the refused place: red dashes of the shape the core refused, while the refusal message is shown (the shape stays where it was); -- the move-mode target: the shape the mode moves (the selection, or later the - chosen vertex) keeps its handles; a drag anywhere on the drawing moves it. +- the move-mode target: the shape the mode moves (the selection, or the + chosen vertex) keeps its handles; a drag anywhere on the drawing moves it; +- a redraw (« Redessiner », or « Remplacer par un polygone » on a path): the + stored outline in grey dashes stays until the new tracing closes, without + vertices or handles; the new tracing is drawn as any tracing. The overlay only proposes geometry. Whether a position, a radius or a polygon is acceptable (frame, minimum visible size, interior) is the core's verdict on