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
|
/*
* $RCSfile$
*
* Copyright (c) 2006 Sun Microsystems, Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* - Redistribution of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* - Redistribution in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any
* kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
* WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
* EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
* NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
* USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
* ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
* CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
* REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
* INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or
* intended for use in the design, construction, operation or
* maintenance of any nuclear facility.
*
* $Revision$
* $Date$
* $State$
*/
/*
************************************************************************
*
* Java 3D configuration file for a single screen stereo desktop display
* using a head tracker and 6DOF mouse.
*
************************************************************************
*/
// Configure the head tracker. The NewDevice command binds a logical name
// (the 2nd argument) to an InputDevice implementation whose class name is
// specified in the 3rd argument. The InputDevice implementation for a head
// tracker must generate position and orientation data relative to a fixed
// frame of reference in the physical world, the "tracker base" of the Java
// 3D view model.
//
// The InputDevice is instantiated through introspection of the class name.
// Available InputDevice implementations are site-specific, so substitute
// the class name in a NewDevice command below with one that is available at
// the local site.
//
// Note that properties are used to configure an InputDevice instead of
// attributes. The details of an InputDevice implementation are not known to
// ConfiguredUniverse, so the property name is invoked as a method through
// introspection. The example properties below must be replaced with the ones
// needed, if any, by specific InputDevice implementations.
//
// All property arguments following the method name are wrapped and passed to
// the specified method as an array of Objects. Strings "true" and "false"
// get wrapped into Boolean, and number strings get wrapped into Double.
// Construct such as (0.0 1.0 2.0) and ((0.0 1.0 2.0 0.5) (3.0 4.0 5.0 1.0)
// (6.0 7.0 8.0 0.0)) get converted to Point3d and Matrix4d respectively.
// Note that last row of a Matrix4d doesn't need to be specified; it is
// implicitly (0.0 0.0 0.0 1.0).
//
(NewDevice glasses LogitechRedBarron)
(DeviceProperty glasses SerialPort "/dev/ttya") // Unix paths need quoting.
(DeviceProperty glasses ReceiverBaseline 0.1450)
(DeviceProperty glasses ReceiverLeftLeg 0.0875)
(DeviceProperty glasses ReceiverHeight 0.0470)
(DeviceProperty glasses ReceiverTopOffset 0.0000)
// Configure an InputDevice to use for a 6 degree of freedom mouse if
// required. In some implementations the same InputDevice instance can be
// used both for head tracking and multiple peripheral sensing devices.
// This example assumes an implementation that requires multiple instances,
// one for each sensor, sharing the same physical hardware used for the
// tracker base. In either case all the sensors must generate position and
// orientation relative to the same fixed tracker base frame of reference.
//
(NewDevice wand LogitechRedBarron)
(DeviceProperty wand SerialPort "/dev/ttyb")
(DeviceProperty wand ReceiverBaseline 0.0700)
(DeviceProperty wand ReceiverLeftLeg 0.0625)
(DeviceProperty wand ReceiverHeight 0.0510)
(DeviceProperty wand ReceiverTopOffset 0.0000)
// Create logical names for the available sensors in the specified input
// devices. The last argument is the sensor's index in the input device.
//
(NewSensor head glasses 0)
(NewSensor mouse6d wand 0)
// Set the 6DOF mouse sensor hotspot in the local sensor coordinate system.
// The hotspot is simply the "active" point relative to the sensor origin
// which interacts with the virtual world, such as the point used for picking
// or grabbing an object. Its interpretation is up to the sensor behavior.
//
// It is set here to 10 centimeters from the base to allow reaching into the
// screen without bumping the device into the glass, and to prevent the device
// itself from obscuring the pointer echo.
//
(SensorAttribute mouse6d Hotspot (0.0 0.0 -0.10))
// Create a new screen object and associate it with a logical name and a
// number. This number is used as an index to retrieve the AWT GraphicsDevice
// from the array that GraphicsEnvironment.getScreenDevices() returns.
//
// NOTE: The GraphicsDevice order in the array is specific to the local
// site and display system.
//
(NewScreen center 0)
// Set the actual available image area. This measured as 0.350 meters in
// width and 0.245 meters in height for the monitor in the sample setup when
// running in stereo resolution.
//
(ScreenAttribute center PhysicalScreenWidth 0.350)
(ScreenAttribute center PhysicalScreenHeight 0.245)
(ScreenAttribute center WindowSize NoBorderFullScreen)
// Set the TrackerBaseToImagePlate transform for this screen. This transforms
// points in tracker base coordinates to image plate coordinates.
//
// For this sample setup the tracker base is leaning at 50 degrees about its
// X-axis over the top edge of the monitor. The middle of the tracker base
// (its origin) is offset by (0.175, 0.345, 0.020) from the lower left
// corner of the screen (origin of the image plate).
//
(ScreenAttribute center TrackerBaseToImagePlate
(RotateTranslate (Rotate 50.000 0.000 0.000)
(Translate 0.175 0.345 0.020)))
// Create a physical environment. This contains the available input devices,
// audio devices, and sensors, and defines the coexistence coordinate system.
//
(NewPhysicalEnvironment SampleSite)
// Register the input devices defined in this file.
//
(PhysicalEnvironmentAttribute SampleSite InputDevice glasses)
(PhysicalEnvironmentAttribute SampleSite InputDevice wand)
// Register the sensor which will drive head tracking.
//
(PhysicalEnvironmentAttribute SampleSite HeadTracker head)
// Define coexistence coordinates.
//
// Coexistence coordinates are defined relative to the tracker base to simplify
// calibration measurements, just as the tracker base is used as the common
// reference frame for the TrackerBaseToImagePlate calibration.
//
// Here the coexistence origin is set to the middle of the center screen, using
// the same basis vectors as its image plate. This will put the tracker base
// origin at (0.0 0.220 0.020) relative to the coexistence origin along its
// basis vectors.
//
(PhysicalEnvironmentAttribute SampleSite CoexistenceToTrackerBase
(TranslateRotate (Translate 0.0 -0.220 -0.020)
(Rotate -50.0 0.0 0.0)))
// Define the physical body.
//
// The head origin is halfway between the eyes, with X extending to the right,
// Y up, and positive Z extending into the skull.
//
(NewPhysicalBody SiteUser)
// Set the interpupilary distance. This sets the LeftEyePosition and
// RightEyePosition to offsets of half this distance along both directions of
// the X axis.
//
(PhysicalBodyAttribute SiteUser StereoEyeSeparation 0.066)
// Define the position and orientation of the head relative to the tracker
// mounted on the head.
//
(PhysicalBodyAttribute SiteUser HeadToHeadTracker ((1.0 0.0 0.0 0.000)
(0.0 1.0 0.0 0.020)
(0.0 0.0 1.0 0.018)))
// Create a view using the defined screens, PhysicalEnvironment, and
// PhysicalBody.
//
(NewView view0)
(ViewAttribute view0 Screen center)
(ViewAttribute view0 PhysicalEnvironment SampleSite)
(ViewAttribute view0 PhysicalBody SiteUser)
// Enable stereo viewing. Enable head tracking to get the position of the eyes
// with respect to coexistence.
//
(ViewAttribute view0 StereoEnable true)
(ViewAttribute view0 TrackingEnable True)
|
