API Reference > geometry-core > Bspline > BSplineCurve3dH BSplineCurve3dH Class Weighted (Homogeneous) BSplineCurve in 3d Extends BSplineCurve3dBase Methods Name Description constructor(poleDimension: number, numPoles: number, order: number, knots: KnotVector): BSplineCurve3dH Protected clone(): BSplineCurve3dH Return a deep clone of this curve. cloneTransformed(transform: Transform): BSplineCurve3dH Clone the curve and apply a transform to the clone. computeAndAttachRecursiveStrokeCounts(options?: StrokeOptions, parentStrokeMap?: StrokeCountMap): void Compute individual segment stroke counts. computeStrokeCountForOptions(options?: StrokeOptions): number Assess length and turn to determine a stroke count. copyPoints(): any[] Return a simple array of arrays with the control points as [[x,y,z,w],[x,y,z,w],..] copyPointsFloat64Array(): Float64Array Return a simple array of the control points coordinates dispatchToGeometryHandler(handler: GeometryHandler): any Second step of double dispatch: call handler.handleBSplineCurve3dH(this) emitStrokableParts(handler: IStrokeHandler, options?: StrokeOptions): void call a handler with interval data for stroking. emitStrokes(dest: LineString3d, options?: StrokeOptions): void Append stroked approximation of this curve to the linestring. evaluatePointAndDerivativeInSpan(spanIndex: number, spanFraction: number, result?: Ray3d): Ray3d Evaluate at a position given by fractional position within a span. evaluatePointInSpan(spanIndex: number, spanFraction: number, result?: Point3d): Point3d Evaluate at a position given by fractional position within a span. extendRange(rangeToExtend: Range3d, transform?: Transform): void Extend a range so in includes the range of this curve getPolePoint3d(poleIndex: number, result?: Point3d): Point3d | undefined Get a pole, normalized to Point3d. getPolePoint4d(poleIndex: number, result?: Point4d): Point4d | undefined Get a pole as Point4d getSaturatedBezierSpan3dH(spanIndex: number, result?: BezierCurveBase): BezierCurveBase | undefined Return a CurvePrimitive (which is a BezierCurve3dH) for a specified span of this curve. getSaturatedBezierSpan3dOr3dH(spanIndex: number, _prefer3dH: boolean, result?: BezierCurveBase): BezierCurveBase | undefined Return a BezierCurveBase for this curve. isAlmostEqual(other: any): boolean test if the curve is almost equal to other isInPlane(plane: Plane3dByOriginAndUnitNormal): boolean Test if the curve is entirely within a plane. isSameGeometryClass(other: any): boolean Test if other is an instance of BSplineCurve3dH knotToPoint(u: number, result?: Point3d): Point3d Evaluate at a position given by a knot value. knotToPointAnd2Derivatives(u: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors Evaluate at a position given by a knot value. knotToPointAndDerivative(u: number, result?: Ray3d): Ray3d Evaluate at a position given by a knot value. quickLength(): number Return the control polygon length as quick approximation to the curve length. spanFractionToKnot(span: number, localFraction: number): number map a spanIndex and fraction to a knot value. tryTransformInPlace(transform: Transform): boolean Apply transform to the curve create(controlPoints: Float64Array | Point4d[] | Point3d[], knotArray: Float64Array | number[], order: number): BSplineCurve3dH | undefined Static Create a bspline with given knots. createUniformKnots(controlPoints: Point3d[] | Point4d[] | Float64Array, order: number): BSplineCurve3dH | undefined Static Create a bspline with uniform knots. Inherited methods Name Inherited from Description addMappedStrokesToLineString3D(map: StrokeCountMap, linestring: LineString3d): number CurvePrimitive * evaluate strokes at fractions indicated in a StrokeCountMap. announceClipIntervals(_clipper: Clipper, _announce?: AnnounceNumberNumberCurvePrimitive): boolean CurvePrimitive Find intervals of this curvePrimitive that are interior to a clipper appendPlaneIntersectionPoints(plane: PlaneAltitudeEvaluator, result: CurveLocationDetail[]): number BSplineCurve3dBase Implement CurvePrimitive.appendPlaneIntersections clonePartialCurve(_fractionA: number, _fractionB: number): CurvePrimitive | undefined CurvePrimitive Return (if possible) a curve primitive which is a portion of this curve. closestPoint(spacePoint: Point3d, _extend: boolean): CurveLocationDetail | undefined BSplineCurve3dBase Search for the curve point that is closest to the spacePoint. collectBezierSpans(prefer3dH: boolean): BezierCurveBase[] BSplineCurve3dBase Return an array with this curve's bezier fragments. collectCurvePrimitives(collectorArray?: CurvePrimitive[], smallestPossiblePrimitives: boolean = false): CurvePrimitive[] CurvePrimitive Return an array containing only the curve primitives. collectCurvePrimitivesGo(collectorArray: CurvePrimitive[], _smallestPossiblePrimitives: boolean): void CurvePrimitive Return an array containing only the curve primitives. copyKnots(includeExtraEndKnot: boolean): number[] BSplineCurve3dBase return a simple array form of the knots. curveLength(): number CurvePrimitive return the length of the curve. curveLengthBetweenFractions(fraction0: number, fraction1: number): number CurvePrimitive Returns a (high accuracy) length of the curve between fractional positions curveLengthWithFixedIntervalCountQuadrature(fraction0: number, fraction1: number, numInterval: number, numGauss: number = 5): number CurvePrimitive * Run an integration (with a default gaussian quadrature) with a fixed fractional step endPoint(): Point3d BSplineCurve3dBase Return the end point of the curve fractionAndDistanceToPointOnTangent(fraction: number, distance: number): Point3d CurvePrimitive Construct a point extrapolated along tangent at fraction. fractionToFrenetFrame(fraction: number, result?: Transform): Transform | undefined CurvePrimitive Construct a frenet frame: fractionToPoint(fraction: number, result?: Point3d): Point3d BSplineCurve3dBase Evaluate the curve point at fraction fractionToPointAnd2Derivatives(fraction: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors BSplineCurve3dBase Construct a plane with fractionToPointAndDerivative(fraction: number, result?: Ray3d): Ray3d BSplineCurve3dBase Construct a ray with fractionToPointAndUnitTangent(fraction: number, result?: Ray3d): Ray3d CurvePrimitive Returns a ray whose origin is the curve point and direction is the unit tangent. getFractionToDistanceScale(): number | undefined CurvePrimitive * If the curve primitive has distance-along-curve strictly proportional to curve fraction, return true moveSignedDistanceFromFraction(startFraction: number, signedDistance: number, allowExtension: boolean, result?: CurveLocationDetail): CurveLocationDetail CurvePrimitive * (Attempt to) find a position on the curve at a signed distance from start fraction. moveSignedDistanceFromFractionGeneric(startFraction: number, signedDistance: number, allowExtension: boolean, result?: CurveLocationDetail): CurveLocationDetail Protected CurvePrimitive Generic algorithm to search for point at signed distance from a fractional startPoint. poleIndexToDataIndex(poleIndex: number): number | undefined BSplineCurve3dBase Given a pole index, return the starting index for the contiguous array. range(transform?: Transform, result?: Range3d): Range3d GeometryQuery return the range of the entire (tree) GeometryQuery reverseInPlace(): void BSplineCurve3dBase Reverse the curve in place. setWrappable(value: BSplineWrapMode): void BSplineCurve3dBase Set the flag indicating the bspline might be suitable for having wrapped "closed" interpretation. startPoint(): Point3d BSplineCurve3dBase Return the start point of the curve. tryTranslateInPlace(dx: number, dy: number = 0, dz: number = 0): boolean GeometryQuery try to move the geometry by dx,dy,dz installStrokeCountMap(curve: CurvePrimitive, curveMap: StrokeCountMap, parentMap?: StrokeCountMap): void Static CurvePrimitive final install step to save curveMap in curve. Properties Name Type Description isClosable Accessor ReadOnly boolean return true if the spline is (a) unclamped with (degree-1) matching knot intervals, Inherited properties Name Type Inherited from Description _bcurve Protected BSpline1dNd BSplineCurve3dBase The underlying blocked-pole spline, with simple x,y,z poles children Accessor ReadOnly GeometryQuery[] | undefined GeometryQuery return GeometryQuery children for recursive queries.* leaf classes do not need to implement. curvePrimitiveType "bsplineCurve" = "bsplineCurve" BSplineCurve3dBase String name for schema properties degree Accessor ReadOnly number BSplineCurve3dBase Return the degree (one less than the order) of the curve geometryCategory "curvePrimitive" = "curvePrimitive" CurvePrimitive String name for schema properties isExtensibleFractionSpace Accessor ReadOnly boolean CurvePrimitive * Returns true if the curve's fraction queries extend beyond 0..1.* Base class default implementation returns false.* These class (and perhaps others in the future) will return true: * LineSegment3d * LineString3d * Arc3d numPoles Accessor ReadOnly number BSplineCurve3dBase Return the number of poles numSpan Accessor ReadOnly number BSplineCurve3dBase Return the number of bezier spans in the curve. Note that this number includes the number of null spans at repeated knows order Accessor ReadOnly number BSplineCurve3dBase Return the order (one more than degree) of the curve strokeData undefined | StrokeCountMap CurvePrimitive data attached during stroking for facets. Defined in core/geometry/src/bspline/BSplineCurve3dH.ts Line 35 Last Updated: 13 June, 2024