Open CASCADE Technology  7.7.0
Public Member Functions
ProjLib_ProjectedCurve Class Reference

Compute the 2d-curve. Try to solve the particular case if possible. Otherwise, an approximation is done. For approximation some parameters are used, including required tolerance of approximation. Tolerance is maximal possible value of 3d deviation of 3d projection of projected curve from "exact" 3d projection. Since algorithm searches 2d curve on surface, required 2d tolerance is computed from 3d tolerance with help of U,V resolutions of surface. 3d and 2d tolerances have sense only for curves on surface, it defines precision of projecting and approximation and have nothing to do with distance between the projected curve and the surface. More...

#include <ProjLib_ProjectedCurve.hxx>

Inheritance diagram for ProjLib_ProjectedCurve:
Inheritance graph
[legend]

Public Member Functions

 ProjLib_ProjectedCurve ()
 Empty constructor, it only sets some initial values for class fields. More...
 
 ProjLib_ProjectedCurve (const Handle< Adaptor3d_Surface > &S)
 Constructor with initialisation field mySurface. More...
 
 ProjLib_ProjectedCurve (const Handle< Adaptor3d_Surface > &S, const Handle< Adaptor3d_Curve > &C)
 Constructor, which performs projecting. If projecting uses approximation, default parameters are used, in particular, 3d tolerance of approximation is Precision::Confusion() More...
 
 ProjLib_ProjectedCurve (const Handle< Adaptor3d_Surface > &S, const Handle< Adaptor3d_Curve > &C, const Standard_Real Tol)
 Constructor, which performs projecting. If projecting uses approximation, 3d tolerance is Tol, default parameters are used,. More...
 
virtual Handle< Adaptor2d_Curve2dShallowCopy () const override
 Shallow copy of adaptor. More...
 
void Load (const Standard_Real Tolerance)
 Changes the tolerance used to project the curve on the surface. More...
 
void Load (const Handle< Adaptor3d_Surface > &S)
 Changes the Surface. More...
 
void Perform (const Handle< Adaptor3d_Curve > &C)
 Performs projecting for given curve. If projecting uses approximation, approximation parameters can be set before by corresponding methods SetDegree(...), SetMaxSegmets(...), SetBndPnt(...), SetMaxDist(...) More...
 
void SetDegree (const Standard_Integer theDegMin, const Standard_Integer theDegMax)
 Set min and max possible degree of result BSpline curve2d, which is got by approximation. If theDegMin/Max < 0, algorithm uses values that are chosen depending of types curve 3d and surface. More...
 
void SetMaxSegments (const Standard_Integer theMaxSegments)
 Set the parameter, which defines maximal value of parametric intervals the projected curve can be cut for approximation. If theMaxSegments < 0, algorithm uses default value = 1000. More...
 
void SetBndPnt (const AppParCurves_Constraint theBndPnt)
 Set the parameter, which defines type of boundary condition between segments during approximation. It can be AppParCurves_PassPoint or AppParCurves_TangencyPoint. Default value is AppParCurves_TangencyPoint;. More...
 
void SetMaxDist (const Standard_Real theMaxDist)
 Set the parameter, which degines maximal possible distance between projected curve and surface. It uses only for projecting on not analytical surfaces. If theMaxDist < 0, algorithm uses default value 100.*Tolerance. If real distance between curve and surface more then theMaxDist, algorithm stops working. More...
 
const Handle< Adaptor3d_Surface > & GetSurface () const
 
const Handle< Adaptor3d_Curve > & GetCurve () const
 
Standard_Real GetTolerance () const
 returns the tolerance reached if an approximation is Done. More...
 
Standard_Real FirstParameter () const override
 
Standard_Real LastParameter () const override
 
GeomAbs_Shape Continuity () const override
 
Standard_Integer NbIntervals (const GeomAbs_Shape S) const override
 If necessary, breaks the curve in intervals of continuity <S>. And returns the number of intervals. More...
 
void Intervals (TColStd_Array1OfReal &T, const GeomAbs_Shape S) const override
 Stores in <T> the parameters bounding the intervals of continuity <S>. More...
 
Handle< Adaptor2d_Curve2dTrim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol) const override
 Returns a curve equivalent of <me> between parameters <First> and <Last>. <Tol> is used to test for 3d points confusion. If <First> >= <Last> More...
 
Standard_Boolean IsClosed () const override
 
Standard_Boolean IsPeriodic () const override
 
Standard_Real Period () const override
 
gp_Pnt2d Value (const Standard_Real U) const override
 Computes the point of parameter U on the curve. More...
 
void D0 (const Standard_Real U, gp_Pnt2d &P) const override
 Computes the point of parameter U on the curve. More...
 
void D1 (const Standard_Real U, gp_Pnt2d &P, gp_Vec2d &V) const override
 Computes the point of parameter U on the curve with its first derivative. Raised if the continuity of the current interval is not C1. More...
 
void D2 (const Standard_Real U, gp_Pnt2d &P, gp_Vec2d &V1, gp_Vec2d &V2) const override
 Returns the point P of parameter U, the first and second derivatives V1 and V2. Raised if the continuity of the current interval is not C2. More...
 
void D3 (const Standard_Real U, gp_Pnt2d &P, gp_Vec2d &V1, gp_Vec2d &V2, gp_Vec2d &V3) const override
 Returns the point P of parameter U, the first, the second and the third derivative. Raised if the continuity of the current interval is not C3. More...
 
gp_Vec2d DN (const Standard_Real U, const Standard_Integer N) const override
 The returned vector gives the value of the derivative for the order of derivation N. Raised if the continuity of the current interval is not CN. Raised if N < 1. More...
 
Standard_Real Resolution (const Standard_Real R3d) const override
 Returns the parametric resolution corresponding to the real space resolution <R3d>. More...
 
GeomAbs_CurveType GetType () const override
 Returns the type of the curve in the current interval : Line, Circle, Ellipse, Hyperbola, Parabola, BezierCurve, BSplineCurve, OtherCurve. More...
 
gp_Lin2d Line () const override
 
gp_Circ2d Circle () const override
 
gp_Elips2d Ellipse () const override
 
gp_Hypr2d Hyperbola () const override
 
gp_Parab2d Parabola () const override
 
Standard_Integer Degree () const override
 
Standard_Boolean IsRational () const override
 
Standard_Integer NbPoles () const override
 
Standard_Integer NbKnots () const override
 
Handle< Geom2d_BezierCurveBezier () const override
 Warning ! This will NOT make a copy of the – Bezier Curve - If you want to modify – the Curve please make a copy yourself – Also it will NOT trim the surface to – myFirst/Last. More...
 
Handle< Geom2d_BSplineCurveBSpline () const override
 Warning ! This will NOT make a copy of the BSpline Curve - If you want to modify the Curve please make a copy yourself Also it will NOT trim the surface to myFirst/Last. More...
 
- Public Member Functions inherited from Adaptor2d_Curve2d
virtual Standard_Integer NbSamples () const
 
virtual ~Adaptor2d_Curve2d ()
 
- Public Member Functions inherited from Standard_Transient
 Standard_Transient ()
 Empty constructor. More...
 
 Standard_Transient (const Standard_Transient &)
 Copy constructor – does nothing. More...
 
Standard_Transientoperator= (const Standard_Transient &)
 Assignment operator, needed to avoid copying reference counter. More...
 
virtual ~Standard_Transient ()
 Destructor must be virtual. More...
 
virtual void Delete () const
 Memory deallocator for transient classes. More...
 
virtual const opencascade::handle< Standard_Type > & DynamicType () const
 Returns a type descriptor about this object. More...
 
Standard_Boolean IsInstance (const opencascade::handle< Standard_Type > &theType) const
 Returns a true value if this is an instance of Type. More...
 
Standard_Boolean IsInstance (const Standard_CString theTypeName) const
 Returns a true value if this is an instance of TypeName. More...
 
Standard_Boolean IsKind (const opencascade::handle< Standard_Type > &theType) const
 Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
 
Standard_Boolean IsKind (const Standard_CString theTypeName) const
 Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
 
Standard_TransientThis () const
 Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero. More...
 
Standard_Integer GetRefCount () const
 Get the reference counter of this object. More...
 
void IncrementRefCounter () const
 Increments the reference counter of this object. More...
 
Standard_Integer DecrementRefCounter () const
 Decrements the reference counter of this object; returns the decremented value. More...
 

Additional Inherited Members

- Public Types inherited from Standard_Transient
typedef void base_type
 Returns a type descriptor about this object. More...
 
- Static Public Member Functions inherited from Standard_Transient
static const char * get_type_name ()
 Returns a type descriptor about this object. More...
 
static const opencascade::handle< Standard_Type > & get_type_descriptor ()
 Returns type descriptor of Standard_Transient class. More...
 

Detailed Description

Compute the 2d-curve. Try to solve the particular case if possible. Otherwise, an approximation is done. For approximation some parameters are used, including required tolerance of approximation. Tolerance is maximal possible value of 3d deviation of 3d projection of projected curve from "exact" 3d projection. Since algorithm searches 2d curve on surface, required 2d tolerance is computed from 3d tolerance with help of U,V resolutions of surface. 3d and 2d tolerances have sense only for curves on surface, it defines precision of projecting and approximation and have nothing to do with distance between the projected curve and the surface.

Constructor & Destructor Documentation

◆ ProjLib_ProjectedCurve() [1/4]

ProjLib_ProjectedCurve::ProjLib_ProjectedCurve ( )

Empty constructor, it only sets some initial values for class fields.

◆ ProjLib_ProjectedCurve() [2/4]

ProjLib_ProjectedCurve::ProjLib_ProjectedCurve ( const Handle< Adaptor3d_Surface > &  S)

Constructor with initialisation field mySurface.

◆ ProjLib_ProjectedCurve() [3/4]

ProjLib_ProjectedCurve::ProjLib_ProjectedCurve ( const Handle< Adaptor3d_Surface > &  S,
const Handle< Adaptor3d_Curve > &  C 
)

Constructor, which performs projecting. If projecting uses approximation, default parameters are used, in particular, 3d tolerance of approximation is Precision::Confusion()

◆ ProjLib_ProjectedCurve() [4/4]

ProjLib_ProjectedCurve::ProjLib_ProjectedCurve ( const Handle< Adaptor3d_Surface > &  S,
const Handle< Adaptor3d_Curve > &  C,
const Standard_Real  Tol 
)

Constructor, which performs projecting. If projecting uses approximation, 3d tolerance is Tol, default parameters are used,.

Member Function Documentation

◆ Bezier()

Handle< Geom2d_BezierCurve > ProjLib_ProjectedCurve::Bezier ( ) const
overridevirtual

Warning ! This will NOT make a copy of the – Bezier Curve - If you want to modify – the Curve please make a copy yourself – Also it will NOT trim the surface to – myFirst/Last.

Reimplemented from Adaptor2d_Curve2d.

◆ BSpline()

Handle< Geom2d_BSplineCurve > ProjLib_ProjectedCurve::BSpline ( ) const
overridevirtual

Warning ! This will NOT make a copy of the BSpline Curve - If you want to modify the Curve please make a copy yourself Also it will NOT trim the surface to myFirst/Last.

Reimplemented from Adaptor2d_Curve2d.

◆ Circle()

gp_Circ2d ProjLib_ProjectedCurve::Circle ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ Continuity()

GeomAbs_Shape ProjLib_ProjectedCurve::Continuity ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ D0()

void ProjLib_ProjectedCurve::D0 ( const Standard_Real  U,
gp_Pnt2d P 
) const
overridevirtual

Computes the point of parameter U on the curve.

Reimplemented from Adaptor2d_Curve2d.

◆ D1()

void ProjLib_ProjectedCurve::D1 ( const Standard_Real  U,
gp_Pnt2d P,
gp_Vec2d V 
) const
overridevirtual

Computes the point of parameter U on the curve with its first derivative. Raised if the continuity of the current interval is not C1.

Reimplemented from Adaptor2d_Curve2d.

◆ D2()

void ProjLib_ProjectedCurve::D2 ( const Standard_Real  U,
gp_Pnt2d P,
gp_Vec2d V1,
gp_Vec2d V2 
) const
overridevirtual

Returns the point P of parameter U, the first and second derivatives V1 and V2. Raised if the continuity of the current interval is not C2.

Reimplemented from Adaptor2d_Curve2d.

◆ D3()

void ProjLib_ProjectedCurve::D3 ( const Standard_Real  U,
gp_Pnt2d P,
gp_Vec2d V1,
gp_Vec2d V2,
gp_Vec2d V3 
) const
overridevirtual

Returns the point P of parameter U, the first, the second and the third derivative. Raised if the continuity of the current interval is not C3.

Reimplemented from Adaptor2d_Curve2d.

◆ Degree()

Standard_Integer ProjLib_ProjectedCurve::Degree ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ DN()

gp_Vec2d ProjLib_ProjectedCurve::DN ( const Standard_Real  U,
const Standard_Integer  N 
) const
overridevirtual

The returned vector gives the value of the derivative for the order of derivation N. Raised if the continuity of the current interval is not CN. Raised if N < 1.

Reimplemented from Adaptor2d_Curve2d.

◆ Ellipse()

gp_Elips2d ProjLib_ProjectedCurve::Ellipse ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ FirstParameter()

Standard_Real ProjLib_ProjectedCurve::FirstParameter ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ GetCurve()

const Handle< Adaptor3d_Curve >& ProjLib_ProjectedCurve::GetCurve ( ) const

◆ GetSurface()

const Handle< Adaptor3d_Surface >& ProjLib_ProjectedCurve::GetSurface ( ) const

◆ GetTolerance()

Standard_Real ProjLib_ProjectedCurve::GetTolerance ( ) const

returns the tolerance reached if an approximation is Done.

◆ GetType()

GeomAbs_CurveType ProjLib_ProjectedCurve::GetType ( ) const
overridevirtual

Returns the type of the curve in the current interval : Line, Circle, Ellipse, Hyperbola, Parabola, BezierCurve, BSplineCurve, OtherCurve.

Reimplemented from Adaptor2d_Curve2d.

◆ Hyperbola()

gp_Hypr2d ProjLib_ProjectedCurve::Hyperbola ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ Intervals()

void ProjLib_ProjectedCurve::Intervals ( TColStd_Array1OfReal T,
const GeomAbs_Shape  S 
) const
overridevirtual

Stores in <T> the parameters bounding the intervals of continuity <S>.

The array must provide enough room to accommodate for the parameters. i.e. T.Length() > NbIntervals()

Reimplemented from Adaptor2d_Curve2d.

◆ IsClosed()

Standard_Boolean ProjLib_ProjectedCurve::IsClosed ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ IsPeriodic()

Standard_Boolean ProjLib_ProjectedCurve::IsPeriodic ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ IsRational()

Standard_Boolean ProjLib_ProjectedCurve::IsRational ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ LastParameter()

Standard_Real ProjLib_ProjectedCurve::LastParameter ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ Line()

gp_Lin2d ProjLib_ProjectedCurve::Line ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ Load() [1/2]

void ProjLib_ProjectedCurve::Load ( const Standard_Real  Tolerance)

Changes the tolerance used to project the curve on the surface.

◆ Load() [2/2]

void ProjLib_ProjectedCurve::Load ( const Handle< Adaptor3d_Surface > &  S)

Changes the Surface.

◆ NbIntervals()

Standard_Integer ProjLib_ProjectedCurve::NbIntervals ( const GeomAbs_Shape  S) const
overridevirtual

If necessary, breaks the curve in intervals of continuity <S>. And returns the number of intervals.

Reimplemented from Adaptor2d_Curve2d.

◆ NbKnots()

Standard_Integer ProjLib_ProjectedCurve::NbKnots ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ NbPoles()

Standard_Integer ProjLib_ProjectedCurve::NbPoles ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ Parabola()

gp_Parab2d ProjLib_ProjectedCurve::Parabola ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ Perform()

void ProjLib_ProjectedCurve::Perform ( const Handle< Adaptor3d_Curve > &  C)

Performs projecting for given curve. If projecting uses approximation, approximation parameters can be set before by corresponding methods SetDegree(...), SetMaxSegmets(...), SetBndPnt(...), SetMaxDist(...)

◆ Period()

Standard_Real ProjLib_ProjectedCurve::Period ( ) const
overridevirtual

Reimplemented from Adaptor2d_Curve2d.

◆ Resolution()

Standard_Real ProjLib_ProjectedCurve::Resolution ( const Standard_Real  R3d) const
overridevirtual

Returns the parametric resolution corresponding to the real space resolution <R3d>.

Reimplemented from Adaptor2d_Curve2d.

◆ SetBndPnt()

void ProjLib_ProjectedCurve::SetBndPnt ( const AppParCurves_Constraint  theBndPnt)

Set the parameter, which defines type of boundary condition between segments during approximation. It can be AppParCurves_PassPoint or AppParCurves_TangencyPoint. Default value is AppParCurves_TangencyPoint;.

◆ SetDegree()

void ProjLib_ProjectedCurve::SetDegree ( const Standard_Integer  theDegMin,
const Standard_Integer  theDegMax 
)

Set min and max possible degree of result BSpline curve2d, which is got by approximation. If theDegMin/Max < 0, algorithm uses values that are chosen depending of types curve 3d and surface.

◆ SetMaxDist()

void ProjLib_ProjectedCurve::SetMaxDist ( const Standard_Real  theMaxDist)

Set the parameter, which degines maximal possible distance between projected curve and surface. It uses only for projecting on not analytical surfaces. If theMaxDist < 0, algorithm uses default value 100.*Tolerance. If real distance between curve and surface more then theMaxDist, algorithm stops working.

◆ SetMaxSegments()

void ProjLib_ProjectedCurve::SetMaxSegments ( const Standard_Integer  theMaxSegments)

Set the parameter, which defines maximal value of parametric intervals the projected curve can be cut for approximation. If theMaxSegments < 0, algorithm uses default value = 1000.

◆ ShallowCopy()

virtual Handle< Adaptor2d_Curve2d > ProjLib_ProjectedCurve::ShallowCopy ( ) const
overridevirtual

Shallow copy of adaptor.

Reimplemented from Adaptor2d_Curve2d.

◆ Trim()

Handle< Adaptor2d_Curve2d > ProjLib_ProjectedCurve::Trim ( const Standard_Real  First,
const Standard_Real  Last,
const Standard_Real  Tol 
) const
overridevirtual

Returns a curve equivalent of <me> between parameters <First> and <Last>. <Tol> is used to test for 3d points confusion. If <First> >= <Last>

Reimplemented from Adaptor2d_Curve2d.

◆ Value()

gp_Pnt2d ProjLib_ProjectedCurve::Value ( const Standard_Real  U) const
overridevirtual

Computes the point of parameter U on the curve.

Reimplemented from Adaptor2d_Curve2d.


The documentation for this class was generated from the following file: