@itwin/core-geometry 5.8.0-dev.8 → 5.9.0-dev.1

package/lib/cjs/curve/internalContexts/geometry2d/ConstrainedImplicitCurve2d.d.ts

@@ -0,0 +1,152 @@
+/** @packageDocumentation
+ * @module CartesianGeometry
+*/
+import { XAndY } from "../../../geometry3d/XYZProps";
+import { ImplicitCurve2d, ImplicitGeometryMarkup } from "./ImplicitCurve2d";
+import { UnboundedCircle2dByCenterAndRadius } from "./UnboundedCircle2d";
+import { UnboundedLine2dByPointAndNormal } from "./UnboundedLine2d";
+/**
+ * Static methods for special case circle and line tangent constructions.
+ * @internal
+ */
+export declare class ConstrainedImplicitCurve2d {
+    /**
+     * Return all (i.e., up to 4) circles that are tangent to 3 given lines.
+     * @param lineA first line
+     * @param lineB second line
+     * @param lineC third line
+     */
+    static circlesTangentLLL(lineA: UnboundedLine2dByPointAndNormal, lineB: UnboundedLine2dByPointAndNormal, lineC: UnboundedLine2dByPointAndNormal): ImplicitGeometryMarkup<UnboundedCircle2dByCenterAndRadius>[] | undefined;
+    /**
+     * Return all (i.e., up to 2) unbounded lines perpendicular to a line and tangent to a circle.
+     * @param line the line
+     * @param circle the circle
+     */
+    static linesPerpLTangentC(line: UnboundedLine2dByPointAndNormal, circle: UnboundedCircle2dByCenterAndRadius): ImplicitGeometryMarkup<UnboundedLine2dByPointAndNormal>[] | undefined;
+    /**
+     * Return all (i.e., 4) variants of the line perpendicular to 2 circles (line between centers, with ends at crossing
+     * points on respective circles).
+     * @param circleA first circle
+     * @param circleB second circle
+     */
+    static linesPerpCPerpC(circleA: UnboundedCircle2dByCenterAndRadius, circleB: UnboundedCircle2dByCenterAndRadius): ImplicitGeometryMarkup<UnboundedLine2dByPointAndNormal>[] | undefined;
+    /**
+     * Return all (i.e., up to 2) unbounded lines perpendicular to a line and a circle.
+     * @param line the line
+     * @param circle the circle
+     */
+    static linesPerpLPerpC(line: UnboundedLine2dByPointAndNormal, circle: UnboundedCircle2dByCenterAndRadius): ImplicitGeometryMarkup<UnboundedLine2dByPointAndNormal>[] | undefined;
+    /**
+     * Return all (i.e., up to 4) unbounded lines perpendicular to a circle and tangent to a circle.
+     * Note that multiple colinear lines are returned tagged with diametrically opposing points of circleA.
+     * @param circleA first circle (for perpendicular constraint)
+     * @param circleB second circle (for tangent constraint)
+     */
+    static linesPerpCTangentC(circleA: UnboundedCircle2dByCenterAndRadius, circleB: UnboundedCircle2dByCenterAndRadius): ImplicitGeometryMarkup<UnboundedLine2dByPointAndNormal>[] | undefined;
+    /**
+     * Return all (i.e., up to 4) unbounded lines tangent to 2 circles.
+     * * There are 4 lines if there is neither intersection nor containment between the circles
+     * * There are 2 lines if the circles intersect
+     * * THere are no lines if the one circle is entirely inside the other.
+     * @param circleA first circle
+     * @param circleB second circle
+     */
+    static linesTangentCC(circleA: UnboundedCircle2dByCenterAndRadius, circleB: UnboundedCircle2dByCenterAndRadius): ImplicitGeometryMarkup<UnboundedLine2dByPointAndNormal>[] | undefined;
+    /**
+    * Return all (i.e., up to 8) circles tangent to two lines and a circle.
+    * * There are 8 circles if the circle contains the intersection of the lines.
+    * * There are 2 circles if the circle is completely contained in one quadrant bounded by the two lines.
+    * * There are 2 circles if the circle intersects one ray outward from the intersection.
+    * * There are 4 circles if the circle intersects two of the outward rays.
+    */
+    static circlesTangentLLC(lineA: UnboundedLine2dByPointAndNormal, lineB: UnboundedLine2dByPointAndNormal, circle: UnboundedCircle2dByCenterAndRadius): ImplicitGeometryMarkup<UnboundedCircle2dByCenterAndRadius>[] | undefined;
+    /**
+     * Return all (i.e., up to 4) circles tangent to 2 circles and a line.
+     * @param circleA first circle
+     * @param circleB second circle
+     * @param line the line
+     */
+    static circlesTangentCCL(circleA: UnboundedCircle2dByCenterAndRadius, circleB: UnboundedCircle2dByCenterAndRadius, line: UnboundedLine2dByPointAndNormal): ImplicitGeometryMarkup<UnboundedCircle2dByCenterAndRadius>[] | undefined;
+    /**
+     * Special case CCC tangent construction when inputs are colinear.
+     * @param circleA first input circle
+     * @param circleB second input circle
+     * @param circleC third input circle
+     * @param rA signed radius for circleA
+     * @param rB signed radius for circleB
+     * @param rC signed radius for circleC
+     * @param result pre-initialized array to which tangent circle markup will be added.
+     */
+    private static solveColinearCCCTangents;
+    /**
+     * Return all (i.e., up to 8) circles tangent to 3 circles.
+     * @param circles the three input circles
+     */
+    private static circlesTangentCCCThisOrder;
+    /**
+     * Return all (i.e., up to 8) circles tangent to 3 circles.
+     * @param circleA first circle
+     * @param circleB second circle
+     * @param circleC third circle
+     */
+    static circlesTangentCCC(circleA: UnboundedCircle2dByCenterAndRadius, circleB: UnboundedCircle2dByCenterAndRadius, circleC: UnboundedCircle2dByCenterAndRadius): ImplicitGeometryMarkup<UnboundedCircle2dByCenterAndRadius>[] | undefined;
+    /**
+     * Return an unbounded line with the midpoint between pointA and pointB as its reference point
+     * and the unit vector from pointA towards pointB as its normal.
+     * @param pointA first point
+     * @param pointB second point
+     * @returns unbounded line, or undefined if pointA and pointB are coincident.
+     */
+    static bisector(pointA: XAndY, pointB: XAndY): UnboundedLine2dByPointAndNormal | undefined;
+    /**
+     * Compute circles of specified radius tangent to each of the lines
+     * * There are normally 4 circles
+     * * The undefined case occurs when the lines are parallel.
+     * @param lineA first line
+     * @param lineB second line
+     * @param radius radius of tangent circles
+     * @returns array of circles with annotated tangencies. returns undefined if lines are parallel.
+     */
+    static circlesTangentLLR(lineA: UnboundedLine2dByPointAndNormal, lineB: UnboundedLine2dByPointAndNormal, radius: number): ImplicitGeometryMarkup<UnboundedCircle2dByCenterAndRadius>[] | undefined;
+    /**
+     * Compute circles of specified radius tangent to both a line and an arc
+     * * There can be 0 to 8 circles
+     * * The undefined case occurs when the smallest distance from circle to line exceeds radius.
+     * @param circleA the circle
+     * @param lineB the line
+     * @param radius radius of tangent circles
+     * @returns array of circles with annotated tangencies
+     */
+    static circlesTangentCLR(circleA: UnboundedCircle2dByCenterAndRadius, lineB: UnboundedLine2dByPointAndNormal, radius: number): ImplicitGeometryMarkup<UnboundedCircle2dByCenterAndRadius>[] | undefined;
+    /**
+     * Compute circles of specified radius tangent to both circles
+     * * There can be 0 to 8 circles
+     * * The undefined case is when the smallest distance between the circles exceeds the requested radius.
+     * @param circleA the first circle
+     * @param circleB the second circle
+     * @param radius radius of tangent circles
+     * @returns array of circles with annotated tangencies
+     */
+    static circlesTangentCCR(circleA: UnboundedCircle2dByCenterAndRadius, circleB: UnboundedCircle2dByCenterAndRadius, radius: number): ImplicitGeometryMarkup<UnboundedCircle2dByCenterAndRadius>[] | undefined;
+    /**
+     * Construct basis vectors for hyperbola or ellipse whose points are equidistant from tangencies with
+     * circleA and circleB.
+     * * If the curve is a hyperbola, the equation is
+     *            X = center + vectorU * sec(theta) + vectorV * tan(theta)
+     * * If the curve is an ellipse, the equation is
+     *            X = center + vectorU * cos(theta) + vectorV * sin(theta)
+     * @param circleA first circle
+     * @param circleB second circle
+     */
+    static medialCurveCircleCircle(circleA: UnboundedCircle2dByCenterAndRadius, circleB: UnboundedCircle2dByCenterAndRadius): ImplicitCurve2d | undefined;
+    /**
+     * Construct parabolas whose points are equidistant from tangencies with
+     * circleA and circleB.
+     * * Note that if th e circle has non-zero radius there are two parabolas based on
+     *     tangencies on near or far side of the circle.
+     * @param line the line
+     * @param circle the circle
+     */
+    static medialCurveLineCircle(line: UnboundedLine2dByPointAndNormal, circle: UnboundedCircle2dByCenterAndRadius): ImplicitCurve2d[] | undefined;
+}
+//# sourceMappingURL=ConstrainedImplicitCurve2d.d.ts.map

package/lib/cjs/curve/internalContexts/geometry2d/ConstrainedImplicitCurve2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConstrainedImplicitCurve2d.d.ts","sourceRoot":"","sources":["../../../../../src/curve/internalContexts/geometry2d/ConstrainedImplicitCurve2d.ts"],"names":[],"mappings":"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"}