mode/command

GETTING STARTED with desktop Virtual Director CAVEsimulator using Orb
See http://virdir.ncsa.uiuc.edu/virdir/raw-material/general/virdir.desk.tutorial.htm
-------------------------------------
cd to svd directory
type one of the "start" scripts to start Tully vis such as
start-g8k

svd cf/g8k.cf cf/g8k.speck   [Tully largest dataset]
svd cf/g3k.cf cf/g3k.speck   [Tully local dataset]

mode/command value,word
command comments

1 Orb Start navigation device for Orb

2. menu # keep submenus in view for # of seconds specified

3 Press button F on Orb, yellow status line should read "trans+rot(btnB)]" to fly in all directions

4 Navigate with Orb ball, familiarize yourself

5 home Go back to initial position

Note Look at yellow status line, it tells you when you are in fly mode;
Look at camera information on the VirDir white & purple menu
Look at small yellow Speck menu, it has camera and coordinate information

6 Fly to virgo cluster or jumpto it by explicitly typing absolute values

7 jumpto -4 17 -2 76 110 106 Move your navigation to Virgo Cluster

8 setjump virgo here Save current location as name virgo

9 setjump List all jump locations, you will see virgo as well as others

10 tele Toggle to turn virtual television on

11 home Go to initial position

12 time 0 Set time to ready for key frame

13 key Sets first key frame at frame 1, time 0

14 time 10 Move ahead 10 seconds

15 jump virgo Go to location named virgo from stored jump in steps 7 & 8

16 key Drop second key here, 300 frames are concatted

Note As you play, notice the yellow status lines
P:1 = path one
K:2 = you have 2 nodes
F:301 = 301 frames
T:10 = 10 count time

17 play Play the 300 frames on path one

Note As you play, notice the yellow status lines give you sequential information
P:1 = path one
F:301 = frames count
T:10 = time moves forward

18 stop Stops all play; note the status line

19 key 2 Go to the second node

20 Navigate backward from the last location, and see the path

21 vcam Turn on the virtual camera

22 play Begins to play the camera along path

Note You can see the virtual camera playing along the path as the tele shows what it sees

23 stop Stops all play; note the status line

24 key 2 Go to the second key, also called node

25 time 20 Add more time so that you can concatenate path

26 jump y Go to predetermined location at y axis, "jump y" is already set up in the configuration file.

27 key Create key and concatted 300 more frames

Note Check yellow status line, now K:3 nodes and F:601 frames

28 play Begins to play the camera along path, see tele and status

29 path 2 Go to second path (and stop playing); you will not affect path 1; you will see path one as a dark grey path; current path is white

30 home Go home position

31 Navigate backwards with the Orb ball until you see red, green, blue axis

32 Select point of interest by pressing Orb buttons D + C

Note Point of interest (poi) appears as cross hairs at the red, green and blue axis
You can move the poi by moving the Orb ball simultaneously with buttons D + C
Notice yellow status line "Center # # #" changes position as you move the poi

33 interest 0 0 0 Put poi at the center of axis with absolute values

34 time 0 return to time 0, frame 1

35 jump z Line up on blue axis using a predetermined locationdown the z axis. This jump has been set up in the configuration file.

36 Press button B on the Orb to toggle to translate only; see yellow status line.
Select B until yellow status line: " [tran only[btnB)]" which does not allow rotation

37 Translate backward using Orb ball, until you see the big picture of the data

Note If the clipping obscures part of the big picture, increase min and max

36 clip .1 1000 Change near and far clipping planes to see closer and farther into the data set. Clipping affects the depth cuing, so it is best to keep the clipping depth range at a balance with the depth of the data.

37 Check the "camera" and "navigation" feedback lines to get numbers to "square up"

38 jumpto 0 0 280 0 0 0 1 Square up your view

39 setjump viewout here Set this position to viewout

40 key Set initial key; make sure that time is 0

41 Press button B on the Orb until you have selected yellow status line " [trans+rot(btnB)]" which means that you will navigate in both translation and rotation

42 Spin around poi at constant distance by moving the Orb

Notes If you cannot spin around, press button F on the Orb
Make sure that Orb is seen in yellow status window.
Notice that the large window navigation view is spinning but not the tele window,
This is because the tele shows current key frame view
You must advance time to activate tele to show 'live' camera or navigation

43 time 10 Time advanced, and tele shows position

44 key 1 Go back to keyed position, key 1,
You will see the keyed position in the tele window but the large navigation view window did not update

45 curr Updates your large navigation view window on current key; now tele and large navigation view are identical; note yellow status line; to get out of curr mode and return to navigate mode, you must type Orb or stop.

46 time 10 Advance time again, it had returned to time 0

Note If Orb does not respond, you might be out of navigate mode or navigation is turned off. If button F does not fly, then re-type Orb. The command curr will put you into a mode that precludes flying or navigating. Type stop to get out of curr mode or type Orb to begin navigation.

47 Press button B to toggle and select rotation only (rot only)

48 record Start recording a path by dropping key frames every 3 seconds; you are rotating about the poi at a constant distance and creating a path. Keys will begin immediately after typing or voice controlling record and will be dropped until you voice control or type stop

49 stop Stops recording

50 erase 2 Erases path 2, your current path; you must be on path 2 to erase it; this erases all frames, keys, but does not reset time

51 jump viewout Return to original position at viewout and start over to record a path

52 time 0 Set time back to zero; Get ready to spin and record about the poi

53 record record new path by spinning about poi

54 key 40 Put the key frames at a number that is far beyond what you have made. This will put you at the last key frame and you can see what those key frames are by checking the yellow status line.

55 rem Remove current key frame. Since you may have recorded extra key frames at the end of this path that you don't want, then you can remove them. If you are on the last key frame, rem will remove the current key frame and move your current position to the last key frame. You can continue to remove frames at the end of a path.

56 stop stop recording

57 wdata filneame Save current path as name filename; the path will be put in svd/data/record/filename.vd

58 sys ls data/record list on disk all of the paths that are stored; any unix command can be given here, but it is sometimes useful to get a quick list of the directory where camera paths are stored.

59 path 3 Go to next path

60 rdata bigturn Read a premade path from disk

61 pmode seq Play all three paths, sequentially

62 path 4

63 rdata bigturn2 Read another premade path

Note Notice the status line indicates the number of the path that you are on current on. If you type list it will provide a short list of all nodes and frames for current path; If you type divulge you will see a long list of times, keys and frames

64 wdata all namec Write all data paths as name.path#.vd on disk for example:
namec.01.vd       for path in path 1
namec.02.vd       for path in path 2
namec.03.vd       for path in path 3
etc.

	mode/command			value,word *command*	comments
1	Orb				Start navigation device for Orb
2.	menu			#	keep submenus in view for # of seconds specified

3	Press button F on Orb, yellow status line should read "trans+rot(btnB)]" to fly in all directions
4	Navigate with Orb ball, familiarize yourself
5	home				Go back to initial position

Note			Look at yellow status line, it tells you when you are in fly mode; Look at camera information on the VirDir white & purple menu Look at small yellow Speck menu, it has camera and coordinate information
6	Fly to virgo cluster or jumpto it by explicitly typing absolute values
7	jumpto			-4 17 -2 76 110 106		Move your navigation to Virgo Cluster
8	setjump			virgo here	Save current location as name virgo
9	setjump				List all jump locations, you will see virgo as well as others
10	tele				Toggle to turn virtual television on

11	home				Go to initial position
12	time			0	Set time to ready for key frame
13	key				Sets first key frame at frame 1, time 0
14	time			10	Move ahead 10 seconds
15	jump			virgo	Go to location named virgo from stored jump in steps 7 & 8
16	key				Drop second key here, 300 frames are concatted
Note			As you play, notice the yellow status lines P:1 = path one K:2 = you have 2 nodes F:301 = 301 frames T:10 = 10 count time
17	play				Play the 300 frames on path one
Note			As you play, notice the yellow status lines give you sequential information P:1 = path one F:301 = frames count T:10 = time moves forward
18	stop				Stops all play; note the status line
19	key 2				Go to the second node
20	Navigate backward from the last location, and see the path
21	vcam				Turn on the virtual camera
22	play				Begins to play the camera along path
Note			You can see the virtual camera playing along the path as the tele shows what it sees

23	stop				Stops all play; note the status line

24	key 2				Go to the second key, also called node
25	time			20	Add more time so that you can concatenate path
26	jump			y	Go to predetermined location at y axis, "jump y" is already set up in the configuration file.
27	key				Create key and concatted 300 more frames
Note			Check yellow status line, now K:3 nodes and F:601 frames
28	play				Begins to play the camera along path, see tele and status

29	path			2	Go to second path (and stop playing); you will not affect path 1; you will see path one as a dark grey path; current path is white
30	home				Go home position
31	Navigate backwards with the Orb ball until you see red, green, blue axis
32	Select point of interest by pressing Orb buttons D + C
Note			Point of interest (poi) appears as cross hairs at the red, green and blue axis You can move the poi by moving the Orb ball simultaneously with buttons D + C Notice yellow status line "Center # # #" changes position as you move the poi
33	interest			*0 0 0*	Put poi at the center of axis with absolute values
34	time			0	return to time 0, frame 1
35	jump			z	Line up on blue axis using a predetermined locationdown the z axis. This jump has been set up in the configuration file.
36	Press button B on the Orb to toggle to translate only; see yellow status line. Select B until yellow status line: " [tran only[btnB)]" which does not allow rotation
37	Translate backward using Orb ball, until you see the big picture of the data
Note			If the clipping obscures part of the big picture, increase min and max
36	clip			.1 1000	Change near and far clipping planes to see closer and farther into the data set. Clipping affects the depth cuing, so it is best to keep the clipping depth range at a balance with the depth of the data.
37	Check the "camera" and "navigation" feedback lines to get numbers to "square up"
38	jumpto			0 0 280 0 0 0 1	Square up your view
39	setjump			viewout here	Set this position to viewout
40	key				Set initial key; make sure that time is 0
41	Press button B on the Orb until you have selected yellow status line " [trans+rot(btnB)]" which means that you will navigate in both translation and rotation

42	Spin around poi at constant distance by moving the Orb
Notes			If you cannot spin around, press button F on the Orb Make sure that Orb is seen in yellow status window. Notice that the large window navigation view is spinning but not the tele window, This is because the tele shows current key frame view You must advance time to activate tele to show 'live' camera or navigation
43	time			10	Time advanced, and tele shows position
44	key			1	Go back to keyed position, key 1, You will see the keyed position in the tele window but the large navigation view window did not update
45	curr				Updates your large navigation view window on current key; now tele and large navigation view are identical; note yellow status line; to get out of curr mode and return to navigate mode, you must type Orb or stop.
46	time			10	Advance time again, it had returned to time 0
Note			If Orb does not respond, you might be out of navigate mode or navigation is turned off. If button F does not fly, then re-type Orb. The command curr will put you into a mode that precludes flying or navigating. Type stop to get out of curr mode or type Orb to begin navigation.
47	Press button B to toggle and select rotation only (rot only)

48	record				Start recording a path by dropping key frames every 3 seconds; you are rotating about the poi at a constant distance and creating a path. Keys will begin immediately after typing or voice controlling record and will be dropped until you voice control or type stop
49	stop				Stops recording
50	erase			2	Erases path 2, your current path; you must be on path 2 to erase it; this erases all frames, keys, but does not reset time
51	jump			viewout	Return to original position at viewout and start over to record a path
52	time			0	Set time back to zero; Get ready to spin and record about the poi
53	record				record new path by spinning about poi
54	key			40	Put the key frames at a number that is far beyond what you have made. This will put you at the last key frame and you can see what those key frames are by checking the yellow status line.
55	rem				Remove current key frame. Since you may have recorded extra key frames at the end of this path that you don't want, then you can remove them. If you are on the last key frame, rem will remove the current key frame and move your current position to the last key frame. You can continue to remove frames at the end of a path.
56	stop				stop recording
57	wdata			filneame	Save current path as name filename; the path will be put in svd/data/record/filename.vd
58	sys			ls data/record	list on disk all of the paths that are stored; any unix command can be given here, but it is sometimes useful to get a quick list of the directory where camera paths are stored.

59	path			3	Go to next path
60	rdata			bigturn	Read a premade path from disk
61	pmode			seq	Play all three paths, sequentially
62	path			4
63	rdata			bigturn2	Read another premade path
Note		Notice the status line indicates the number of the path that you are on current on. If you type list it will provide a short list of all nodes and frames for current path; If you type divulge you will see a long list of times, keys and frames
64	wdata all			namec	Write all data paths as name.path#.vd on disk for example: namec.01.vd for path in path 1 namec.02.vd for path in path 2 namec.03.vd for path in path 3 etc.