Open CASCADE Technology 7.8.2.dev
|
Provides an algorithm to compute a distribution of points on a 'C2' continuous curve. The algorithm respects a criterion of maximum deflection between the curve and the polygon that results from the computed points. Note: This algorithm is relatively time consuming. A GCPnts_QuasiUniformDeflection algorithm is quicker; it can also work with non-'C2' continuous curves, but it generates more points in the distribution. More...
#include <GCPnts_UniformDeflection.hxx>
Public Member Functions | |
GCPnts_UniformDeflection () | |
Constructs an empty algorithm. To define the problem to be solved, use the function Initialize. | |
GCPnts_UniformDeflection (const Adaptor3d_Curve &theC, const Standard_Real theDeflection, const Standard_Boolean theWithControl=Standard_True) | |
Computes a uniform Deflection distribution of points on the curve. | |
GCPnts_UniformDeflection (const Adaptor2d_Curve2d &theC, const Standard_Real theDeflection, const Standard_Boolean theWithControl=Standard_True) | |
Computes a uniform Deflection distribution of points on the curve. | |
GCPnts_UniformDeflection (const Adaptor3d_Curve &theC, const Standard_Real theDeflection, const Standard_Real theU1, const Standard_Real theU2, const Standard_Boolean theWithControl=Standard_True) | |
Computes a Uniform Deflection distribution of points on a part of the curve. | |
GCPnts_UniformDeflection (const Adaptor2d_Curve2d &theC, const Standard_Real theDeflection, const Standard_Real theU1, const Standard_Real theU2, const Standard_Boolean theWithControl=Standard_True) | |
Computes a Uniform Deflection distribution of points on a part of the curve. | |
void | Initialize (const Adaptor3d_Curve &theC, const Standard_Real theDeflection, const Standard_Boolean theWithControl=Standard_True) |
Initialize the algorithms with 3D curve and deflection. | |
void | Initialize (const Adaptor2d_Curve2d &theC, const Standard_Real theDeflection, const Standard_Boolean theWithControl=Standard_True) |
Initialize the algorithms with 2D curve and deflection. | |
void | Initialize (const Adaptor3d_Curve &theC, const Standard_Real theDeflection, const Standard_Real theU1, const Standard_Real theU2, const Standard_Boolean theWithControl=Standard_True) |
Initialize the algorithms with 3D curve, deflection, parameter range. | |
void | Initialize (const Adaptor2d_Curve2d &theC, const Standard_Real theDeflection, const Standard_Real theU1, const Standard_Real theU2, const Standard_Boolean theWithControl=Standard_True) |
Initialize the algorithms with curve, deflection, parameter range. This and the above methods initialize (or reinitialize) this algorithm and compute a distribution of points: | |
Standard_Boolean | IsDone () const |
Returns true if the computation was successful. IsDone is a protection against: | |
Standard_Integer | NbPoints () const |
Returns the number of points of the distribution computed by this algorithm. Exceptions StdFail_NotDone if this algorithm has not been initialized, or if the computation was not successful. | |
Standard_Real | Parameter (const Standard_Integer Index) const |
Returns the parameter of the point of index Index in the distribution computed by this algorithm. Warning Index must be greater than or equal to 1, and less than or equal to the number of points of the distribution. However, pay particular attention as this condition is not checked by this function. Exceptions StdFail_NotDone if this algorithm has not been initialized, or if the computation was not successful. | |
gp_Pnt | Value (const Standard_Integer Index) const |
Returns the point of index Index in the distribution computed by this algorithm. Warning Index must be greater than or equal to 1, and less than or equal to the number of points of the distribution. However, pay particular attention as this condition is not checked by this function. Exceptions StdFAil_NotDone if this algorithm has not been initialized, or if the computation was not successful. | |
Standard_Real | Deflection () const |
Returns the deflection between the curve and the polygon resulting from the points of the distribution computed by this algorithm. This value is the one given to the algorithm at the time of construction (or initialization). Exceptions StdFail_NotDone if this algorithm has not been initialized, or if the computation was not successful. | |
Provides an algorithm to compute a distribution of points on a 'C2' continuous curve. The algorithm respects a criterion of maximum deflection between the curve and the polygon that results from the computed points. Note: This algorithm is relatively time consuming. A GCPnts_QuasiUniformDeflection algorithm is quicker; it can also work with non-'C2' continuous curves, but it generates more points in the distribution.
GCPnts_UniformDeflection::GCPnts_UniformDeflection | ( | ) |
Constructs an empty algorithm. To define the problem to be solved, use the function Initialize.
GCPnts_UniformDeflection::GCPnts_UniformDeflection | ( | const Adaptor3d_Curve & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Computes a uniform Deflection distribution of points on the curve.
theC | [in] input 3D curve |
theDeflection | [in] target deflection |
theWithControl | [in] when TRUE, the algorithm controls the estimate deflection |
GCPnts_UniformDeflection::GCPnts_UniformDeflection | ( | const Adaptor2d_Curve2d & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Computes a uniform Deflection distribution of points on the curve.
theC | [in] input 2D curve |
theDeflection | [in] target deflection |
theWithControl | [in] when TRUE, the algorithm controls the estimate deflection |
GCPnts_UniformDeflection::GCPnts_UniformDeflection | ( | const Adaptor3d_Curve & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Real | theU1, | ||
const Standard_Real | theU2, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Computes a Uniform Deflection distribution of points on a part of the curve.
theC | [in] input 3D curve |
theDeflection | [in] target deflection |
theU1 | [in] first parameter on curve |
theU2 | [in] last parameter on curve |
theWithControl | [in] when TRUE, the algorithm controls the estimate deflection |
GCPnts_UniformDeflection::GCPnts_UniformDeflection | ( | const Adaptor2d_Curve2d & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Real | theU1, | ||
const Standard_Real | theU2, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Computes a Uniform Deflection distribution of points on a part of the curve.
theC | [in] input 2D curve |
theDeflection | [in] target deflection |
theU1 | [in] first parameter on curve |
theU2 | [in] last parameter on curve |
theWithControl | [in] when TRUE, the algorithm controls the estimate deflection |
|
inline |
Returns the deflection between the curve and the polygon resulting from the points of the distribution computed by this algorithm. This value is the one given to the algorithm at the time of construction (or initialization). Exceptions StdFail_NotDone if this algorithm has not been initialized, or if the computation was not successful.
void GCPnts_UniformDeflection::Initialize | ( | const Adaptor2d_Curve2d & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Initialize the algorithms with 2D curve and deflection.
void GCPnts_UniformDeflection::Initialize | ( | const Adaptor2d_Curve2d & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Real | theU1, | ||
const Standard_Real | theU2, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Initialize the algorithms with curve, deflection, parameter range. This and the above methods initialize (or reinitialize) this algorithm and compute a distribution of points:
Warning
Warning theC is an adapted curve, i.e. an object which is an interface between:
void GCPnts_UniformDeflection::Initialize | ( | const Adaptor3d_Curve & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Initialize the algorithms with 3D curve and deflection.
void GCPnts_UniformDeflection::Initialize | ( | const Adaptor3d_Curve & | theC, |
const Standard_Real | theDeflection, | ||
const Standard_Real | theU1, | ||
const Standard_Real | theU2, | ||
const Standard_Boolean | theWithControl = Standard_True ) |
Initialize the algorithms with 3D curve, deflection, parameter range.
|
inline |
Returns true if the computation was successful. IsDone is a protection against:
|
inline |
Returns the number of points of the distribution computed by this algorithm. Exceptions StdFail_NotDone if this algorithm has not been initialized, or if the computation was not successful.
|
inline |
Returns the parameter of the point of index Index in the distribution computed by this algorithm. Warning Index must be greater than or equal to 1, and less than or equal to the number of points of the distribution. However, pay particular attention as this condition is not checked by this function. Exceptions StdFail_NotDone if this algorithm has not been initialized, or if the computation was not successful.
gp_Pnt GCPnts_UniformDeflection::Value | ( | const Standard_Integer | Index | ) | const |
Returns the point of index Index in the distribution computed by this algorithm. Warning Index must be greater than or equal to 1, and less than or equal to the number of points of the distribution. However, pay particular attention as this condition is not checked by this function. Exceptions StdFAil_NotDone if this algorithm has not been initialized, or if the computation was not successful.