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
|
// 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_Transformation_HeaderFile
#define _Geom_Transformation_HeaderFile
#ifndef _Standard_HeaderFile
#include <Standard.hxx>
#endif
#ifndef _Standard_DefineHandle_HeaderFile
#include <Standard_DefineHandle.hxx>
#endif
#ifndef _Handle_Geom_Transformation_HeaderFile
#include <Handle_Geom_Transformation.hxx>
#endif
#ifndef _gp_Trsf_HeaderFile
#include <gp_Trsf.hxx>
#endif
#ifndef _MMgt_TShared_HeaderFile
#include <MMgt_TShared.hxx>
#endif
#ifndef _Standard_Real_HeaderFile
#include <Standard_Real.hxx>
#endif
#ifndef _Standard_Boolean_HeaderFile
#include <Standard_Boolean.hxx>
#endif
#ifndef _gp_TrsfForm_HeaderFile
#include <gp_TrsfForm.hxx>
#endif
#ifndef _Standard_Integer_HeaderFile
#include <Standard_Integer.hxx>
#endif
class Standard_ConstructionError;
class Standard_OutOfRange;
class gp_Trsf;
class gp_Pnt;
class gp_Ax1;
class gp_Ax2;
class gp_Ax3;
class gp_Vec;
//! Describes how to construct the following elementary transformations <br>
//! - translations, <br>
//! - rotations, <br>
//! - symmetries, <br>
//! - scales. <br>
//! The Transformation class can also be used to <br>
//! construct complex transformations by combining these <br>
//! elementary transformations. <br>
//! However, these transformations can never change <br>
//! the type of an object. For example, the projection <br>
//! transformation can change a circle into an ellipse, and <br>
//! therefore change the real type of the object. Such a <br>
//! transformation is forbidden in this environment and <br>
//! cannot be a Geom_Transformation. <br>
//! The transformation can be represented as follow : <br>
//! <br>
//! V1 V2 V3 T <br>
//! | a11 a12 a13 a14 | | x | | x'| <br>
//! | a21 a22 a23 a24 | | y | | y'| <br>
//! | a31 a32 a33 a34 | | z | = | z'| <br>
//! | 0 0 0 1 | | 1 | | 1 | <br>
class Geom_Transformation : public MMgt_TShared {
public:
//! Creates an identity transformation. <br>
Standard_EXPORT Geom_Transformation();
//! Creates a transient copy of T. <br>
Standard_EXPORT Geom_Transformation(const gp_Trsf& T);
//! Makes the transformation into a symmetrical transformation <br>
//! with respect to a point P. <br>
//! P is the center of the symmetry. <br>
Standard_EXPORT void SetMirror(const gp_Pnt& P) ;
//! Makes the transformation into a symmetrical transformation <br>
//! with respect to an axis A1. <br>
//! A1 is the center of the axial symmetry. <br>
Standard_EXPORT void SetMirror(const gp_Ax1& A1) ;
//! Makes the transformation into a symmetrical transformation <br>
//! with respect to a plane. The plane of the symmetry is <br>
//! defined with the axis placement A2. It is the plane <br>
//! (Location, XDirection, YDirection). <br>
Standard_EXPORT void SetMirror(const gp_Ax2& A2) ;
//! Makes the transformation into a rotation. <br>
//! A1 is the axis rotation and Ang is the angular value <br>
//! of the rotation in radians. <br>
Standard_EXPORT void SetRotation(const gp_Ax1& A1,const Standard_Real Ang) ;
//! Makes the transformation into a scale. P is the center of <br>
//! the scale and S is the scaling value. <br>
Standard_EXPORT void SetScale(const gp_Pnt& P,const Standard_Real S) ;
//! Makes a transformation allowing passage from the coordinate <br>
//! system "FromSystem1" to the coordinate system "ToSystem2". <br>
//! Example : <br>
//! In a C++ implementation : <br>
//! Real x1, y1, z1; // are the coordinates of a point in the <br>
//! // local system FromSystem1 <br>
//! Real x2, y2, z2; // are the coordinates of a point in the <br>
//! // local system ToSystem2 <br>
//! gp_Pnt P1 (x1, y1, z1) <br>
//! Geom_Transformation T; <br>
//! T.SetTransformation (FromSystem1, ToSystem2); <br>
//! gp_Pnt P2 = P1.Transformed (T); <br>
//! P2.Coord (x2, y2, z2); <br>
Standard_EXPORT void SetTransformation(const gp_Ax3& FromSystem1,const gp_Ax3& ToSystem2) ;
//! Makes the transformation allowing passage from the basic <br>
//! coordinate system <br>
//! {P(0.,0.,0.), VX (1.,0.,0.), VY (0.,1.,0.), VZ (0., 0. ,1.) } <br>
//! to the local coordinate system defined with the Ax2 ToSystem. <br>
//! Same utilisation as the previous method. FromSystem1 is <br>
//! defaulted to the absolute coordinate system. <br>
Standard_EXPORT void SetTransformation(const gp_Ax3& ToSystem) ;
//! Makes the transformation into a translation. <br>
//! V is the vector of the translation. <br>
Standard_EXPORT void SetTranslation(const gp_Vec& V) ;
//! Makes the transformation into a translation from the point <br>
//! P1 to the point P2. <br>
Standard_EXPORT void SetTranslation(const gp_Pnt& P1,const gp_Pnt& P2) ;
//! Converts the gp_Trsf transformation T into this transformation. <br>
Standard_EXPORT void SetTrsf(const gp_Trsf& T) ;
//! Checks whether this transformation is an indirect <br>
//! transformation: returns true if the determinant of the <br>
//! matrix of the vectorial part of the transformation is less than 0. <br>
Standard_EXPORT Standard_Boolean IsNegative() const;
//! Returns the nature of this transformation as a value <br>
//! of the gp_TrsfForm enumeration. <br>
Standard_EXPORT gp_TrsfForm Form() const;
//! Returns the scale value of the transformation. <br>
Standard_EXPORT Standard_Real ScaleFactor() const;
//! Returns a non transient copy of <me>. <br>
Standard_EXPORT const gp_Trsf& Trsf() const;
//! Returns the coefficients of the global matrix of tranformation. <br>
//! It is a 3 rows X 4 columns matrix. <br>
//! Raised if Row < 1 or Row > 3 or Col < 1 or Col > 4 <br>
//! Computes the reverse transformation. <br>
Standard_EXPORT Standard_Real Value(const Standard_Integer Row,const Standard_Integer Col) const;
//! Raised if the the transformation is singular. This means that <br>
//! the ScaleFactor is lower or equal to Resolution from <br>
//! package gp. <br>
Standard_EXPORT void Invert() ;
//! Raised if the the transformation is singular. This means that <br>
//! the ScaleFactor is lower or equal to Resolution from <br>
//! package gp. <br>
Standard_EXPORT Handle_Geom_Transformation Inverted() const;
//! Computes the transformation composed with Other and <me>. <br>
//! <me> * Other. <br>
//! Returns a new transformation <br>
Standard_EXPORT Handle_Geom_Transformation Multiplied(const Handle(Geom_Transformation)& Other) const;
//! Computes the transformation composed with Other and <me> . <br>
//! <me> = <me> * Other. <br>
Standard_EXPORT void Multiply(const Handle(Geom_Transformation)& Other) ;
//! Computes the following composition of transformations <br>
//! if N > 0 <me> * <me> * .......* <me>. <br>
//! if N = 0 Identity <br>
//! if N < 0 <me>.Invert() * .........* <me>.Invert() <br>
//! Raised if N < 0 and if the transformation is not inversible <br>
Standard_EXPORT void Power(const Standard_Integer N) ;
//! Raised if N < 0 and if the transformation is not inversible <br>
Standard_EXPORT Handle_Geom_Transformation Powered(const Standard_Integer N) const;
//! Computes the matrix of the transformation composed with <br>
//! <me> and Other. <me> = Other * <me> <br>
Standard_EXPORT void PreMultiply(const Handle(Geom_Transformation)& Other) ;
//! Applies the transformation <me> to the triplet {X, Y, Z}. <br>
Standard_EXPORT void Transforms(Standard_Real& X,Standard_Real& Y,Standard_Real& Z) const;
//! Creates a new object which is a copy of this transformation. <br>
Standard_EXPORT Handle_Geom_Transformation Copy() const;
DEFINE_STANDARD_RTTI(Geom_Transformation)
protected:
private:
gp_Trsf gpTrsf;
};
// other Inline functions and methods (like "C++: function call" methods)
#endif
|
