mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-11-17 19:30:06 +00:00
shape.circleThroughPoints draws the circle whose edge passes through three points, as a live ellipse with the current paint, in one undo step. The points come from `points` or, when it is left out, from the three selected anchor points: anchor points selected with Direct Selection, or all the anchor points of a path selected whole. The ends of selected segments do not count. The result gives the circle's center and radius. The circle is not pixel-aligned, even while Align New Objects to Pixel Grid is on, so it stays through the points. Two points that are the same, or three on one line (twice the triangle's area at most 1e-10 of its longest side squared), are refused with a message and nothing is drawn. The center is computed from the corner opposite the longest side, so nearly collinear points and points far from the origin keep their precision. With the Ellipse tool, the first two Shift-clicks place points and the third draws the circle through the three. After two points the tool previews the circle through the snapped pointer as a dashed outline; the preview goes when the pointer leaves the canvas. Once a point is placed, a Shift-click on the selection's handles or shape widgets places a point too. Escape, a click without Shift, a drag, a press without Shift on the selection or a shape widget, and an edit, Undo or Redo made outside the tool remove the points placed so far. A Shift-click without a drag used to open the size dialog, as a plain click does; a plain click still opens it, and so does a Shift-click while the perspective grid shows with an active plane, so that shape still goes on the plane. Docs: docs/mcp.md, ROADMAP. Messages translated in the 24 catalogs with complete messages.