About This Guide

Cosmo 3D is a new toolkit that brings 3D graphics programming to desktop applications. Cosmo 3D is a scene graph API; its concepts are new, but similar to concepts developed in Open Inventor, Performer, and OpenGL.

This guide shows you how to develop Cosmo 3D applications. Included are descriptions of Cosmo 3D applications that you can run on your workstation, as well as code examples that you can use as a guide when developing your Cosmo 3D applications.

This guide presents the developer's view of the Cosmo 3D's C++ library with C++ examples.

What This Guide Contains

This guide presents information about Cosmo 3D in a task-oriented manner: the topics in this guide are arranged to coincide with the order in which you need to refer to them while writing a Cosmo 3D application. To illustrate the use of Cosmo 3D, code examples are sprinkled throughout the guide. Additional sample source code is provided in the /usr/share/optimizer/cosmo1.1/cosmo/test/C++ directory.

Brief descriptions of the chapters in this guide follow:

These chapters and appendices are followed by an index.

Related Reading

Reference pages for Cosmo 3D are obtained by pointing your web browser at:

  • For IRIX: /usr/share/Optimizer/doc/developer

  • For Windows: <inst_dir>/doc/developer

Where inst_dir is the directory where Optimizer was installed. The default installation location is <system_drive>:/Progral Files/Silicon Graphics/Optimizer.

Who Should Read This Guide

This guide is written for developers of OpenGL Optimizer applications. Developers use Cosmo 3D scene graph nodes and actions to develop OpenGL Optimizer applications.

What You Should Know Before Reading This Guide

This guide is written with the assumption that the reader is experienced with C++.

Suggestions for Further Reading

For information on Open Inventor, see the following:

  • Wernecke, Josie, The Inventor Mentor. Reading, Mass.:Addison Wesley 1994

  • Wernecke, Josie, The Inventor Toolmaker. Reading, Mass.:Addison Wesley 1994

  • Open Inventor Architecture Group, Open Inventor C++ Reference Manual. Reading, Mass.:Addison Wesley 1994

  • OpenGL Architecture Review Board, M. Woo, J. Neider, and Tom Davis, OpenGL Programming Guide, Second Edition, 1997. (Also known as “the Red book.”)

For information on OpenGL Optimizer; see the following SGI manual:

OpenGL Optimizer Programmer's Guide: An Open API for Large-Model Visualization (document number 007-2852-002).

Style Conventions

These style conventions are used in this guide:

  • Bold—Functions, class names, node names, data members, and data types

  • Italics—Variables, filenames, spatial dimensions, and commands

  • Regular—Program names and enumerated types

Code examples are set off from the text in a fixed-space font.