Path Precision Tools: test that every Tangents choice keeps the same lines from a point

The dialog test for a point now compares the previewed lines' end points
across the External, Internal and All choices, confirms OK with each choice
and checks that the kept lines are the previewed ones, then undoes.

The params text, docs/mcp.md and the parity doc now say "at most" the
touching tolerance, matching the comparison in the code, and the parity doc
gives the tolerance's value.
This commit is contained in:
dotCooCoo
2026-11-18 06:02:24 -08:00
parent dce8a0c05e
commit e2dec218c8
4 changed files with 38 additions and 9 deletions
+2 -2
View File
@@ -13417,12 +13417,12 @@ Commands:
only. A path inside the other has none. Paths that touch, from outside or from inside, share one tangent there
instead: a line centered on the point where they touch and as long as the narrower path is wide along it. Paths
that meet at a corner or along a shared stretch of outline get one such line, at the middle of the directions that
touch both. Paths count as touching when the gap between them is less than the tolerance, a billionth of the larger
touch both. Paths count as touching when the gap between them is at most the tolerance, a billionth of the larger
of their sizes and the distance between their centers. One of the two may be a point instead, a path of one
anchor: the lines then run from the point to where they touch the path, two when the point lies outside it (one
that lies along a straight side covers the whole side), one when the point lies on its outline (centered on the
point and as long as the path is wide along it, or the whole straight side the point lies on), and none when it
lies inside. The point counts as on the outline when it is less than the touching tolerance from it, with the
lies inside. The point counts as on the outline when it is at most the touching tolerance from it, with the
point's distance from the path's center in place of the distance between centers. Every `tangents` value gives
the same lines, counted in `internal` when `tangents` is `internal` and in `external` otherwise; the centerline
runs from the point to the path's center. Two points are refused with "select two closed paths". The lines are
+1 -1
View File
@@ -2778,7 +2778,7 @@ A VectorCraft addition, so no area score moves. Object › Plug-ins › Cutting
## Path Precision Tools add-on: Common Tangents (2026-11-15)
A VectorCraft addition, so no area score moves. Object › Plug-ins › Path Precision Tools › Common Tangents… (`addon.pathtools.commonTangents`) adds the common tangent lines of two convex closed paths ([tangent lines to circles](https://en.wikipedia.org/wiki/Tangent_lines_to_circles)) as separate open paths: external, internal or all, with the line joining the two centers if asked. The rest is VectorCraft's own: an ellipse drawn with the Ellipse tool, turned or scaled, is measured as an exact ellipse, and any other path must be closed, have one outline and bend the same way all around. Each line runs between the points where it touches the two paths. Separate paths have four tangents, overlapping paths only external ones (two for ellipses), and a path inside the other has none, in which case nothing changes and a message says why. Paths that touch, from outside or from inside, share one tangent there instead: a line centered on the point where they touch and as long as the narrower path is wide along it. Since 2026-11-18 one of the two may be a point (a path of one anchor): the lines run from the point to where they touch the path, two from a point outside it, one at a point on its outline or less than the touching tolerance from it (centered on the point, or covering the straight side it lies on), and none from a point inside, with a message; the centerline runs from the point to the path's center, and every Tangents choice gives the same lines. The lines take the current stroke and no fill; one undo step. The dialog has Preview. Tests: `addons::pathtools::tangents::tests` in `vectorcraft-pathops` (circles against the closed form, turned ellipses against a brute-force scan, nested, overlapping and touching circles, a convex Bézier path, flat sides, squares meeting at a corner, a curve touched beside an anchor, a point outside a turned ellipse, on a circle, inside it, beside a square and at its corner, on a turned outline, within the touching tolerance, refused outlines), `cmd::addons::pathtools::tangents::tests` in `vectorcraft-engine`, `common_tangents_previews_cancels_and_runs_on_ok` and `common_tangents_on_a_point_gives_the_same_lines_for_every_choice` in `vectorcraft-ui-egui` and `command_sweep`. Commands: `docs/mcp.md` › Path Precision Tools add-on.
A VectorCraft addition, so no area score moves. Object › Plug-ins › Path Precision Tools › Common Tangents… (`addon.pathtools.commonTangents`) adds the common tangent lines of two convex closed paths ([tangent lines to circles](https://en.wikipedia.org/wiki/Tangent_lines_to_circles)) as separate open paths: external, internal or all, with the line joining the two centers if asked. The rest is VectorCraft's own: an ellipse drawn with the Ellipse tool, turned or scaled, is measured as an exact ellipse, and any other path must be closed, have one outline and bend the same way all around. Each line runs between the points where it touches the two paths. Separate paths have four tangents, overlapping paths only external ones (two for ellipses), and a path inside the other has none, in which case nothing changes and a message says why. Paths that touch, from outside or from inside, share one tangent there instead: a line centered on the point where they touch and as long as the narrower path is wide along it. Since 2026-11-18 one of the two may be a point (a path of one anchor): the lines run from the point to where they touch the path, two from a point outside it, one at a point on its outline, or at most a billionth of the larger of the path's size and the point's distance from its center away from it (centered on the point, or covering the straight side it lies on), and none from a point inside, with a message; the centerline runs from the point to the path's center, and every Tangents choice gives the same lines. The lines take the current stroke and no fill; one undo step. The dialog has Preview. Tests: `addons::pathtools::tangents::tests` in `vectorcraft-pathops` (circles against the closed form, turned ellipses against a brute-force scan, nested, overlapping and touching circles, a convex Bézier path, flat sides, squares meeting at a corner, a curve touched beside an anchor, a point outside a turned ellipse, on a circle, inside it, beside a square and at its corner, on a turned outline, within the touching tolerance, refused outlines), `cmd::addons::pathtools::tangents::tests` in `vectorcraft-engine`, `common_tangents_previews_cancels_and_runs_on_ok` and `common_tangents_on_a_point_gives_the_same_lines_for_every_choice` in `vectorcraft-ui-egui` and `command_sweep`. Commands: `docs/mcp.md` › Path Precision Tools add-on.
## Path Precision Tools add-on: Divide into Dashes (2026-11-01)