#include <DbNurbSurface.h>
Static Public Member Functions | |
| static OdResult | createNurbSurface (const OdGeNurbSurface &surface, const OdArray< OdArray< OdGeNurbCurve3d * > > &arrLoopsPtr, const OdArray< OdGePoint3d > *arrApex, const OdArray< OdArray< OdGeNurbCurve2d * > > &arrLoopsProjPtr, OdDbNurbSurface &NURBS, bool bVaidateInput=true) |
 Static Public Member Functions inherited from OdDbSurface | |
| static OdResult | createFrom (const OdDbEntity *pFromEntity, OdDbSurfacePtr &pNewSurface) |
| static OdResult | trimSurface (const OdDbObjectId &blankSurfaceId, const OdDbObjectIdArray &toolIds, const OdDbObjectIdArray &toolCurveIds, const OdGeVector3dArray &projVectors, const OdGePoint3d &pickPoint, const OdGeVector3d &viewVector, bool bAutoExtend, bool bAssociativeEnabled) |
| static OdResult | createOffsetSurface (OdDbEntity *pInputSurface, double dOffsetDistance, OdDbEntityPtr &offsetSurface) |
| static OdResult | createOffsetSurface (OdDbEntity *pInputSurface, double dOffsetDistance, bool bAssociativeEnabled, OdDbObjectId &offsetSurfaceId) |
| static OdResult | createFilletSurface (const OdDbObjectId &surfId1, const OdGePoint3d &pickPt1, const OdDbObjectId &surfId2, const OdGePoint3d &pickPt2, double dRadius, OdDb::FilletTrimMode trimMode, const OdGeVector3d &projDir, OdDbSurface *&filletSurface) |
| static OdResult | createFilletSurface (const OdDbObjectId &surfId1, const OdGePoint3d &pickPt1, const OdDbObjectId &surfId2, const OdGePoint3d &pickPt2, double dRadius, OdDb::FilletTrimMode trimMode, const OdGeVector3d &projDir, bool bAssociativeEnabled, OdDbObjectId &filletSurfaceId) |
| static OdResult | createExtendSurface (OdDbObjectId sourceSurface, const OdArray< OdDbSubentId > &edgesId, double dExtDist, EdgeExtensionType extOption, bool bAssociativeEnabled, OdDbObjectId &newExtendSurfaceId) |
| Static Public Member Functions inherited from OdRxObject | |
| static OdRxObjectPtr | cast (const OdRxObject *pointer) |
| static OdRxClass * | desc () |
Detailed Description
This class implements a three-dimensional NURB surface entity.
- See also
- TD_Db
<group OdDb_Classes>
Definition at line 48 of file DbNurbSurface.h.
Constructor & Destructor Documentation
◆ OdDbNurbSurface()
| OdDbNurbSurface::OdDbNurbSurface | ( | ) |
Creates an OdDbNurbSurface object.
Member Function Documentation
◆ convertFrom()
| OdResult OdDbNurbSurface::convertFrom | ( | OdDbSurface * | pSource, |
| OdDb::DwgVersion | version, | ||
| bool | transferId = true |
||
| ) |
Creates a surface from a specified surface with conversion.
- Parameters
-
pSource [in] A pointer to the source surface. version [in] .dwg file version of the source surface. transferId [in] Indicates whether the Id of the source surface is transferred to the surface.
- Returns
- Returns eOk if successful or an appropriate error code in the other case.
◆ createNurbSurface()
|
static |
Creates a NURBS surface from a specified surface.
- Parameters
-
arrLoopsPtr [in] A array of curves. First is a trimming-loop other holes arrLoopsProjPtr [in] Projections of curves in arrLoopsPtr on UV-parameter space of nurbsurface arrApex [in] Array of 3dPoints (apexes). Used to create additional topology in trimming-loop. bVaidateInput [in] Validation flag. Perform checks like: are curves self-intersecting, is the end of current curve is coincides with start of next curve, curves are situated on nurbs surface. pSurface [out] Output nurbsurface
- Returns
- Returns eOk if successful or an appropriate error code in the other case.
◆ dwgInFields()
|
virtual |
Reads the .dwg file data of this object.
- Parameters
-
pFiler [in] Filer object from which data are read.
- Returns
- Returns the filer status.
This function is called by dwgIn() to allow the object to read its data.
When overriding this function:
1) Call assertWriteEnabled(). 2) Call the parent class's dwgInFields(pFiler). 3) If it returns eOK, continue; otherwise return whatever the parent's dwgInFields(pFiler) returned. 4) Call the OdDbDwgFiler(pFiler) methods to read each of the object's data items in the order they were written. 5) Return pFiler->filerStatus().
Reimplemented from OdDbSurface.
◆ dwgOutFields()
|
virtual |
Writes the .dwg file data of this object.
- Parameters
-
pFiler [in] Pointer to the filer to which data are written.
- Remarks
This function is called by dwgIn() to allow the object to write its data.
When overriding this function:
1) Call assertReadEnabled(). 2) Call the parent class's dwgOutFields(pFiler). 3) Call the OdDbDwgFiler(pFiler) methods to write each of the object's data items in the order they were written.
Reimplemented from OdDbSurface.
◆ dxfInFields()
|
virtual |
Reads the DXF data of this object.
- Parameters
-
pFiler [in] Pointer to the filer from which data are read.
- Returns
- Returns the filer status.
This function is called by dxfIn() to allow the object to read its data.
When overriding this function:
1) Call assertWriteEnabled(). 2) Call the parent class's dwgInFields(pFiler). 3) If it returns eOK, continue; otherwise return whatever the parent's dxfInFields(pFiler) returned. 4) Call the OdDbDxfFiler(pFiler) methods to read each of the object's data items in the order they were written. 5) Return pFiler->filerStatus().
Reimplemented from OdDbSurface.
◆ dxfOutFields()
|
virtual |
Writes the DXF data of this object.
- Parameters
-
pFiler [in] Pointer to the filer to which data are to be written.
- Remarks
This function is called by dxfOut() to allow the object to write its data.
When overriding this function:
1) Call assertReadEnabled(). 2) Call the parent class's dxfOutFields(pFiler). 4) Use pFiler to call the OdDbDxfFiler methods to write each of the object's data items in the order they were written.
Reimplemented from OdDbSurface.
◆ evaluate() [1/4]
| OdResult OdDbNurbSurface::evaluate | ( | double | dU, |
| double | dV, | ||
| int | iDerivDegree, | ||
| OdGePoint3d & | point, | ||
| OdGeVector3dArray & | derivatives | ||
| ) | const |
Evaluates the position and an arbitrary number of derivatives of the surface at the specified parameter value (u, v).
- Parameters
-
dU [in] u direction parameter. dV [in] v direction parameter. iDerivDegree [in] The degree of derivatives to evaluate. point [out] A passed-in parameter for returning the evaluated position on the surface. derivatives [out] A passed-in parameter for returning derivatives array of vectors, in the order of uDeriv, vDeriv, uuDeriv, uvDeriv, vvDeriv.
- Returns
- Returns eOk if evaluation is successfully done. If the surface doesn't contain any NURBS information, returns eFail. If the u or v value is out of range, returns eOutOfRange.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ evaluate() [2/4]
| OdResult OdDbNurbSurface::evaluate | ( | double | dU, |
| double | dV, | ||
| OdGePoint3d & | pos | ||
| ) | const |
Evaluates the position on the NURBS surface at the specified parameter value (u, v).
- Parameters
-
dU [in] u direction parameter. dV [in] v direction parameter. pos [out] A passed-in parameter for returning the evaluated position on the surface.
- Returns
- Returns eOk if evaluation is successfully done. If the surface doesn't contain any NURBS information, returns eFail. If the u or v value is out of range, returns eOutOfRange.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ evaluate() [3/4]
| OdResult OdDbNurbSurface::evaluate | ( | double | dU, |
| double | dV, | ||
| OdGePoint3d & | pos, | ||
| OdGeVector3d & | uDeriv, | ||
| OdGeVector3d & | vDeriv | ||
| ) | const |
Evaluates the position and first derivatives on the NURBS surface at the specified parameter value (u, v).
- Parameters
-
dU [in] u direction parameter. dV [in] v direction parameter. pos [out] A passed-in parameter for returning the evaluated position on the surface. uDeriv [out] A passed-in parameter for returning the first derivative with respect to u. vDeriv [out] A passed-in parameter for returning the first derivative with respect to v.
- Returns
- Returns eOk if evaluation is successfully done. If the surface doesn't contain any NURBS information, returns eFail. If the u or v value is out of range, returns eOutOfRange.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ evaluate() [4/4]
| OdResult OdDbNurbSurface::evaluate | ( | double | dU, |
| double | dV, | ||
| OdGePoint3d & | pos, | ||
| OdGeVector3d & | uDeriv, | ||
| OdGeVector3d & | vDeriv, | ||
| OdGeVector3d & | uuDeriv, | ||
| OdGeVector3d & | uvDeriv, | ||
| OdGeVector3d & | vvDeriv | ||
| ) | const |
Evaluates the position and first and second derivatives on the NURBS surface at the specified parameter value (u, v).
- Parameters
-
dU [in] u direction parameter. dV [in] v direction parameter. pos [out] A passed-in parameter for returning the evaluated position on the surface. uDeriv [out] A passed-in parameter for returning the first derivative with respect to u. vDeriv [out] A passed-in parameter for returning the first derivative with respect to v. uuDeriv [out] A passed-in parameter for returning the second derivative with respect to u twice. uvDeriv [out] A passed-in parameter for returning the second derivative with respect to u and v. vvDeriv [out] A passed-in parameter for returning the second derivative with respect to v twice.
- Returns
- Returns eOk if evaluation is successfully done. If the surface doesn't contain any NURBS information, returns eFail. If the u or v value is out of range, returns eOutOfRange.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ get()
| OdResult OdDbNurbSurface::get | ( | int & | iUDegree, |
| int & | iVDegree, | ||
| bool & | bRational, | ||
| int & | iUNumControlPoints, | ||
| int & | iVNumControlPoints, | ||
| OdGePoint3dArray & | ctrlPtsArr, | ||
| OdGeDoubleArray & | weights, | ||
| OdGeKnotVector & | uKnots, | ||
| OdGeKnotVector & | vKnots | ||
| ) | const |
Gets all NURB data.
- Parameters
-
iUDegree [out] Degree in the u direction. iVDegree [out] Degree in the v direction. bRational [out] Determines whether the surface is rational. iUNumControlPoints [out] The quantity of control points in the u direction. iVNumControlPoints [out] The quantity of control points in the v direction. ctrlPtsArr [out] An array of control points (in WCS coordinates). weights [out] An array of the weights for each control point. uKnots [out] An array of the knot values in the u direction. vKnots [out] An array of the knot values in the v direction.
- Returns
- Returns eOk if successful or an appropriate error code otherwise.
- Remarks
- The control points are represented with an AcGePoint3d array. The column indexes are for the v direction, and row indexes are for the u direction. For example, if the surface has n control points in the u direction and m control points in the v direction, the array looks like [0,0], [0,1], ...[0,n-1], ..., [m-1,0], [m-1,1], ...[m-1,n-1]. If the surface is rational, the weights array will contain the same number of entries as the ctrlPts array. The values in weights and ctrlPts arrays have the same sequential order as the control points array. If the surface is not periodic in the u direction, the size of the uKnots vector is greater than the iUNumControlPoints value by the degree + 1. If the surface is periodic in the u direction, the size of the uKnots vector is greater than the iUNumControlPoints value by 1. Similarly, if the surface is not periodic in the v direction, the size of the vKnots vector is greater than the iUNumControlPoints by the degree + 1. If the surface is periodic in the v direction, the size of the vKnots vector is greater than the iUNumControlPoints by 1.
◆ getControlPointAt()
| OdResult OdDbNurbSurface::getControlPointAt | ( | int | iUIndex, |
| int | iVIndex, | ||
| OdGePoint3d & | point | ||
| ) | const |
Returns the control point (in WCS coordinates) at the specified position in the control points vector.
- Parameters
-
iUIndex [in] An index of a control point in the u direction. Index starts from the 0 value. iVIndex [in] An index of a control point in the v direction. Index starts from the 0 value. point [out] The control point (in WCS coordinates) at specified index.
- Returns
- Returns eOk if a control point was returned successfully. If the surface doesn't contain the control point information, the method returns eFail. Returns eOutOfRange if the uIndex or vIndex are not valid.
◆ getControlPoints()
| OdResult OdDbNurbSurface::getControlPoints | ( | int & | iUCount, |
| int & | iVCount, | ||
| OdGePoint3dArray & | points | ||
| ) | const |
Returns the control points and the quantity of control points in both u and v directions.
- Parameters
-
iUCount [out] The quantity of control points in u direction. iVCount [out] The quantity of control points in v direction. points [out] Array of control points (in WCS coordinates).
- Returns
- Returns eOk if control point were successfully returned, or an appropriate error code in other case.
- Remarks
- The control points will be allocated in the passed-in OdGePoint3d array. The column indexes are for the v direction, and row indexes are for the u direction. For example, if the surface has n control points in the u direction and m control points in the v direction, the array looks like [0,0], [0,1], ...[0,vCount-1], ..., [uCount-1,0], [uCount-1,1], ...[uCount-1,vCount-1].
◆ getDegreeInU()
| OdResult OdDbNurbSurface::getDegreeInU | ( | int & | iDegree | ) | const |
Returns the degree of NURBS surface in the u direction.
- Parameters
-
iDegree [out] A passed-in parameter for returning the degree in the u direction.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getDegreeInV()
| OdResult OdDbNurbSurface::getDegreeInV | ( | int & | iDegree | ) | const |
Returns the degree of NURBS surface in the v direction.
- Parameters
-
iDegree [out] A passed-in parameter for returning the degree in the v direction.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getIsolineAtU()
| OdResult OdDbNurbSurface::getIsolineAtU | ( | double | dU, |
| OdDbCurvePtrArray & | lineSegments | ||
| ) | const |
Returns the isolines at a specified u value. The isolines are created in the v direction. If there are holes in the surface, there could be a number of isoline segments at a specified u value.
- Parameters
-
dU [in] u parameter. lineSegments [out] A passed-in parameter for returning the array of isoline segments.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getIsolineAtV()
| OdResult OdDbNurbSurface::getIsolineAtV | ( | double | dV, |
| OdDbCurvePtrArray & | lineSegments | ||
| ) | const |
Returns the isolines at a specified v value. The isolines are created in the u direction. If there are holes in the surface, there could be a number of isoline segments at a specified v value.
- Parameters
-
dV [in] v parameter. lineSegments [out] A passed-in parameter for returning the array of isoline segments.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getNormal()
| OdResult OdDbNurbSurface::getNormal | ( | double | dU, |
| double | dV, | ||
| OdGeVector3d & | normal | ||
| ) | const |
Returns the normal vector at the specified parameter location ([u, v]).
- Parameters
-
dU [in] u parameter. dV [in] v parameter. normal [out] A passed-in parameter for returning the normal vector.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail. If the dU or dV values are invalid, returns eOutOfRange.
◆ getNumberOfControlPointsInU()
| OdResult OdDbNurbSurface::getNumberOfControlPointsInU | ( | int & | iCount | ) | const |
Returns the quantity of control points in the u direction.
- Parameters
-
iCount [out] A passed-in parameter for returning the quantity of control points in the u direction.
- Returns
- Returns eOk if successful or eFail if the surface doesn't contain control point information.
◆ getNumberOfControlPointsInV()
| OdResult OdDbNurbSurface::getNumberOfControlPointsInV | ( | int & | iCount | ) | const |
Returns the quantity of control points in the v direction.
- Parameters
-
iCount [out] A passed-in parameter for returning the quantity of control points in the v direction.
- Returns
- Returns eOk if successful or eFail if the surface doesn't contain control point information.
◆ getNumberOfKnotsInU()
| OdResult OdDbNurbSurface::getNumberOfKnotsInU | ( | int & | iCount | ) | const |
Returns the quantity of knots in the u direction.
- Parameters
-
iCount [out] A passed-in parameter for returning the quantity of knots in the u direction.
- Returns
- Returns eOk if successful or eFail if the surface doesn't contain knot information.
◆ getNumberOfKnotsInV()
| OdResult OdDbNurbSurface::getNumberOfKnotsInV | ( | int & | iCount | ) | const |
Returns the quantity of knots in the v direction.
- Parameters
-
iCount [out] A passed-in parameter for returning the quantity of knots in the v direction.
- Returns
- Returns eOk if successful or eFail if the surface doesn't contain knot information.
◆ getNumberOfSpansInU()
| OdResult OdDbNurbSurface::getNumberOfSpansInU | ( | int & | span | ) | const |
Returns the simple patches in the u direction.
- Parameters
-
span [out] A passed-in parameter for returning the number of simple patches in the u direction.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getNumberOfSpansInV()
| OdResult OdDbNurbSurface::getNumberOfSpansInV | ( | int & | span | ) | const |
Returns the simple patches in the v direction.
- Parameters
-
span [out] A passed-in parameter for returning the number of simple patches in the v direction.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getParameterOfPoint()
| OdResult OdDbNurbSurface::getParameterOfPoint | ( | const OdGePoint3d & | point, |
| double & | dU, | ||
| double & | dV | ||
| ) | const |
Returns the u and v parameter for a point on the surface.
- Parameters
-
point [in] A point on the surface. dU [in] A passed-in parameter for returning the value of the u parameter. dV [in] A passed-in parameter for returning the value of the v parameter.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ getPeriodInU()
| OdResult OdDbNurbSurface::getPeriodInU | ( | double & | dPeriod | ) | const |
Returns the period value in the u direction for the surface. Returned value is valid only if the surface is periodic in the u direction.
- Parameters
-
dPeriod [out] A passed-in parameter for returning the period value in the u direction.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getPeriodInV()
| OdResult OdDbNurbSurface::getPeriodInV | ( | double & | dPeriod | ) | const |
Returns the period value in the v direction for the surface. Returned value is valid only if the surface is periodic in the v direction.
- Parameters
-
dPeriod [out] A passed-in parameter for returning the period value in the v direction.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ getUKnots()
| OdResult OdDbNurbSurface::getUKnots | ( | OdGeKnotVector & | knots | ) | const |
Returns the knot vector in the u direction.
- Parameters
-
knots [out] A passed-in parameter for returning the knot vector in the u direction
- Returns
- Returns eOk if successful or eFail if the surface doesn't contain knot information.
◆ getVKnots()
| OdResult OdDbNurbSurface::getVKnots | ( | OdGeKnotVector & | knots | ) | const |
Returns the knot vector in the v direction.
- Parameters
-
knots [out] A passed-in parameter for returning the knot vector in the v direction
- Returns
- Returns eOk if successful or eFail if the surface doesn't contain knot information.
◆ getWeight()
| OdResult OdDbNurbSurface::getWeight | ( | int | iUIndex, |
| int | iVIndex, | ||
| double & | weight | ||
| ) | const |
Returns the weight at a specified position (uIndex, vIndex) in the weights array. Returns valid weight value only when the surface is rational.
- Parameters
-
iUIndex [in] An index of weight value in the u direction. Index starts from the 0 value. iVIndex [in] An index of weight value in the v direction. Index starts from the 0 value. weight [out] A passed-in parameter for returning the weight value at the specified position.
- Returns
- Returns eOk if the weight value was successfully returned.
If the surface doesn't contain the weight information (weight array is empty or is NULL), returns eFail. If the uIndex or vIndex values are invalid, returns eOutOfRange.
◆ InsertControlPointsAtU()
| OdResult OdDbNurbSurface::InsertControlPointsAtU | ( | double | dU, |
| const OdGePoint3dArray & | vCtrlPts, | ||
| const OdGeDoubleArray & | vWeights | ||
| ) |
Inserts a row of control points at the given u knot parameter.
- Parameters
-
dU [in] u parameter. vCtrlPts [in] An array of control points to be added. vWeights [in] Array of weight values to add if the surface is rational.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail. If the dU parameter is out of range, returns eOutOfRange.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ InsertControlPointsAtV()
| OdResult OdDbNurbSurface::InsertControlPointsAtV | ( | double | dV, |
| const OdGePoint3dArray & | uCtrlPts, | ||
| const OdGeDoubleArray & | uWeights | ||
| ) |
Inserts a row of control points at the given v knot parameter.
- Parameters
-
dV [in] v parameter. uCtrlPts [in] An array of control points to be added. vWeights [in] Array of weight values to add if the surface is rational.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail. If the dV parameter is out of range, returns eOutOfRange.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ InsertKnotAtU()
| OdResult OdDbNurbSurface::InsertKnotAtU | ( | double | dU | ) |
Inserts a knot at the specified u parameter. The knot insertion doesn't modify the shape of the surface. It will add a new row of control points in the v direction and adjust the local control point's location.
- Parameters
-
dU [in] u parameter.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail. If the surface's knot multiplicity at the u parameter is bigger than the degree in the u direction, returns eInvalidInput.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ InsertKnotAtV()
| OdResult OdDbNurbSurface::InsertKnotAtV | ( | double | dV | ) |
Inserts a knot at the specified v parameter. The knot insertion doesn't modify the shape of the surface. It will add a new row of control points in the u direction and adjust the local control point's location.
- Parameters
-
dV [in] v parameter.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail. If the surface's knot multiplicity at the v parameter is bigger than the degree in the v direction, returns eInvalidInput.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ isClosedInU()
| OdResult OdDbNurbSurface::isClosedInU | ( | bool & | bIsClosed | ) | const |
Determines whether the surface is closed in the u direction.
- Parameters
-
bIsClosed [out] A passed-in parameter for returning the indicator of whether the surface is closed in the u direction. bIsClosed is equal to true if the surface is closed in the u direction, otherwise it is equal to false.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ isClosedInV()
| OdResult OdDbNurbSurface::isClosedInV | ( | bool & | bIsClosed | ) | const |
Determines whether the surface is closed in the v direction.
- Parameters
-
bIsClosed [out] A passed-in parameter for returning the indicator of whether the surface is closed in the v direction. bIsClosed is equal to true if the surface is closed in the v direction, otherwise it is equal to false.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ isPeriodicInU()
| OdResult OdDbNurbSurface::isPeriodicInU | ( | bool & | bIsPeriodic | ) | const |
Determines whether the surface is periodic in the u direction.
- Parameters
-
bIsPeriodic [out] A passed-in parameter for returning the indicator of whether the surface is periodic in the u direction. bIsPeriodic is equal to true if the surface is periodic in the u direction, otherwise it is equal to false.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ isPeriodicInV()
| OdResult OdDbNurbSurface::isPeriodicInV | ( | bool & | bIsPeriodic | ) | const |
Determines whether the surface is periodic in the v direction.
- Parameters
-
bIsPeriodic [out] A passed-in parameter for returning the indicator of whether the surface is periodic in the v direction. bIsPeriodic is equal to true if the surface is periodic in the v direction, otherwise it is equal to false.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ isPlanar()
| OdResult OdDbNurbSurface::isPlanar | ( | bool & | bIsPlanar, |
| OdGePoint3d & | ptOnSurface, | ||
| OdGeVector3d & | normal | ||
| ) | const |
Determines whether the surface is planar. If the surface is planar, also returns the plane information and normal. If the surface is planar, the method returns true via the bIsPlanar parameter, otherwise the method returns false.
- Parameters
-
bIsPlanar [out] A passed-in parameter for returning the indicator of whether the surface is planar. ptOnSurface [out] A passed-in parameter for returning the point on the surface (if the surface is planar). normal [out] A passed-in parameter for returning the plane normal (if the surface is planar).
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ isPointOnSurface()
| OdResult OdDbNurbSurface::isPointOnSurface | ( | const OdGePoint3d & | point, |
| bool & | bOnSurface | ||
| ) | const |
Determines whether a specified point is on the surface. If specified point is on the surface, the method returns true via bOnSurface, otherwise the method returns false.
- Parameters
-
point [in] A point. bOnSurface [out] A passed-in parameter for returning the indicator of whether the specified point is on the surface.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ isRational()
| OdResult OdDbNurbSurface::isRational | ( | bool & | bIsRational | ) | const |
Determines whether the surface is rational. If the surface is rational, the method returns true, otherwise the method returns false.
- Parameters
-
bIsRational [out] A passed-in parameter for returning the indicator of whether the surface is rational.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
◆ modifyPositionAndTangent()
| OdResult OdDbNurbSurface::modifyPositionAndTangent | ( | double | dU, |
| double | dV, | ||
| const OdGePoint3d & | point, | ||
| const OdGeVector3d * | uDeriv = NULL, |
||
| const OdGeVector3d * | vDeriv = NULL |
||
| ) |
Adjusts the location and tangent of a point on the surface with the specified parameter ([u, v]). The local control points are adjusted accordingly. If the pointer uDeriv and vDeriv are equal to NULL, then only the location of the point is adjusted.
- Parameters
-
dU [in] u parameter. dV [in] v parameter. point [in] A new location of the point on the surface. uDeriv [in] The tangent vector in the u direction. vDeriv [in] The tangent vector in the v direction.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
- Remarks
- This method is not implemented.
◆ ODDB_DECLARE_MEMBERS()
| OdDbNurbSurface::ODDB_DECLARE_MEMBERS | ( | OdDbNurbSurface | ) |
◆ rebuild()
| OdResult OdDbNurbSurface::rebuild | ( | int | iUDegree, |
| int | iVDegree, | ||
| int | iNumUCtrlPts, | ||
| int | iNumVCtrlPts, | ||
| bool | bRestore = false |
||
| ) |
Rebuilds the NURBS surface with a specified new degree and quantity of control points in the u and v directions. This operation modifies the shape of the surface.
- Parameters
-
iUDegree [in] The new degree value in the u direction. iVDegree [in] The new degree value in the v direction. iNumUCtrlPts [in] The new quantity of control point in the u direction. iNumVCtrlPts [in] The new quantity of control point in the v direction. bRestore [in] Restore flag.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
- Remarks
- This method is not implemented.
◆ RemoveControlPointsAtU()
| OdResult OdDbNurbSurface::RemoveControlPointsAtU | ( | int | iUDegree | ) |
Removes a row of control points at the specified position in the control points array. The method modifies the shape of the surface.
- Parameters
-
iUDegree [in] An index of the control point to remove from the array.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ RemoveControlPointsAtV()
| OdResult OdDbNurbSurface::RemoveControlPointsAtV | ( | int | iVDegree | ) |
Removes a row of control points at the specified position in the control points array. The method modifies the shape of the surface.
- Parameters
-
iVDegree [in] An index of the control point to remove from the array.
- Returns
- Returns eOk if successful. If the surface doesn't contain any NURBS information, returns eFail.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ set()
| OdResult OdDbNurbSurface::set | ( | int | iUDegree, |
| int | iVDegree, | ||
| bool | bRational, | ||
| int | iUNumControlPoints, | ||
| int | iVNumControlPoints, | ||
| const OdGePoint3dArray & | ctrlPtsArr, | ||
| const OdGeDoubleArray & | weights, | ||
| const OdGeKnotVector & | uKnots, | ||
| const OdGeKnotVector & | vKnots | ||
| ) |
Set new data for the existing NURBS surface.
- Parameters
-
iUDegree [in] A new value for degrees in the u direction. iVDegree [in] A new value for degrees in the v direction. bRational [in] Determines whether the surface is rational (new value). IUNumControlPoints [in] A new value of the quantity of control points in the u direction. iVNumControlPoints [in] A new value of the quantity of control points in the v direction. ctrlPtsArr [in] A new array of control points (in WCS coordinates). weights [in] A new array of the weights for each control point. uKnots [in] A new array of the knot values in the u direction. vKnots [in] A new array of the knot values in the v direction.
- Returns
- Returns eOk if successful or an appropriate error code otherwise.
- Remarks
- The column indexes is for the v direction, and row indexes are for the u direction. For example, if the surface has n control points in the u direction and m control points in the v direction, the array looks like [0,0], [0,1], ...[0,n-1], ..., [m-1,0], [m-1,1], ...[m-1,n-1].
If the surface is rational (bRational == true), the weights array must contain the same number of entries as the ctrlPts array. All weight values must be greater than 0.0. The values in weights and ctrlPts arrays must have the same sequential order as the control points array. If the surface is not rational (bRational == false), the weight array must be empty.
If the surface is not periodic in the u direction, the size of the uKnots vector must be equal to iUNumControlPoints + iUDegree + 1. If the surface is periodic in the u direction, the size of the uKnots vector must be iUNumControlPoints + 1. Similarly, if the surface is not periodic in the v direction, the size of the vKnots vector must be equal to iVNumControlPoints + iVDegree + 1. If the surface is periodic in the v direction, the size of the vKnots vector must be iVNumControlPoints + 1. Each knot must have a value greater than or equal to the value of its predecessor in the array.
If any of the passed-in parameters are not valid, the surface will not be created.
This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ setControlPointAt()
| OdResult OdDbNurbSurface::setControlPointAt | ( | int | iUIndex, |
| int | iVIndex, | ||
| const OdGePoint3d & | point | ||
| ) |
Sets a new control point (in WCS coordinates) at a specified position in the control points vector.
- Parameters
-
iUIndex [in] An index of a control point in the u direction. Index starts from the 0 value. iVIndex [in] An index of a control point in the v direction. Index starts from the 0 value. point [in] A new control point (in WCS coordinates) to be set at the specified position.
- Returns
- Returns eOk if a control point was returned successfully. If the surface doesn't contain the control point information, the method returns eFail. Returns eOutOfRange if the uIndex or vIndex are not valid.
- Remarks
- This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
◆ setControlPoints()
| OdResult OdDbNurbSurface::setControlPoints | ( | int | iUCount, |
| int | iVCount, | ||
| const OdGePoint3dArray & | points | ||
| ) |
Sets the control points.
- Parameters
-
iUCount [in] The new value of the quantity of control points in the u direction. iVCount [in] The new value of the quantity of control points in the v direction. points [in] New array of control points (in WCS coordinates).
- Returns
- Returns eOk if control points were successfully set or an appropriate error code in other case. Returns eFail if the surface doesn't contain the control point information. Returns eInvalidInput if the uCount and vCount are not the same as the current numbers.
- Remarks
- The new quantity of control points in the u and v direction must be equal to the current values. New control points are allocated in an AcGePoint3d array. The column indexes are for the v direction, and row indexes are for the u direction. For example, if the surface has n control points in the u direction and m control points in the v direction, the array looks like [0,0], [0,1], ...[0,vCount-1], ..., [uCount-1,0], [uCount-1,1], ...[uCount-1,vCount-1].
◆ setWeight()
| OdResult OdDbNurbSurface::setWeight | ( | int | iUIndex, |
| int | iVIndex, | ||
| double | weight | ||
| ) |
Sets the weight value at a specified position in the weights array.
If the surface is not rational, the method does nothing.
- Parameters
-
iUIndex [in] An index of weight value in the u direction. Index starts from the 0 value. iVIndex [in] An index of weight value in the v direction. Index starts from the 0 value. weight [in] A new weight value to be set at a specified position.
- Returns
- Returns eOk if a new weight value was successfully set. If the surface doesn't contain the weight information (weight array is empty or is NULL), returns eFail. If the uIndex or vIndex values are invalid, returns eOutOfRange.
- Remarks
This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.
The documentation for this class was generated from the following file: