mirror of
https://github.com/excalidraw/excalidraw.git
synced 2025-05-03 10:00:07 -04:00
88 lines
2.7 KiB
TypeScript
88 lines
2.7 KiB
TypeScript
import { invariant } from "../excalidraw/utils";
|
|
import { cartesian2Polar, radians } from "./angle";
|
|
import { ellipse, ellipseSegmentInterceptPoints } from "./ellipse";
|
|
import { point, pointDistance } from "./point";
|
|
import { segment } from "./segment";
|
|
import type { GenericPoint, Segment, Radians, Arc } from "./types";
|
|
import { PRECISION } from "./utils";
|
|
|
|
/**
|
|
* Constructs a symmetric arc defined by the originating circle radius
|
|
* the start angle and end angle with 0 radians being the most "eastward" point
|
|
* of the circle.
|
|
*
|
|
* @param radius The radius of the circle this arc lies on
|
|
* @param startAngle The start angle with 0 radians being the most "eastward" point
|
|
* @param endAngle The end angle with 0 radians being the "northest" point
|
|
* @returns The constructed symmetric arc
|
|
*/
|
|
export function arc<Point extends GenericPoint>(
|
|
center: Point,
|
|
radius: number,
|
|
startAngle: Radians,
|
|
endAngle: Radians,
|
|
) {
|
|
return { center, radius, startAngle, endAngle } as Arc<Point>;
|
|
}
|
|
|
|
/**
|
|
* Determines if a cartesian point lies on a symmetric arc, i.e. an arc which
|
|
* is part of a circle contour centered on 0, 0.
|
|
*/
|
|
export function arcIncludesPoint<P extends GenericPoint>(
|
|
{ center, radius: arcRadius, startAngle, endAngle }: Arc<P>,
|
|
p: P,
|
|
): boolean {
|
|
const [radius, angle] = cartesian2Polar(
|
|
point(p[0] - center[0], p[1] - center[1]),
|
|
);
|
|
|
|
return startAngle < endAngle
|
|
? Math.abs(radius - arcRadius) < PRECISION &&
|
|
startAngle <= angle &&
|
|
endAngle >= angle
|
|
: startAngle <= angle || endAngle >= angle;
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param a
|
|
* @param p
|
|
*/
|
|
export function arcDistanceFromPoint<Point extends GenericPoint>(
|
|
a: Arc<Point>,
|
|
p: Point,
|
|
) {
|
|
const intersectPoint = arcSegmentInterceptPoint(a, segment(p, a.center));
|
|
|
|
invariant(
|
|
intersectPoint.length !== 1,
|
|
"Arc distance intersector cannot have multiple intersections",
|
|
);
|
|
|
|
return pointDistance(intersectPoint[0], p);
|
|
}
|
|
|
|
/**
|
|
* Returns the intersection point(s) of a line segment represented by a start
|
|
* point and end point and a symmetric arc.
|
|
*/
|
|
export function arcSegmentInterceptPoint<Point extends GenericPoint>(
|
|
a: Readonly<Arc<Point>>,
|
|
s: Readonly<Segment<Point>>,
|
|
): Point[] {
|
|
return ellipseSegmentInterceptPoints(
|
|
ellipse(a.center, radians(0), a.radius, a.radius),
|
|
s,
|
|
).filter((candidate) => {
|
|
const [candidateRadius, candidateAngle] = cartesian2Polar(
|
|
point(candidate[0] - a.center[0], candidate[1] - a.center[1]),
|
|
);
|
|
|
|
return a.startAngle < a.endAngle
|
|
? Math.abs(a.radius - candidateRadius) < PRECISION &&
|
|
a.startAngle <= candidateAngle &&
|
|
a.endAngle >= candidateAngle
|
|
: a.startAngle <= candidateAngle || a.endAngle >= candidateAngle;
|
|
});
|
|
}
|