[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference bgsdev::open3d

Title:open3d
Notice:Kits on notes 3 and 4; Documents note 223
Moderator:WRKSYS::COULTER
Created:Wed Dec 09 1992
Last Modified:Fri Jun 06 1997
Last Successful Update:Fri Jun 06 1997
Number of topics:1306
Total number of notes:5260

1266.0. "Looking for documentation" by LEMAN::NEUWEILER () Tue Mar 25 1997 08:57

    One of our customers is programming Open3D on OpenVMS Alpha. The
    documentation containted in the DOC CD's is not sufficient for him.
    He needs more information about the AUX librarys espcially the LIBAUX
    routines. Is there anay DOC available concerning this routines.? He 
    would also like to see an OpenGL reference guide, is one available?
    Thanks for any pointer to documentation that can be given to customers.
    
    Joerg
T.RTitleUserPersonal
Name
DateLines
1266.1Your customer should consider the OpenGL booksVESPER::VESPEROpenGL Alpha GeekTue Mar 25 1997 13:0965
>    One of our customers is programming Open3D on OpenVMS Alpha. The
>    documentation containted in the DOC CD's is not sufficient for him.

The documentation that we supply is intended to help people use OpenGL
on DIGITAL computer systems.

The Preface of "Using OpenGL" says:

	This guide is intended for experience programmers who are
	knowledgeable in graphics. You should be thoroughly familiar
	with OpenGL software to make full use of the product's potential.

Hmm. A little ambiguous, perhaps. The intent is that this is not a tutorial,
reference book or guide to OpenGL itself, just how to use it on our computer
systems.

Please point your customer to the red and blue books on OpenGL:

Blue Book -- 'man' pages:

	OpenGL Architecture Review Board, Renate Kempf and Chris Frazier,
	editors, _OpenGL(R)_Reference_Manual_ Second Edition, ISBN
	0-201-46140-4, Addison-Wesley Developers Press, Reading MA.

Red Book -- introduction and guide:

	Mason Woo, Jackie Neider, Tom Davis, _OpenGL(R)_Programming_Guide_
	Second Edition, ISBN 0-201-46138-2, Addison-Wesley Developers Press,
	Reading MA.

Note that both of these books are second editions and deal with OpenGL version
1.1; Digital is currently shipping version 1.0.

The man pages are also available on the world-wide web at:

	http://www.digital.com/pub/doc/opengl

These are OpenGL version 1.0 man pages.

>    He needs more information about the AUX librarys espcially the LIBAUX
>    routines. Is there anay DOC available concerning this routines.?

I strongly suggest that he look into the GLUT library rather than the
AUX library. GLUT is a much better toolkit library than AUX; I'd say
it is suitable for small to medium sized projects. AUX is barely suitable
for toy programs.

GLUT can be obtained through the web, starting at:

	http://www.sgi.com/Technology/openGL/glut.html

> He 
>    would also like to see an OpenGL reference guide, is one available?

Aside from the books mentioned earlier, the OpenGL version 1.1 specification
itself is available on the web:

	http://www.sgi.com/Technology/openGL/glspec1.1/glspec.html

The OpenGL spec is being tweaked by the ARB, and the html'ized version
is not the 'current' specification. The specification is not the easiest
document to read; you have to read between the lines in a number of areas
and there are some sections that are still a little controversial.

Andy V