2 C-Style OpenGL

The sgl/gl module provides a direct interface to the system’s GL library closely following the conventions of the C-language OpenGL API. It provides a binding for each #defined constant (these start with GL_) and for the functions in the GL 1.5 and GLU 1.3 specifications, except for the following:

Vertex arrays (GL 1.5, Section 2.8)
Buffer objects (GL 1.5, Section 2.9)
glGetPointerv (GL 1.5, Section 6.1.11)
Buffer object queries (GL 1.5, Section 6.1.13)
Polygon tessellation (GLU 1.3, Section 5)
gluQuadricCallback (GLU 1.3, Section 6.2)
NURBS (GLU 1.3, Section 7)

If one of the provided functions is not present on your system (e.g. if your system supports only GL 1.3), then the corresponding sgl/gl function raises a run-time exception when invoked.

The functions provided by sgl/gl perform comparable checking to their C-language counterparts; they check the types of their arguments, but do not check the length of array arguments. The following details the kinds of Racket values that can be provided for each primitive OpenGL type:

GLbyte, GLshort, GLint: exact integer in the proper range
GLubyte, GLushort, GLuint: exact non-negative integer in the proper range
GLsizei, GLenum, GLbitfield: exact non-negative integer in the proper range
GFfloat, GLdouble: real number
GFclampf, GLclampd: real number
GLboolean: any value, where #f means GL_FALSE and all other values mean GL_TRUE; do not use GL_FALSE or GL_TRUE, since they are bound to integers, both will end up being converted to GL_TRUE.

OpenGL functions that take vector arguments accept cvector values. The type of the cvector is checked; for example, glVertex3fv expects a vector of GLfloats, so glVertex3fv accepts only a cvector containing reals. See also sgl/gl-vectors. Functions that accept arrays of type void* accept any cvector; you must ensure that you supply the proper kind of vector, as in the C-language OpenGL API.

Examples:
  (require sgl/gl
           sgl/gl-vectors)
  (glBegin GL_TRIANGLES)
  (glVertex3i 1 2 3)
  (glVertex4fv (gl-float-vector 1 2 3 4))
  (glEnd)

glPixelMapfv : procedure?

glPixelMapuiv : procedure?

glPixelMapusv : procedure?

glDeleteTextures : procedure?

glDeleteQueries : procedure?

These functions do not take a size argument, because it is derived from the length of the argument vector.

glGenTextures : procedure?

glGenQueries : procedure?

These functions do not take vector arguments. Instead, they allocate a vector of the requested size and return it.

glAreTexturesResident : procedure?

This function takes in a GLuint vector and textures, and it returns 2 values: the specified boolean and a boolean vector of residences.

glGetBooleanv : procedure?

glGetIntegerv : procedure?

glGetFloatv : procedure?

glGetDoublev : procedure?

glGetLightfv : procedure?

glGetLightiv : procedure?

glGetMaterialfv : procedure?

glGetMaterialiv : procedure?

glGetTexEnvfv : procedure?

glGetTexEnviv : procedure?

glGetTexGendv : procedure?

glGetTexGenfv : procedure?

glGetTexGeniv : procedure?

glGetTexParameterfv : procedure?

glGetTexParameteriv : procedure?

glGetTexLevelParameterfv : procedure?

glGetTexLevelParameteriv : procedure?

glGetPixelMapfv : procedure?

glGetPixelMapuiv : procedure?

glGetPixelMapusv : procedure?

glGetMapdv : procedure?

glGetMapfv : procedure?

glGetMapiv : procedure?

glGetBufferParameteriv : procedure?

glGetConvolutionParameterfv : procedure?

glGetConvolutionParameteriv : procedure?

glGetHistogramParameterfv : procedure?

glGetHistogramParameteriv : procedure?

glGetMinmaxParameterfv : procedure?

glGetMinmaxParameteriv : procedure?

glGetQueryiv : procedure?

glGetQueryObjectiv : procedure?

glGetQueryObjectuiv : procedure?

Instead of taking a vector argument, these function take an integer argument that specifies the size of the vector that is returned.

glGetClipPlane : procedure?

This function does not take a vector argument and returns a GLdouble vector of length 4.

glGetString : procedure?

gluCheckExtension : procedure?

gluErrorString : procedure?

gluGetString : procedure?

These functions deal with strings instead of GLubyte vectors.

gluProject : procedure?

gluUnProject : procedure?

gluUnProject4 : procedure?

Instead of taking pointers to GLdoubles for return values, these function directly return GLdouble vectors.

glSelectBuffer : procedure?

glFeedbackBuffer : procedure?

These functions do not take vectors, instead they return a selection-buffer-object or feedback-buffer-object. The select-buffer->gl-uint-vector and feedback-buffer->gl-float-vector functions copy the contents of the buffer into a vector. Because the OpenGL library writes to the buffer-object on OpenGL function calls after glSelectBuffer or glFeedbackBuffer has returned, if the buffer is garbage collected before OpenGL is finished writing to it, the entire Racket system can crash. The gl-process-selection function in sgl helps interpret the results of glSelectBuffer in a Racket-friendly format.

1	Using Open GL
2	C-Style Open GL
3	Racket-Style Open GL
4	Open GL Vectors
5	Bitmaps
	Index