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:

[legend]

Public Member Functions
	ProjLib_ProjectedCurve ()
	Empty constructor, it only sets some initial values for class fields.

	ProjLib_ProjectedCurve (const Handle< Adaptor3d_Surface > &S)
	Constructor with initialisation field mySurface.

	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 (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,.

virtual Handle< Adaptor2d_Curve2d >	ShallowCopy () const override
	Shallow copy of adaptor.

void	Load (const Standard_Real Tolerance)
	Changes the tolerance used to project the curve on the surface.

void	Load (const Handle< Adaptor3d_Surface > &S)
	Changes the Surface.

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(...)

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.

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.

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;.

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.

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.

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 ~~. And returns the number of intervals.~~

void	Intervals (TColStd_Array1OfReal &T, const GeomAbs_Shape S) const override
	Stores in <T> the parameters bounding the intervals of continuity .

Handle< Adaptor2d_Curve2d >	Trim (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>

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.

void	D0 (const Standard_Real U, gp_Pnt2d &P) const override
	Computes the point of parameter U on the curve.

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.

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.

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.

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.

Standard_Real	Resolution (const Standard_Real R3d) const override
	Returns the parametric resolution corresponding to the real space resolution <R3d>.

GeomAbs_CurveType	GetType () const override
	Returns the type of the curve in the current interval : Line, Circle, Ellipse, Hyperbola, Parabola, BezierCurve, BSplineCurve, OtherCurve.

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_BezierCurve >	Bezier () 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.

Handle< Geom2d_BSplineCurve >	BSpline () 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.

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.

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.

virtual	~Standard_Transient ()
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

Standard_Boolean	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName.

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.

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.

Standard_Transient *	This () 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.

Standard_Integer	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object.

Standard_Integer	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value.

virtual void	Delete () const
	Memory deallocator for transient classes.

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object.

Static Public Member Functions inherited from Standard_Transient
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

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 .

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 Handle< Adaptor3d_Surface > & S )

Changes the Surface.

◆ Load() [2/2]

void ProjLib_ProjectedCurve::Load ( const Standard_Real Tolerance )

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

◆ NbIntervals()

Standard_Integer ProjLib_ProjectedCurve::NbIntervals ( const GeomAbs_Shape S ) const

overridevirtual

If necessary, breaks the curve in intervals of continuity ~~. 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:

ProjLib_ProjectedCurve.hxx

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ProjLib_ProjectedCurve() [1/4]

◆ ProjLib_ProjectedCurve() [2/4]

◆ ProjLib_ProjectedCurve() [3/4]

◆ ProjLib_ProjectedCurve() [4/4]

Member Function Documentation

◆ Bezier()

◆ BSpline()

◆ Circle()

◆ Continuity()

◆ D0()

◆ D1()

◆ D2()

◆ D3()

◆ Degree()

◆ DN()

◆ Ellipse()

◆ FirstParameter()

◆ GetCurve()

◆ GetSurface()

◆ GetTolerance()

◆ GetType()

◆ Hyperbola()

◆ Intervals()

◆ IsClosed()

◆ IsPeriodic()

◆ IsRational()

◆ LastParameter()

◆ Line()

◆ Load() [1/2]

◆ Load() [2/2]

◆ NbIntervals()

◆ NbKnots()

◆ NbPoles()

◆ Parabola()

◆ Perform()

◆ Period()

◆ Resolution()

◆ SetBndPnt()

◆ SetDegree()

◆ SetMaxDist()

◆ SetMaxSegments()

◆ ShallowCopy()

◆ Trim()

◆ Value()