Visualiser 4-00D Readme ======================= Welcome to the Superscape Visualiser, an application that lets you move around and interact with virtual worlds on a desktop computer. This Readme contains detailed information on the following: 1. Loading a world 2. Moving around a world 3. Adjusting the sensitivity of the keyboard 4. Changing screen resolution 5. Saving screens 6. Printing screens 7. Setting up a device 8. Troubleshooting ==================== 1. Loading a world ==================== 1. Choose Open from the File Menu. The Open VRT File dialogue box is displayed. The scroll box on the left shows the directories and files in the current directory. Superscape worlds have a .VRT file extension. 2. Go to the drive where your worlds are stored. For example, if you are loading a world from a drive which is using the letter D, click on D: in the drive list. 3. Go to the directory where your worlds are stored. Click on the .. in the file list or the Parent button to go up the directory tree one level. 4. Select a world, and choose OK. The world is loaded and displayed. ========================== 2. Moving around a world ========================== There are two ways of moving around a virtual world: 1. Using the mouse. 2. Using the keyboard. You can use either of these methods or a combination of both. When you first enter a world you are positioned at the default viewpoint and position. As you move around the world, you may find yourself disorientated; press the F12 key to return to the initial position and reset the world. 2.1 Using the mouse in Movement Mode ==================================== When you start Visualiser, the mouse is set to selection mode which lets you select items by clicking on them. To switch to movement mode, position the mouse pointer in the centre of the screen and press the space bar once. A small square (known as the home position) is displayed on the screen at the tip of the pointer, indicating that you are in movement mode. Now when you move the mouse, you move your position within the virtual world or change the viewpoint. The direction that you move and any change of viewpoint depends on whether you are moving just the mouse, or holding down the left or right mouse button at the same time. Check the following table: | Mouse only | +Left But | +Right But ______|______________|___________|___________ | | | Up | Move forwards| Rot up | Move up Down | Move back | Rot down | Move down Left | Rot left | Rot left | Move left Right | Rot right | Rot right | Move right The further you move the mouse pointer from the home position, the faster you move in the world. When the mouse pointer is over the home position, any movement stops. To switch back to selection mode, press the space bar. The home position disappears and you can use the mouse to select items again. 2.2 Using the Keyboard ====================== You can use the keyboard to navigate around a world. Pressing the keys changes the viewpoint and direction that you move as follows: O Move forwards Q Rotate left K Move backwards W Rotate right H Move left P Rotate up J Move right L Rotate down R Move up N Tilt left F Move down M Tilt right < or , zooms out of the world > or . zooms into the world Each world may have several set viewpoints onto the world, which you can go to by pressing F1 - F10. Press F11 to go to back to the last viewpoint that you selected. Press F12 to reset the world. ============================================== 3. Adjusting the sensitivity of the keyboard ============================================== You can adjust the distance that you move each time you press a key. 1. Choose Setup from the Settings menu. The Setup dialogue box is displayed. 2. Drag the Movement Step slider (or click on the slider scale) to adjust the amount you move in a linear direction. Movement Step has a range of 0-100000. 3. Drag the Angular Step slider (or click on the slider scale) to adjust the amount you move in a rotational direction. Angular Step has a range of 0-90 degrees. 4. Choose OK. =============================== 4. Changing screen resolution =============================== With some graphics cards, you can use Visualiser in several screen resolutions. These differ according to the graphics card you are using and its configuration. To change the screen resolution press SHIFT and + or SHIFT and - on the keypad to change to a higher or lower resolution if one is available. At each end, the resolution changes wrap around. For example, changing down from the lowest available resolution switches to the highest resolution. If Visualiser only runs in low resolution (320 x 200), see the Troubleshooting section below. =================== 5. Saving screens =================== You can save the currently displayed screen to disk within Visualiser by pressing CTRL+PRINT SCREEN. By default, the screen is saved to disk as a 256 colour .PCX format file in the current directory. The name of the screen file is, by default, the first five characters of the configuration file name (usually the same as the VRT file name) padded with underscores if necessary, followed by a unique three digit number, and the file extension. For example, if you start Visualiser, load the world OFFICE.VRT and take three screenshots, the files are saved as OFFIC001.PCX, OFFIC002.PCX, OFFIC003.PCX. If you take the screenshots from the file GO.VRT the files are GO___001.PCX, GO___002.PCX, GO___003.PCX. You can override the default screen file name and format by choosing Screen Filename from the File menu. The Format button in the Screen Filename dialogue box lets you select one of the following graphics formats: PCX, BMP, GIF, JPG, TGA, TIF. ===================== 6. Printing screens ===================== You can print a screen on a connected printer without saving it to disk by pressing PRINT SCREEN. If this is the first screen to be printed, the Printer dialogue box is displayed, with a list of available printer types. Follow the dialogue boxes to set up your printer and print the screen. If you want to select a different printer choose Print Setup from the File menu. ======================== 7. Setting up a device ======================== The default installation assumes that you have no devices other than the keyboard and mouse connected to Visualiser. If you have an additional device (such as a sound card), you must configure the Visualiser software before you can use it. 1. Choose Device Select from the Settings menu. The Device Select dialogue box is displayed. 2. Scroll through the list of devices until you find your device. 3. Select the check box to the left of the device name to enable it (a tick is displayed in the box when the device is enabled). 4. Click on the Setup button to the right of the device name. A device configuration dialogue box is displayed. 5. Enter the details required, and choose OK. The Device Select dialogue box is displayed again. Some devices, such as sound cards, are activated immediately. Others, such as graphics cards, are only set up when Visualiser is started; in this case you are warned that you must save your Preferences and restart Visualiser. 6. Choose Save Prefs to save the new settings, (or OK to return to the Visualiser window without saving the changes). The Save Preferences dialogue box is displayed. Choose OK. An alert box warns you that the file you are about to save (called VIS.CFG) already exists and that you are about to overwrite it. Choose OK to save the new configuration. (Choose Cancel if you do not want to save the configuration.) The new device configuration is saved in Visualiser's Preferences file. =================== 8. Troubleshooting =================== This section identifies some of the most common problems that can occur with the Visualiser software. If you have a problem running the program the first time that you use Visualiser, check first that the hardware is operating correctly and that the software is correctly installed. 8.1 Bad command or file name ============================ For Visualiser to run correctly, you should be in the directory where it was installed (but see below). 8.2 No system message data specified ==================================== If Visualiser is not run from the install directory, it will not know where to find its system files. This can be overcome by setting an environment variable in your AUTOEXEC.BAT file: SET VIS=C:\VISDEMO If, in addition, you add the install directory to the PATH in your AUTOEXEC.BAT file, you can run Visualiser from any directory. If you make these changes to your AUTOEXEC.BAT file make sure that you reboot your computer to enable the new configuration. 8.3 Visualiser runs in low resolution (320 x 200) ================================================= To run in a higher resolution, your graphics card must be VESA compatible. Most cards come with a small driver to do this. On one of the disks supplied with the graphics card there should be a file supporting this, probably a .COM or .EXE file with VESA somewhere in the name. If you cannot find a file with this name, consult the documentation included with the graphics card. The VESA driver is a small memory resident program that converts the SVGA card into a truly standard VESA SVGA. Copy this to your hard disk, following the instructions supplied with the graphics card. (It may also be necessary to copy some other files.) To test this, run the driver from the DOS prompt. You should get a short message informing you that the driver has been installed. Now run the Visualiser. If the title screen is displayed, then all is well and the VESA configuration has been recognised. To make this change permanent, add a line to your AUTOEXEC.BAT file to run the VESA driver every time you reboot. 8.4 Blank Screen ================ Some mouse drivers may cause problems with the SVGA leading to a blank screen. Try removing the mouse driver from memory (usually this means removing it from your AUTOEXEC.BAT or CONFIG.SYS file and rebooting the machine), and running Visualiser without a mouse. If this cures the problem, try using a different mouse driver. Mouse drivers are usually called MOUSE.COM, and are in a directory called MOUSE, or UTILS. 8.5 Playing sounds hangs the system =================================== The Ad Lib Gold 1000, Sound Blaster 2 and Sound Blaster 16 ASP cards all require a certain amount of processor time to process the sound data. Several other devices, most notably the mouse, work in a similar way. Some mouse drivers contain a bug which causes them to lock up when using the interrupt driven sound in this way. Try another mouse driver. 8.6 Mouse does not work ======================= First, check that the mouse is connected to the correct port , and that the mouse driver supplied is installed correctly. Instructions on how to do this are contained in the documentation that accompanies the mouse. For three button mice, a different mouse driver may be required if the third button is enabled. Check with the mouse documentation to see if this is the case. 8.7 Image trails on screen ========================== If you press the B key (accidentally), you switch off the buffer clear mode instructing Visualiser not to clear the display buffer each frame. In this case the data in the buffer is left as it is and the next frame is drawn on top of it, causing an image trail to be left on the screen. Press the B key to cycle through the available buffer clear modes. 8.8 Error screen ================ Very occasionally a combination of keystrokes and operations may highlight an unreported problem. If Visualiser is the cause, the screen is likely to contain some form of data and an error message, usually as a red, white and blue error screen. Reset your computer, load Visualiser and try the same sequence again to see if it is directly related to Visualiser's operation. If the problem does not re-occur, it may have been due to an environmental problem affecting the hardware, such as a mains spike.