OCC Main Page | FoundationClasses | Toolkits | Packages | Class Hierarchy | Data Structures | File List | Data Fields | Globals

FoundationClasses
TKMath
Convert


Convert_CompBezierCurvesToBSplineCurve Class Reference

An algorithm to convert a sequence of adjacent
non-rational Bezier curves into a BSpline curve.
A CompBezierCurvesToBSplineCurve object provides a framework for:
- defining the sequence of adjacent non-rational Bezier
curves to be converted into a BSpline curve,
- implementing the computation algorithm, and
- consulting the results.
Warning
Do not attempt to convert rational Bezier curves using this type of algorithm.
.

#include <Convert_CompBezierCurvesToBSplineCurve.hxx>


Public Member Functions

void * operator new (size_t, void *anAddress)
void * operator new (size_t size)
void operator delete (void *anAddress)
Standard_EXPORT Convert_CompBezierCurvesToBSplineCurve (const Standard_Real AngularTolerance=1.0e-4)
 Constructs a framework for converting a sequence of
adjacent non-rational Bezier curves into a BSpline curve.
Knots will be created on the computed BSpline curve at
each junction point of two consecutive Bezier curves. The
degree of continuity of the BSpline curve will be increased at
the junction point of two consecutive Bezier curves if their
tangent vectors at this point are parallel. AngularTolerance
(given in radians, and defaulted to 1.0 e-4) will be used
to check the parallelism of the two tangent vectors.
Use the following functions:
- AddCurve to define in sequence the adjacent Bezier
curves to be converted,
- Perform to compute the data needed to build the BSpline curve,
- and the available consultation functions to access the
computed data. This data may be used to construct the BSpline curve.
.
Standard_EXPORT void AddCurve (const TColgp_Array1OfPnt &Poles)
 Adds the Bezier curve defined by the table of poles Poles, to
the sequence (still contained in this framework) of adjacent
Bezier curves to be converted into a BSpline curve.
Only polynomial (i.e. non-rational) Bezier curves are
converted using this framework.
If this is not the first call to the function (i.e. if this framework
still contains data in its Bezier curve sequence), the degree
of continuity of the BSpline curve will be increased at the
time of computation at the first point of the added Bezier
curve (i.e. the first point of the Poles table). This will be the
case if the tangent vector of the curve at this point is
parallel to the tangent vector at the end point of the
preceding Bezier curve in the Bezier curve sequence still
contained in this framework. An angular tolerance given at
the time of construction of this framework will be used to
check the parallelism of the two tangent vectors. This
checking procedure and all related computations will be
performed by the Perform function.
When the adjacent Bezier curve sequence is complete, use
the following functions:
- Perform to compute the data needed to build the BSpline curve,
- and the available consultation functions to access the
computed data. This data may be used to construct the BSpline curve.
Warning
The Bezier curve sequence treated by this framework is
automatically initialized with the first Bezier curve when the
function is first called. During subsequent use of this function,
ensure that the first point of the added Bezier curve (i.e. the
first point of the Poles table) is coincident with the last point
of the Bezier curve sequence (i.e. the last point of the
preceding Bezier curve in the sequence) still contained in
this framework. An error may occur at the time of
computation if this condition is not satisfied. Particular care
must be taken with respect to the above, as this condition is
not checked either when defining the Bezier curve
sequence or at the time of computation.
.
Standard_EXPORT void Perform ()
 Computes all the data needed to build a BSpline curve
equivalent to the adjacent Bezier curve sequence still
contained in this framework.
A knot is inserted on the computed BSpline curve at the
junction point of two consecutive Bezier curves. The
degree of continuity of the BSpline curve will be increased
at the junction point of two consecutive Bezier curves if
their tangent vectors at this point are parallel. An angular
tolerance given at the time of construction of this
framework is used to check the parallelism of the two
tangent vectors.
Use the available consultation functions to access the
computed data. This data may then be used to construct
the BSpline curve.
Warning
Make sure that the curves in the Bezier curve sequence
contained in this framework are adjacent. An error may
occur at the time of computation if this condition is not
satisfied. Particular care must be taken with respect to the
above as this condition is not checked, either when
defining the Bezier curve sequence or at the time of computation.
.
Standard_EXPORT Standard_Integer Degree () const
 Returns the degree of the BSpline curve whose data is
computed in this framework.
Warning
Take particular care not to use this function before the
computation is performed (Perform function), as this
condition is not checked and an error may therefore occur.
.
Standard_EXPORT Standard_Integer NbPoles () const
 Returns the number of poles of the BSpline curve whose
data is computed in this framework.
Warning
Take particular care not to use this function before the
computation is performed (Perform function), as this
condition is not checked and an error may therefore occur.
.
Standard_EXPORT void Poles (TColgp_Array1OfPnt &Poles) const
 Loads the Poles table with the poles of the BSpline curve
whose data is computed in this framework.
Warning
- Do not use this function before the computation is
performed (Perform function).
- The length of the Poles array must be equal to the
number of poles of the BSpline curve whose data is
computed in this framework.
Particular care must be taken with respect to the above, as
these conditions are not checked, and an error may occur.
.
Standard_EXPORT Standard_Integer NbKnots () const
 Returns the number of knots of the BSpline curve whose
data is computed in this framework.
Warning
Take particular care not to use this function before the
computation is performed (Perform function), as this
condition is not checked and an error may therefore occur.
.
Standard_EXPORT void KnotsAndMults (TColStd_Array1OfReal &Knots, TColStd_Array1OfInteger &Mults) const
 
  • loads the Knots table with the knots,
    - and loads the Mults table with the corresponding multiplicities
    of the BSpline curve whose data is computed in this framework.
    Warning
    - Do not use this function before the computation is
    performed (Perform function).
    - The length of the Knots and Mults arrays must be equal
    to the number of knots in the BSpline curve whose data is
    computed in this framework.
    Particular care must be taken with respect to the above as
    these conditions are not checked, and an error may occur.


Private Attributes

Convert_SequenceOfArray1OfPoles mySequence
TColgp_SequenceOfPnt CurvePoles
TColStd_SequenceOfReal CurveKnots
TColStd_SequenceOfInteger KnotsMultiplicities
Standard_Integer myDegree
Standard_Real myAngular
Standard_Boolean myDone


Constructor & Destructor Documentation

Standard_EXPORT Convert_CompBezierCurvesToBSplineCurve::Convert_CompBezierCurvesToBSplineCurve const Standard_Real  AngularTolerance = 1.0e-4  ) 
 


Member Function Documentation

Standard_EXPORT void Convert_CompBezierCurvesToBSplineCurve::AddCurve const TColgp_Array1OfPnt Poles  ) 
 

Standard_EXPORT Standard_Integer Convert_CompBezierCurvesToBSplineCurve::Degree  )  const
 

Standard_EXPORT void Convert_CompBezierCurvesToBSplineCurve::KnotsAndMults TColStd_Array1OfReal Knots,
TColStd_Array1OfInteger Mults
const
 

Standard_EXPORT Standard_Integer Convert_CompBezierCurvesToBSplineCurve::NbKnots  )  const
 

Standard_EXPORT Standard_Integer Convert_CompBezierCurvesToBSplineCurve::NbPoles  )  const
 

void Convert_CompBezierCurvesToBSplineCurve::operator delete void *  anAddress  )  [inline]
 

void* Convert_CompBezierCurvesToBSplineCurve::operator new size_t  size  )  [inline]
 

void* Convert_CompBezierCurvesToBSplineCurve::operator new size_t  ,
void *  anAddress
[inline]
 

Standard_EXPORT void Convert_CompBezierCurvesToBSplineCurve::Perform  ) 
 

Standard_EXPORT void Convert_CompBezierCurvesToBSplineCurve::Poles TColgp_Array1OfPnt Poles  )  const
 


Field Documentation

TColStd_SequenceOfReal Convert_CompBezierCurvesToBSplineCurve::CurveKnots [private]
 

TColgp_SequenceOfPnt Convert_CompBezierCurvesToBSplineCurve::CurvePoles [private]
 

TColStd_SequenceOfInteger Convert_CompBezierCurvesToBSplineCurve::KnotsMultiplicities [private]
 

Standard_Real Convert_CompBezierCurvesToBSplineCurve::myAngular [private]
 

Standard_Integer Convert_CompBezierCurvesToBSplineCurve::myDegree [private]
 

Standard_Boolean Convert_CompBezierCurvesToBSplineCurve::myDone [private]
 

Convert_SequenceOfArray1OfPoles Convert_CompBezierCurvesToBSplineCurve::mySequence [private]
 


The documentation for this class was generated from the following file:
Generated on Mon Aug 25 13:12:04 2008 for OpenCASCADE by  doxygen 1.4.1