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
Implements
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 | |
| uvFractionToPoint(u: number, v: number): Point3d | Implementation of the UVSurface interface; allows PolyfaceBuilder.addUVGridBody to facet this B-spline surface. |
|
| uvFractionToPointAndTangents(u: number, v: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors | Implementation of the UVSurface interface; allows PolyfaceBuilder.addUVGridBody to facet this B-spline surface. |
|
| create(controlPointArray: Float64Array | Point3d[], numPolesU: number, orderU: number, knotArrayU: undefined | Float64Array | number[], numPolesV: number, orderV: number, knotArrayV: undefined | Float64Array | number[]): undefined | BSplineSurface3d Static | Create a bspline surface. | |
| createGrid(points: number[][][], orderU: number, knotArrayU: undefined | Float64Array | number[], orderV: number, knotArrayV: undefined | Float64Array | number[]): 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 indexed Point3d. |
| getPoint3dPoleXYZW(i: number, j: number, result?: Point3d): undefined | Point3d | BSpline2dNd | Get the indexed Point3d, projecting the weight away to get to xyz. |
| getPoint4dPole(i: number, j: number, result?: Point4d): undefined | Point4d | BSpline2dNd | Get the indexed Point4d. |
| getWrappable(select: UVSelect): BSplineWrapMode | BSpline2dNd | Get the flag indicating the surface might be suitable for having wrapped "closed" interpretation. |
| isClosable(select: UVSelect): boolean | BSpline2dNd | Test knots and control points to determine if it is possible to close (aka "wrap") the surface in the selected parametric direction. |
| isClosableSurface(select: UVSelect): BSplineWrapMode | BSpline2dNd | Test knots and control points to determine if it is possible to close (aka "wrap") the surface in the selected parametric 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 GeometryQuery tree. |
| 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 surface 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): boolean | BSpline2dNd | Evaluate basis functions given |
| sumPoleBufferDerivativesForSpan(spanIndexU: number, spanIndexV: number): void | BSpline2dNd | sum derivatives by the weights in the basisBuffer, using poles for given span |
| 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 poles by the weights in the basisBuffer, using poles for given span |
| testClosableGrid(select: UVSelect, mode?: BSplineWrapMode): boolean | BSpline2dNd | Test if degree leading and trailing (one of U or V) blocks match, as if the data is a non-periodic physically closed spline in the selected direction. |
| 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 BSpline2dNd.isAlmostEqual if both are defined. |
| isWrappedGrid(data: Float64Array, numRows: number, numColumns: number, dimension: number, blockLength: number, select: UVSelect): boolean Static | BSpline2dNd | Test if leading and trailing blocks of points match in a given direction. |
| 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 data, 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 565
Last Updated: 25 April, 2024
Found something wrong, missing, or unclear on this page?
Raise an issue in our repo.