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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
|
// 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 _Geom_ToroidalSurface_HeaderFile
#define _Geom_ToroidalSurface_HeaderFile
#ifndef _Standard_HeaderFile
#include <Standard.hxx>
#endif
#ifndef _Standard_DefineHandle_HeaderFile
#include <Standard_DefineHandle.hxx>
#endif
#ifndef _Handle_Geom_ToroidalSurface_HeaderFile
#include <Handle_Geom_ToroidalSurface.hxx>
#endif
#ifndef _Standard_Real_HeaderFile
#include <Standard_Real.hxx>
#endif
#ifndef _Geom_ElementarySurface_HeaderFile
#include <Geom_ElementarySurface.hxx>
#endif
#ifndef _Standard_Boolean_HeaderFile
#include <Standard_Boolean.hxx>
#endif
#ifndef _Handle_Geom_Curve_HeaderFile
#include <Handle_Geom_Curve.hxx>
#endif
#ifndef _Standard_Integer_HeaderFile
#include <Standard_Integer.hxx>
#endif
#ifndef _Handle_Geom_Geometry_HeaderFile
#include <Handle_Geom_Geometry.hxx>
#endif
class Standard_ConstructionError;
class Standard_DimensionError;
class Standard_RangeError;
class gp_Ax3;
class gp_Torus;
class TColStd_Array1OfReal;
class Geom_Curve;
class gp_Pnt;
class gp_Vec;
class gp_Trsf;
class Geom_Geometry;
//! Describes a torus. <br>
//! A torus is defined by its major and minor radii, and <br>
//! positioned in space with a coordinate system (a <br>
//! gp_Ax3 object) as follows: <br>
//! - The origin is the center of the torus. <br>
//! - The surface is obtained by rotating a circle around <br>
//! the "main Direction". This circle has a radius equal <br>
//! to the minor radius, and is located in the plane <br>
//! defined by the origin, "X Direction" and "main <br>
//! Direction". It is centered on the "X Axis", on its <br>
//! positive side, and positioned at a distance from the <br>
//! origin equal to the major radius. This circle is the <br>
//! "reference circle" of the torus. <br>
//! - The plane defined by the origin, the "X Direction" <br>
//! and the "Y Direction" is called the "reference plane" of the torus. <br>
//! This coordinate system is the "local coordinate <br>
//! system" of the torus. The following apply: <br>
//! - Rotation around its "main Axis", in the trigonometric <br>
//! sense given by "X Direction" and "Y Direction", <br>
//! defines the u parametric direction. <br>
//! - The "X Axis" gives the origin for the u parameter. <br>
//! - Rotation around an axis parallel to the "Y Axis" and <br>
//! passing through the center of the "reference circle" <br>
//! gives the v parameter on the "reference circle". <br>
//! - The "X Axis" gives the origin of the v parameter on <br>
//! the "reference circle". <br>
//! - The v parametric direction is oriented by the <br>
//! inverse of the "main Direction", i.e. near 0, as v <br>
//! increases, the Z coordinate decreases. (This <br>
//! implies that the "Y Direction" orients the reference <br>
//! circle only when the local coordinate system is direct.) <br>
//! - The u isoparametric curve is a circle obtained by <br>
//! rotating the "reference circle" of the torus through <br>
//! an angle u about the "main Axis". <br>
//! The parametric equation of the torus is : <br>
//! P(u, v) = O + (R + r*cos(v)) * (cos(u)*XDir + <br>
//! sin(u)*YDir ) + r*sin(v)*ZDir, where: <br>
//! - O, XDir, YDir and ZDir are respectively the <br>
//! origin, the "X Direction", the "Y Direction" and the "Z <br>
//! Direction" of the local coordinate system, <br>
//! - r and R are, respectively, the minor and major radius. <br>
//! The parametric range of the two parameters is: <br>
//! - [ 0, 2.*Pi ] for u <br>
//! - [ 0, 2.*Pi ] for v <br>
class Geom_ToroidalSurface : public Geom_ElementarySurface {
public:
//! A3 is the local coordinate system of the surface. <br>
//! The orientation of increasing V parametric value is defined <br>
//! by the rotation around the main axis (ZAxis) in the <br>
//! trigonometric sense. The parametrization of the surface in the <br>
//! U direction is defined such as the normal Vector (N = D1U ^ D1V) <br>
//! is oriented towards the "outside region" of the surface. <br>
//! Warnings : <br>
//! It is not forbidden to create a toroidal surface with <br>
//! MajorRadius = MinorRadius = 0.0 <br>
//! Raised if MinorRadius < 0.0 or if MajorRadius < 0.0 <br>
Standard_EXPORT Geom_ToroidalSurface(const gp_Ax3& A3,const Standard_Real MajorRadius,const Standard_Real MinorRadius);
//! Creates a ToroidalSurface from a non transient Torus from <br>
//! package gp. <br>
Standard_EXPORT Geom_ToroidalSurface(const gp_Torus& T);
//! Modifies this torus by changing its major radius. <br>
//! Exceptions <br>
//! Standard_ConstructionError if: <br>
//! - MajorRadius is negative, or <br>
//! - MajorRadius - r is less than or equal to <br>
//! gp::Resolution(), where r is the minor radius of this torus. <br>
Standard_EXPORT void SetMajorRadius(const Standard_Real MajorRadius) ;
//! Modifies this torus by changing its minor radius. <br>
//! Exceptions <br>
//! Standard_ConstructionError if: <br>
//! - MinorRadius is negative, or <br>
//! - R - MinorRadius is less than or equal to <br>
//! gp::Resolution(), where R is the major radius of this torus. <br>
Standard_EXPORT void SetMinorRadius(const Standard_Real MinorRadius) ;
//! Converts the gp_Torus torus T into this torus. <br>
Standard_EXPORT void SetTorus(const gp_Torus& T) ;
//! Returns the non transient torus with the same geometric <br>
//! properties as <me>. <br>
Standard_EXPORT gp_Torus Torus() const;
//! Return the parameter on the Ureversed surface for <br>
//! the point of parameter U on <me>. <br>
//! Return 2.PI - U. <br>
Standard_EXPORT Standard_Real UReversedParameter(const Standard_Real U) const;
//! Return the parameter on the Ureversed surface for <br>
//! the point of parameter U on <me>. <br>
//! Return 2.PI - U. <br>
Standard_EXPORT Standard_Real VReversedParameter(const Standard_Real U) const;
//! Computes the aera of the surface. <br>
Standard_EXPORT Standard_Real Area() const;
//! Returns the parametric bounds U1, U2, V1 and V2 of this torus. <br>
//! For a torus: U1 = V1 = 0 and V1 = V2 = 2*PI . <br>
Standard_EXPORT void Bounds(Standard_Real& U1,Standard_Real& U2,Standard_Real& V1,Standard_Real& V2) const;
//! Returns the coefficients of the implicit equation of the surface <br>
//! in the absolute cartesian coordinate system : <br>
//! Coef(1) * X**4 + Coef(2) * Y**4 + Coef(3) * Z**4 + <br>
//! Coef(4) * X**3 * Y + Coef(5) * X**3 * Z + Coef(6) * Y**3 * X + <br>
//! Coef(7) * Y**3 * Z + Coef(8) * Z**3 * X + Coef(9) * Z**3 * Y + <br>
//! Coef(10) * X**2 * Y**2 + Coef(11) * X**2 * Z**2 + <br>
//! Coef(12) * Y**2 * Z**2 + Coef(13) * X**3 + Coef(14) * Y**3 + <br>
//! Coef(15) * Z**3 + Coef(16) * X**2 * Y + Coef(17) * X**2 * Z + <br>
//! Coef(18) * Y**2 * X + Coef(19) * Y**2 * Z + Coef(20) * Z**2 * X + <br>
//! Coef(21) * Z**2 * Y + Coef(22) * X**2 + Coef(23) * Y**2 + <br>
//! Coef(24) * Z**2 + Coef(25) * X * Y + Coef(26) * X * Z + <br>
//! Coef(27) * Y * Z + Coef(28) * X + Coef(29) * Y + Coef(30) * Z + <br>
//! Coef(31) = 0.0 <br>//! Raised if the length of Coef is lower than 31. <br>
Standard_EXPORT void Coefficients(TColStd_Array1OfReal& Coef) const;
//! Returns the major radius, or the minor radius, of this torus. <br>
Standard_EXPORT Standard_Real MajorRadius() const;
//! Returns the major radius, or the minor radius, of this torus. <br>
Standard_EXPORT Standard_Real MinorRadius() const;
//! Computes the volume. <br>
Standard_EXPORT Standard_Real Volume() const;
//! Returns True. <br>
Standard_EXPORT Standard_Boolean IsUClosed() const;
//! Returns True. <br>
Standard_EXPORT Standard_Boolean IsVClosed() const;
//! Returns True. <br>
Standard_EXPORT Standard_Boolean IsUPeriodic() const;
//! Returns True. <br>
Standard_EXPORT Standard_Boolean IsVPeriodic() const;
//! Computes the U isoparametric curve. <br>
//! <br>
//! For a toroidal surface the UIso curve is a circle. <br>
//! The center of the Uiso circle is at the distance MajorRadius <br>
//! from the location point of the toroidal surface. <br>
//! Warnings : <br>
//! The radius of the circle can be zero if for the surface <br>
//! MinorRadius = 0.0 <br>
Standard_EXPORT Handle_Geom_Curve UIso(const Standard_Real U) const;
//! Computes the V isoparametric curve. <br>
//! <br>
//! For a ToroidalSurface the VIso curve is a circle. <br>
//! The axis of the circle is the main axis (ZAxis) of the <br>
//! toroidal surface. <br>
//! Warnings : <br>
//! The radius of the circle can be zero if for the surface <br>
//! MajorRadius = MinorRadius <br>
Standard_EXPORT Handle_Geom_Curve VIso(const Standard_Real V) const;
//! Computes the point P (U, V) on the surface. <br>
//! P (U, V) = Loc + MinorRadius * Sin (V) * Zdir + <br>
//! (MajorRadius + MinorRadius * Cos(V)) * <br>
//! (cos (U) * XDir + sin (U) * YDir) <br>
//! where Loc is the origin of the placement plane (XAxis, YAxis) <br>
//! XDir is the direction of the XAxis and YDir the direction of <br>
//! the YAxis and ZDir the direction of the ZAxis. <br>
Standard_EXPORT void D0(const Standard_Real U,const Standard_Real V,gp_Pnt& P) const;
//! Computes the current point and the first derivatives in <br>
//! the directions U and V. <br>
Standard_EXPORT void D1(const Standard_Real U,const Standard_Real V,gp_Pnt& P,gp_Vec& D1U,gp_Vec& D1V) const;
//! Computes the current point, the first and the second derivatives <br>
//! in the directions U and V. <br>
Standard_EXPORT void D2(const Standard_Real U,const Standard_Real V,gp_Pnt& P,gp_Vec& D1U,gp_Vec& D1V,gp_Vec& D2U,gp_Vec& D2V,gp_Vec& D2UV) const;
//! Computes the current point, the first,the second and the <br>
//! third derivatives in the directions U and V. <br>
Standard_EXPORT void D3(const Standard_Real U,const Standard_Real V,gp_Pnt& P,gp_Vec& D1U,gp_Vec& D1V,gp_Vec& D2U,gp_Vec& D2V,gp_Vec& D2UV,gp_Vec& D3U,gp_Vec& D3V,gp_Vec& D3UUV,gp_Vec& D3UVV) const;
//! Computes the derivative of order Nu in the direction u and <br>
//! Nv in the direction v. <br>//! Raised if Nu + Nv < 1 or Nu < 0 or Nv < 0. <br>
Standard_EXPORT gp_Vec DN(const Standard_Real U,const Standard_Real V,const Standard_Integer Nu,const Standard_Integer Nv) const;
//! Applies the transformation T to this torus. <br>
Standard_EXPORT void Transform(const gp_Trsf& T) ;
//! Creates a new object which is a copy of this torus. <br>
Standard_EXPORT Handle_Geom_Geometry Copy() const;
DEFINE_STANDARD_RTTI(Geom_ToroidalSurface)
protected:
private:
Standard_Real majorRadius;
Standard_Real minorRadius;
};
// other Inline functions and methods (like "C++: function call" methods)
#endif
|
