SGI Techpubs Library

IRIX 6.5  »  Books  »  Developer  »  
 OpenGL Optimizer Programmer's Guide: An Open API for Large-Model Visualization
(document number: 007-2852-002 / published: 1998-06-09)    table of contents  |  additional info  |  download
find in page

Appendix A. Installing OpenGL Optimizer
Prev Part VII. Appendices Next

Appendix A. Installing OpenGL Optimizer

This appendix guides you through the process of installing OpenGL Optimizer.

Installing the OpenGL Optimizer and Supporting Software on UNIX Systems

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
7.2 is preferred.

 

 

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
inventor_eoe

 

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.

Environment Variables to Set Before Compiling an Application

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.

Installing OpenGL Optimizer on NT Systems

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.

Prev Table of Contents Next
Part VII. Appendices  Appendix B. OpenGL Optimizer Sample Applications 

OpenGL Optimizer Programmer's Guide: An Open API for Large-Model Visualization
(document number: 007-2852-002 / published: 1998-06-09)    table of contents  |  additional info  |  download

    Front Matter
    About This Guide
    Part I. Getting Started
    Part II. High-Level Strategic Tools for Fast Rendering
    Part III. Specific Tools for Fast Rendering
    Part IV. Managing and Rendering Higher-Order Geometric Primitives
    Part V. Traversers, Low-Level Geometry Processing, and Multiprocessing
    Part VI. Utilities and Troubleshooting
    Part VII. Appendices
    Glossary
    Index


home/search | what's new | help