English
资源说明：Vrui-based 3DVisualizer by Oliver Kreylos
======================================================================== README for 3D Visualizer version 1.7 Copyright (c) 2005-2009 Oliver Kreylos ======================================================================== Overview ======== 3D Visualizer is a highly interactive application for visualization and analysis of 3D multivariate gridded data, such as produced by finite element method (FEM) simulations, confocal microscopy, serial sectioning, computerized axial tomography (CAT) scans, or magnetic resonance imaging (MRI) scans. 3D Visualizer is based on the Vrui software development toolkit (see http://idav.ucdavis.edu/~okreylos/ResDev/Vrui), and runs in a variety of environments ranging from laptop or desktop computers over semi- immersive environments such as Geowalls to fully immersive virtual reality environments such as CAVEs. More information about 3D Visualizer can be found at http://www.keckcaves.org. 3D Visualizer's development was supported by the University of California, Davis, by the UC Davis W.M. Keck Center for Active Visualization in the Earth Sciences (KeckCAVES, http://www.keckcaves.org), and the W.M Keck Foundation. Requirements ============ 3D Visualizer requires Vrui version 1.0 build 063 or newer. To read images in PNG format, libpng has to be installed, and Vrui has to be configured with support for PNG images (see Vrui README file). Installation Guide ================== It is recommended to download or move the source packages for Vrui and 3D Visualizer into a src directory underneath the user's home directory. Otherwise, references to ~/src in the following instructions need to be changed. It is also recommended to skip optional steps 4 and 6 in the following instructions. 3D Visualizer does not need to be installed in order to be used; installation (to a system directory such as /usr/local) is only recommended if 3D Visualizer will be used from multiple user accounts. 0. Install Vrui from ~/src/Vrui-1.0 (see Vrui README file). 1. Change into ~/src directory and unpack the 3D Visualizer tarball: > cd ~/src > tar xfz/3DVisualizer- .tar.gz - or - > tar xf /3DVisualizer- .tar 2. Change into 3D Visualizer base directory: > cd 3DVisualizer- 3. Adapt makefile if Vrui installation path is *not* ~/Vrui-1.0 by setting the VRUIDIR variable to the correct location. VRUIDIR is *not* the directory containing Vrui's sources (and the Vrui README file), but the directory specified via the INSTALLDIR variable in Vrui's makefile. 4. Optional: Adapt makefile if 3D Visualizer is to be installed in a different location, for example /usr/local. Set INSTALLDIR to the desired target location. 3D Visualizer will be then be installed in $(INSTALLDIR)/bin, $(INSTALLDIR)/lib (or $(INSTALLDIR)/lib64 on 64-bit Linux systems), and $(INSTALLDIR)/share. Important note: Do not use ~ as a shortcut for the user's home directory here; use $(HOME) instead. For example, write INSTALLDIR = $(HOME)/apps instead of INSTALLDIR = ~/apps 5. Build 3D Visualizer: > make 6. Optional: Install 3D Visualizer in the selected target location. This is only necessary if the INSTALLDIR variable in the makefile was changed. By default, 3D Visualizer can be run from its base directory. To install: > make install - or, if the target location is a system directory - > sudo make install 7. Optional: Add directory containing the 3D Visualizer executable (~/src/3DVisualizer- /bin in the default installation, $(INSTALLDIR)/bin otherwise) to the user's search path. This allows running 3D Visualizer from any directory. Using csh or tcsh: > setenv PATH ${PATH}:~/src/3DVisualizer- /bin - or - > setenv PATH ${PATH}: /bin where is the target location set in the makefile. Using bash: > export PATH=${PATH}:~/src/3DVisualizer- /bin - or - > export PATH=${PATH}: /bin These lines can also be added to the user's .cshrc or .bashrc files to make the additions persist between logins. Running 3D Visualizer on Alaska Example Data ============================================ These instructions assume that 3D Visualizer was installed in its base directory, (see steps 4 and 6 above). 1. Change into 3D Visualizer base directory: > cd ~/src/3DVisualizer- 2. Download example data tarball AlaskaData.tar.gz. 3. Unpack example data tarball in 3D Visualizer directory: > tar xfz /AlaskaData.tar.gz - or - > tar xf /AlaskaData.tar 4. On MacOS X: Start X11. 3D Visualizer requires a running X server, but, if preferred, it can be started from a MacOS X terminal instead of xterm. 5. Run 3D Visualizer on example data: > ./bin/3DVisualizer -palette AlaskaData/slab2.pal AlaskaData/slab2.in - or (full command line) - > ./bin/3DVisualizer -palette AlaskaData/slab2.pal -class MultiCitcomtFile AlaskaData/slab2.dat Temp "log(Visc)" 6. See Vrui-1.0 documentation or 3D Visualizer's user's guide on Vrui's basic user interface and how to use 3D Visualizer.
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
