OpenGL Programming Release Notes

Revision 4.0, Apr 1999
Operating System(s): IRIX 6.5
Release Status: MR

Contents

• Link to Instructor Notes
• Hardware Requirements
• Software Requirements
• Software Verification (Optional)
• Important Notes
• Bugs and Workarounds
• Bill of Materials
• Current Contact for this Course
• Delivering this Course in Different Configurations (Optional)

Hardware Requirements

Release/System	Indy	Indigo2	O2	Octane	ONYX2	Origin200	Origin2000	CHALLENGE
IRIX 5.3
IRIX 6.2		X
IRIX 6.3
IRIX 6.4
IRIX 6.5	X		X	X	X
IRIX 7.0

• NT Workstation
• Other Requirements
• IRIX
  • Should run on all platforms that support OpenGL and run IRIX 6.5. All programs have been tested under IRIX 6.5 on Onyx2, Octane, O2, and Indy.
• Windows NT
  • Should run on all PCs with Windows NT 4.0 and OpenGL hardware support.
  • Silicon Graphics 320 or 540 workstations are suggested. The course can be taught on other PCs with similar configurations, but they require graphics cards with hardware support for OpenGL, or several of the programs will run very slowly.

Return to top

Software Requirements

• Graphics Genre
• Other Requirements
• Note: This class may be taught on all IRIX, all NT, or mixed IRIX-NT. If you're only using one operating system, skip the part of the instructions that doesn't apply.
  
  
• Software setup requirements are listed below separately for IRIX and NT.

IRIX

All machines (student and instructor, except where noted) require the following software:

• IRIX 6.5 or later.
• 6.5 base software plus the Graphics Genre software (Josh Paley created this list).
• glut_dev package (version 3.6 or later). The installable images can be found at dist.engr:/sgi/hacks/glut_dev.
• Netscape version 4.0.6 or later.
• If the course is being taught in a mixed NT/IRIX environment, all IRIX systems will need Samba (version 1.9 or later).
• opengl_student, the student package, should be installed on both instructor and student machines.
  • The class software is installed in /usr/people/opengl. If an account name 'opengl' does not already exist, an account is set up in /etc/passwd with /usr/people/opengl as its home.
• opengl_instructor, the instructor package, should be installed only on the instructor machine.
  • It contains the HTML the instructor notes, datasheet, and a presentation for the course. The files will be put in /usr/people/opengl/{instructor_notes,public_html/presentation}.
  • It also contains release notes and README files, which will be put in /usr/people/opengl.
• Note: The opengl_student and opengl_instructor idbs were created using version 1.3 of inst_dev from IRIX 6.2.

Initially, everything needs to be compiled. To build everything, go to the top level and make everything by typing

% cd ~opengl
% make 

Windows NT

All machines (student and instructor, except where noted) require the following software:

• Windows NT 4.0 (Typical installation)
• Netscape Communicator version 4.04 or later, or Internet Explorer 4.0
• Visual C++ version 6.0 (Typical installation). Use the Professional Edition, which comes with multiple licenses.
• GLUT for Windows (version 3.6 or later) is needed in order to run and compile the examples and demos. GLUT for Windows can be installed from the OpenGL Developer Tools CD (April 1998 or later, available from SGI Advanced Graphics marketing) or downloaded from http://reality.sgi.com/opengl/glut3/glut3.html#windows. Follow the directions and install all three files: glut32.dll, glut32.lib, and glut.h.
• Note: Either the instructor machine should be set up as a Web server and the presentation installed in a public Web directory, or the instructor package be installed on an IRIX machine so that OutBox can be used if the students want to follow along with the presentation.

Detailed instructions follow, explaining how to set up the opengl account, install the software, and build the programs under Windows NT.

NT Account Setup

• Log in as Administrator and do the following:
  1. run Start->Programs->Administrative tools->User manager
  2. it is recommended you give the Administrator account a password if it doesn't have one:
     • double-click on Administrator to open the User Properties window
     • enter the password in the Password and Confirm Password fields
     • click OK
  3. create a new user:
     • select User->New User
     • set the Username to opengl
     • set the description to "OpenGL Programming student"
  4. set no password, and no permission to change password
     • turn on User Cannot Change Password and Password Never Expires
  5. click Groups button:
     • set the Member of panel to contain only Users
     • under no conditions add the group Guests!
     • click OK
  6. click OK to close the User Properties window

NT Software Installation

• Log in as opengl and do the following for both student and instructor machines:
  1. install Visual C++ (typical installation)
     • VC++ will restart the system as part of installation
     • leave the CD in place when the system restarts
  2. log back in as opengl
  3. install MSDN (custom installation - just VC++ docs)
  4. insert the OGL_4.0_6.5 Student CD and copy the entire opengl directory into c:\opengl
     • if you don't have the CD, you can copy the ~opengl directory from an IRIX system that has only the student package installed. First do a `make clobber' to ensure that IRIX object and executable files aren't copied onto the NT system.
• On the instructor machine only, if it is set up as a Web server, insert the OGL_4.0_6.5 Instructor CD and copy the entire presentation into a Web directory.
  • if you don't have the CD, you can copy the ~opengl/public_html/presentation directory and the release and instructor notes from an IRIX system that has the instructor package installed.

NT Environment Variables

• Environment variables are needed build from the command line under Windows NT:

  LIB=C:\Program Files\Microsoft Visual Studio\Vc98\lib
  INCLUDE=C:\Program Files\Microsoft Visual Studio\Vc98\include
  Path=%Path%;C:\Program Files\Microsoft Visual Studio\Vc98\bin;C:\Program Files\Microsoft Visual Studio\Common\MSDev98\bin
  

• The admin can set up these variables for the user, but it is not required. There is a script called setupNT.bat in the c:\opengl directory that will set up the environment for the user.

NT Setup

• Initially, everything needs to be compiled. To build everything:
  1. Open an MSDos Command Prompt (Start->Programs->Command Prompt)
  2. In the MSDos Command Prompt window, type:

       > cd c:\opengl
       > setupNT
       > nmake /f Makefile.win
     

  3. The programs will be built and nmake should finish without error.
• Note: The setupNT script must be run every time a new Command Prompt is opened before compiling.

Return to top

Software Verification

IRIX

The following is a list of tests you can use to help verify that the installation of the opengl student package was successful. For the most part, they should be performed in the order shown. If a particular test fails, you will generally need to resolve the problem before going on to the next test.

% ls -l /usr/people/opengl

% versions c_dev

% versions x_dev

% versions motif_dev

% versions gl_dev

% versions glut_dev

% su opengl
% cd /usr/people/opengl
% make clobber
% make

% cd answers
% solar14

% insight

% versions demos

% RUN_DEMOS

> cd c:\opengl
> setupNT
> nmake /f Makefile.win clean clobber
> nmake /f Makefile.win

> opengl.fnd