source: Swollen/INSTALL @ 1978

Last change on this file since 1978 was 1978, checked in by ole, 18 years ago

Whacked in blurb about environment variable

File size: 2.8 KB
Line 
1
2
3BUILDING FROM SOURCE
4
51) The pyVolution Visualizer has several dependencies.
6
7   OpenThreads, Producer, OpenSceneGraph:
8            - http://openscenegraph.sourceforge.net
9            - available as a bundle, OSG_OP_OT-0.9.8, that contains
10              OpenThreads, (Open)Producer and OpenSceneGraph as
11              subdirectories. 
12            - OpenSceneGraph has 3rd party dependencies, these are
13              available as a downloadable .zip for Windows.  Extracted
14              .zip directory (3rdParty) lives alongside other three
15              subdirectories.
16            - Build "release" versions in above order
17            - ensure you can run the examples that come with OSG
18              prior to building the viewer (these live in the
19              OpenSceneGraph/bin directory on Windows).
20
21   NetCDF   - a self-describing binary file format I/O library
22            - http://my.unidata.ucar.edu/content/software/netcdf/index.html
23            - require the header file netcdf.h and the library proper to
24              link against
25
26   cppUnit  - a unit testing framework for C++
27            - http://cppunit.sourceforge.net
28            - this is optional
29
30
312) Set environment variables:
32
33   OSG_ROOT :  root of your OpenSceneGraph installation
34               conforming to following layout
35
36               OSG_ROOT
37                 /OpenThreads
38                    /lib
39                       /win32 (for VisualStudio builds)
40                    /include
41                 /Producer
42                    /lib
43                    /include
44                 /OpenSceneGraph
45                    /lib
46                    /include
47                 /3rdParty (Windows only)
48
49   NETCDF_DIR :  root of NetCDF binary package with needed subdirs
50                 /lib and /include
51
52   CPPUNIT :  root of c++ unit testing framework with needed subdirs
53              /lib and /include (optional)
54
55
563) Compilation
57
58
59   WINDOWS
60
61      (i) Within VisualStudio, Open the solution in Swollen visualstudio subdirectory
62     (ii) Open Menu Tools|Options|Projects|VC++Directories and add a
63          path to $(NETCDF_DIR)/bin and $(OSG_ROOT)/bin.
64     (iii) Build the solution
65
66
67   Mac OSX
68
69          Run make in top-level OSG_ROOT directory.
70
71
72   Linux
73
74          Makefiles not yet written
75
76
77
784) The binary swollen (swollen.exe on Windows) lives in the distribution's
79   bin directory.  Test the build with any of the sample datasets in the
80   distribution's data subdirectory, e.g.,
81         "cd bin; ./swollen ../data/laminar.sww"
82         
83
84=========================================               
85RUNNING SWOLLEN
86
87Fix for swollen not locating sky and water texture images when binary found using PATH environment variable. The fix is to set an environment variable SWOLLEN_BINDIR pointing to your distro directory. This is not an optimal approach … but it works.
88
89         
90
91
92
Note: See TracBrowser for help on using the repository browser.