ImmersaView for Windows: Customizing the settings

How to load your own configuration settings:

If you used Immersaview previously, you would remember there was one configuration file that you had to edit to change the settings. Now there are two. One configuration file handles the settings for the window drawn by the computer and sets up two camera views; so let's call it the 'StereoCameras' file. The other is a 'scene' file and has information on what data is to be loaded, how it is centered, frame rate,etc. This has been done to support easy distribution of datasets for Immersaview.

Let's look at the 'scene' file first. In the distribution 'heart.iv' and 'Quakes.iv' are scene files. The scene files are actually Inventor files and are written in the Inventor format. You will see a bunch of nodes with names given to them

Name of the node	Description
Data	Immersaview will look for the data files in this node. List each file under this node. See Section 'Loading your own data' for details.
BindCenter	Specify how the data sets are centered ORIGIN:Each object is fixed to the center of the screen MASS :The whole group of objects have a common center hint - If you load a flipbook and the models seem to have different centers use 'ORIGIN' If the models seem to wobble around the center specify 'MASS'.
FrameRate	Specify how fast you want to interact with the data This node will be used only for interaction with the mouse FAST :A bounding box will be substituted for the data when you rotate, zoom or pan NORMAL: You will see the data while it is being manipulated. This is recommended.
TextDisplay	Specify whether you want to display the text on the screen. ON : default value OFF: turn off the text
frontLight	Specify whether you want the front lighting to be on, the intensity, color and direction of this light. Leave these values as they are if you are not familiar with these parameters.
topLight	A second light has been added to the scene. It sits along the Y axis and points downwards. You can manipulate it's attributes.

The cameras configuration file named 'StereoCameras.iv' should not need to be changed very often. Most probably you will edit the WindowSize, DisplayMode and the collabNode parts of the file. Here is a description of the different options you have:

Name of the node	Description
ViewCamera	Perspective camera parameters
CameraSeparation	Separation between the two cameras
WindowPosition	Specify the location of the top left corner of the window.
WindowSize	Specify the size of the window.
DisplayMode	MONO, STEREO or CLONE Specify MONO for single window displays. Specify STEREO for a Geowall using horizontal span. Specify CLONE for a Geowall using clone mode stereo
collabNode	Specify the server address and the server port number if you want to run a collaborative session. If you are running a stand alone version, Immersaview will attempt to connect to the server and will continue to load the data even if the connection is refused.

So if you create your own scene file(called 'scene.iv') and camera configuration file (called 'MyConfig.iv'), you can run the viewer by performing the following steps:

Change to the subdirectory of the data model that you want to view remembering that Windows uses backslashes and Mac OS and Linux uses forward slashes. If you start in the base directory of Immersaview, type: cd data/MyDataDirectory
Type the following to start immersaview:

On Windows, type: ..\..\bin\immersaview scene.iv ..\..\configFiles\StereoCameras.iv
On Linux and Mac OS (assuming that symbolic links of immersaview and StereoConfig.iv were made to every data subdirectory), type: immersaview scene.iv StereoCameras.iv

| home |