This appendix guides you through the process of installing OpenGL Optimizer.
The OpenGL Optimizer library can either be downloaded from the designated Web site or from the release CD. In either case, use the Software Manager (swmgr) interface to install the software.
In addition to the library, you need the software listed in Table A-1:
Table A-1. Libraries Used by OpenGL Optimizer
Software Purpose |
| Program Name |
| Program Source |
|---|---|---|---|---|
Compile and run C++ programs, use one of the three. |
| c++_dev |
| MIPSpro C++ 7.1 or 7.2 CD |
|
| c++_eoe |
| IRIX™ 6.2 part 1 of 2 or IRIX 6.3 CD |
|
| compiler_dev |
| 7.1 IDO package. The IDO package contains 3 CDs, one per IRIX platform. |
Compile programs in the developer build environment. |
| dev |
| IRIS® Developer's Option CD |
Load Inventor™ files: Inventor 2.1.1 or higher. |
| inventor_dev
and |
| IRIX 6.2 and above |
To link with the Digital Media Execution Environment. |
| dmedia_eoe |
| IRIX 6.2 and above |
For reflection mapping: Image Format Library. |
| ifl_eoe |
| Installable from Silicon SurfSM as part of the ImageVision™ Runtimes 3.1.1 |
The installation overwrites previously-installed Cosmo3D and OpenGL Optimizer libraries and sample applications. To avoid overwriting any changed files during the installation, save them in another directory.
Sample OpenGL Optimizer applications, file loaders and scene-graph viewers are in /usr/share/Optimizer/. Sample Cosmo3D applications are in /usr/share/Optimizer/src/apps/Cosmo3D. Use the commands make ddso or make dso to build these programs.
Before compiling an OpenGL Optimizer application, you should set several environment variables.
To specify which ABI to compile (o32, n32, or n64), enter this command:
setenv OBJECT_STYLE 32 or N32_M3 or 64
Note: For systems with IRIX 6.4, the compiler defaults to using n32. To force an o32 build enter this command: setenv OBJECT_STYLE 32
To designate linking with single or double-precision OpenGL Optimizer libraries, edit the `OP_SINGLE' value set in /usr/share/Optimizer/src/opusercommondefs.
To run-time load the debugging versions of the libraries, enter one of these commands:
setenv LD_LIBRARY_PATH /usr/lib/Optimizer/Debug:/usr/lib/Cosmo3D/Debug setenv LD_LIBRARYN32_PATH /usr/lib32/Optimizer/Debug:/usr/lib32/Cosmo3D/Debug setenv LD_LIBRARY_PATH64 /usr/lib64/Optimizer/Debug:/usr/lib64/Cosmo3D/Debug
Note: For performance, do not set LD_LIBRARY_PATH to the /usr/lib/{Optimizer,Cosmo3D}/Debug directories. If you see a compile-time warning that mentions incompatible versions for libifl.so (sgi1.0), and your application does not use reflection mapping, you can enter this command
setenv _RLD_ARGS -ignore_all_versions
This error occurs if you have a more recent version of libifl.so that ships with IRIX 6.3 or 6.4: Image Vision Runtimes 3.1.1.
You can avoid the error message by installing the IRIX 6.2 libifl.so into a different directory than /usr/lib and set your LD_LIBRARY_PATH to point to that directory first. For example, if you install libifl.so in /usr/tmp/ifllib, enter the following command:
setenv LD_LIBRARY_PATH /usr/tmp/ifllib:/usr/lib
For further details, see “Compiler Warning Messages” and the file /usr/share/Optimizer/doc/Programming_tips/Compile_Notes.html.
To install OpenGL Optimizer on an NT Systems, insert the CD-ROM in the drive, the choose Start > Run and type at the prompt:
Drive:Optimizer_1.1_PC.exe |
where Drive is the name of your CD-ROM drive. InstallShield will then install the software in the appropriate location.
To build any of the sample applications, type
nmake appname |
The makefile provided with OpenGL Optimizer will then compile your program with the appropriate flags.