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
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
|
--
-- File: Visual3d_ViewMapping.cdl
-- Created: Mercredi 12 Juin 1991
-- Author: NW,JPB,CAL
--
---Copyright: MatraDatavision 1991,1992,1993
--
class ViewMapping from Visual3d
---Version:
---Purpose: This class allows the definition of a projection and
-- a system of coordinates called NPC.
-- (Normalized Projection Coordinates).
-- The projection can be parallel or perspective.
-- References: The definitions are Phigs oriented.
-- Keywords: View, Mapping, Window, View Plane, Front Plane,
-- BackPlane, Projection Type, Reset, Projection
-- Summary of 3D View Mapping --
-- The view mapping transformation defines the --
-- window-to-viewport mapping of View Reference --
-- Coordinates (VRC) to Normalized Projection --
-- Coordinates (NPC). --
-- CAS.CADE supports two kinds of projection : --
-- Parallel : --
-- The Projection Reference Point (PRP) --
-- determines the direction of projection. --
-- Perspective : --
-- The projector lines converge at the --
-- Projection Reference Point (PRP). --
-- To define a view mapping transformation you --
-- must define : --
-- The Projection Type --
-- The Projection Reference Point (PRP) --
-- The Distance from Back Plane (BPD) --
-- The Distance from Front Plane (FPD) --
-- The Distance from View Plane (VPD) --
-- The Window in the View Plane. --
uses
Vertex from Graphic3d,
HArray2OfReal from TColStd,
TypeOfProjection from Visual3d
raises
ViewMappingDefinitionError from Visual3d
is
Create
returns ViewMapping from Visual3d;
---Level: Public
---Purpose: Creates a projection.
--
-- TypeOfProjection = TOP_PARALLEL
-- PRP : Projection Reference Point= (0.5, 0.5, 2.0)
-- BPD : Distance from Back Plane = 0.0
-- FPD : Distance from Front Plane = 1.0
-- VPD : Distance from View Plane = 1.0
-- WUmin = 0.0
-- WUmax = 1.0
-- WVmin = 0.0
-- WVmax = 1.0
Create ( AType : TypeOfProjection from Visual3d;
PRP : Vertex from Graphic3d;
BPD, FPD, VPD : Real from Standard;
WUmin,WVmin : Real from Standard;
WUmax,WVmax : Real from Standard )
returns ViewMapping from Visual3d
---Level: Public
---Purpose: Creates a projection.
--
-- TypeOfProjection : TOP_PERSPECTIVE
-- TOP_PARALLEL
-- PRP : Projection Reference Point with respect to
-- coordinate system VRC, defined by the
-- class ViewOrientation.
-- BPD : Distance from Back Plane.
-- FPD : Distance from Front Plane.
-- VPD : Distance from View Plane.
-- These three values are with respect to VRP, according to
-- the N axis of the VRC coordinate system, defined by the class
-- ViewOrientation.
-- WUmin,WUmax,WVmin,WVmax : Visible part of the plane of
-- projection defined with respect to the UV axes of coordinate
-- system VRC.
-- That's what allows modification of the zoom/panning.
-- The mapping of the visible part of the plane of projection
-- on the screen is done in the window.
-- That's why multiple views on the same window is not allowed.
-- Warning: Raises ViewMappingDefinitionError
-- if the specified window is invalid.
-- if <PRP> is between the front and back planes.
-- if <PRP> is positioned on the view plane.
-- if the back plane is in front of the front plane.
raises ViewMappingDefinitionError from Visual3d;
---------------------------------------------------
-- Category: Methods to modify the class definition
---------------------------------------------------
SetBackPlaneDistance ( me : in out;
BPD : Real from Standard )
---Level: Public
---Purpose: Modifies the back clipping plane.
-- Category: Methods to modify the class definition
-- Warning: Raises ViewMappingDefinitionError
-- if <PRP> is between the front and back planes.
-- if <PRP> is positioned on the view plane.
-- if the back plane is in front of the front plane.
raises ViewMappingDefinitionError from Visual3d is static;
SetFrontPlaneDistance ( me : in out;
FPD : Real from Standard )
---Level: Public
---Purpose: Modifies the front clipping plane.
-- Category: Methods to modify the class definition
-- Warning: Raises ViewMappingDefinitionError
-- if <PRP> is between the front and back planes.
-- if <PRP> is positioned on the view plane.
-- if the back plane is in front of the front plane.
raises ViewMappingDefinitionError from Visual3d is static;
SetProjection ( me : in out;
AType : TypeOfProjection from Visual3d )
is static;
---Level: Public
---Purpose: Modifies the type of projection.
--
-- TypeOfProjection : TOP_PERSPECTIVE
-- TOP_PARALLEL
--
---Category: Methods to modify the class definition
SetProjectionReferencePoint ( me : in out;
PRP : Vertex from Graphic3d )
---Level: Public
---Purpose: Modifies the PRP.
-- Category: Methods to modify the class definition
-- Warning: Raises ViewMappingDefinitionError
-- if <PRP> is between the front and back planes.
-- if <PRP> is positioned on the view plane.
raises ViewMappingDefinitionError from Visual3d is static;
SetViewPlaneDistance ( me : in out;
VPD : Real from Standard )
---Level: Public
---Purpose: Modifies the distance of the view plane of projection.
-- Category: Methods to modify the class definition
-- Warning: Raises ViewMappingDefinitionError
-- if <PRP> is positioned on the view plane.
raises ViewMappingDefinitionError from Visual3d is static;
SetWindowLimit ( me : in out;
Umin,Vmin,Umax,Vmax : Real from Standard )
---Level: Public
---Purpose: Modifies the visible part of the projection plane.
-- Category: Methods to modify the class definition
-- Warning: Raises ViewMappingDefinitionError if the
-- specified window is invalid.
raises ViewMappingDefinitionError from Visual3d is static;
SetCustomProjectionMatrix( me : in out;
Mat : HArray2OfReal from TColStd ) is static;
---Level: Public
---Purpose: Sets custom PROJECTION matrix for the OpenGl context
----------------------------
-- Category: Inquire methods
----------------------------
BackPlaneDistance ( me )
returns Real from Standard
is static;
---Level: Public
---Purpose: Returns the distance from the back clipping plane
-- of this view mapping.
---Category: Inquire methods
FrontPlaneDistance ( me )
returns Real from Standard
is static;
---Level: Public
---Purpose: Returns the distance from the front clipping plane
-- of this view mapping.
---Category: Inquire methods
Projection ( me )
returns TypeOfProjection from Visual3d
is static;
---Level: Public
---Purpose: Returns the type of projection.
---Category: Inquire methods
ProjectionReferencePoint ( me )
returns Vertex from Graphic3d
is static;
---Level: Public
---Purpose: Returns the PRP.
---Category: Inquire methods
ViewPlaneDistance ( me )
returns Real from Standard
is static;
---Level: Public
---Purpose: Returns the distance from the projection plane.
---Category: Inquire methods
WindowLimit ( me;
Umin,Vmin,Umax,Vmax : out Real from Standard )
is static;
---Level: Public
---Purpose: Returns the visible part of the projection plane.
---Category: Inquire methods
IsCustomMatrix( me )
returns Boolean from Standard
is static;
---Level: Public
---Purpose: Returns whether the custom PROJECTION matrix is used.
----------------------------
-- Category: Private methods
----------------------------
Assign ( me : in out;
Other : ViewMapping from Visual3d )
is static private;
---Level: Internal
---Purpose: Copies the content of <Other> into <me>.
---Category: Private methods
--
fields
--
-- Class : Visual3d_ViewMapping
--
-- Purpose : Declaration of variables specific to
-- the mapping of views.
--
-- Reminder : A view mapping is defined by :
-- - the reference point of projection
-- - the type of projection
-- - a distance from the Back Plane
-- - a distance from the Front Plane
-- - a distance from the Projection Plane
-- - the definition of the visible part of the
-- plane of projection
--
-- the reference point of projection
MyReferencePoint : Vertex from Graphic3d;
-- the type of projection
MyProjectionType : TypeOfProjection from Visual3d;
-- the distance from the Back Plane
MyBackPlaneDistance : Real from Standard;
-- the distance from the Front Plane
MyFrontPlaneDistance : Real from Standard;
-- the distance from the Projection Plane
MyViewPlaneDistance : Real from Standard;
-- the limits of the visible part of the plane
-- MyWindowLimits[0] = u left lower corner.
-- MyWindowLimits[1] = v left lower corner.
-- MyWindowLimits[2] = u right upper corner.
-- MyWindowLimits[3] = v right upper corner.
MyWindowLimits : Real[4];
-- the custom PROJECTION matrix to set directly to OpenGl context
MyProjectionMatrix : HArray2OfReal from TColStd;
friends
class View from Visual3d
end ViewMapping;
|
