OpenGL Programming For the Mac

What you need to download or have:

• An unzip program; if you don't have one, try installing ZipIt. You'll need this for starter files, etc.

• The OpenGL 1.1.2 Installer, courtesy of Apple. You can find the link to the file here; we'll use it in the steps below.

• The OpenGL SDK 1.0, found at the same site. Again, this will be used below.

• A recent version of CodeWarrior (buy it at the Stanford bookstore). These instructions were written for Codewarrior Pro 4. If you are using a more recent version, the names of buttons and screens might be slightly different, but we trust that as experienced programmers you can figure out what to do.

Installing OpenGL on a Mac

2. Run the Installer program located in that folder. When given the choice, select "Easy Install". The Installer will close all other programs and reboot your computer when it's done. You can now find various OpenGL extensions in the System Folder.

3. The other file that you downloaded, the SDK, also needs to be decompressed if it hasn't been automatically. When fully decompressed, it will be a folder called "OpenGL SDK" containing 5 subfolders (Documentation, Headers, Libraries, Resources, Source). Put this folder in a safe place, like in your CodeWarrior application directory. If you're short on disk space, you can (probably) safely kill the contents of the Source folder.

4. That's it! After creating a test project below to make sure things work okay, you can delete the original archives that you downloaded and the OpenGL Installer folder.

Creating an OpenGL/Glut project

2. From the File menu, choose "New Project".

3. You need to specify what type of project this will be. Choose MacOS -> C_C++ -> Standard Console -> Standard C Console PPC and click OK.

4. Give your project a name and location (For example, OpenGLTester) and click on OK.

5. We now need to add files from OpenGL SDK to the project so that we can use glut. Choose "Add Files" from the Project menu.

6. Find the OpenGL SDK/Libraries folder (wherever you chose to put it above) in the dialog box. Double click on it. You should then see all of the files in the folder listed (glut.lib, OpenGLLibraryStub, etc.). You don't need all of these. You need: glut.lib OpenGLLibraryStub OpenGLMemoryStub OpenGLUtilityStub.

7. For each of these four files, click on them and then click on the Add button. Then click Done.

8. Go to "Create New Group" in the Project menu. Call it "OpenGL Libraries". The new group will appear in the project window.

9. Drag and drop the files you added into this new group.

10. In addition to the Library files, we must add a resource file. The resource file describes stuff like how to create windows. Your code may compile if the resource file isn't included, but you'll never get a window to appear. Choose "Add Files" from the Project menu. Find the OpenGL SDK/Resources folder in the dialog box. Click on glut.rsrc and then click the Add button, and Done.

11. You need to increase the project's Memory Size. To do this, select "PPC Std C Console Settings" from the Edit menu.

12. Choose the "PPC Target Panel" on the left hand side.

13. Change the numbers given to: Preferred Heap: 3084 Minimum Heap: 3085 StackSize: 128. If your assignments still run out of memory, you can increase the memory allocation here.

14. Finally, you need to add the appropriate Header files. Select "Access Paths" from the choices on the left of the new window.

15. Click into the "System Paths" subwindow.

16. Click on the Add button.

17. Locate OpenGL SDK/Headers in the dialog box.

18. Double click on it.

19. Click on the "Select Headers" button (note: this button might not exist in your version of Codewarrior; just make sure that you add the Headers folder to your list of System Paths using whatever buttons are necessary)

Now your project should support OpenGL and GLUT. Use a sample file from the class website (by adding it to the project). Don't forget to remove the HelloWorld.c file from the project too.