- A canceled press on the second segment (a canceled touch, a second
finger) draws nothing and leaves the first segment picked. A canceled
press that picked the first segment leaves no segment picked. Before
this change a canceled press worked as Escape and forgot the first
segment.
- Shift pressed or let go during a click on the second segment, before
the pointer moves far enough to start a drag, counts at the release:
the circle is looked for again with or without the tool's radius.
- A session test sends the tool's release with a command that fails and
checks that the first segment stays picked.
- The radius option's test checks that a value outside 0.01 to 1000000,
or one that is not a number, leaves the radius as it is.
Docs: docs/target-app-parity.md lists every kind of circle the tool
leaves out: circles whose nearest point on the second segments is not on
the circle, circles that cross the first segment, circles that touch
both segments at one point, circles without a finite radius above 0, and
circles too small or too large for three of their points to give them
back. A circle found twice is kept once. docs/mcp.md says that in a
drag the circle touching nearest the press is drawn, and that the
radius option is not checked yet.
Part of #7178.
- The release returns shape.circleThroughPoints followed by a Notify,
and the tool forgets the first segment only when it is told, so a
command that fails leaves the segment picked (as the Direct Selection
tool's FRAME_PICKED notice follows its command).
- The preview leaves out circles that three of their points cannot give
back, so the note shows where a click would draw nothing.
- A double-click draws nothing more: the canvas sends it after the
second click's release, which drew the circle.
- The re-exports for the tool are a separate `pub use` in the pathops
pathtools module, whose module comment is unchanged.
- Circles of one radius at places tried close together along the
first segment are no longer taken for repeats: a repeat also touches
the first segment at the same point. At a radius of 1,000,000 pt the
513 places along a 100 pt line were cut to 86.
- A test checks the note's row in every complete catalog.
Docs: a drag's circle may touch the first segment anywhere along it;
the circles that are left out; an out-of-range radius option leaves
the radius as it is. The ROADMAP, target-app-parity and ui-parity
entries move next to related entries, and docs/mcp.md is rewrapped to
120 columns.
Part of #7178.
The Tangent Circle Tool (tangentCircle) joins the add-on's tools, in
Object > Plug-ins > Path Precision Tools and the All Tools drawer. A click
on a path segment picks it; a click on a second segment draws the circle
that is tangent to the first segment at the point clicked and touches
the second. The segments beside the second one count with it, and of
the circles found the one touching them nearest the pointer is drawn.
- Shift on the second click uses the tool's radius (36 pt to start, set
in its options), anywhere along the first segment.
- A drag from the second segment sets the radius to the drag's length;
Shift steps it by 1, 2 or 5 times a power of 10 pt, at least 4 screen
pixels, and Cmd/Ctrl pressed during the drag moves it by a tenth.
- Before the click the circle shows with its center, its radii to the
touch points and its radius, or a translated note says there is none.
The preview follows a pan, a zoom or an edit under a still pointer.
- The circle is drawn with shape.circleThroughPoints, so Align New
Objects to Pixel Grid leaves it tangent; one undo step. A circle that
its three points cannot give back in floating point is not drawn, and
the first segment stays picked. Escape, an edit outside the tool or
another document forgets the first segment.
The geometry is circles_through and circles_of_radius in the pathops
crate: the distance to the second segments is sampled along the first
segment's normal (or along the segment, for a radius) and the places
where it equals the radius are taken, including touches between samples.
Part of #7178.
Docs: docs/mcp.md, docs/ui-parity.md, docs/target-app-parity.md, ROADMAP.