Stories
Slash Boxes
Comments

News for nerds, stuff that matters

OpenGL Reference Manual v1.4

Posted by timothy on Thu May 06, 2004 01:00 PM
from the a-lotta-book dept.
Tasha Jessup writes "The fourth edition of the OpenGL Reference Manual, edited by Dave Shreiner, provides an official command reference for the OpenGL graphics library version 1.4. Published by Addison Wesley, the text is approximately 760 pages and has a suggested retail price of $59.99." Read on for the rest of Jessup's brief review to see how well it justifies that pricetag, and for whom.
OpenGL Reference Manual v1.4
author Dave Shreiner
pages 760
publisher Addison-Wesley
rating 8
reviewer Tasha Jessup
ISBN 032117383X
summary Handy desk reference

First introduced in 1992, OpenGL is an industry-standard graphical application programming interface (API) that supports 2D and 3D rendering across a host of platforms. The Architectural Review Board (ARB) governs the OpenGL API and oversees the adoption of new interface functions. Functions (or commands) within the API are usually simple and discrete. A developer calls a series of these small functions in sequence to specify rendering operations. To help utilize the library, the OpenGL Reference Manual supplies key functional documentation in a uniform manner.

The first two chapters provide an introduction to OpenGL, and an overview of the OpenGL architecture. The provided information is largely for reference rather than instruction. Generally, it is assumed the reader has a working knowledge of the pipeline already. The third and fourth chapters list different groupings of the functional commands to provide the reader with several methods to index and reference functions. The third chapter details all each official OpenGL command categorized by functionality. The fourth chapter lists the various OpenGL constants that are compatible with each command.

Beginning with the fifth chapter, 160 official OpenGL commands are described. Listed alphabetically, every command has the following sections: Name, Function Prototype, Parameters, Description, Notes, Errors, See Also, and (sometimes when appropriate) Associated Gets. The coverage of each command spans an average of 3 pages.

The last two chapters describe fifty-two of the OpenGL Utility Library (GLU) and thirty-five OpenGL X-Windows extension commands. The reference format is identical but slightly shorter (averaging about 2 pages per command).

Overall, the organization and consistency is excellent. Often, material is duplicated per command to save the reader cross-referencing other sections of the book. Throughout the text, the wording is clear and unambiguous (if a bit dry) -- exactly what you'd expect from a reference book of this nature.

The book does have a few shortcomings, however. There is only a small trace of sample source code. While the commands are presented alphabetically by class, the book contained no overall index. OpenGL Extensions (pixel and vertex shader commands, etc.) are not provided since they're not officially part of the Standard. Finally, having an electronic version of the text would have been a nice touch -- especially one that integrated with the common development environments to provide context sensitive help or electronic searching.

Overall, the latest edition of the OpenGL Reference Manual is a great companion for OpenGL developers. To get the most from this book, readers unfamiliar or interested in learning the API should first read the OpenGL Programming Guide, 4th Edition (ISBN 0-3-211-73491) also published by Addison Wesley.


You can purchase the OpenGL Reference Manual v1.4 from bn.com. Slashdot welcomes readers' book reviews -- to see your own review here, carefully read the book review guidelines, then visit the submission page.

This discussion has been archived. No new comments can be posted.
Display Options Threshold:
The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
  • Learning OGL? (Score:5, Interesting)

    by Shadowlion (18254) <cdc@gis.net> on Thursday May 06 2004, @01:05PM (#9075600)
    (http://slashdot.org/)
    Can anybody recommend some good books on learning OpenGL?
  • NeHe's tutorials... (Score:5, Informative)

    by Brando_Calrisean (755640) on Thursday May 06 2004, @01:07PM (#9075621)
    I agree with the reviewer's sentiment that this is not the place to look as a beginner.
    I would recommend, even before checking out the mentioned 'Bible', taking a look at NeHe Production's OpenGL tutorials [gamedev.net] (see the sidebar).
  • Typos (Score:5, Informative)

    by andy666 (666062) on Thursday May 06 2004, @01:07PM (#9075628)
    This thing is FILLED with typos, which is horrible for a reference manuel.
  • by foidulus (743482) on Thursday May 06 2004, @01:08PM (#9075636)
    To buy the new version of the book if you already have the old version, esp. if you do not do much graphics programming. The previous version seems to contain a lot of the same content, though the API(which can be found online) is updated.
  • next week - list of C reserved words! (Score:1, Interesting)

    by Anonymous Coward on Thursday May 06 2004, @01:09PM (#9075648)
    Wouldn't a review of the OpenGL Programming Guide, listed towards the end been a bit more appropriate? I can see Brian Paul [mesa3d.org] rubbing his hands with glee at the thoughts of this one, but for developers I think the programming guide plus the man pages are what you're looking for.
  • good book! (Score:5, Insightful)

    by Gingko (195226) on Thursday May 06 2004, @01:09PM (#9075651)
    OpenGL has changed focus a good deal since the last edition, and as such it is particularly good to see this updated. Driven by concerns such as ATI, NVidia and Microsoft (I *think* they're still involved), a lot of work has been done on modernising, streamlining and orthoganalising (like that's a word!) the API and it is now a good deal more useful. We're now in a situation where OpenGL combines the modern feature set of Direct3D with the rigorous review process implied by the ARB, while the extension mechanism, for all its drawbacks, is an elegant way of staging expansion of functionality.

    This book is really one of a pair - it's not the OpenGL Programming Guide (the Red Book) and as such is not supposed to educate a newcomer to OpenGL on how to make use of the API and accomplish simple tasks. This would explain much of the lack of tutorial code. This book really is supposed to be a dictionary, an expanded set of documentation and assuming it sticks to the format of the previous editions will become just as well-worn occupant of my shelf as its predecessor.

    Henry

  • OpenGL Super Bible (Score:4, Informative)

    by TheRealMindChild (743925) on Thursday May 06 2004, @01:10PM (#9075657)
    (http://www.mindchild.net/ | Last Journal: Tuesday November 29 2005, @10:16AM)
    I recommend the OpenGL Super Bible [amazon.com] as a good reference book too.
  • by lambent (234167) <slashdotNO@SPAMluxovius.net> on Thursday May 06 2004, @01:10PM (#9075660)
    Finally, having an electronic version of the text would have been a nice touch

    Truly, if you're programming, and using a reference manual at the same time (I don't know anyone who has the OpenGL spec memorized), it really slows you down if you have to switch from screen to book constantly.

    On the plus side, it's only a matter of time before the text gets scanned and posted to the usual suspects. (names omitted to protect the innocent, and stymie the unlearned)
    • Already online by AnEmbodiedMind (Score:1) Thursday May 06 2004, @04:53PM
  • Open GL Programming Guide (Score:2, Interesting)

    by godzillion (693800) on Thursday May 06 2004, @01:11PM (#9075666)
    The OGL Programming Guide is put out by the OpenGL ARB. The version covering 1.1 was excellent.
  • Where is the news here? (Score:1, Informative)

    by Anonymous Coward on Thursday May 06 2004, @01:14PM (#9075708)
    This OpenGL Ref. Manual has been around for quite a while. Good that they noticed it though, even though it is not as useful as the Red book (the Programming Guide). Most of the info in the Ref manual can be found in man-pages.
  • Faster and cheaper (Score:5, Informative)

    by The Old Me (641450) on Thursday May 06 2004, @01:14PM (#9075719)
    You can get the OpenGL spec (1.5!) for free from opengl.org, if you are a true hard-core OpenGL programmer.
  • by CatGrep (707480) on Thursday May 06 2004, @01:43PM (#9075965)
    The review didn't mention this, I'm wondering if there are there similar references available online so I don't have to drop $60?
    • 1 reply beneath your current threshold.
  • by sw155kn1f3 (600118) on Thursday May 06 2004, @01:44PM (#9075974)
    That's something astonishingly exciting in this book, it extends 1.4 refernce manuals and it will last forever as... well.. 1.4 opengl reference manual.

    I'm kind of historian and keeping the count of varios books published.

    Here's my summary of hits:

    "How To Become 3d Artist/Programmer With OpenGL And Be Just Cool As John Carmack", published n/0 times.

    "How To Become 3d Artist/Programmer With Direct3D And Be Just Cool As Bill Gates", published (n-10000)/0 times.

    "Request For Comments Refernce Manual - All You Wanted To Know About Networking Protocols". Is published (n-1)/0 times. Pretty common. But still very popular, get your copy today.

    "Manual Pages Of Unix"
    That was used hard to find... People would kill each other for that, or sue... (n-1000000)/0 times.

    In other news (n-(-1))/0's "Windows Help Reference Manual For Dummies" is soon to hit bookshelves.

    Look at this math isn't it nice?

    Hm... what were we all talking about?... Nevermind.
    • 1 reply beneath your current threshold.
  • I'm torn (Score:4, Insightful)

    by magic (19621) on Thursday May 06 2004, @01:47PM (#9076018)
    (http://graphics3d.com/matrix)
    I'm really glad the book has been updated to version 1.4. The problem is that the API is currently on version 1.5 and the useful functions are all in extension (GL_vertex_buffer_object, GL_shader_objects) that aren't covered at all by the main API.

    The OpenGL consortium needs to get its act together. DirectX has an incredibly streamlined API with up-to-date documentation that includes all of the latest hardware features and runs identically on all cards. OpenGL is saddled with backward compatibility across 10 years and the latest features are all vendor-specific. The OpenGL 2.0 proposal doesn't go far enough; it basically brings OpenGL up to DirectX 9.0, while Microsoft is already releasing information about DirectX NEXT, which will be the new generation of graphics APIs.

    Frankly, the only reason I put up with OpenGL is that it runs on Linux and Mac. Portability is ceasing to be a compelling argument when the common .NET runtime across all versions of windows (embedded, CE, Xbox, desktop, server) and new features of DirectX NEXT are available.

    -m
    • Re:I'm torn by jonsmirl (Score:2) Thursday May 06 2004, @04:04PM
    • DX vs OpenGL extensions (Score:5, Insightful)

      The problem is that the API is currently on version 1.5 and the useful functions are all in extension (GL_vertex_buffer_object, GL_shader_objects) that aren't covered at all by the main API.

      I'm with you here. I get better reference material on the net.

      DirectX has an incredibly streamlined API...

      Man, I so totally disagree (this is COM we're talking about), but perhaps that's just me :-)

      ...runs identically on all cards

      Uh uh, it most certainly does not. DirectX runs very differently on a 9800XT vs a TNT2. Obviously.

      OpenGL's ARB and vendor extensions are good and bad - good because you get the very latest hardware features immediately and you don't have to wait a year or two for the (admittedly slow) ARB to decide whether they like them or not. Bad because the vendor extensions at least aren't standardized, and if you want to use them, chances are you'll need multiple code paths for different vendor hardware. ARB extensions are standard, but of course not all hardware supports them (or indeed, older hardware may not support the newer versions of OpenGL).

      Instead, DirectX uses capability bits to differentiate between hardware. If you want a new feature, you have to wait until MS gets around to supporting it (e.g. PS 3.0, even though that's already been defined, cannot be used until you get DX9.0c). MS do update DX more regularly than the ARB (they have to, without vendor extensions), but you could still be waiting a while. You still need multiple codepaths to cope with different hardware caps - no difference there, and you may still have to deal with cards that don't have drivers for the latest DX at all.

      OpenGL is saddled with backward compatibility

      OpenGL 2.0 reinvents the API to cope with programmable hardware, and mitigates that effect fairly well.

      Microsoft is already releasing information about DirectX NEXT

      Yeah, like what? Nothing exactly useful. You won't see much from MS for quite a while.

      the only reason I put up with OpenGL is that it runs on Linux and Mac. Portability is ceasing to be a compelling argument when the common .NET runtime across all versions of windows (embedded, CE, Xbox, desktop, server)

      That's hardly much portability - it doesn't run on Linux and Mac. OpenGL is available on many more platforms than .NET, let alone DirectX.

      ...and new features of DirectX NEXT are available.

      That could still be some time. I don't think .NET is going to solve portability problems anytime soon, especially for games, professional apps etc, any more than Java did (and probably somewhat less).

      [ Parent ]
    • 1 reply beneath your current threshold.
  • Probably not as complete, but the man pages are free:

    http://www.cs.rutgers.edu/~decarlo/428/glman.html [rutgers.edu]
  • was just looking (Score:1)

    by Gecedion (729009) on Thursday May 06 2004, @01:54PM (#9076106)
    I was just looking for a review for this on /. yesterday. I've been stuck with the third edition for a while and was wondering if this was worth getting.
  • by Performer Guy (69820) on Thursday May 06 2004, @02:29PM (#9076478)
    OpenGL 1.5 is already upon us looks like the authors can't keep up with the spec any more.
  • by 91degrees (207121) on Thursday May 06 2004, @02:35PM (#9076537)
    (Last Journal: Friday June 11 2004, @11:15AM)
    It seems a little arbitrary to include the X extensions, but not the Windows extensions (and apple assuming there are some). There are a number of OpenGL programmers who use Windows after all. And it's not like 10 or so extra functions would have made the book a lot thicker.

    Really though, the main addition a typical programmer would benefit from is a list of some of the more common extensions. Even if they're terse, and give only the briefest of descriptions, it would be nice to know what extensions might exist.
  • two words (Score:3, Informative)

    by nuttyprofessor (83282) on Thursday May 06 2004, @02:45PM (#9076654)
    (http://cs.vancouver.wsu.edu/)
    man page.
    e.g., man glBegin.
    Actually, hypertexting through this the docs found here [opengl.org] is even better.
  • Missing Content (Score:2, Informative)

    by Anonymous Coward on Thursday May 06 2004, @03:09PM (#9076933)
    I was perfectly fine my previous red book but what got me to upgrade was that the back of the book promised an introduction to the ARB vertex and fragment programs. Well, unless the copy I have is missing a couple of pages, its NOT in there! I spent 2 nights pouring over the contents hoping that it was just not in the table of contents or indexed incorrectly, nope, its not in there...
  • opengl 2.0 (Score:2, Insightful)

    by Anonymous Coward on Thursday May 06 2004, @09:18PM (#9079837)
    in it's current form opengl is still a great opensource (mesa) crossplatform alternative to directX (in terms of graphics). But it is currently flailing, the revision of opengl 2.0 is greatly needed Hopefully all of the commitee can get the spec decided upon and out there, before directX forces everyone to develop using c#.
  • by tiger99 (725715) on Friday May 07 2004, @08:13AM (#9082998)
    ...than what you have to pay to get a specification for USB, or PCMCIA cards, or many other things. The cost of getting the documentation kills many small projects before they begin, this at least is priced within the reach of most people who will actually need it.

    But, I expect I will not be one of them, I am not into that kind of programming. However, I would like to get at proper USB, PCI and PCMCIA specifications right now, and others from time to time, without paying silly money. Oh yes, and a proper, complete and accurate set of Windoze API documentation...... (even the Monopolist probably does not have such a thing!) Now, about SCO Unix..........

    Those who really can't afford the book or only need a few bits of info can always use the web site, no such ability with the othrs I have mentioned. Standards should be accessible to everyone at a fair price, preferably free, that way they can be worked to accurately, so everyone benefits. A book like this is at the high end of the price range, but worth every cent if it helps someone write less buggy code.

  • Re:I Heard.... (Score:1, Interesting)

    by Anonymous Coward on Thursday May 06 2004, @01:34PM (#9075872)
    Only if you believe that MS controls the gaming industry, and controls the graphics industry and controls....

    opengl, is the standard that runs gamecube, ps2, many pc games, and is the standard that is used for anything non-microsoft.

    Direct3D has more features, because they don't follow an industry standard, they are able to develop faster. You will also notice that Direct3d contains a very thin wrapper to OpenGL as well.

    Take a look at NeHe productions [gamedev.net] to see what is possible with opengl.

    [ Parent ]
  • 12 replies beneath your current threshold.