1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
// This file is generated by WOK (CPPExt).
// Please do not edit this file; modify original file instead.
// The copyright and license terms as defined for the original file apply to
// this header file considered to be the "object code" form of the original source.
#ifndef _FairCurve_MinimalVariation_HeaderFile
#define _FairCurve_MinimalVariation_HeaderFile
#include <Standard.hxx>
#include <Standard_DefineAlloc.hxx>
#include <Standard_Macro.hxx>
#include <Standard_Real.hxx>
#include <FairCurve_Batten.hxx>
#include <Standard_Boolean.hxx>
#include <FairCurve_AnalysisCode.hxx>
#include <Standard_Integer.hxx>
#include <Standard_OStream.hxx>
class Standard_NegativeValue;
class Standard_NullValue;
class Standard_DomainError;
class gp_Pnt2d;
class gp_Vec2d;
//! Computes a 2D curve using an algorithm which
//! minimizes tension, sagging, and jerk energy. As in
//! FairCurve_Batten, two reference points are used.
//! Unlike that class, FairCurve_MinimalVariation
//! requires curvature settings at the first and second
//! reference points. These are defined by the rays of
//! curvature desired at each point.
class FairCurve_MinimalVariation : public FairCurve_Batten
{
public:
DEFINE_STANDARD_ALLOC
//! Constructs the two contact points P1 and P2 and the geometrical
//! characteristics of the batten (elastic beam)
//! These include the real number values for height of
//! deformation Height, slope value Slope, and kind of
//! energy PhysicalRatio. The kinds of energy include:
//! - Jerk (0)
//! - Sagging (1).
//! Note that the default setting for Physical Ration is in FairCurve_Batten
//! Other parameters are initialized as follow :
//! - FreeSliding = False
//! - ConstraintOrder1 = 1
//! - ConstraintOrder2 = 1
//! - Angle1 = 0
//! - Angle2 = 0
//! - Curvature1 = 0
//! - Curvature2 = 0
//! - SlidingFactor = 1
//! Warning
//! If PhysicalRatio equals 1, you cannot impose constraints on curvature.
//! Exceptions
//! NegativeValue if Height is less than or equal to 0.
//! NullValue if the distance between P1 and P2 is less
//! than or equal to the tolerance value for distance in
//! Precision::Confusion: P1.IsEqual(P2,
//! Precision::Confusion()). The function
//! gp_Pnt2d::IsEqual tests to see if this is the case.
//! Definition of the geometricals constraints
Standard_EXPORT FairCurve_MinimalVariation(const gp_Pnt2d& P1, const gp_Pnt2d& P2, const Standard_Real Heigth, const Standard_Real Slope = 0, const Standard_Real PhysicalRatio = 0);
//! Allows you to set a new constraint on curvature at the first point.
void SetCurvature1 (const Standard_Real Curvature) ;
//! Allows you to set a new constraint on curvature at the second point.
void SetCurvature2 (const Standard_Real Curvature) ;
//! Allows you to set the physical ratio Ratio.
//! The kinds of energy which you can specify include:
//! 0 is only "Jerk" Energy
//! 1 is only "Sagging" Energy like batten
//! Warning: if Ratio is 1 it is impossible to impose curvature constraints.
//! Raises DomainError if Ratio < 0 or Ratio > 1
void SetPhysicalRatio (const Standard_Real Ratio) ;
//! Computes the curve with respect to the constraints,
//! NbIterations and Tolerance. The tolerance setting
//! allows you to control the precision of computation, and
//! the maximum number of iterations allows you to set a limit on computation time.
Standard_EXPORT virtual Standard_Boolean Compute (FairCurve_AnalysisCode& ACode, const Standard_Integer NbIterations = 50, const Standard_Real Tolerance = 1.0e-3) ;
//! Returns the first established curvature.
Standard_Real GetCurvature1() const;
//! Returns the second established curvature.
Standard_Real GetCurvature2() const;
//! Returns the physical ratio, or kind of energy.
Standard_Real GetPhysicalRatio() const;
//! Prints on the stream o information on the current state
//! of the object.
//! Is used to redefine the operator <<.
Standard_EXPORT virtual void Dump (Standard_OStream& o) const;
protected:
private:
//! compute the curve with respect of the delta-constraints.
Standard_EXPORT Standard_Boolean Compute (const gp_Vec2d& DeltaP1, const gp_Vec2d& DeltaP2, const Standard_Real DeltaAngle1, const Standard_Real DeltaAngle2, const Standard_Real DeltaCurvature1, const Standard_Real DeltaCurvature2, FairCurve_AnalysisCode& ACode, const Standard_Integer NbIterations, const Standard_Real Tolerance) ;
Standard_Real OldCurvature1;
Standard_Real OldCurvature2;
Standard_Real OldPhysicalRatio;
Standard_Real NewCurvature1;
Standard_Real NewCurvature2;
Standard_Real NewPhysicalRatio;
};
#include <FairCurve_MinimalVariation.lxx>
#endif // _FairCurve_MinimalVariation_HeaderFile
|
