TeraRecon, Inc. Real Time Visualization June-19-2001 ======================= This document provides the information needed to install the VolumePro V2.10 software on to a IRIX 6.5.x system. You must be "root" to install the software. The name of the package is vpro_sgi.tar SYSTEM REQUIREMENTS ==================== The following are the Irix system minimum hardware and software requirements: * SGI Silicon Graphics O2 visual workstation. * IRIX v.6.5.4 or later * CC V7.3 and cc V7.3 or later * Minimum of 256Mb RAM memory * Minimum of 10 Mb free disk space to install the VolumePro 500 software NOTE: This release of the VolumePro software has only been tested on the R12000 CPU. CHANGES IN THIS SOFTWARE ======================== 1. New settings for SW. (See SETTINGS below.) 2. Fixed bugs listed at the end of this document. 3. Threaded, and 7th point features are added. (See NEW FEATURES below.) INSTALLING THE VOLUMEPRO 500 BOARD =================================== If VOLUMEPRO 500 board is externally powered, then turn the system power off and install the VolumePro board directly into the PCI slot. If VOLUMEPRO 500 board is internally powered follow these instructions. The PCI slot in the O2 workstation provides 10 watts of power. The VolumePro board requires a maximum of 34 watts. Therefore, DO NOT INSTALL the VolumePro board directly into the O2 PCI slot. This may result in damage to the VolumePro board and/or to the O2 workstation. Installing the VolumePro directly into the O2 voids all warranties. The VolumePro board must instead be installed in a PCI expansion chassis. The specific model that we support is: SBS Technologies, Inc. Model 2134 PCI 4-Slot Micro ATX Mini-Tower Expansion Unit Install the VolumePro board and the expansion chassis in the following order, using the installation instructions accompanying the expansion chassis: 1. Install the SBS 2134 Expansion Unit PCI bridge card into the PCI slot in the O2 workstation. 2. Install the VolumePro into one of the PCI slots in the Expansion Unit. 3. Make sure that the VolumePro board I/O plate is fastened securely to the PCI expansion chassis with a screw. 4. Power up the Expansion Unit and verify that the fan for the Expansion Unit and the fan for the VolumePro are working. 5. Boot up the O2 workstation. INSTALLING VOLUMEPRO SOFTWARE =============================== 1. If a previous version of the VolumePro software is installed, please remove it from the system with the following commands: >inst remove VolumePro go quit 2. Copy the distribution package vpro_sgi.tar from CD into a directory, then unpack the distribution with the following command: tar xvf vpro_sgi.tar 3. Install the package using the following command > inst -f VolumePro go quit After installation, the following files are added to the system /usr/lib32/libvli.so.2.0 /usr/lib32/libvli.so (a link to libvli.so.2.0) /usr/include/vli.h /var/sysgen/master.d/vg500 /var/sysgen/boot/vg500.o /var/sysgen/system/vg500.sm /var/bin/loadVG /usr/bin/vg500_control /usr/doc/VolumePro/*pdf /usr/doc/volumePro/test/{Makefile, sanity.cpp, sanity_c.c} /usr/man/man5/vli.man 4. Load the driver by entering the following commands: rehash loadVG There should be a message stating the driver is loaded. 5. Compile and run the sanity program sanity.cpp and sanity_c.c using a sample makefile. The makefile, sanity.cpp and sample datasets are located in the following directory: /usr/doc/VolumePro/test 6. On the VolumePro CD, Unix_SDK/test.tar.gz contains more test/sample code. REMOVING VOLUMEPRO SOFTWARE ============================== 1. If the VolumePro driver is loaded, unload the driver first with the following command: > loadVG clean 2. Then remove the software with the following commands: > inst remove VolumePro go quit SETTINGS ========== 1. Change Max Angle Deviation settings in csh setenv DEFAULT_MAX_ANGLE_BEHAVIOUR 1 If the value is greater than 1, VLI will adjust the value of the angle to avoid the Max Angle Deviation. (VLI 1.2 behavior) If the value is 0, VLI will return kVLIErrMaxAngleDeviation error. (VLI 2.0 behavior) 2. Set True size False = 0 (Performance get faster, VLI 1.2 behavior): setenv VLItrue_size=0 (for csh and tcsh) set VLItrue_size=0 (for sh and bash) This setting allows VLI to skip rendering small and very small sub-volumes of a large volume when rendering. When the large volume is split into sub-volumes for rendering, sub-volumes with one or more dimensions less than 32 voxels will be skipped. For example, a 512x512x512 volume will be rendered as eight 256x256x256 sub-volumes, with subvolumes with sizes of 256x256x6, 256x6x6 and 6x6x6 skipped. (This curious arithmetic is caused by the requirement of a three voxel overlap when splitting a volume into sub-volumes.) Set true size to True = 1 (Default setting, VLI 2.0 behavior): setenv VLItrue_size=1 (for csh and tcsh) set VLItrue_size=1 (for sh and bash) This setting asks VLI to render the full size of the volume, even when this requires rendering a number of small and very small sub-volumes. VLItrue_size only makes a difference when one or more dimensions of the volume are greater than 509. LIST OF THE FIXED BUGS ======================= 1. Opacity issue Opacity correction for Super sampling is fixed. 2. Lighting did not follow the volume rotation with Emissive 0. Lighting direction is now corrected to follow the camera. 3. Memory leak issues The Memory leaks in VLI are corrected. 4. Max Angle Behavior on and off switch. The switch to select either display next possible lender angle or return error. 5. VLItrue_size on and off swith. Now you can set VLItrue size values. (See SETTINGS above) 6. Large Volume Load Software changed to load volume over 512x512x512~. 7. Performance improvement. NEW FEATURES ============ 1. VLIThreaded control (see Threaded_Render.txt in CD\Docs or our web site). 2. 7th point feature (see 7th_point.txt in CD\Docs). KNOWN ISSUES / LIMITATIONS =========================== 1. User Guide / documentation is not updated with the latest version.