Intergraph RenderGL User Manual

Finding Intergraph on the Internet

You can find Intergraph on the Internet in the following ways:

u

On the World Wide Web, visit Intergraph Online at http://www.intergraph.com. From the
home page, go to Drivers and Updates for the latest system software or application software
updates, or to Customer Services for information on available customer services and support
options.

u

Using a File Transfer Protocol (FTP) program or Gopher program, visit ftp.intergraph.com or
gopher.intergraph.com.

u

Get information from Intergraph’s email server at [e-mail]. Put help in the
body of the message (the subject line is ignored) to get information on such subjects as
Intergraph’s online services and where to get World Wide Web browsers.

u

Participate in the Intergraph Customer Forum (ICF), a bi-directional gateway to the USENET

newsgroup comp.sys.intergraph. Anything posted to that group or sent to comp-sys-
[e-mail] is emailed to all subscribers. Incoming email messages are also

posted to the newsgroup. You can subscribe to the ICF via Intergraph Online.

Getting Telephone Support

If you experience problems with your Intergraph product, or have questions about the information in
this document, you can contact Intergraph for help.

For RenderGL 3.0 SDK support, call the RenderGL Development Team at [phone] or send
e-mail to [e-mail].

Using the Intergraph FAXLink

Use the Intergraph FAXLink to get technical support information by fax 24 hours a day, 7 days a
week. From a touch-tone phone or fax machine phone:

u

Call 1-800-240-4300 to get new user instructions, an index listing of available documents, and
an overview of the categories of available information.

u

Call 1-205-730-9000 to order the documents (up to 5 per call).

Follow the prompts provided to locate and deliver the information you need.

Using the Intergraph Bulletin Board Service

Available 24 hours a day, 7 days a week, the Intergraph Bulletin Board Service (IBBS) is an
electronic forum for Intergraph customers to exchange information with Intergraph's technical and
marketing staff, and with other Intergraph customers. You can use the IBBS to get technical
support information, documentation and training information, programs, and software updates and
fixes. The IBBS is also available for you to give suggestions, make inquiries, and report problems.

To connect to the IBBS:

1. Set your system’s communications protocol for eight (8) data bits, no parity, one (1) stop bit,
and any baud rate up to 14,400.

2. Using a modem, dial the IBBS number, 1-205-730-8786. You can dial 1-205-730-6504 if you
are using a 2,400 baud connection.

3. Mirror sites are maintained for locations outside the United States. Information on these sites
is available on Intergraph Online, Intergraph’s World Wide Web server.

4. When connected, respond to the login request by keying in your user ID. If you have not
connected before, key in new to create a user ID.

5. Follow the menus to find what you need. If you are new to computer bulletin boards, the IBBS
provides clear choices and plenty of online help. A text file that explains IBBS commands and
organization is available for you to download.

If you have trouble connecting to or using the IBBS, log a support request through the Customer
Response Center (product entry IBBS); send a fax to 1-205-730-1110, or leave a message for the
System Operator (Sysop) at 1-205-730-1413.

RenderGL 3.0 SDK

Software Developer’s Kit

December 1997
DSA085300

Warranties and Liabilities

The information and the software discussed in this document are subject to change without notice and should not
be considered commitments by Intergraph Corporation. Intergraph Corporation assumes no responsibility for any
errors in this document.

The software discussed in this document is furnished under a license and may be used or copied only in
accordance with the terms of the license. No responsibility is assumed by Intergraph for the use or reliability of
software on equipment that is not supplied by Intergraph or its affiliated companies.

All warranties given by Intergraph Corporation about equipment or software are set forth in your purchase
contract, and nothing stated in, or implied by, this document or its contents shall be considered or deemed a
modification or amendment of such warranties.

Copyright

 1997, Intergraph Corporation including this documentation, and any software and its file formats and audio­visual displays described herein; all rights reserved; may only be used pursuant to the applicable software license
agreement; contains confidential and proprietary information of Intergraph and/or other third parties which is
protected by copyright, trade secret and trademark law and may not be provided or otherwise made available
without prior written authorization.

Restricted Rights Legend

Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subdivision
(c)(1)(ii) of the rights in technical data and computer software clause at DFARS 252.227-7013.

Unpublished rights reserved under the copyright laws of the United States.
Intergraph Corporation, Huntsville AL 35894-0001

Trademarks

Intergraph and the Intergraph logo are registered trademarks of Intergraph Corporation. RenderGL™ is a
trademark of Intergraph Corporation.

Other brands and product names are trademarks of their respective owners.

RenderGL SDK

The RenderGL SDK is a software development kit for using RenderGL. RenderGL is a photo­realistic graphics library that provides a high-level application programming interface (API) which

works with OpenGL® to produce more realistic rendering (Phong shading, shadows, bump maps,
and procedural textures) at hardware speeds.

This document provides information on the installation and removal of the RenderGL SDK, as well
as a description of the SDK, system requirements, and support information. For detailed
information on each function in the RenderGL SDK, see the online Help delivered with the product.

System Requirements

The RenderGL SDK is delivered on CD-ROM and must be installed on your computer’s hard disk
(see “Installing the RenderGL SDK”). At a minimum, your computer needs the following to run
RenderGL:

u

An Intel® Pentium®, Pentium Pro® or Pentium II® processor.

u

At least 32 megabytes of RAM; 64 megabytes of RAM is recommended.

u

Windows NT® version 4.0 or higher operating system installed and running.

u

For optimal performance on OpenGL hardware, Windows NT Service Pack 3 software
installed and running.

u

Intergraph Computer Systems’ Intense 3D Pro®, RealiZm®, or RealiZm II® graphics
hardware.

Installing the RenderGL SDK

The RenderGL SDK is provided on CD-ROM and is not automatically installed. To install the SDK,
copy the library and include files from the CD-ROM to the location you require on one of your
system’s hard disk drives.

Removing the RenderGL SDK

To remove the RenderGL SDK from your system, simply select all of the related files in Explorer or
File Manager and delete them.

Using the RenderGL SDK

The DOC directory contains an online Help file (RENDERGL.HLP) for RenderGL. Refer to this Help file
for more detailed information on the API and its functions.

DOC directory also contains a SAMPLES.DOC file which explains the sample programs provided in

The
the

SAMPLES directory. Most samples are written in C, although a few are written in C++. Project

files for the samples are included for Microsoft Visual C++ version 4.2. Each sample builds on the
previous one.

BIN directory contains RENDERGL.DLL, the RenderGL run-time library. It also contains compiled

The
versions of all of the sample programs.

BINDEBUG directory contains a debug version of RENDERGL.DLL for use in debugging the API.

The
(The debug version will by default display error messages whenever an API routine is called with
invalid arguments.)

The

LIB directory contains RENDERGL.LIB, which is an MSVC++ 4.2-compiled link library

corresponding to

INCLUDE directory contains RENDERGL.H, the main include file for the RenderGL API, and

The

RGLERROR.H, an include file with full error-return codes.

IMAGES subdirectory contains some images which the sample programs use for textures.

The

RENDERGL.DLL.