API Reference > geometry-core > Bspline > BSplineSurface3d BSplineSurface3d Class BSplineSurface3d is a parametric surface in xyz space. This (BSplineSurface3d) is an unweighted surface. Use the separate class BSplineSurface3dH for a weighted surface. The various static "create" methods have subtle differences in how grid sizes are conveyed: | Method | control point array | counts | | create | flat array of [x,y,z] | arguments numPolesU, numPolesV | | createGrid | array of array of [x,y,z ] | There are no numPolesU or numPolesV args. The counts are conveyed by the deep arrays | Extends BSpline2dNd Implements BSplineSurface3dQuery Methods Name Description clone(): BSplineSurface3d Return a complete copy of the bspline surface. cloneTransformed(transform: Transform): BSplineSurface3d Return a complete copy of the bspline surface, with a transform applied to the control points. copyKnots(select: UVSelect, includeExtraEndKnot: boolean): number[] return a simple array form of the knots. copyPointsFloat64Array(): Float64Array Return a simple array of the control points coordinates dispatchToGeometryHandler(handler: GeometryHandler): any Second step of double dispatch: call handler.handleBSplineSurface3d(this) extendRange(rangeToExtend: Range3d, transform?: Transform): void Extend the range to include all poles fractionToPoint(fractionU: number, fractionV: number): Point3d Evaluate at a position given by fractional coordinate in each direction. fractionToPointAndDerivatives(fractionU: number, fractionV: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors evaluate the surface at u and v fractions. getPointArray(flatArray: boolean = true): any[] Return control points json arrays. getPointGridJSON(): PackedPointGrid Return control points json arrays. getPole(i: number, j: number, result?: Point3d): undefined | Point3d Return a pole by u and v indices isAlmostEqual(other: any): boolean test for identical counts and near-equal coordinates isInPlane(plane: Plane3dByOriginAndUnitNormal): boolean Test if all poles are in a plane isSameGeometryClass(other: any): boolean Test if other is an instance of `BSplineSurface3d knotToPoint(u: number, v: number): Point3d Evaluate at a position given by u and v coordinates in knot space. knotToPointAndDerivatives(u: number, v: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors Evaluate at a position given by a knot value. tryTransformInPlace(transform: Transform): boolean Apply the transform to the poles create(controlPointArray: Point3d[] | Float64Array, numPolesU: number, orderU: number, knotArrayU: undefined | number[] | Float64Array, numPolesV: number, orderV: number, knotArrayV: undefined | number[] | Float64Array): undefined | BSplineSurface3d Static Create a bspline surface. createGrid(points: number[][][], orderU: number, knotArrayU: undefined | number[] | Float64Array, orderV: number, knotArrayV: undefined | number[] | Float64Array): undefined | BSplineSurface3d Static Create a bspline surface. Inherited methods Name Inherited from Description degreeUV(select: UVSelect): number BSpline2dNd Return the degree (one less than order) for the select direction (0 or 1) evaluateBuffersAtKnot(u: number, v: number, numDerivative: number = 0): void BSpline2dNd Evaluate the _basisBuffer, _poleBuffer and (optionally) _basisBuffer1 and _poleBuffer1 arrays at given knot. extendRangeXYZ(rangeToExtend: Range3d, transform?: Transform): void BSpline2dNd extend a range, treating each block as simple XYZ extendRangeXYZH(rangeToExtend: Range3d, transform?: Transform): void BSpline2dNd extend a range, treating each block as homogeneous xyzw, with weight at offset 3 fractionToRigidFrame(fractionU: number, fractionV: number, result?: Transform): undefined | Transform BSpline2dNd evaluate the surface at u and v fractions. getPoint3dPole(i: number, j: number, result?: Point3d): undefined | Point3d BSpline2dNd Get the Point3d by row and column. getPoint3dPoleXYZW(i: number, j: number, result?: Point3d): undefined | Point3d BSpline2dNd Get the Point3d by row and column, projecting the weight away to get to xyz isClosable(select: UVSelect): boolean BSpline2dNd Test if degree leading and trailing (one of U or V) blocks match, as if the data is an unwrapped closed spline in the selected direction. numPolesTotal(): number BSpline2dNd Return the total number of poles (product of x and y pole counts) numPolesUV(select: UVSelect): number BSpline2dNd Return the number of poles for the select direction (0 or 1) numSpanUV(select: UVSelect): number BSpline2dNd Return the number of spans (INCLUDING NULL SPANS) for the select direction (0 or 1) numberToUVSelect(value: number): UVSelect BSpline2dNd Return 0 for 0 input, 1 for any nonzero input. orderUV(select: UVSelect): number BSpline2dNd Return the order (one more than degree) for the select direction (0 or 1) poleStepUV(select: UVSelect): number BSpline2dNd Return the step between adjacent poles for the select direction (0 or 1) range(transform?: Transform, result?: Range3d): Range3d BSpline2dNd return the range of the entire (tree) GeometryQuery reverseInPlace(select: UVSelect): void BSpline2dNd Reverse the parameter direction for either u or v. setWrappable(select: UVSelect, value: BSplineWrapMode): void BSpline2dNd Set the flag indicating the bspline might be suitable for having wrapped "closed" interpretation. spanFractionToKnot(select: UVSelect, span: number, localFraction: number): number BSpline2dNd Map a position, specified as (uv direction, bezier span, fraction within the bezier), to an overall knot value. spanFractionsToBasisFunctions(select: UVSelect, spanIndex: number, spanFraction: number, f: Float64Array, df?: Float64Array): void BSpline2dNd Evaluate basis functions given sumPoleBufferForSpan(spanIndexU: number, spanIndexV: number): void BSpline2dNd sum poles by the weights in the basisBuffer, using poles for given span sumpoleBufferDerivativesForSpan(spanIndexU: number, spanIndexV: number): void BSpline2dNd sum derivatives by the weights in the basisBuffer, using poles for given span tryTranslateInPlace(dx: number, dy: number = 0.0, dz: number = 0.0): boolean BSpline2dNd try to move the geometry by dx,dy,dz areAlmostEqual(a: undefined | GeometryQuery, b: undefined | GeometryQuery): boolean Static BSpline2dNd apply instance method isAlmostEqual if both are defined. validOrderAndPoleCounts(orderU: number, numPolesU: number, orderV: number, numPolesV: number, numUV: number): boolean Static BSpline2dNd Confirm that order and pole counts agree for both u and v directions Inherited properties Name Type Inherited from Description _basisBuffer1UV Protected Float64Array[] BSpline2dNd a scratch array sized for order numbers _basisBufferUV Protected Float64Array[] BSpline2dNd a scratch array sized for order numbers _poleBuffer Protected Float64Array BSpline2dNd a scratch array sized for one pole _poleBuffer1UV Protected Float64Array[] BSpline2dNd array of 2 scratch array, each sized for one pole children Accessor ReadOnly undefined | GeometryQuery[] BSpline2dNd return GeometryQuery children for recursive queries.* leaf classes do not need to implement. coffs Float64Array BSpline2dNd flat array of coordinate daa, blocked by poleDimension and row geometryCategory Readonly "bsurf" BSpline2dNd String name for schema properties knots KnotVector[] BSpline2dNd Array of (exactly 2) knot vectors for the u, v directions poleDimension number BSpline2dNd Number of components per pole. Defined in bspline/BSplineSurface.ts Line 513 Last Updated: 11 June, 2024