1 // Created on: 1997-05-05
2 // Created by: Joelle CHAUVET
3 // Copyright (c) 1997-1999 Matra Datavision
4 // Copyright (c) 1999-2014 OPEN CASCADE SAS
6 // This file is part of Open CASCADE Technology software library.
8 // This library is free software; you can redistribute it and/or modify it under
9 // the terms of the GNU Lesser General Public License version 2.1 as published
10 // by the Free Software Foundation, with special exception defined in the file
11 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
12 // distribution for complete text of the license and disclaimer of any warranty.
14 // Alternatively, this file may be used under the terms of Open CASCADE
15 // commercial license or contractual agreement.
17 #ifndef _GeomPlate_CurveConstraint_HeaderFile
18 #define _GeomPlate_CurveConstraint_HeaderFile
20 #include <Standard.hxx>
21 #include <Standard_Type.hxx>
23 #include <Standard_Integer.hxx>
24 #include <Standard_Boolean.hxx>
25 #include <GeomLProp_SLProps.hxx>
26 #include <Standard_Real.hxx>
27 #include <Standard_Transient.hxx>
28 class Adaptor3d_HCurveOnSurface;
29 class Adaptor3d_HCurve;
31 class Adaptor2d_HCurve2d;
33 class Standard_ConstructionError;
34 class GeomLProp_SLProps;
39 class GeomPlate_CurveConstraint;
40 DEFINE_STANDARD_HANDLE(GeomPlate_CurveConstraint, Standard_Transient)
43 //! Defines curves as constraints to be used to deform a surface.
44 class GeomPlate_CurveConstraint : public Standard_Transient
51 //! Initializes an empty curve constraint object.
52 Standard_EXPORT GeomPlate_CurveConstraint();
54 //! Create a constraint
55 //! Order is the order of the constraint. The possible values for order are -1,0,1,2.
56 //! Order i means constraints Gi
57 //! Npt is the number of points associated with the constraint.
58 //! TolDist is the maximum error to satisfy for G0 constraints
59 //! TolAng is the maximum error to satisfy for G1 constraints
60 //! TolCurv is the maximum error to satisfy for G2 constraints
61 //! These errors can be replaced by laws of criterion.
62 //! Raises ConstructionError if Order is not -1 , 0, 1, 2
63 Standard_EXPORT GeomPlate_CurveConstraint(const Handle(Adaptor3d_HCurve)& Boundary, const Standard_Integer Order, const Standard_Integer NPt = 10, const Standard_Real TolDist = 0.0001, const Standard_Real TolAng = 0.01, const Standard_Real TolCurv = 0.1);
65 //! Allows you to set the order of continuity required for
66 //! the constraints: G0, G1, and G2, controlled
67 //! respectively by G0Criterion G1Criterion and G2Criterion.
68 Standard_EXPORT void SetOrder (const Standard_Integer Order);
70 //! Returns the order of constraint, one of G0, G1 or G2.
71 Standard_EXPORT Standard_Integer Order() const;
73 //! Returns the number of points on the curve used as a
74 //! constraint. The default setting is 10. This parameter
75 //! affects computation time, which increases by the cube of
76 //! the number of points.
77 Standard_EXPORT Standard_Integer NbPoints() const;
80 //! Allows you to set the number of points on the curve
81 //! constraint. The default setting is 10. This parameter
82 //! affects computation time, which increases by the cube of
83 //! the number of points.
84 Standard_EXPORT void SetNbPoints (const Standard_Integer NewNb);
87 //! Allows you to set the G0 criterion. This is the law
88 //! defining the greatest distance allowed between the
89 //! constraint and the target surface for each point of the
90 //! constraint. If this criterion is not set, TolDist, the
91 //! distance tolerance from the constructor, is used.
92 Standard_EXPORT void SetG0Criterion (const Handle(Law_Function)& G0Crit);
95 //! Allows you to set the G1 criterion. This is the law
96 //! defining the greatest angle allowed between the
97 //! constraint and the target surface. If this criterion is not
98 //! set, TolAng, the angular tolerance from the constructor, is used.
99 //! Raises ConstructionError if the curve is not on a surface
100 Standard_EXPORT void SetG1Criterion (const Handle(Law_Function)& G1Crit);
102 Standard_EXPORT void SetG2Criterion (const Handle(Law_Function)& G2Crit);
104 //! Returns the G0 criterion at the parametric point U on
105 //! the curve. This is the greatest distance allowed between
106 //! the constraint and the target surface at U.
107 Standard_EXPORT Standard_Real G0Criterion (const Standard_Real U) const;
109 //! Returns the G1 criterion at the parametric point U on
110 //! the curve. This is the greatest angle allowed between
111 //! the constraint and the target surface at U.
112 //! Raises ConstructionError if the curve is not on a surface
113 Standard_EXPORT Standard_Real G1Criterion (const Standard_Real U) const;
115 //! Returns the G2 criterion at the parametric point U on
116 //! the curve. This is the greatest difference in curvature
117 //! allowed between the constraint and the target surface at U.
118 //! Raises ConstructionError if the curve is not on a surface
119 Standard_EXPORT Standard_Real G2Criterion (const Standard_Real U) const;
121 Standard_EXPORT Standard_Real FirstParameter() const;
123 Standard_EXPORT Standard_Real LastParameter() const;
125 Standard_EXPORT Standard_Real Length() const;
127 Standard_EXPORT GeomLProp_SLProps& LPropSurf (const Standard_Real U);
129 Standard_EXPORT void D0 (const Standard_Real U, gp_Pnt& P) const;
131 Standard_EXPORT void D1 (const Standard_Real U, gp_Pnt& P, gp_Vec& V1, gp_Vec& V2) const;
133 Standard_EXPORT void D2 (const Standard_Real U, gp_Pnt& P, gp_Vec& V1, gp_Vec& V2, gp_Vec& V3, gp_Vec& V4, gp_Vec& V5) const;
135 Standard_EXPORT Handle(Adaptor3d_HCurve) Curve3d() const;
137 //! loads a 2d curve associated the surface resulting of the constraints
138 Standard_EXPORT void SetCurve2dOnSurf (const Handle(Geom2d_Curve)& Curve2d);
140 //! Returns a 2d curve associated the surface resulting of the constraints
141 Standard_EXPORT Handle(Geom2d_Curve) Curve2dOnSurf() const;
143 //! loads a 2d curve resulting from the normal projection of
144 //! the curve on the initial surface
145 Standard_EXPORT void SetProjectedCurve (const Handle(Adaptor2d_HCurve2d)& Curve2d, const Standard_Real TolU, const Standard_Real TolV);
147 //! Returns the projected curve resulting from the normal projection of the
148 //! curve on the initial surface
149 Standard_EXPORT Handle(Adaptor2d_HCurve2d) ProjectedCurve() const;
154 DEFINE_STANDARD_RTTIEXT(GeomPlate_CurveConstraint,Standard_Transient)
159 Handle(Adaptor3d_HCurveOnSurface) myFrontiere;
160 Standard_Integer myNbPoints;
161 Standard_Integer myOrder;
162 Handle(Adaptor3d_HCurve) my3dCurve;
163 Standard_Integer myTang;
164 Handle(Geom2d_Curve) my2dCurve;
165 Handle(Adaptor2d_HCurve2d) myHCurve2d;
166 Handle(Law_Function) myG0Crit;
167 Handle(Law_Function) myG1Crit;
168 Handle(Law_Function) myG2Crit;
169 Standard_Boolean myConstG0;
170 Standard_Boolean myConstG1;
171 Standard_Boolean myConstG2;
172 GeomLProp_SLProps myLProp;
173 Standard_Real myTolDist;
174 Standard_Real myTolAng;
175 Standard_Real myTolCurv;
176 Standard_Real myTolU;
177 Standard_Real myTolV;
193 #endif // _GeomPlate_CurveConstraint_HeaderFile