HP Workstation c3650 OpenGL 1.1 Reference for HP-UX 11.x
HP Workstation c3650 Manual
View all HP Workstation c3650 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP Workstation c3650 manual content summary:
- HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 1
OpenGL 1.1 Reference for HP-UX 11.x Manufacturing Part Number: B2355-IE001 Edition E0302 © Copyright 2002 by Hewlett-Packard - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 2
Legal Notices The information contained in this document is subject to change without notice. Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard. This document contains proprietary information that is protected - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 3
Contents glAccum 10 glAlphaFunc 13 glAreaTexturesResident 15 glArrayElement 17 glBegin 20 gluBeginCurve 23 gluBeginPolygon 24 gluBeginSurface 25 gluBeginTrim 26 glBindTexture 28 glBitMap 30 glBlendColorEXT 32 glBlendFunc 33 gluBuild1DMipmaps 36 gluBuild2DMipmaps 38 glCallList 42 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 4
Contents glCullFace 91 gluCylinder 92 glDeleteLists 94 gluDeleteNurbsRenderer 95 gluDeleteQuadric 96 gluDeleteTess 97 glDeleteTextures 98 glDepthFunc 100 glDepthMask 102 glDepthRange 103 glXDestroyContext 104 glXDestroyGLXPixmap 105 glDisable 106 gluDisk 112 glDrawArrays 113 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 5
Contents glXGetClientString 186 glXGetClipPlane 187 glXGetConfig 188 glXGetCurrentContext 191 glXGetCurrentDisplay 192 glXGetCurrentDrawable 193 glGetError 194 glGetLight 196 glGetMap 199 glGetMaterial 201 gluGetNurbsProperty 203 glGetPixelMap 204 glGetPointer 206 glGetPolygonStipple - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 6
Contents glLoadIdentity 262 glLoadMatrix 263 glLoadName 265 gluLoadSamplingMatrices 266 glLogicOp 267 gluLookAt 269 glXMakeCurrent 272 glMap1 274 glMap2 278 glMapGrid 283 glMaterials 285 glMatrixMode 288 glMultMatrix 289 glNewList 292 glNextVisibilityTesthp 294 gluNewNurbsRenderer - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 7
Contents glPolygonMode 340 glPolygonOffset 342 glPolygonStipple 344 glPrioritizeTextures 346 gluProject 348 glPushAttrib 349 glPushClientAttrib 355 glPushMatrix 357 glPushName 359 gluPwlCurve 361 gluQuadricCallback 364 gluQuadricDrawStyle 365 gluQuadricNormals 366 gluQuadricOrientation - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 8
Contents gluTessEndPolygon 416 gluTessNormal 417 gluTessProperty 418 gluTessVertex 420 glTexCoord 422 glTexCoordPointer 425 glTexEnv 427 glTexGen 431 glTexImage1D 434 glTexImage2D 439 glTexImage3DEXT 444 glTexParameter 449 glTexSubImage1D 455 glTexSubImage2D 458 glTexSubImage3DEXT 461 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 9
1 A Chapter 1 9 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 10
A glAccum 10 glAccum glAccum: operate on the accumulation buffer. C Specification void glAccum( GLenum op, GLfloat value) Parameters op value Specifies the accumulation buffer operation. Symbolic constants GL_ACCUM, GL_LOAD, GL_ADD, GL_MULT, and GL_RETURN are accepted. Specifies a floating-point - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 11
Chapter 1 A glAccum Each component value is divided by 2n -1, where n is the number of bits allocated to each color component in the currently selected buffer. The result is a floating-point value in the range [0, 1], which is multiplied by value and added to the corresponding pixel component in - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 12
A glAccum glLogicOp, glPixelStore, glPixelTransfer, glReadBuffer, glReadPixels, glScissor, glStencilOp 12 Chapter 1 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 13
reference value. glAlphaFunc specifies the reference value and the comparison function. The comparison is performed only if alpha testing is enabled. By default, it is not enabled. (See glEnable and glDisable of GL_ALPHA_TEST.) func and ref specify the conditions under which the pixel is drawn. The - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 14
A glAlphaFunc glAlphaFunc operates on all pixel write operations, including those resulting from the scan conversion of points, lines, polygons, and bitmaps, and from pixel draw and copy operations. glAlphaFunc does not affect screen-clear operations. Notes Alpha testing is performed only in RGBA - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 15
This is the only way that the residence status of a default texture can be queried. Notes glAreTexturesResident is available only if resident at any other time. If textures reside in virtual memory (there is no texture memory), they are considered always resident. Some implementations may not load - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 16
A glAreaTexturesResident Errors • GL_INVALID_VALUE is generated if n is negative. • GL_INVALID_VALUE is generated if any element in textures is 0 or does not name a texture. In that case, the function returns GL_FALSE and the contents of residences is indeterminate. • GL_INVALID_OPERATION is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 17
A glArrayElement glArrayElement glArrayElement: render a vertex using the specified vertex array element. C Specification void glArrayElement( GLint i) Parameters i Specifies an index into the enabled vertex data arrays. Description glArrayElement commands are used within glBegin/glEnd pairs to - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 18
A glArrayElement glNormalPointer, glTexCoordPointer, glVertexPointer 18 Chapter 1 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 19
2 B Chapter 2 19 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 20
B glBegin glBegin glBegin, glEnd: delimit the vertices of a primitive or a group of like primitives. C Specification void glBegin( GLenum mode) void glEnd(void) Parameters mode Specifies the primitive or primitives that will be created from vertices presented between glBegin and the subsequent - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 21
B glBegin GL_TRIANGLE_FAN Draws a connected group of triangles. One triangle is defined for each vertex presented after the first two vertices. Vertices 1, n+1, and n+2 define triangle n. n - 2 triangles are drawn. GL_QUADS Treats each group of four vertices as an independent quadrilateral. Vertices - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 22
B glBegin Execution of glEnableClientState, glDisableClientState, glEdgeFlagPointer, glTexCoordPointer, glColorPointer, glIndexPointer, glNormalPointer, glVertexPointer, glInterleavedArrays, or glPixelStore is not allowed after a call to glBegin and before the corresponding call to glEnd, but an - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 23
B gluBeginCurve gluBeginCurve gluBeginCurve, gluEndCurve: delimit a NURBS curve definition. C Specification void gluBeginCurve( GLUnurbs* nurb) void gluEndCurve( GLUnurbs* nurb) Parameters nurb Specifies the NURBS object (created with gluNewNurbsRenderer). Description Use gluBeginCurve to mark - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 24
B gluBeginPolygon gluBeginPolygon gluBeginPolygon, gluEndPolygon: delimit a polygon description. C Specification void gluBeginPolygon( GLUtesselator* tess) void gluEndPolygon( GLUtesselator* tess) Parameters tess Specifies the tessellation object (created with gluNewTess). Description - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 25
GL_MAP2_VERTEX_3 or GL_MAP2_VERTEX_4. To mark the end of the NURBS surface definition, call gluEndSurface. Trimming of NURBS surfaces is supported with gluBeginTrim, gluPwlCurve, gluNurbsCurve, andgluEndTrim. See the gluBeginTrim reference page for details. GL evaluators are used to render the NURBS - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 26
B gluBeginTrim gluBeginTrim gluBeginTrim, gluEndTrim: delimit a NURBS trimming loop definition. C Specification void gluBeginTrim( GLUnurbs* nurb) void gluEndTrim( GLUnurbs* nurb) Parameters nurb Specifies the NURBS object (created with gluNewNurbsRenderer). Description Use gluBeginTrim to mark - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 27
B gluBeginTrim If a trimming loop definition contains multiple curves, the direction of the curves must be consistent (that is, the inside must be to the left of all of the curves). Nested trimming loops are legal as long as the curve orientations alternate correctly. If trimming curves are self- - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 28
is bound to a target, the previous binding for that target is broken. Texture names are unsigned integers. The value 0 is reserved to represent the default texture for each texture target. glGenTextures may be used to generate a set of new texture names. When a texture is first bound, it assumes the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 29
B glBindTexture Notes glBindTexture is available only if the GL version is 1.1 or greater. Errors • GL_INVALID_ENUM is generated if target is not one of the allowable values. • GL_INVALID_OPERATION is generated if texture has a dimensionality that doesn't match that of target. • GL_INVALID_OPERATION - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 30
B glBitMap 30 glBitMap glBitmap: draw a bitmap. C Specification void glBitmap( GLsizei width, GLsizei height, GLfloat xorig, GLfloat yorig, GLfloat xmove, GLfloat ymove, const GLubyte *bitmap) Parameters width, height xorig, yorig xmove, ymove bitmap Specify the pixel width and height of the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 31
B glBitMap where (xr, yr) is the raster position and (xo, yo) is the bitmap origin. Fragments are then generated for each pixel corresponding to a 1 (one) in the bitmap image. These fragments are generated using the current raster z coordinate, color or color index, and current raster texture - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 32
command set. If GL_EXT_blend_color is included in the string returned by glGetString, when called with argument GL_EXTENSIONS, extension EXT_blend_color is supported by the connection. Errors • GL_INVALID_OPERATION is generated if glBlendColorEXT is executed between the execution of glBegin and the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 33
Chapter 2 B glBlendFunc glBlendFunc glBlendFunc: specify pixel arithmetic. C Specification void glBlendFunc( GLenum sfactor, GLenum dfactor) Parameters sfactor dfactor Specifies how the red, green, blue, and alpha source blending factors are computed. Nine symbolic constants are accepted: - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 34
B glBlendFunc Table 2-1 Parameters Parameter GL_ZERO GL_ONE GL_SRC_COLOR GL_ONE_MINUS_SRC_COLOR GL_DST_COLOR GL_ONE_MINUS_DST_COLOR GL_SRC_ALPHA GL_ONE_MINUS_SRC_ALPHA GL_DST_ALPHA GL_ONE_MINUS_DST_ALPHA GL_SRC_ALPHA_SATURATE (fR, fG, fB, fA) (0, 0, 0, 0) (1, 1, 1, 1) (Rs/kR, Gs/kG, Bs/kB, As/kA) - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 35
B glBlendFunc Examples Blend function (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA) is also useful for rendering anti-aliased points and lines in arbitrary order. Polygon anti-aliasing is optimized using blend function (GL_SRC_ALPHA_SATURATE, GL_ONE) with polygons sorted from nearest to farthest. (See the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 36
or GL_FLOAT. Specifies a pointer to the image data in memory. Description gluBuild1DMipmaps builds a series of pre-filtered 1D texture maps of data scales up to 64 before mipmapping takes place. (If width is exactly between powers of 2, the copy of data is scaled upward.) If the GL version is 1.1 or - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 37
halves a copy of data (or a scaled version of data, if necessary) until size 1 is reached. At each level, each texel in the halved image is an have shrunk or expanded width if width isn't a power of 2 or if the implementation only supports smaller textures. The maximum level can then be derived - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 38
or GL_FLOAT. Specifies a pointer to the image data in memory. Description gluBuild2DMipmaps builds a series of pre-filtered 2D texture maps of width and height of data are both powers of 2. If not, gluBuild2DMipmaps scales a copy of data up or down to the nearest power of 2. This copy is then used - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 39
can store the requested texture in texture memory. If not, both dimensions are continually scaled version of type, if necessary) along both dimensions until size 11 is reached. At each level, each texel in the or height are not powers of 2 or if the implementation only supports smaller textures.) The - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 40
B gluBuild2DMipmaps 40 Chapter 2 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 41
3 C Chapter 3 41 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 42
C glCallList glCallList glCallList: execute a display list. C Specification void glCallList( GLuint list) Parameters list Specifies the integer name of the display list to be executed. Description glCallList causes the named display list to be executed. The commands saved in the display list are - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 43
C glCallLists glCallLists glCallLists: execute a list of display lists. C Specification void glCallLists( GLsizei n, GLenum type, const GLvoid *lists) Parameters n type lists Specifies the number of display lists to be executed. Specifies the type of values in lists. Symbolic constants GL_BYTE, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 44
C glCallLists GL_2_BYTES lists is treated as an array of unsigned bytes. Each pair of bytes specifies a single display-list name. The value of the pair is computed as 256 times the unsigned value of the first byte plus the unsigned value of the second byte. GL_3_BYTES lists is treated as an array - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 45
See Also glCallList, glDeleteLists, glGenLists, glListBase, glNewList, glPushAttrib, glPushMatrix C glCallLists Chapter 3 45 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 46
and StaticColor visuals, respectively. If no conforming visual exists, NULL is returned. To free the data returned by this function, use XFree. All boolean GLX attributes default to False except GLX_USE_GL, which defaults to True. All integer GLX attributes default to zero. Default specifications - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 47
is preferred. Otherwise, the largest available alpha buffer of at least the minimum size is preferred. GLX_DEPTH_SIZE Must be followed by a nonnegative minimum size specification. If this value is zero, visuals with no depth buffer are preferred. Otherwise, the largest available depth buffer of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 48
size is preferred. GLX_ACCUM_ALPHA_SIZE Must be followed by a nonnegative minimum size specification. If this value is zero, visuals picking only visuals that support GLXPixmaps. GLXPixmaps are supported for visuals whose GLX_BUFFER_SIZE is one of the pixmap depths supported by the X server. Errors • - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 49
See Also glXCreateContext, glXGetConfig C glXChooseVisual Chapter 3 49 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 50
C glClear glClear glClear: clear buffers to preset values. C Specification void glClear( GLbitfield mask) Parameters mask Bitwise OR of masks that indicate the buffers to be cleared. The four masks are GL_COLOR_BUFFER_BIT, GL_DEPTH_BUFFER_BIT, GL_ACCUM_BUFFER_BIT, and GL_STENCIL_BUFFER_BIT. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 51
C glClear Errors • GL_INVALID_VALUE is generated if any bit other than the four defined bits is set in mask. • GL_INVALID_OPERATION is generated if glClear is executed between the execution of glBegin and the corresponding execution of glEnd. Associated gets glGet with argument GL_ACCUM_CLEAR_VALUE - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 52
C glClearAccum glClearAccum glClearAccum: specify clear values for the accumulation buffer. C Specification void glClearAccum( GLfloat red, GLfloat green, GLfloat blue, GLfloat alpha) Parameters red, green, blue, alpha Specify the red, green, blue, and alpha values used when the accumulation buffer - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 53
C glClearColor glClearColor glClearColor: specify clear values for the color buffers. C Specification void glClearColor( GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha) Parameters red, green, blue, alpha Specify the red, green, blue, and alpha values used when the color buffers are - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 54
C glClearDepth glClearDepth glClearDepth: specify the clear value for the depth buffer. C Specification void glClearDepth( GLclampd depth) Parameters depth Specifies the depth value used when the depth buffer is cleared. The initial value is 1. Description glClearDepth specifies the depth value - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 55
C glClearindex glClearindex glClearIndex: specify the clear value for the color index buffers. C Specification void glClearIndex( GLfloat c) Parameters c Specifies the index used when the color index buffers are cleared. The initial value is 0. Description glClearIndex specifies the index used - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 56
C glClearStencil glClearStencil glClearStencil: specify the clear value for the stencil buffer. C Specification void glClearStencil( GLint s) Parameters s Specifies the index used when the stencil buffer is cleared. The initial value is 0. Description glClearStencil specifies the index used by - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 57
which all geometry is clipped. To determine the maximum number of additional clipping planes, call glGetIntegerv with argument GL_MAX_CLIP_PLANES. All implementations support at least six such clipping planes. Because the resulting clipping region is the intersection of the defined half-spaces, it - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 58
C glClipPlane Associated gets glGetClipPlane glIsEnabled with argument GL_CLIP_PLANE\f2i\fP See Also glEnable 58 Chapter 3 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 59
Chapter 3 C glColor glColor glColor3b, glColor3d, glColor3f, glColor3i, glColor3s, glColor3ub, glColor3ui, glColor3us, glColor4b, glColor4d, glColor4f, glColor4i, glColor4s, glColor4ub, glColor4ui, glColor4us, glColor3bv, glColor3dv, glColor3fv, glColor3iv, glColor3sv, glColor3ubv, glColor3uiv, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 60
C glColor 60 GLdouble green, GLdouble blue, GLdouble alpha) void glColor4f( GLfloat red, GLfloat green, GLfloat blue, GLfloat alpha) void glColor4i( GLint red, GLint green, GLint blue, GLint alpha) void glColor4s( GLshort red, GLshort green, GLshort blue, GLshort alpha) void glColor4ub( GLubyte red - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 61
take a pointer to an array of such values. Current color values are stored in floating-point format, with unspecified mantissa and exponent sizes. Unsigned integer color components, when specified, are linearly mapped to floating-point values such that the largest representable value maps to 1.0 (full - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 62
C glColor Associated Gets glGet with argument GL_CURRENT_COLOR glGet with argument GL_RGBA_MODE See Also glIndex 62 Chapter 3 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 63
C glColorMask glColorMask glColorMask: enable and disable writing of frame buffer color components. C Specification void glColorMask( GLboolean red, GLboolean green, GLboolean blue, GLboolean alpha) Parameters red, green, blue, alpha Specify whether red, green, blue, and alpha can or cannot be - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 64
C glColorMaterial glColorMaterial glColorMaterial: cause a material color to track the current color. C Specification void glColorMaterial( GLenum face, GLenum mode) Parameters face mode Specifies whether front, back, or both front and back material parameters should track the current color. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 65
C glColorMaterial • GL_INVALID_OPERATION is generated if glColorMaterial is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glIsEnabled with argument GL_COLOR_MATERIAL glGet with argument GL_COLOR_MATERIAL_PARAMETER glGet with argument - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 66
location and data format of an array of color components to use when rendering. size specifies the number of components per color, and must be 3 or 4. type some implementations; see glInterleavedArrays.) When a color array is specified, size, type, stride, and pointer are saved as client-side state. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 67
and are therefore not saved or restored by glPushAttrib and glPopAttrib. Use glPushClientAttrib and glPopClientAttrib instead. Errors • GL_INVALID_VALUE is generated if size is not 3 or 4. • GL_INVALID_ENUM is generated if type is not an accepted value. • GL_INVALID_VALUE is generated if stride is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 68
share an address space if both are non-direct using the same server, or if both are direct and owned by a single process. Note subprocesses that share a single address space, but maintain separate program counters, stack spaces, and other related global data. A thread that is the only member - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 69
C glXCopyContext Errors • BadMatch is generated if rendering contexts src and dst do not share an address space or were not created with respect to the same screen. • BadAccess is generated if dst is current to any thread (including the calling thread) at the time glXCopyContext is called. • - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 70
C glCopyPixels glCopyPixels glCopyPixels: copy pixels in the frame buffer. C Specification void glCopyPixels( GLint x, GLint y, GLsizei width, GLsizei height, GLenum type) Parameters x, y width, height type Specify the window coordinates of the lower left corner of the rectangular region of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 71
ALPHA for the respective color components. The results are clamped to the range [0, 1]. If GL_MAP_COLOR is true, each color component is scaled by the size of lookup table GL_PIXEL_MAP_c_TO_c, then replaced by the value that it references in that table. c is R, G, B, or A. The GL then converts the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 72
C glCopyPixels The rasterization described thus far assumes pixel zoom factors of 1.0. If glPixelZoom is used to change the x and y pixel zoom factors, pixels are converted to fragments as follows. If (xr, yr) is the current raster position, and a given pixel is in the ith location in the jth row - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 73
glReadBuffer, glReadPixels, glStencilFunc C glCopyPixels Chapter 3 73 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 74
C glCopyTexImage1D glCopyTexImage1D glCopyTexImage1D: copy pixels into a 1D texture image. C Specification void glCopyTexImage1D( GLenum target, GLint level, GLenum internalFormat, GLint x, GLint y, GLsizei width, GLint border) Parameters target Specifies the target texture. Must be GL_TEXTURE_1D - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 75
C glCopyTexImage1D The screen-aligned pixel row with left corner at (x, y) and with a length of width+2 × border defines the texture array at the mipmap level specified by level. internalFormat specifies the internal format of the texture array. The pixels in the row are processed exactly as if - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 76
C glCopyTexImage1D See Also glCopyPixels, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glPixelStore glPixelTransfer, glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexSubImage1D, glTexSubImage2D, glTexParameter 76 Chapter 3 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 77
C glCopyTexImage2D glCopyTexImage2D glCopyTexImage2D: copy pixels into a 2D texture image. C Specification C Specification void glCopyTexImage2D( GLenum target, GLint level, GLenum internalFormat, GLint x, GLint y, GLsizei width, GLsizei height, GLint border) Parameters target Specifies the target - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 78
C glCopyTexImage2D Description glCopyTexImage2D defines a two-dimensional texture image with pixels from the current GL_READ_BUFFER. The screen-aligned pixel rectangle with lower left corner at (x, y) and with a width of width + 2 × border and a height of height + 2 × border defines the texture array - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 79
Associated Gets glGetTexImage glIsEnabled with argument GL_TEXTURE_2D See Also glCopyPixels, glCopyTexImage1D, glCopyTexSubImage1D, glCopyTexSubImage2D, glPixelStore, glPixelTransfer, glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexSubImage1D, glTexSubImage2D, glTexParameter C glCopyTexImage2D - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 80
sub image. Description glCopyTexSubImage1D replaces a portion of a one-dimensional texture image with pixels from the current GL_READ_BUFFER (rather than from main memory, as is the case for glTexSubImage1D). The screen-aligned pixel row with left corner at (x, y), and with length width replaces - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 81
C glCopyTexSubImage1D Texturing has no effect in color index mode. glPixelStore and glPixelTransfer modes affect texture images in exactly the way they affect glDrawPixels. Errors • GL_INVALID_ENUM is generated if target is not GL_TEXTURE_1D. • GL_INVALID_OPERATION is generated if the texture array - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 82
Description glCopyTexSubImage2D replaces a rectangular portion of a two-dimensional texture image with pixels from the current GL_READ_BUFFER (rather than from main memory, as is the case for glTexSubImage2D). The screen-aligned pixel rectangle with lower left corner at (x, y) and with width width - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 83
Chapter 3 C glCopyTexSubImage2D If any of the pixels within the specified rectangle of the current GL_READ_BUFFER are outside the read window associated with the current rendering context, then the values obtained for those pixels are undefined. No change is made to the internalformat, width, height, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 84
C glCopyTexSubImage2D glTexParameter, glTexSubImage1D, glTexSubImage2D 84 Chapter 3 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 85
glCopyTexSubImage3DEXT replaces a rectangular portion of a three-dimensional texture image with pixels from the current GL_READ_BUFFER (rather than from main memory, as is the case for glTexSubImage3DEXT). The screen-aligned pixel rectangle with lower-left corner at (x, y) having width width - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 86
C glCopyTexSubImage3DEXT The pixels in the rectangle are processed exactly as if glCopyPixels had been called, but the process stops just before final conversion. At this point all pixel component values are clamped to the range [0, 1] and then converted to the texture's internal format for storage - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 87
vis sharelist direct Specifies the connection to the X server. Specifies the visual that defines the frame buffer resources available to the rendering direct rendering context is created if the implementation supports direct rendering, if the connection is to an X server that is local, and if a direct - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 88
BadValue is generated if vis is not a valid visual (for example, if a particular GLX implementation does not support it). • GLXBadContext is generated if shareList is not a GLX context and is not NULL. • BadAlloc is generated if the server - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 89
) Parameters dpy vis pixmap Specifies the connection to the X server. Specifies the visual that defines the structure of the rendering area. It is may not support GLX pixmaps with direct rendering contexts. Notes XVisualInfo is defined in Xutil.h. It is a structure that includes visual, visualID - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 90
C glXCreateGLXPixmap • BadAlloc is generated if the server cannot allocate the GLX pixmap. See Also glXCreateContext, glXIsDirect, glXMakeCurrent 90 Chapter 3 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 91
C glCullFace glCullFace glCullFace: specify whether front- or back-facing facets can be culled. C Specification void glCullFace( GLenum mode) Parameters mode Specifies whether front- or back-facing facets are candidates for culling. Symbolic constants GL_FRONT, GL_BACK, and GL_FRONT_AND_BACK are - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 92
is placed at Z = 0, and the top at Z = height. Like a sphere, a cylinder is subdivided around the Z axis into slices, and along the Z axis into stacks. Note that if top is set to 0.0, this routine generates a cone. If the orientation is set to GLU_OUTSIDE (with gluQuadricOrientation), then any - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 93
4 D Chapter 4 93 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 94
D glDeleteLists glDeleteLists glDeleteLists: delete a contiguous group of display lists. C Specification void glDeleteLists( GLuint list, GLsizei range) Parameters list range Specifies the integer name of the first display list to delete. Specifies the number of display lists to delete. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 95
Specifies the NURBS object to be destroyed. Description gluDeleteNurbsRenderer destroys the NURBS object (which was created with gluNewNurbsRenderer) and frees any memory it uses. Once gluDeleteNurbsRenderer has been called, nurb cannot be used again. See Also gluNewNurbsRenderer Chapter 4 95 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 96
* quad) Parameters quad Specifies the quadrics object to be destroyed. Description gluDeleteQuadric destroys the quadrics object (created with gluNewQuadric) and frees any memory it uses. Once gluDeleteQuadric has been called, quad cannot be used again. See Also gluNewQuadric 96 Chapter 4 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 97
* tess) Parameters tess Specifies the tessellation object to destroy. Description gluDeleteTess destroys the indicated tessellation object (which was created with gluNewTess) and frees any memory that it used. See Also gluBeginPolygon, gluNewTess, gluTessCallback Chapter 4 97 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 98
its name is free for reuse (for example by glGenTextures). If a texture that is currently bound is deleted, the binding everts to 0 (the default texture). glDeleteTextures silently ignores 0s and names that do not correspond to existing textures. Notes glDeleteTextures is available only if the GL - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 99
glTexImage1D, glTexImage2D, glTexParameter D glDeleteTextures Chapter 4 99 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 100
D glDepthFunc glDepthFunc glDepthFunc: specify the value used for depth buffer comparisons. C Specification void glDepthFunc( GLenum func) Parameters func Specifies the depth comparison function. Symbolic constants GL_NEVER, GL_LESS, GL_EQUAL, GL_LEQUAL, GL_GREATER, GL_NOTEQUAL, GL_GEQUAL, and - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 101
D glDepthFunc Notes Even if the depth buffer exists and the depth mask is non-zero, the depth buffer is not updated if the depth test is disabled. Errors • GL_INVALID_ENUM is generated if func is not an accepted value. • GL_INVALID_OPERATION is generated if glDepthFunc is executed between the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 102
D glDepthMask glDepthMask glDepthMask: enable or disable writing into the depth buffer. C Specification void glDepthMask( GLboolean flag) Parameters flag Specifies whether the depth buffer is enabled for writing. If flag is GL_FALSE, depth buffer writing is disabled. Otherwise, it is enabled. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 103
Chapter 4 D glDepthRange glDepthRange glDepthRange: specify mapping of depth values from normalized device coordinates to window coordinates. C Specification void glDepthRange( GLclampd zNear, GLclampd zFar) Parameters zNear zFar Specifies the mapping of the near clipping plane to window - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 104
glXDestroyContext: destroy a GLX context. C Specification void glXDestroyContext( Display *dpy, GLXContext ctx) Parameters dpy Specifies the connection to the X server. ctx Specifies the GLX context to be destroyed. Description If the GLX rendering context ctx is not current to any thread - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 105
glXDestroyGLXPixmap: destroy a GLX pixmap. C Specification void glXDestroyGLXPixmap( Display *dpy, GLXPixmap pix) Parameters dpy Specifies the connection to the X server. pix Specifies the GLX pixmap to be destroyed. Description If the GLX pixmap pix is not current to any client - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 106
D glDisable 106 glDisable glEnable, glDisable: enable or disable server-side GL capabilities. C Specification void glEnable( GLenum cap) void glDisable( GLenum cap) Parameters cap Specifies a symbolic constant indicating a GL capability. Description glEnable and - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 107
Chapter 4 D glDisable If enabled, do depth comparisons and update the depth buffer. Note that even if the depth buffer exists and the depth mask is non-zero, the depth buffer is not updated if the depth test is disabled. See glDepthFunc and glDepthRange. GL_DITHER If enabled, dither color - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 108
D glDisable 108 GL_MAP1_TEXTURE_COORD_4 If enabled, calls to glEvalCoord1, glEvalMesh1, and glEvalPoint1 generate s, t, r, and q texture coordinates. See glMap1. GL_MAP1_VERTEX_3 If enabled, calls to glEvalCoord1, glEvalMesh1, and glEvalPoint1 generate x, y, and z vertex coordinates. See glMap1. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 109
Chapter 4 D glDisable This token enables HP's occlusion-testing extension. If any geometry is rendered while occlusion culling is enabled, and if that geometry would be visible (i.e., rendering it would affect the Z- - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 110
is also enabled). See glTexImage1D. GL_TEXTURE_2D If enabled, two-dimensional texturing is performed. See glTexImage2D. GL_TEXTURE_3D_EXT If supported and enabled, three-dimensional texturing is performed. See glTexImage3DEXT. GL_TEXTURE_GEN_Q If enabled, the q texture coordinate is computed - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 111
glEnableClientState, glFog, glGet, glIsEnabled, glLight, glLightModel, glLineWidth, glLineStipple, glLogicOp, glMap1, glMap2, glMaterial, glNormal, glPointSize, glPolygonMode, glPolygonOffset, glPolygonStipple, glScissor, glStencilFunc, glStencilOp, glTexGen, glTexImage1D, glTexImage2D D glDisable - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 112
D gluDisk 112 gluDisk gluDisk: draw a disk. C Specification void gluDisk( GLUquadric* quad, GLdouble inner, GLdouble outer, GLint slices, GLint loops) Parameters quad inner outer slices loops Specifies the quadrics object (created with gluNewQuadric). Specifies the inner radius of the disk (may be - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 113
D glDrawArrays glDrawArrays glDrawArrays: render primitives from array data. C Specification void glDrawArrays( GLenum mode, GLint first, GLsizei count) Parameters mode first count Specifies what kind of primitives to render. Symbolic constants GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 114
D glDrawArrays Errors • GL_INVALID_ENUM is generated if mode is not an accepted value. • GL_INVALID_VALUE is generated if count is negative. • GL_INVALID_OPERATION is generated if glDrawArrays is executed between the execution of glBegin and the corresponding glEnd. See Also glArrayElement, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 115
Chapter 4 D glDrawArraysSethp glDrawArraysSethp glDrawArraySethp: render multiple primitives from array data. C Specification void glDrawArraySethp( GLenum mode, const GLint* list, GLsizei count) Parameters mode list count Specifies what kind of primitives to render. Symbolic constants GL_POINTS - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 116
D glDrawArraysSethp glDrawArraySethp is included in display lists. If glDrawArraySethp is entered into a display list, the necessary array data (determined by the array pointers and enables) is also entered into the display list. Because the array pointers and enables are client- side state, their - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 117
D glDrawBuffer glDrawBuffer glDrawBuffer: specify which color buffers are to be drawn into. C Specification void glDrawBuffer( GLenum mode) Parameters mode Specifies up to four color buffers to be drawn into. Symbolic constants GL_NONE,GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 118
D glDrawBuffer Only the front left and back left color buffers are written. If there is no back left color buffer, only the front left color buffer is written. GL_RIGHT Only the front right and back right color buffers are written. If there is no back right color buffer, only the front right color - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 119
D glDrawElements glDrawElements glDrawElements: render primitives from array data. C Specification void glDrawElements( GLenum mode, GLsizei count, GLenum type, const GLvoid *indices) Parameters mode count type indices Specifies what kind of primitives to render. Symbolic constants - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 120
D glDrawElements glDrawElements is included in display lists. If glDrawElements is entered into a display list, the necessary array data (determined by the array pointers and enables) is also entered into the display list. Because the array pointers and enables are client-side state, their values - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 121
current raster position; use glGet with argument GL_CURRENT_RASTER_POSITION to query the raster position. Several parameters define the encoding of pixel data in memory and control the processing of the pixel data before it is placed in the frame buffer. These parameters are set with four commands - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 122
× height pixels are read from memory, starting at location pixels. By default, these pixels are taken from adjacent memory locations, except that after all for details on these options. The width × height pixels that are read from memory are each operated on in the same way, based on the values of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 123
the respective color components. The results are clamped to the range [0, 1]. If GL_MAP_COLOR is true, each color component is scaled by the size of lookup table GL_PIXEL_MAP_c_TO_c, then replaced by the value that it references in that table. c is R, G, B, or A respectively. The GL then converts - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 124
D glDrawPixels yn = yr + n/width where (xr, yr) is the current raster position.These pixel fragments are then treated just like the fragments generated by rasterizing points, lines, or polygons. Texture mapping, fog, and all the fragment operations are applied before the fragments are written to - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 125
Table 4-1 Chapter 4 D glDrawPixels The following table summarizes the meaning of the valid constants for the type parameter: Type Corresponding Type GL_UNSIGNED_BYTE Unsigned 8-bit integer GL_BYTE Signed 8-bit integer GL_BITMAP Single bits in unsigned 8-bit integers GL_UNSIGNED_SHORT - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 126
D glDrawPixels See Also glAlphaFunc, glBlendFunc, glCopyPixels, glDepthFunc, glLogicOp, glPixelMap, glPixelStore, glPixelTransfer, glPixelZoom, glRasterPos, glReadPixels, glScissor, glStencilFunc 126 Chapter 4 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 127
5 E Chapter 5 127 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 128
E glEdgeFlag glEdgeFlag glEdgeFlag, glEdgeFlagv: flag edges as either boundary or non-boundary. C Specification void glEdgeFlag( GLboolean flag) void glEdgeFlagv( const GLboolean *flag) Parameters flag Specifies the current edge flag value, either GL_TRUE or GL_FALSE. The initial value is GL_TRUE. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 129
E glEdgeFlagPointer glEdgeFlagPointer glEdgeFlagPointer: define an array of edge flags. C Specification void glEdgeFlagPointer( GLsizei stride const GLvoid *pointer) Parameters stride pointer Specifies the byte offset between consecutive edge flags. If stride is 0 (the initial value), the edge flags - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 130
E glEdgeFlagPointer Errors • GL_INVALID_ENUM is generated if stride is negative. Associated Gets glIsEnabled with argument GL_EDGE_FLAG_ARRAY glGet with argument GL_EDGE_FLAG_ARRAY_STRIDE glGetPointer with argument GL_EDGE_FLAG_ARRAY_POINTER See Also glArrayElement, glColorPointer, glDrawArrays, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 131
Chapter 5 E glEnable glEnable glEnable, glDisable: enable or disable server-side GL capabilities. C Specification void glEnable( GLenum cap) void glDisable( GLenum cap) Parameters cap Specifies a symbolic constant indicating a GL capability. Description glEnable and - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 132
E glEnable 132 If enabled, do depth comparisons and update the depth buffer. Note that even if the depth buffer exists and the depth mask is non-zero, the depth buffer is not updated if the depth test is disabled. See glDepthFunc and glDepthRange. GL_DITHER If enabled, dither color components or - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 133
Chapter 5 E glEnable GL_MAP1_TEXTURE_COORD_4 If enabled, calls to glEvalCoord1, glEvalMesh1, and glEvalPoint1 generate s, t, r, and q texture coordinates. See glMap1. GL_MAP1_VERTEX_3 If enabled, calls to glEvalCoord1, glEvalMesh1, and glEvalPoint1 generate x, y, and z vertex coordinates. See - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 134
E glEnable 134 This token enables HP's occlusion-testing extension. If any geometry is rendered while occlusion culling is enabled, and if that geometry would be visible (i.e., rendering it would affect the Z- - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 135
is also enabled). See glTexImage1D. GL_TEXTURE_2D If enabled, two-dimensional texturing is performed. See glTexImage2D. GL_TEXTURE_3D_EXT If supported and enabled, three-dimensional texturing is performed. See glTexImage3DEXT. GL_TEXTURE_GEN_Q If enabled, the q texture coordinate is computed - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 136
E glEnable glFog, glGet, glIsEnabled, glLight, glLightModel, glLineWidth, glLineStipple, glLogicOp, glMap1, glMap2, glMaterial, glNormal, glPointSize, glPolygonMode, glPolygonOffset, glPolygonStipple, glScissor, glStencilFunc, glStencilOp, glTexGen, glTexImage1D, glTexImage2D 136 Chapter 5 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 137
Specifies the capability to disable. Description glEnableClientState and glDisableClientState enable or disable individual client-side capabilities. By default, all client-side capabilities are disabled. Both glEnableClientState and glDisableClientState take a single argument, cap, which can assume - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 138
E glEnableClientState If enabled, the vertex array is enabled for writing and used during rendering when glDrawArrays or glDrawElements is called. See glVertexPointer. Notes glEnableClientState is available only if the GL version is 1.1 or greater. Errors • GL_INVALID_ENUM is generated if cap is not - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 139
or GLU error code. The string is in ISO Latin 1 format. For example, gluErrorString (GL_OUT_OF_MEMORY) returns the string out of memory. The standard GLU error codes are GLU_INVALID_ENUM, GLU_INVALID_VALUE, and GLU_OUT_OF_MEMORY. Certain other GLU functions can return specialized error codes through - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 140
E glEvalCoord glEvalCoord glEvalCoord1d, glEvalCoord1f, glEvalCoord2d, glEvalCoord2f, glEvalCoord1dv, glEvalCoord1fv, glEvalCoord2dv, glEvalCoord2fv: evaluate enabled one- and two-dimensional maps. C Specification void glEvalCoord1d( GLdouble u) void glEvalCoord1f( GLfloat u) void glEvalCoord2d( - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 141
Chapter 5 E glEvalCoord is produced, and if any of GL_MAP1_TEXTURE_COORD_1, GL_MAP1_TEXTURE_COORD_2, GL_MAP1_TEXTURE_COORD_3, GL_MAP1_TEXTURE_COORD_4, GL_MAP2_TEXTURE_COORD_1, GL_MAP2_TEXTURE_COORD_2, GL_MAP2_TEXTURE_COORD_3, or GL_MAP2_TEXTURE_COORD_4 is enabled, then an appropriate glTexCoord - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 142
E glEvalCoord glIsEnabled with argument GL_MAP2_INDEX glIsEnabled with argument GL_MAP2_COLOR_4 glIsEnabled with argument GL_MAP2_NORMAL glIsEnabled with argument GL_MAP2_TEXTURE_COORD_1 glIsEnabled with argument GL_MAP2_TEXTURE_COORD_2 glIsEnabled with argument GL_MAP2_TEXTURE_COORD_3 glIsEnabled - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 143
Chapter 5 E glEvalMesh glEvalMesh glEvalMesh1, glEvalMesh2: compute a one- or two-dimensional grid of points or lines. C Specification void glEvalMesh1( GLenum mode, GLint i1, GLint i2) void glEvalMesh2( GLenum mode, GLint i1, GLint i2, GLint j1, GLint j2) Parameters mode i1, i2 mode i1, i2 j1, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 144
E glEvalMesh and n, u1, and u2 are the arguments to the most recent glMapGrid1 command. type is GL_POINTS if mode is GL_POINT, or GL_LINES if mode is GL_LINE. The one absolute numeric requirement is that if i=n, then the value computed from i−∆u + u1 is exactly u2. In the two-dimensional case, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 145
E glEvalMesh • GL_INVALID_OPERATION is generated if glEvalMesh is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGet with argument GL_MAP1_GRID_DOMAIN glGet with argument GL_MAP2_GRID_DOMAIN glGet with argument GL_MAP1_GRID_SEGMENTS glGet with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 146
E glEvalPoint glEvalPoint glEvalPoint1, glEvalPoint2: generate and evaluate a single point in a mesh. C Specification void glEvalPoint1( GLint i) void glEvalPoint2( GLint i, GLint j) Parameters i Specifies the integer value for grid domain variable i. j Specifies the integer value for grid - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 147
Associated Gets glGet with argument GL_MAP1_GRID_DOMAIN glGet with argument GL_MAP2_GRID_DOMAIN glGet with argument GL_MAP1_GRID_SEGMENTS glGet with argument GL_MAP2_GRID_SEGMENTS See Also glEvalCoord, glEvalMesh, glMap1, glMap2, glMapGrid E glEvalPoint Chapter 5 147 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 148
E glEvalPoint 148 Chapter 5 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 149
6 F Chapter 6 149 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 150
in feedback mode, it returns the number of entries placed in the feedback array, and resets the feedback array pointer to the base of the feedback buffer. The returned value never exceeds size. If the feedback data required more room than was available in buffer, glRenderMode returns a negative - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 151
, GL_POLYGON_TOKEN, GL_BITMAP_TOKEN, GL_DRAW_PIXEL_TOKEN, GL_COPY_PIXEL_TOKEN and GL_PASS_THROUGH_TOKEN are symbolic floating-point constants. GL_LINE_RESET_TOKEN is returned whenever the line stipple pattern is reset. The data returned as a vertex depends on the feedback type. Chapter 6 151 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 152
list but is executed immediately. Errors • GL_INVALID_ENUM is generated if type is not an accepted value. • GL_INVALID_VALUE is generated if size is negative. • GL_INVALID_OPERATION is generated if glFeedbackBuffer is called while the render mode is GL_FEEDBACK, or if glRenderMode is called with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 153
GL state, all changes to connection state, and all changes to the frame buffer contents. Notes glFinish requires a round trip to the server. Errors • GL_INVALID_OPERATION is generated if glFinish is executed between the execution of glBegin and the corresponding execution of glEnd. See Also glFlush - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 154
F glFlush glFlush glFlush: force execution of GL commands in finite time. C Specification void glFlush(void) Description Different GL implementations buffer commands in several different locations, including network buffers and the graphics accelerator itself. glFlush empties all of these buffers, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 155
F glFog glFog glFogf, glFogi, glFogfv, glFogiv: specify fog parameters. C Specification void glFogf( GLenum pname, GLfloat param) void glFogi( GLenum pname, GLint param) void glFogfv( GLenum pname, const GLfloat *params) void glFogiv( GLenum pname, const GLint *params) Parameters pname param - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 156
F glFog 156 params is a single integer or floating-point value that specifies density, the fog density used in both exponential fog equations. Only nonnegative densities are accepted. The initial fog density is 1. GL_FOG_START params is a single integer or floating-point value that specifies start, the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 157
Associated Gets glIsEnabled with argument GL_FOG glGet with argument GL_FOG_COLOR glGet with argument GL_FOG_INDEX glGet with argument GL_FOG_DENSITY glGet with argument GL_FOG_START glGet with argument GL_FOG_END glGet with argument GL_FOG_MODE See Also glEnable F glFog Chapter 6 157 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 158
-facing. Passing GL_CCW to mode selects counterclockwise polygons as front-facing; GL_CW selects clockwise polygons as front-facing. By default, counterclockwise polygons are taken to be front-facing. Errors • GL_INVALID_ENUM is generated if mode is not an accepted value. • GL_INVALID_OPERATION - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 159
Chapter 6 F glFrustum glFrustum glFrustum: multiply the current matrix by a perspective matrix. C Specification void glFrustum( GLdouble left, GLdouble right, GLdouble bottom, GLdouble top, GLdouble zNear, GLdouble zFar) Parameters left, right bottom, top zNear, zFar Specify the coordinates for - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 160
F glFrustum Use glPushMatrix and glPopMatrix to save and restore the current matrix stack. Notes Depth buffer precision is affected by the values specified for zNear and zFar. The greater the ratio of zFar to zNear is, the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 161
7 G Chapter 7 161 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 162
G glGenLists glGenLists glGenLists: generate a contiguous set of empty display lists. C Specification GLuint glGenLists( GLsizei range) Parameters range Specifies the number of contiguous empty display lists to be generated. Description glGenLists has one argument, range. It returns an integer n - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 163
Chapter 7 G glGenTextures glGenTextures glGenTextures: generate texture names. C Specification void glGenTextures( GLsizei n, GLuint *textures) Parameters n textures Specifies the number of texture names to be generated. Specifies an array in which the generated texture names are stored. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 164
G glGenTextures glTexImage1D, glTexImage2D, glTexParameter 164 Chapter 7 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 165
Chapter 7 G glGet glGet glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv: return the value or values of a selected parameter. C Specification void glGetBooleanv( GLenum pname, GLboolean *params) void glGetDoublev( GLenum pname, GLdouble *params) void glGetFloatv( GLenum pname, GLfloat * - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 166
, and - 1.0 returns the most negative representable integer value. GL_ATTRIB_STACK_DEPTH params returns one value, the depth of the attribute stack. If the stack is empty, 0 is returned. The initial value is 0. See glPushAttrib. GL_AUTO_NORMAL params returns a single boolean value indicating whether - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 167
hint. The initial value is GL_FASTEST. See glHint. GL_CLIENT_ATTRIB_STACK_DEPTH params returns one value indicating the depth of the attribute stack. The initial value is 0. See glPushClientAttrib. GL_CLIP_PLANEi params returns a single boolean value indicating whether the specified clipping plane - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 168
G glGet params returns a single boolean value indicating whether a fragment's RGBA color values are merged into the frame buffer using a logical operation. The initial value is GL_FALSE. See glLogicOp. GL_COLOR_MATERIAL params returns a single boolean value indicating whether one or more material - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 169
Chapter 7 G glGet params returns four values: the red, green, blue, and alpha values of the current raster position. Integer values, if requested, are linearly mapped from the internal floating-point representation such that 1.0 returns the most positive representable integer value, and - 1.0 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 170
and indices is enabled. The initial value is GL_TRUE. GL_DOUBLEBUFFER params returns a single boolean value indicating whether double buffering is supported. GL_DRAW_BUFFER params returns one value, a symbolic constant indicating which buffers are being drawn to. See glDrawBuffer. The initial value - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 171
Chapter 7 G glGet params returns a single boolean value indicating whether edge clamping is enabled. The initial value is GL_FALSE. See glTexImage3DEXT. GL_FOG params returns a single boolean value indicating whether fogging is enabled. The initial value is GL_FALSE. See glFog. GL_FOG_COLOR params - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 172
G glGet params returns a single boolean value indicating whether texture lighting is enabled. The initial value is GL_FALSE. See glTexImage3DEXT. GL_INDEX_ARRAY params returns a single boolean value indicating whether the color index array is enabled. The initial value is GL_FALSE. See - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 173
one value, the line width as specified with glLineWidth. The initial value is 1. GL_LINE_WIDTH_GRANULARITY params returns one value, the width difference between adjacent supported widths for anti-aliased lines. See glLineWidth. GL_LINE_WIDTH_RANGE params returns two values: the smallest and largest - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 174
G glGet 174 params returns one value, the name of the display list currently under construction. 0 is returned if no display list is currently under construction. The initial value is 0. See glNewList. GL_LIST_MODE params returns one value, a symbolic constant indicating the construction mode of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 175
Chapter 7 G glGet params returns a single boolean value indicating whether 1D evaluation generates 4D vertex coordinates. The initial value is GL_FALSE. See glMap1. GL_MAP2_COLOR_4 params returns a single boolean value indicating whether 2D evaluation generates colors. The initial value is GL_FALSE - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 176
params returns one value, the maximum supported depth of the model view matrix stack. The value must be at least supported depth of the selection name stack. he value must be at least 64. See glPushName. GL_MAX_PIXEL_MAP_TABLE params returns one value, the maximum supported size - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 177
modelview matrix on the top of the modelview matrix stack. Initially this matrix is the identity matrix. See returns a single boolean value indicating whether HP's occlusion-testing extension is currently activated to memory. The initial value is 4. See glPixelStore. GL_PACK_LSB_FIRST Chapter 7 177 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 178
of pixel locations skipped before the first pixel is written into memory. The initial value is 0. See glPixelStore. GL_PACK_SWAP_BYTES params returns a GL_DONT_CARE. See glHint. GL_PIXEL_MAP_A_TO_A_SIZE params returns one value, the size of the alpha-to-alpha pixel translation table. The initial - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 179
anti-aliased points. See glPointSize. GL_POINT_SIZE_RANGE params returns two values: the smallest and largest supported sizes for anti-aliased points. The smallest size must be at most 1, and the largest size must be at least 1. See glPointSize. GL_POINT_SMOOTH params returns a single boolean value - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 180
value is GL_FALSE. See glPolygonStipple. GL_PROJECTION_MATRIX params returns sixteen values: the projection matrix on the top of the projection matrix stack. Initially this matrix is the identity matrix. See glPushMatrix. GL_PROJECTION_STACK_DEPTH params returns one value, the number of matrices on - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 181
box, followed by its width and height. Initially the x and y window coordinates are both 0 and the width and height are set to the size of the window. See glScissor. GL_SCISSOR_TEST params returns a single boolean value indicating whether scissoring is enabled. The initial value is GL_FALSE. See - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 182
. The initial value is all 1s. See glStencilMask. GL_STEREO params returns a single boolean value indicating whether stereo buffers (left and right) are supported. GL_SUBPIXEL_BITS params returns one value, an estimate of the number of bits of subpixel resolution that are used to position rasterized - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 183
: the texture matrix on the top of the texture matrix stack. Initially this matrix is the identity matrix. See glPushMatrix. GL_TEXTURE_STACK_DEPTH of pixel locations skipped before the first pixel is read from memory. The initial value is 0. See glPixelStore. GL_UNPACK_SWAP_BYTES params returns a - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 184
G glGet 184 params returns one value, the data type of each coordinate in the vertex array. The initial value is GL_FLOAT. See glVertexPointer. GL_VIEWPORT params returns four values: the x and y window coordinates of the viewport, followed by its width and height. Initially the x and y window - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 185
glGetTexGen, glGetTexImage, glGetTexLevelParameter, glGetTexParameter, glIsEnabled G glGet Chapter 7 185 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 186
, int name) Parameters dpy name Specifies the connection to the X server. Specifies which string is returned. One of GLX_VENDOR, GLX_VERSION, or about GLX extensions supported by the client. Call glGetString to get a list of GL extensions supported by the server. See Also glXQueryVersion - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 187
plane equation Specifies a clipping plane. The number of clipping planes depends on the implementation, but at least six clipping planes are supported. They are identified by symbolic names of the form GL_CLIP_PLANEi where 0 ≥ i < GL_MAX_CLIP_PLANES. Returns four double-precision values that are the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 188
server. Specifies the visual to be queried. It is a pointer to an XVisualInfo structure, not a visual ID or a pointer to a Visual. Specifies the visual index visuals, GLX_BUFFER_SIZE is the size of the color indexes. GLX_LEVEL Frame buffer level of the visual. Level zero is the default frame buffer - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 189
, its color buffer size must be as great as that of the deepest TrueColor, DirectColor, PseudoColor, or StaticColor visual supported on level zero, and it must itself be made available on level zero. In addition, if the X server exports a PseudoColor or StaticColor visual on frame buffer level - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 190
G glXGetConfig Notes XVisualInfo is defined in Xutil.h. It is a structure that includes visual, visualID, screen, and depth elements. Errors • GLX_NO_EXTENSION is returned if dpy does not support the GLX extension. • GLX_BAD_SCREEN is returned if the screen of vis does not correspond to a screen. • - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 191
fied by glXMakeCurrent. If there is no current context, NULL is returned. glXGetCurrentContext returns client-side information. It does not make a round trip to the server. See Also glXCreateContext, glXMakeCurrent Chapter 7 191 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 192
. glXGetCurrentDisplay returns client-side information. It does not make a round trip to the server, and therefore does not flush any pending events. Notes glXGetCurrentDisplay is only supported if the GLX version is 1.2 or greater. See Also glXQueryVersion, glXQueryExtensionsString 192 Chapter - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 193
fied by glXMakeCurrent. If there is no current drawable, None is returned. glXGetCurrentDrawable returns client-side information. It does not make a round trip to the server. See Also glXCreateGLXPixmap, glXMakeCurrent Chapter 7 193 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 194
until glGetError is called, the error code is returned, and the flag is reset to GL_NO_ERROR. If a call to glGetError returns GL_NO_ERROR, there has been no than to set the error flag. GL_STACK_OVERFLOW This command would cause a stack overflow. The offending command is ignored, and has no other side - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 195
G glGetError There is not enough memory left to execute the command. The state of the GL is undefined, except for the state of the error flags, after this error is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 196
light pname params Specifies a light source. The number of possible lights depends on the implementation, but at least eight lights are supported. They are identified by symbolic names of the form GL_LIGHTi where 0 ≥ i < GL_MAX_LIGHTS. Specifies a light source parameter for light. Accepted symbolic - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 197
G glGetLight params returns four integer or floating-point values representing the diffuse intensity of the light source. Integer values, when requested, are linearly mapped from the internal floating-point representation such that 1.0 maps to the most positive representable integer value, and - 1.0 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 198
G glGetLight params returns a single integer or floating-point value representing the linear attenuation of the light. An integer value, when requested, is computed by rounding the internal floating-point representation to the nearest integer. The initial value is 0. GL_QUADRATIC_ATTENUATION params - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 199
Chapter 7 G glGetMap glGetMap glGetMapdv, glGetMapfv, glGetMapiv: return evaluator parameters. C Specification void glGetMapdv( GLenum target, GLenum query, GLdouble *v) void glGet GLenum target, GLenum query, GLfloat *v) void glGetMapiv( GLenum target, GLenum query, GLint *v) Parameters target - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 200
G glGetMap the type of the evaluator. The GL returns two-dimensional control points in row-major order, incrementing the uorder index quickly and the vorder index after each row. Integer values, when requested, are computed by rounding the internal floating-point values to the nearest integer values - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 201
G glGetMaterial glGetMaterial glGetMaterialfv, glGetMaterialiv: return material parameters. C Specification void glGetMaterialfv( GLenum face, GLenum pname, GLfloat *params) void glGetMaterialiv( GLenum face, GLenum pname, GLint *params) Parameters face pname params Specifies which of the two - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 202
G glGetMaterial params returns four integer or floating-point values representing the specular reflectance of the material. Integer values, when requested, are linearly mapped from the internal floating-point representation such that 1.0 maps to the most positive representable integer value, and - 1.0 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 203
G gluGetNurbsProperty gluGetNurbsProperty gluGetNurbsProperty: get a NURBS property. C Specification void gluGetNurbsProperty( GLUnurbs* nurb, GLenum property, GLfloat* data) Parameters nurb property data Specifies the NURBS object (created with gluNewNurbsRenderer). Specifies the property whose - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 204
integer value, and 0.0 maps to 0. Return unsigned integer values are undefined if the map value was not in the range [0, 1]. To determine the required size of map, call glGet with the appropriate symbolic constant. Notes If an error is generated, no change is made to the contents of values. Errors - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 205
G glGetPixelMap • GL_INVALID_OPERATION is generated if glGetPixelMap is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGet with argument GL_PIXEL_MAP_I_TO_I_SIZE glGet with argument GL_PIXEL_MAP_S_TO_S_SIZE glGet with argument - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 206
G glGetPointer glGetPointer glGetPointer: return the address of the specified pointer. C Specification void glGetPointerv( GLenum pname, GLvoid* *params) Parameters pname params Specifies the array or buffer pointer to be returned. Symbolic constants GL_COLOR_ARRAY_POINTER, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 207
glSelectBuffer, glTexCoordPointer, glVertexPointer G glGetPointer Chapter 7 207 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 208
the stipple pattern. The initial value is all 1's. Description glGetPolygonStipple returns to mask a 32 × 32 polygon stipple pattern. The pattern is packed into memory as if glReadPixels with both height and width of 32, type of GL_BITMAP, and format of GL_COLOR_INDEX were called, and the stipple - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 209
of the standard GL. These features may be implemented as extensions to the standard GL. The GL_EXTENSIONS string is a space-separated list of supported GL extensions. (Extension names never contain a space character.) The GL_VERSION string begins with a version number. The version number uses one of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 210
If an error is generated, glGetString returns 0. The client and server may support different versions or extensions. glGetString always returns a compatible version number or list of extensions. The release number always describes the server. Errors • GL_INVALID_ENUM is generated if name is not an - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 211
depend on the implementation. The standard GLU contains a basic set of features and capabilities. If a company or group of companies wish to support other features, these may be included as extensions to the GLU. If name is GLU_EXTENSIONS, then gluGetString returns a space-separated list of names - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 212
G gluGetTessProperty gluGetTessProperty gluGetTessProperty: get a tessellation object property. C Specification void gluGetTessProperty( GLUtesselator* tess, GLenum which, GLdouble* data) Parameters tess which data Specifies the tessellation object (created with gluNewTess). Specifies the property - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 213
that was specified with glTexEnv. target specifies a texture environment. Currently, only one texture environment is defined and supported: GL_TEXTURE_ENV. pname names a specific texture environment parameter, as follows: GL_TEXTURE_ENV_MODE params returns the single-valued texture environment mode - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 214
G glGetTexEnv GL_TEXTURE_LIGHTING_MODE_hp is only supported if the GL_hp_texture_lighting extension is supported. Errors • GL_INVALID_ENUM is generated if target or pname is not an accepted value. • GL_INVALID_OPERATION is generated if glGetTexEnv is executed between the execution of glBegin - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 215
G glGetTexGen glGetTexGen glGetTexGendv, glGetTexGenfv, glGetTexGeniv: return texture coordinate generation parameters. C Specification void glGetTexGendv( GLenum coord, GLenum pname, GLdouble *params) void glGetTexGenfv( GLenum coord, GLenum pname, GLfloat *params) void glGetTexGeniv( GLenum coord - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 216
G glGetTexGen params returns the four plane equation coefficients that specify eye linear-coordinate generation. Integer values, when requested, are mapped directly from the internal floating-point representation. The returned values are those maintained in eye coordinates. They are not equal to the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 217
mipmap reduction image. Specifies a pixel format for the returned data. The supported formats are GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_LUMINANCE, and four-component texture image to be an RGBA color buffer the size of the image. The semantics of glGetTexImage are then identical to - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 218
with red set to component zero, green set to component one, blue set to component two, and alpha set to 1. To determine the required size of pixels, use glGetTexLevelParameter to determine the dimensions of the internal texture image, then scale the required number of pixels by the storage required - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 219
image that can be accommodated with mipmaps and borders, but a long skinny texture, or a texture without mipmaps and borders, may easily fit in texture memory. The proxy targets allow the user to more accurately query whether the GL can accommodate a texture of a given configuration. If the texture - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 220
G glGetTexLevelParameter pname specifies the texture parameter whose value or values will be returned. The accepted parameter names are as follows: GL_TEXTURE_WIDTH params returns a single value, the width of the texture image. This value includes the border of the texture image. The initial value is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 221
glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexSubImage1D, glTexSubImage2D, glTexParameter G glGetTexLevelParameter Chapter 7 221 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 222
G glGetTexParameter glGetTexParameter glGetTexParameterfv, glGetTexParameteriv: return texture parameter values. C Specification void glGetTexParameterfv( GLenum target, GLenum pname, GLfloat *params) void glGetTexParameteriv( GLenum target, GLenum pname, GLint *params) Parameters target pname - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 223
texture is resident in texture memory. See glAreTexturesResident. Notes supported. GL_GENERATE_MIPMAP_EXT is only supported if the extension GL_EXT_generate_mipmap is supported. GL_TEXTURE_COMPARE_EXT and GL_TEXTURE_COMPARE_OPERATOR_EXT are only supported if the extension GL_EXT_shadow is supported - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 224
G glGetTexParameter See Also glAreTexturesResident, glPrioritizeTextures, glTexParameter 224 Chapter 7 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 225
8 H Chapter 8 225 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 226
semantics, are as follows: GL_FOG_HINT Indicates the accuracy of fog calculation. If per-pixel fog calculation is not efficiently supported by the GL implementation, hinting GL_DONT_CARE or GL_FASTEST can result in per-vertex calculation of fog effects. GL_LINE_SMOOTH_HINT Indicates the sampling - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 227
GL_PERSPECTIVE_CORRECTION_HINT Indicates the quality of color and texture coordinate interpolation. If perspective-corrected parameter interpolation is not efficiently supported by the GL implementation, hinting GL_DONT_CARE or GL_FASTEST can result in simple linear interpolation of colors and/or - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 228
H glHint 228 Chapter 8 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 229
9 I Chapter 9 229 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 230
I glIndex glIndex glIndexd, glIndexf, glIndexi, glIndexs, glIndexub, glIndexdv, glIndexfv, glIndexiv, glIndexsv, glIndexubv: set the current color index. C Specification void glIndexd( GLdouble c) void glIndexf( GLfloat c) void glIndexi( GLint c) void glIndexs( GLshort c) void glIndexub( GLubyte c) - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 231
I glIndex Notes glIndexub and glIndexubv are available only if the GL version is 1.1 or greater. The current index can be updated at any time. In particular, glIndex can be called between a call to glBegin and the corresponding call to glEnd. Associated Gets glGet with argument GL_CURRENT_INDEX See - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 232
I glIndexMask glIndexMask glIndexMask: control the writing of individual bits in the color index buffers. C Specification void glIndexMask( GLuint mask) Parameters mask Specifies a bit mask to enable and disable the writing of individual bits in the color index buffers. Initially, the mask is all - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 233
Chapter 9 I glIndexPointer glIndexPointer glIndexPointer: define an array of color indexes. C Specification void glIndexPointer( GLenum type, GLsizei stride, const GLvoid *pointer) Parameters type array stride pointer Specifies the data type of each color index in the Symbolic constants - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 234
I glIndexPointer glIndexPointer is typically implemented on the client side. Since the color index array parameters are client-side state, they are not saved or restored by glPushAttrib and glPopAttrib. Use glPushClientAttrib and glPopClientAttrib instead. Errors • GL_INVALID_ENUM is generated if - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 235
commands to be uniquely identified. It consists of an ordered set of unsigned integers. glInitNames causes the name stack to be initialized to its default empty state. The name stack is always empty while the render mode is not GL_SELECT. Calls to glInitNames while the render mode is not GL_SELECT - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 236
I glInterleavedArrays glInterleavedArrays glInterleavedArrays: simultaneously specify and enable several interleaved arrays. C Specification void glInterleavedArrays( GLenum format, GLsizei stride, const GLvoid *pointer) Parameters format stride Specifies the type of array to enable. Symbolic - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 237
I glInterleavedArrays Vertex array parameters are client-side state and are therefore not saved or restored by glPushAttrib and glPopAttrib. Use glPushClientAttrib and glPopClientAttrib instead. Errors • GL_INVALID_ENUM is generated if format is not an accepted value. • GL_INVALID_VALUE is generated - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 238
determine whether the GLX extension is supported by an X server, and if so, what version is supported, call glXQueryExtension and glXQueryVersion. GLX extended servers make a subset of their visuals available for OpenGL rendering. Drawables created with these visuals can also be rendered using the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 239
glXIntro GLX_RGBA, GLX_DOUBLE_BUFFER, /*In case single buffering is not supported*/ GLX_RED_SIZE, 1, GLX_GREEN_SIZE, 1, GLX_BLUE_SIZE, 1, None}; static get a connection */ dpy = XOpenDisplay(0); /* get an appropriate visual */ vi = glXChooseVisual(dpy, DefaultScreen(dpy), attributeListSgl); if (vi - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 240
may be damaged and should be repainted. Although certain buffers of some visuals on some systems may never require repainting (the depth buffer, for returns the version that is supported on the connection. Thus if 1.2 is returned, both the client and server support GLX 1.2. You can also - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 241
glXCreateGLXPixmap, glXDestroyContext, glXGetClientString, glXGetConfig, glXIsDirect, glXMakeCurrent, glXQueryExtension, glXQueryExtensionsString, glXQueryServerString, glXQueryVersion, glXSwapBuffers, glXUseXFont, glXWaitGL, glXWaitX, XCreateColormap, XCreateWindow, XSync I glXIntro Chapter 9 241 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 242
whether direct rendering is enabled. C Specification Bool glXIsDirect( Display *dpy, GLXContext ctx) Parameters dpy Specifies the connection to the X server. ctx Specifies the GLX context that is being queried. Description glXIsDirect returns True if ctx is a direct rendering context, False - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 243
Chapter 9 I glIsEnabled glIsEnabled glIsEnabled: test whether a capability is enabled. C Specification GLboolean glIsEnabled( GLenum cap) Parameters cap Specifies a symbolic constant indicating a GL capability. Description glIsEnabled returns GL_TRUE if cap is an enabled capability and returns - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 244
glPolygonOffset glPolygonOffset glPolygonOffset glPolygonStipple glEnable glScissor glStencilFunc, glStencilOp glTexImage1D glTexImage2D (if 3D texturing is supported) glTexImage3DEXT glTexCoordPointer glTexGen glTexGen glTexGen glTexGen glVertexPointer Notes If an error is generated, glIsEnabled - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 245
I glIsEnabled GL_COLOR_LOGIC_OP, GL_COLOR_ARRAY, GL_EDGE_FLAG_ARRAY, GL_INDEX_ARRAY, GL_INDEX_LOGIC_OP, GL_NORMAL_ARRAY, GL_POLYGON_OFFSET_FILL,GL_POLYGON_OFFSET_LINE, GL_POLYGON_OFFSET_POINT, GL_TEXTURE_COORD_ARRAY, and GL_VERTEX_ARRAY are only available if the GL version is 1.1 or greater Errors • - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 246
I glIsList glIsList glIsList: determine if a name corresponds to a display-list. C Specification GLboolean glIsList( GLuint list) Parameters list Specifies a potential display-list name. Description glIsList returns GL_TRUE if list is the name of a display list and returns GL_FALSE otherwise. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 247
I glIsTexture glIsTexture glIsTexture: determine if a name corresponds to a texture. C Specification GLboolean glIsTexture( GLuint texture) Parameters texture Specifies a value that may be the name of a texture. Description glIsTexture returns GL_TRUE if texture is currently the name of a - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 248
I glIsTexture 248 Chapter 9 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 249
10 L Chapter 10 249 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 250
light source light will be set to. Specifies a light. The number of lights depends on the implementation, but at least eight lights are supported. They are identified by symbolic names of the form GL_LIGHTi where 0 ≥i < GL_MAX_LIGHTS. Specifies a light source parameter for light. GL_AMBIENT, GL_DIFFUSE - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 251
Chapter 10 L glLight Description glLight sets the values of individual light source parameters. light names the light and is a symbolic name of the form GL_LIGHTi, where 0 ≥ i < GL_MAX_LIGHTS. pname specifies one of ten light source parameters, again by symbolic name. params is either a single value - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 252
cosine of the angle between the direction of the light and the direction from the light to the vertex being lighted, raised to the power of the spot exponent. Thus, higher spot exponents result in a more focused light source, regardless of the spot cutoff angle (see GL_SPOT_CUTOFF, next paragraph - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 253
Associated Gets glGetLight glIsEnabled with argument GL_LIGHTING See Also glColorMaterial, glLightModel, glMaterial L glLight Chapter 10 253 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 254
GLfloat *params) void glLightModeliv( GLenum pname, const GLint *params) Parameters pname param pname params Specifies a single-valued lighting model parameter. GL_LIGHT_MODEL_LOCAL_VIEWER and GL_LIGHT_MODEL_TWO_SIDE are accepted. Specifies the value that param will be set to. Specifies a lighting - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 255
, the product of the material ambient reflectance and the lighting model full-scene ambient intensity, and the contribution of each enabled light normalized vertex-to-eye and vertex-to-light vectors, raised to the power of the shininess of the material. All three light source contributions are - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 256
L glLightModel See Also glLight, glMaterial 256 Chapter 10 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 257
in the pattern is used. factor is clamped to the range [1, 256] and defaults to 1. Specifies a 16-bit integer whose bit pattern determines which fragments of the repeat count factor, and an integer stipple counter s. Counter s is reset to 0 whenever glBegin is called, and before each line segment of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 258
L glLineStipple Associated Gets glGet with argument GL_LINE_STIPPLE_PATTERN glGet with argument GL_LINE_STIPPLE_REPEAT glIsEnabled with argument GL_LINE_STIPPLE See Also glLineWidth, glPolygonStipple 258 Chapter 10 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 259
disabled, the actual width is determined by rounding the supplied width to the nearest integer. (If the rounding supported width is used. Only width 1 is guaranteed to be supported; others depend on the implementation. To query the range of supported widths and the size difference between supported - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 260
L glLineWidth • GL_INVALID_OPERATION is generated if glLineWidth is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGet with argument GL_LINE_WIDTH glGet with argument GL_LINE_WIDTH_RANGE glGet with argument GL_LINE_WIDTH_GRANULARITY glIsEnabled - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 261
L glListBase glListBase glListBase: set the display-list base for glCallLists. C Specification void glListBase( GLuint base) Parameters base Specifies an integer offset that will be added to glCallLists offsets to generate display-list names. The initial value is 0. Description glCallLists speci - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 262
L glLoadIdentity glLoadIdentity glLoadIdentity: replace the current matrix with the identity matrix. C Specification void glLoadIdentity(void) Description glLoadIdentity replaces the current matrix with the identity matrix. It is semantically equivalent to calling glLoadMatrix with the identity - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 263
L glLoadMatrix glLoadMatrix glLoadMatrixd, glLoadMatrixf: replace the current matrix with the specified matrix. C Specification void glLoadMatrixd( const GLdouble *m) void glLoadMatrixf( const GLfloa *m) Parameters m Specifies a pointer to 16 consecutive values, which are used as the elements of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 264
L glLoadMatrix Associated Gets glGet with argument GL_MATRIX_MODE glGet with argument GL_MODELVIEW_MATRIX glGet with argument GL_PROJECTION_MATRIX glGet with argument GL_TEXTURE_MATRIX See Also glLoadIdentity, glMatrixMode, glMultMatrix, glPushMatrix 264 Chapter 10 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 265
. It consists of an ordered set of unsigned integers. glLoadName causes name to replace the value on the top of the name stack, which is initially empty. The name stack is always empty while the render mode is not GL_SELECT. Calls to glLoadName while the render mode is not GL_SELECT are ignored - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 266
fies a viewport (as from a glGetIntegerv call). Description gluLoadSamplingMatrices uses model, perspective, and view to recompute the sampling and culling matrices stored performance penalty for doing so. (A round trip to the GL server is needed to fetch the current values of the modelview matrix, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 267
L glLogicOp Chapter 10 glLogicOp glLogicOp: specify a logical pixel operation for color index rendering. C Specification void glLogicOp( GLenum opcode) Parameters opcode Specifies a symbolic constant that selects a logical operation. The following symbols are accepted: GL_CLEAR, GL_SET, GL_COPY, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 268
is applied independently to each bit pair of the source and destination indices or colors. Notes Color index logical operations are always supported. RGBA logical operations are supported only if the GL version is 1.1 or greater. When more than one RGBA color or index buffer is enabled for drawing - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 269
L gluLookAt Chapter 10 gluLookAt gluLookAt: define a viewing transformation. C Specification void gluLookAt( GLdouble eyeX. GLdouble eyeY, GLdouble eyeZ, GLdouble centerX, GLdouble centerY, GLdouble centerZ, GLdouble upX, GLdouble upY, GLdouble upZ) Parameters eyeX, eyeY, eyeZ Specifies the position - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 270
L gluLookAt M = s[0] s[1] s[2] 0 u[0] u[1] u[2] 0 - f[0 - f[1]- f[2] 0 0 0 01 and gluLookAt is equivalent to glMultMatrixf(M); glTranslated (-eyex, -eyey, -eyez); See Also glFrustum, gluPerspective 270 Chapter 10 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 271
11 M Chapter 11 271 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 272
dpy drawable ctx Specifies the connection to the X server. Specifies a GLX drawable. Must be either an thread, its viewport is set to the full size of drawable. Subsequent calls by any thread to address space, but maintain separate program counters, stack spaces, and other related global data. A - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 273
generated if drawable was not created with the same X screen and visual as ctx. It is also generated if drawable is None and ctx is a window that is no longer valid. • BadAlloc may be generated if the server has delayed allocation of ancillary buffers until glXMakeCurrent is called, only to find that - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 274
points to be embedded in arbitrary data structures. The only constraint is that the values for a particular control point must occupy contiguous memory locations. Specifies the number of control points. Must be positive. Specifies a pointer to the array of control points. Description Evaluators - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 275
M glMap1 Equation 11-1 All polynomial or rational polynomial splines of any degree (up to the maximum degree supported by the GL implementation) can be described using evaluators. These include almost all splines used in compute graphics: B-splines, Bezier curves, Hermite splines, and so - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 276
the array addressing for accessing the control points. points is the location of the first control point, which occupies one, two, three, or four contiguous memory locations, depending on which map is being defined. order is the number of control points in the array. stride specifies how many float - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 277
M glMap1 • GL_INVALID_VALUE is generated if order is less than 1 or greater than the return value of GL_MAX_EVAL_ORDER. • GL_INVALID_OPERATION is generated if glMap1 is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGetMap glGet with argument - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 278
allows control points to be embedded in arbitrary data structures. The only constraint is that the values for a particular control point must occupy contiguous memory locations. The initial value of ustride is 0. Specifies the dimension of the control point array in the u axis. Must be positive. The - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 279
only constraint is that the values for a particular control point must occupy contiguous memory locations. The initial value of vstride is 0. Specifies the dimension of polynomial splines of any degree (up to the maximum degree supported by the GL implementation) can be described using evaluators. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 280
M glMap2 Equation 11-8 Equation 11-9 00 ≡ 1and n 0 ≡ 1 glMap2 is used to define the basis and to specify what kind of values are produced. Once defined, a map can be enabled and disabled by calling glEnable and glDisable with the map name, one of the nine predefined values for target, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 281
array addressing for accessing the control points. points is the location of the first control point, which occupies one, two, three, or four contiguous memory locations, depending on which map is being defined. There are uorder× vorder control points in the array. ustride specifies how many float or - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 282
M glMap2 Associated Gets glGetMap glGet with argument GL_MAX_EVAL_ORDER glIsEnabled with argument GL_MAP2_VERTEX_3 glIsEnabled with argument GL_MAP2_VERTEX_4 glIsEnabled with argument GL_MAP2_INDEX glIsEnabled with argument GL_MAP2_COLOR_4 glIsEnabled with argument GL_MAP2_NORMAL glIsEnabled with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 283
M glMapGrid glMapGrid glMapGrid1d, glMapGrid1f, glMapGrid2d, glMapGrid2f: define a one- or two-dimensional mesh. C Specification void glMapGrid1d( GLint un, GLdouble u1, GLdouble u2) void glMapGrid1f( GLint un, GLfloat u1, GLfloat u2) void glMapGrid2d( GLint un, GLdouble u1, GLdouble u2, GLint vn, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 284
M glMapGrid glMapGrid1 and glMapGrid2 specify the linear grid mappings between the i (or i and j) integer grid coordinates, to the u (or u and v) floating-point evaluation map coordinates. See glMap1 and glMap2 for details of how u and v coordinates are evaluated. glMapGrid1 specifies a single linear - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 285
M glMaterials glMaterials glMaterialf, glMateriali, glMaterialfv, glMaterialiv: specify material parameters for the lighting model. C Specification void glMaterialf( GLenum face, GLenum pname, GLfloat param) void glMateriali( GLenum face, GLenum pname, GLint param) void glMaterialfv( GLenum face, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 286
M glMaterials 286 glMaterial takes three arguments. The first, face, specifies whether the GL_FRONT materials, the GL_BACK materials, or both GL_FRONT_AND_BACK materials will be modified. The second, pname, specifies which of several parameters in one or both sets will be modified. The third, params, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 287
M glMaterials params contains three integer or floating-point values specifying the color indices for ambient, diffuse, and specular lighting. These three values, and GL_SHININESS, are the only material values used by the color index mode lighting equation. Refer to the glLightModel reference page - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 288
: specify which matrix is the current matrix. C Specification void glMatrixMode( GLenum mode) Parameters mode Specifies which matrix stack is the target for subsequent matrix operations. Three values are accepted: GL_MODELVIEW, GL_PROJECTION, and GL_TEXTURE. The initial value is GL_MODELVIEW - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 289
M glMultMatrix Chapter 11 glMultMatrix glMultMatrixd, glMultMatrixf: multiply the current matrix with the specified matrix. C Specification void glMultMatrixd( const GLdouble *m) void glMultMatrixf( const GLfloat *m) Parameters m Points to 16 consecutive values that are used as the elements of a - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 290
M glMultMatrix In many computer languages, 4 × 4 arrays are represented in row-major order. The transformations just described represent these matrices in column-major order. The order of the multiplication is important. For example, if the current transformation is a rotation, and glMultMatrix is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 291
12 N Chapter 12 291 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 292
N glNewList glNewList glNewList, glEndList: create or replace a display list. C Specification void glNewList( GLuint list, GLenum mode) void glEndList(void) Parameters list mode Specifies the display-list name. Specifies the compilation mode, which can be GL_COMPILE or GL_COMPILE_AND_EXECUTE. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 293
if glNewList or glEndList is executed between the execution of glBegin and the corresponding execution of glEnd. • GL_OUT_OF_MEMORY is generated if there is insufficient memory to compile the display list. If the GL version is 1.1 or greater, no change is made to the previous contents of the display - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 294
N glNextVisibilityTesthp glNextVisibilityTesthp glNextVisibilityTesthp - end the current visibility test and begin the next. C Specification void glNextVisibilityTesthp(void) Parameters None Description glNextVisibilityTesthp is used in conjunction with glVisibilityBufferhp to test the visibility of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 295
. This object must be referred to when calling NURBS rendering and control functions. A return value of 0 means that there is not enough memory to allocate the object. See Also gluBeginCurve, gluBeginSurface, gluBeginTrim, gluDeleteNurbsRenderer, gluNurbsCallback, gluNurbsProperty Chapter 12 295 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 296
calling quadrics rendering and control functions. A return value of 0 means that there is not enough memory to allocate the object. See Also gluCylinder, gluDeleteQuadric, gluDisk, gluPartialDisk, gluQuadricCallback, gluQuadricDrawStyle, gluQuadricNormals, gluQuadricOrientation, gluQuadricTexture - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 297
returns a pointer to a new tessellation object. This object must be referred to when calling tessellation functions. A return value of 0 means that there is not enough memory to allocate the object. See Also gluTessBeginPolygon, gluDeleteTess, gluTessCallback Chapter 12 297 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 298
N gluNextContour gluNextContour gluNextContour: mark the beginning of another contour. C Specification void gluNextContour( GLUtesselator* tess, GLenum type) Parameters tess Specifies the tessellation object (created with gluNewTess). type Specifies the type of the contour being defined. Valid - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 299
N gluNextContour Before the first contour is described, gluNextContour can be called to define the type of the first contour. If gluNextContour is not called before the first contour, then the first contour is marked GLU_EXTERIOR. This command is obsolete and is provided for backward compatibility only. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 300
N glNormal glNormal glNormal3b, glNormal3d, glNormal3f, glNormal3i, glNormal3s, glNormal3bv, glNormal3dv, glNormal3fv, glNormal3iv, glNormal3sv: set the current normal vector. C Specification void glNormal3b( GLbyte nx, GLbyte ny, GLbyte nz) void glNormal3d( GLdouble nx, GLdouble ny, GLdouble nz) - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 301
N glNormal Description The current normal is set to the given coordinates whenever glNormal is issued. Byte, short, or integer arguments are converted to floating-point format with a linear mapping that maps the most positive representable integer value to 1.0, and the most negative representable - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 302
N glNormalPointer glNormalPointer glNormalPointer: define an array of normals. C Specification void glNormalPointer( GLenum type, GLsizei stride, const GLvoid *pointer) Parameters type stride pointer Specifies the data type of each coordinate in the array. Symbolic constants GL_BYTE, GL_SHORT, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 303
N glNormalPointer glNormalPointer is typically implemented on the client side. Since the normal array parameters are client-side state, they are not saved or restored by glPushAttrib and glPopAttrib. Use glPushClientAttrib and glPopClientAttrib instead. Errors • GL_INVALID_ENUM is generated if type - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 304
N gluNurbsCallback gluNurbsCallback gluNurbsCallback: define a callback for a NURBS object. C Specification void gluNurbsCallback( GLUnurbs* nurb, GLenum which, GLvoid (*CallBackFunc)() Parameters nurb which CallBackFunc Specifies the NURBS object (created with gluNewNurbsRenderer). Specifies the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 305
N gluNurbsCurve gluNurbsCurve gluNurbsCurve: define the shape of a NURBS curve. C Specification void gluNurbsCurve( GLUnurbs* nurb, GLint knotCount, GLfloat *knots, GLint stride, GLfloat *control, GLint order, GLenum type) Parameters nurb knotCount knots stride control order type Specifies the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 306
N gluNurbsCurve When gluNurbsCurve appears between a gluBeginTrim/gluEndTrim pair, it is used to describe a trimming curve on a NURBS surface. If type is GLU_MAP1_TRIM_2, then it describes a curve in two-dimensional (u and v) parameter space. If it is GLU_MAP1_TRIM_3, then it describes a curve in - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 307
N gluNurbsPrperty gluNurbsPrperty gluNurbsProperty: set a NURBS property. C Specification void gluNurbsProperty( GLUnurbs* nurb, GLenum property, GLfloat value) Parameters nurb property value Specifies the NURBS object (created with gluNewNurbsRenderer). Specifies the property to be set. Valid - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 308
is a boolean value. When set to GL_TRUE, the NURBS code downloads the projection matrix, the modelview matrix, and the viewport from the GL server to compute sampling and culling matrices for each NURBS curve that is rendered. Sampling and culling matrices are required to determine the tesselation - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 309
N gluNurbsPrperty A property of GLU_PARAMETRIC_TOLERANCE, GLU_SAMPLING_METHOD, GLU_U_STEP, or GLU_V_STEP, or a value of GLU_PATH_LENGTH, GLU_PARAMETRIC_ERROR, GLU_DOMAIN_DISTANCE are only available if the GLU version is 1.1 or greater. They are not valid parameters in GLU 1.0. gluGetString can be - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 310
N gluNurbsSurface gluNurbsSurface gluNurbsSurface: define the shape of a NURBS surface. C Specification void gluNurbsSurface( GLUnurbs* nurb, GLint sKnotCount, GLfloat* sKnots, GLint tKnotCount, GLfloat* tKnots, GLint sStride, GLint tStride, GLfloat* control, GLint sOrder, GLint tOrder, GLenum type) - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 311
N gluNurbsSurface Description Use gluNurbsSurface within a NURBS (Non-Uniform Rational B-Spline) surface definition to describe the shape of a NURBS surface (before any trimming). To mark the beginning of a NURBS surface definition, use the gluBeginSurface command. To mark the end of a NURBS surface - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 312
N gluNurbsSurface 312 Chapter 12 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 313
13 O Chapter 13 313 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 314
O glOrtho glOrtho glOrtho: multiply the current matrix with an orthographic matrix. C Specification void glOrtho( GLdouble left, GLdouble right, GLdouble bottom, GLdouble top, GLdouble zNear, GLdouble zFar) Parameters left, right bottom, top zNear, zFar Specify the coordinates for the left and - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 315
plane. Both zNear and zFar can be either positive or negative. Use glPushMatrix and glPopMatrix to save and restore the current matrix stack. Errors • GL_INVALID_OPERATION is generated if glOrtho is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 316
O gluOrtho2D gluOrtho2D gluOrtho2D: define a 2D orthographic projection matrix. C Specification void gluOrtho2D( GLdouble left, GLdouble right, GLdouble bottom, GLdouble top) Parameters left, right bottom, top Specify the coordinates for the left and right vertical clipping planes. Specify the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 317
14 P Chapter 14 317 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 318
P gluPartialDisk gluPartialDisk gluPartialDisk: draw an arc of a disk. C Specification void gluPartialDisk( GLUquadric* quad, GLdouble inner, GLdouble outer, GLint slices, GLint loops, GLdouble start, GLdouble sweep) Parameters quad inner outer slices loops start sweep Specifies a quadrics object - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 319
See Also gluCylinder, gluDisk, gluNewQuadric, gluQuadricOrientation, gluQuadricTexture, gluSphere P gluPartialDisk Chapter 14 319 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 320
P glPassThrough glPassThrough glPassThrough: place a marker in the feedback buffer. C Specification void glPassThrough( GLfloat token) Parameters token Specifies a marker value to be placed in the feedback buffer following a GL_PASS_THROUGH_TOKEN. Description Feedback is a GL render mode. The - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 321
by the current matrix, just as if glMultMatrix were called with the generated matrix. To load the perspective matrix onto the current matrix stack instead, precede the call to gluPerspective with a call to glLoadIdentity. Given f defined as cotangent(fovy / 2), the generated matrix is A000 0f 00 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 322
P gluPerspective Notes Depth buffer precision is affected by the values specified for zNear and zFar. The greater the ratio of zFar to zNear is, the less effective the depth buffer will be at distinguishing between surfaces that are near each other. If r = zFar / zNear, roughly log2 r bits of depth - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 323
matrix. To effectively use the generated pick matrix for picking, first call glLoadIdentity to load an identity matrix onto the perspective matrix stack. Then call gluPickMatrix, and finally, call a command (such as gluPerspective) to multiply the perspective matrix by the pick matrix. When using - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 324
GL_PIXEL_MAP_S_TO_S, GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B, GL_PIXEL_MAP_I_TO_A, GL_PIXEL_MAP_R_TO_R, GL_PIXEL_MAP_G_TO_G, GL_PIXEL_MAP_B_TO_B, or GL_PIXEL_MAP_A_TO_A. Specifies the size of the map being defined. Specifies an array of mapsize values. Description glPixelMap sets - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 325
0s to the right of the binary point. The following table shows the initial sizes and values for each of the maps. Maps that are indexed by either color 2n for some n or the results are undefined. The maximum allowable size for each map depends on the implementation and can be determined by calling - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 326
Index color index stencil index color index color index color index color index R G B A Lookup Value Initial Size color index 1 stencil 1 index R 1 G 1 B 1 A 1 R 1 G 1 B 1 A 1 or GL_PIXEL_MAP_I_TO_A, and mapsize is not a power of two. • GL_INVALID_OPERATION is generated if - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 327
glGet with argument GL_PIXEL_MAP_B_TO_B_SIZE glGet with argument GL_PIXEL_MAP_A_TO_A_SIZE glGet with argument GL_MAX_PIXEL_MAP_TABLE See Also glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glPixelStore, glPixelTransfer, glReadPixels, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 328
parameter to be set, and param is the new value. Six of the twelve storage parameters affect how pixel data is returned to client memory, and are therefore significant only for glReadPixels commands. They are as follows: GL_PACK_SWAP_BYTES If true, byte ordering for multibyte color components, depth - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 329
row. If the first pixel of a row is placed at location p in memory, then the location of the first pixel of the next row is obtained by to the pixel routine otherwise), a is the value of GL_PACK_ALIGNMENT, and s is the size, in bytes, of a single component (if a - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 330
row. If the first pixel of a row is placed at location p in memory, then the location of the first pixel of the next row is obtained by to the pixel routine otherwise), a is the value of GL_UNPACK_ALIGNMENT, and s is the size, in bytes, of a single component (if a - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 331
per row, as just computed in the GL_UNPACK_ROW_LENGTH section. GL_UNPACK_ALIGNMENT Specifies the alignment requirements for the start of each pixel row in memory. The allowable values are 1 (byte-alignment), 2 (rows aligned to even-numbered bytes), 4 (word-alignment), and 8 (rows start on double-word - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 332
P glPixelStore Errors • GL_INVALID_ENUM is generated if pname is not an accepted value. • GL_INVALID_VALUE is generated if a negative row length, pixel skip, or row skip value is specified, or if alignment is specified as other than 1, 2, 4, or 8. • GL_INVALID_OPERATION is generated if glPixelStore - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 333
of pixels being written back into client memory. Pixel transfer operations handle four fundamental pixel types: color, color index, depth, and stencil. Color pixels consist of four floating-point values with unspecified mantissa and exponent sizes, scaled such that 0 represents zero intensity and - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 334
glPixelTransfer. If GL_MAP_COLOR is true, each color component is scaled by the size of the corresponding color-to-color map, then replaced by the contents of color index buffer, or if they are being read back to client memory in GL_COLOR_INDEX format, the pixels continue to be treated as indices. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 335
Chapter 14 P glPixelTransfer Each index is shifted GL_INDEX_SHIFT bits just as a color index is, then added to GL_INDEX_OFFSET. If GL_MAP_STENCIL is true, each index is masked by 2n - 1, where n is GL_PIXEL_MAP_S_TO_S_SIZE, then replaced by the contents of GL_PIXEL_MAP_S_TO_S indexed by the masked - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 336
P glPixelTransfer Errors • GL_INVALID_ENUM is generated if pname is not an accepted value. • GL_INVALID_OPERATION is generated if glPixelTransfer is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGet with argument GL_MAP_COLOR glGet with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 337
P glPixelZoom glPixelZoom glPixelZoom: specify the pixel zoom factors. C Specification void glPixelZoom( GLfloat xfactor, GLfloat yfactor) Parameters xfactor, yfactor Specify the x and y zoom factors for pixel write operations. Description glPixelZoom specifies values for the x and y zoom factors. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 338
, the actual size is determined by rounding the supplied size to the nearest size is requested, the nearest supported size is used. Only size 1 is guaranteed to be supported; others depend on the implementation. To query the range of supported sizes and the size difference between supported sizes - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 339
GL_POINT_SIZE is queried. Clamping and rounding for aliased and anti-aliased points have no effect on the specified value. A non-anti-aliased point size may be clamped to an implementation-dependent maximum. Although this maximum cannot be queried, it must be no less than the maximum value for anti - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 340
as line segments. They are treated as connected line segments for line stippling; the line stipple counter and pattern are not reset between segments (see glLineStipple). Line attributes such as GL_LINE_WIDTH and GL_LINE_SMOOTH control the rasterization of the lines. Polygon rasterization attributes - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 341
P glPolygonMode Examples To draw a surface with filled back-facing polygons and outlined front-facing polygons, call glPolygonMode(GL_FRONT, GL_LINE); Notes Vertices are marked as boundary or non-boundary with an edge flag. Edge flags are generated internally by the GL when it decomposes polygons; they - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 342
P glPolygonOffset glPolygonOffset glPolygonOffset: set the scale and bias used to calculate depth values. C Specification void glPolygonOffset( GLfloat factor, GLfloat units) Parameters factor units Specifies a scale factor that is used to create a variable depth offset for each polygon. The - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 343
See Also glDepthFunc, glDisable, glEnable, glGet, glIsEnabled, glLineWidth, glStencilOp, glTexEnv P glPolygonOffset Chapter 14 343 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 344
a pattern. Stippling is independent of polygon anti-aliasing. *mask is a pointer to a 32 × 32 stipple pattern that is stored in memory just like the pixel data supplied to a glDrawPixels call with height and width both equal to 32, a pixel format of GL_COLOR_INDEX, and data type of GL_BITMAP. That - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 345
See Also glDrawPixels, glLineStipple, glPixelStore, glPixelTransfer P glPolygonStipple Chapter 14 345 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 346
"working set" of textures that are resident in texture memory. These textures may be bound to a texture target each texture, glPrioritizeTextures allows applications to guide the GL implementation in determining which priority of a default texture. Notes glPrioritizeTextures is available only if the GL version - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 347
P glPrioritizeTextures Errors • GL_INVALID_VALUE is generated if n is negative. • GL_INVALID_OPERATION is generated if glPrioritizeTextures is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGetTexParameter with parameter name GL_TEXTURE_PRIORITY - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 348
GLdouble* winZ) Parameters objA, objY, objZ Specify the object coordinates. model Specifies the current modelview matrix (as from a glGetDoublev call). gluProject transforms the specified object coordinates into window coordinates using model, proj, and view. The result is stored in winX, winY - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 349
glPushAttrib glPushAttrib glPushAttrib, glPopAttrib: push and pop the server attribute stack. C Specification void glPushAttrib( GLbitfield mask) mask that indicates which groups of state variables to save on the attribute stack. Symbolic constants are used to set bits in the mask. mask is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 350
P glPushAttrib GL_CURRENT_BIT GL_DEPTH_BUFFER_BIT GL_ENABLE_BIT Current RGBA color Current color index Current normal vector Current texture coordinates Current raster position GL_CURRENT_RASTER_POSITION_VALID flag RGBA color associated with current raster position Color index associated with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 351
GL_EVAL_BIT GL_FOG_BIT GL_HINT_BIT GL_LIGHTING_BIT GL_LINE_BIT GL_LIST_BIT P glPushAttrib GL_MAP1_x enable bits, where x is a map type GL_MAP2_x enable bits, where x is a map type 1D grid endpoints and divisions 2D grid endpoints and divisions GL_AUTO_NORMAL enable bit GL_FOG enable bit Fog color - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 352
values GL_MAP_COLOR and GL_MAP_STENCIL flags GL_ZOOM_X and GL_ZOOM_Y factors GL_READ_BUFFER setting GL_POINT_SMOOTH flag Point size GL_CULL_FACE enable bit GL_CULL_FACE_MODE value GL_FRONT_FACE indicator GL_POLYGON_MODE setting GL_POLYGON_SMOOTH flag GL_POLYGON_STIPPLE enable bit GL_POLYGON_OFFSET_FILL - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 353
, render mode state, and select and feedback state cannot be saved. Client state must be saved with glPushClientAttrib. The depth of the attribute stack depends on the implementation, but it must be at least 16. Errors • GL_STACK_OVERFLOW is generated if glPushAttrib is called while the attribute - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 354
P glPushAttrib Associated Gets glGet with argument GL_ATTRIB_STACK_DEPTH glGet with argument GL_MAX_ATTRIB_STACK_DEPTH See Also glGet, glGetClipPlane, glGetError, glGetLight, glGetMap, glGetMaterial, glGetPixelMap, glGetPolygonStipple, glGetString, glGetTexEnv, glGetTexGen, glGetTexImage, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 355
, select and feedback state cannot be saved. The depth of the attribute stack depends on the implementation, but it must be at least 16. Use glPushAttrib and glPopAttrib to push and restore state which is kept on the server. Only pixel storage modes and vertex array state may be pushed and popped - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 356
Errors • GL_STACK_OVERFLOW is generated if glPushClientAttrib is called while the attribute stack is full. • GL_STACK_UNDERFLOW is generated if glPopClientAttrib is called while the attribute stack is empty. Associated Gets glGet with argument GL_ATTRIB_STACK_DEPTH glGet with argument - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 357
two modes, GL_PROJECTION and GL_TEXTURE, the depth is at least 2. The current matrix in any mode is the matrix on the top of the stack for that mode. glPushMatrix pushes the current matrix stack down by one, duplicating the current matrix. That is, after a glPushMatrix call, the matrix on top of the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 358
P glPushMatrix See Also glFrustum, glLoadIdentity, glLoadMatrix, glMatrixMode, glMultMatrix, glOrtho, glRotate, glScale, glTranslate, glViewport 358 Chapter 14 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 359
corresponding execution of glEnd. In any of these cases, the error flag is set and no other change is made to GL state. The name stack is always empty while the render mode is not GL_SELECT. Calls to glPushName or glPopName while the render mode is not GL_SELECT are ignored. Errors - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 360
P glPushName See Also glInitNames, glLoadName, glRenderMode, glSelectBuffer 360 Chapter 14 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 361
P gluPwlCurve Chapter 14 gluPwlCurve gluPwlCurve: describe a piece-wise linear NURBS trimming curve. C Specification void gluPwlCurve( GLUnurbs* nurb, GLint count, GLfloat* data, GLint stride, GLenum type) Parameters nurb count data stride type Specifies the NURBS object (created with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 362
P gluPwlCurve 362 Chapter 14 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 363
15 Q Chapter 15 363 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 364
Q gluQuadricCallback gluQuadricCallback gluQuadricCallback: define a callback for a quadrics object. C Specification void gluQuadricCallback( GLUquadric* quad, GLenum which, GLvoid (*CallBackFunc)() Parameters quad which CallBackFunc Specifies the quadrics object (created with gluNewQuadric). - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 365
Q gluQuadricDrawStyle gluQuadricDrawStyle gluQuadricDrawStyle: specify the draw style desired for quadrics. C Specification void gluQuadricDrawStyle( GLUquadric* quad, GLenum draw) Parameters quad draw Specifies the quadrics object (created with gluNewQuadric). Specifies the desired draw style. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 366
Q gluQuadricNormals gluQuadricNormals gluQuadricNormals: specify what kind of normals are desired for quadrics. C Specification void gluQuadricNormals( GLUquadric* quad, GLenum normal) Parameters quad normal Specifies the quadrics object (created with gluNewQuadric). Specifies the desired type of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 367
Q gluQuadricOrientation gluQuadricOrientation gluQuadricOrientation: specify inside/outside orientation for quadrics. C Specification void gluQuadricOrientation( GLUquadric* quad, GLenum orientation) Parameters quad orientation Specifies the quadrics object (created with gluNewQuadric). Specifies - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 368
Q gluQuadricTexture gluQuadricTexture gluQuadricTexture: specify if texturing is desired for quadrics. C Specification void gluQuadricTexture( GLUquadric* quad, GLboolean texture) Parameters quad texture Specifies the quadrics object (created with gluNewQuadric). Specifies a flag indicating if - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 369
eventBase Specifies the connection to the X server. Returns the base error code of the GLX server extension. Returns the base event code of the GLX server extension. Description glXQueryExtension returns True if the X server of connection dpy supports the GLX extension, False otherwise. If True - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 370
*dpy, int screen) Parameters dpy screen Specifies the connection to the X server. Specifies the screen. Description glXQueryExtensionsString returns a pointer to a string describing which GLX extensions are supported on the connection. The string is null-terminated and contains a space-separated - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 371
is 1.1 or 1.0, the GL version must be 1.0. If the GLX version is 1.2, the GL version must be 1.1. glXQueryServerString only returns information about GLX extensions supported by the server. Call glGetString to get a list of GL extensions. Call glXGetClientString to get a list of GLX extensions - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 372
Q glXQueryVersion glXQueryVersion 372 Chapter 15 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 373
16 R Chapter 16 373 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 374
R glRasterPos glRasterPos glRasterPos2d, glRasterPos2f, glRasterPos2i, glRasterPos2s, glRasterPos3d, glRasterPos3f, glRasterPos3i, glRasterPos3s, glRasterPos4d, glRasterPos4f, glRasterPos4i, glRasterPos4s, glRasterPos2dv, glRasterPos2fv, glRasterPos2iv, glRasterPos2sv, glRasterPos3dv, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 375
R glRasterPos GLint x, GLint y, GLint z, GLint w) void glRasterPos4s( GLshort x, GLshort y, GLshort z, GLshort w) void glRasterPos2dv( const GLdouble *v) void glRasterPos2fv( const GLfloat *v) void glRasterPos2iv( const GLint *v) void glRasterPos2sv( const GLshort *v) void glRasterPos3dv( const - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 376
R glRasterPos 376 glRasterPos3 specifies object coordinate x, y, and z explicitly, while w is implicitly set to 1. glRasterPos2 uses the argument values for x and y while implicitly setting z and w to 0 and 1. The object coordinates presented by glRasterPos are treated just like those of a glVertex - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 377
glGet with argument GL_CURRENT_RASTER_COLOR glGet with argument GL_CURRENT_RASTER_INDEX glGet with argument GL_CURRENT_RASTER_TEXTURE_COORDS See Also glBitmap, glCopyPixels, glDrawElements, glDrawPixels, glLight, glLightModel, glShadeModel, glTexCoord, glTexGen, glVertex R glRasterPos Chapter 16 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 378
R glReadBuffer glReadBuffer glReadBuffer: select a color buffer source for pixels. C Specification void glReadBuffer( GLenum mode) Parameters mode Specifies a color buffer. Accepted values are GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT, and - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 379
See Also glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawBuffer, glReadPixels R glReadBuffer Chapter 16 379 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 380
starting at location pixels. Several parameters control the processing of the pixel data before it is placed into client memory. These parameters are set with three commands: glPixelStore, glPixelTransfer, and glPixelMap. This reference page describes the effects on glReadPixels of most, but not - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 381
, where c is RED, GREEN, BLUE, or ALPHA. Finally, if GL_MAP_COLOR is GL_TRUE, each component is clamped to the range [0, 1], scaled to the size of its corresponding table, and is then replaced by its mapping in the table GL_PIXEL_MAP_c_TO_c, where c is R, G, B, or A. Unneeded data is then discarded - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 382
contiguous space in pixels. Storage parameters set by glPixelStore, such as GL_PACK_LSB_FIRST and GL_PACK_SWAP_BYTES, affect the way that data is written into memory. See glPixelStore for a description. Notes Values for pixels that lie outside the window connected to the current GL context are unde - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 383
R glReadPixels • GL_INVALID_OPERATION is generated if glReadPixels is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGet with argument GL_INDEX_MODE See Also glCopyPixels, glDrawPixels, glPixelMap, glPixelStore, glPixelTransfer, glReadBuffer - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 384
R glRect glRect glRectd, glRectf, glRecti, glRects, glRectdv, glRectfv, glRectiv, glRectsv: draw a rectangle. C Specification void glRectd( GLdouble x1, GLdouble y1, GLdouble x2, GLdouble y2) void glRectf( GLfloat x1, GLfloat y1, GLfloat x2, GLfloat y2) void glRecti( GLint x1, GLint y1, GLint x2, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 385
R glRect Description glRect supports efficient specification of rectangles as two corner points. Each rectangle command takes four arguments, organized either as two consecutive pairs of (x,y) coordinates, or - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 386
Render mode. Primitives are rasterized, producing pixel fragments, which are written into the frame buffer. This is the normal mode and also the default mode. GL_SELECT Selection mode. No pixel fragments are produced, and no change to the frame buffer contents is made. Instead, a record of the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 387
R glRenderMode Notes If an error is generated, glRenderMode returns 0 regardless of the current render mode. Errors • GL_INVALID_ENUM is generated if mode is not one of the three accepted values. • GL_INVALID_OPERATION is generated if glSelectBuffer is called while the render mode is GL_SELECT, or - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 388
R glRotate 388 glRotate glRotated, glRotatef: multiply the current matrix by a rotation matrix. C Specification void glRotated( GLdouble angle, GLdouble x, GLdouble y, GLdouble z) void glRotatef( GLfloat angle, GLfloat x, GLfloat y, GLfloat z) Parameters angle x, y, z Specifies the angle of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 389
R glRotate Errors • GL_INVALID_OPERATION is generated if glRotate is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGet with argument GL_MATRIX_MODE glGet with argument GL_MODELVIEW_MATRIX glGet with argument GL_PROJECTION_MATRIX glGet with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 390
R glRotate 390 Chapter 16 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 391
17 S Chapter 17 391 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 392
S glScale 392 glScale glScaled, glScalef: multiply the current matrix by a general scaling matrix. C Specification void glScaled( GLdouble x, GLdouble y, GLdouble z) void glScalef( GLfloat x, GLfloat y, GLfloat z) Parameters x, y, z Specify scale factors along the x, y, and z axes, respectively. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 393
Associated Gets glGet with argument GL_MATRIX_MODE glGet with argument GL_MODELVIEW_MATRIX glGet with argument GL_PROJECTION_MATRIX glGet with argument GL_TEXTURE_MATRIX See Also glMatrixMode, glMultMatrix, glPushMatrix, glRotate, glTranslate S glScale Chapter 17 393 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 394
S gluScaleImage gluScaleImage gluScaleImage: scale an image to an arbitrary size. C Specification GLint gluScaleImage( GLenum format, GLsizei wIn, GLsizei hIn, GLenum typeIn, const void *dataIn, GLsizei wOut, GLsizei hOut, GLenum typeOut, GLvoid* dataOut) Parameters format - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 395
S gluScaleImage A return value of 0 indicates success. Otherwise gluScaleImage returns a GLU error code that indicates what the problem is (see gluErrorString). See the glReadPixels reference page for a description of the acceptable values for format, typeIn, and typeOut. Errors • GLU_INVALID_VALUE - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 396
S glScissor glScissor glScissor: define the scissor box. C Specification void glScissor( GLint x, GLint y, GLsizei width, GLsizei height) Parameters x, y width, height Specify the lower left corner of the scissor box. Initially (0, 0). Specify the width and height of the scissor box. When a GL - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 397
See Also glEnable, glViewport S glScissor Chapter 17 397 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 398
Specification void glSelectBuffer( GLsizei size, GLuint *buffer) Parameters size buffer Specifies the size of buffer. Returns the the number of hit records copied to buffer, resets the overflow flag and the selection buffer pointer, and initializes the name stack to be empty. If the overflow bit - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 399
an argument other than GL_SELECT. glBegin/glEnd primitives and calls to glRasterPos can result in hits. Errors • GL_INVALID_VALUE is generated if size is negative. • GL_INVALID_OPERATION is generated if glSelectBuffer is called while the render mode is GL_SELECT, or if glRenderMode is called with - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 400
GL_FLAT and GL_SMOOTH. The initial value is GL_SMOOTH. Description GL primitives can have either flat or smooth shading. Smooth shading, the default, causes the computed colors of vertices to be interpolated as the primitive is rasterized, typically assigning different colors to each resulting pixel - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 401
S glShadeModel Errors • GL_INVALID_ENUM is generated if mode is any value other than GL_FLAT or GL_SMOOTH. • GL_INVALID_OPERATION is generated if glShadeModel is executed between the execution of glBegin and the corresponding execution of glEnd. Associated Gets glGet with argument GL_SHADE_MODEL See - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 402
of the given radius centered around the origin. The sphere is subdivided around the Z axis into slices and along the Z axis into stacks (similar to lines of longitude and latitude). If the orientation is set to GLU_OUTSIDE (with gluQuadricOrientation), then any normals generated point away from - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 403
S glStencilFunc glStencilFunc glStencilFunc: set function and reference value for stencil testing. C Specification void glStencilFunc( GLenum func, GLint ref, GLuint mask) Parameters func ref mask Specifies the test function. Eight tokens are valid: GL_NEVER, GL_LESS, GL_LEQUAL, GL_GREATER, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 404
S glStencilFunc The following values are accepted by func: GL_NEVER Always fails. GL_LESS Passes if (ref & mask) < (stencil & mask). GL_LEQUAL Passes if (ref & mask) ≤(stencil & mask). GL_GREATER Passes if (ref & mask) > (stencil & mask). GL_GEQUAL Passes if (ref & mask) ≥ (stencil & mask). - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 405
S glStencilMask glStencilMask glStencilMask: control the writing of individual bits in the stencil planes. C Specification void glStencilMask( GLuint mask) Parameters mask Specifies a bit mask to enable and disable writing of individual bits in the stencil planes. Initially, the mask is all 1s. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 406
S glStencilOp 406 glStencilOp glStencilOp: set stencil test actions. C Specification void glStencilOp( GLenum fail, GLenum zfail, GLenum zpass) Parameters fail zfail zpass Specifies the action to take when the stencil test fails. Six symbolic constants are accepted: GL_KEEP, GL_ZERO, GL_REPLACE, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 407
S glStencilOp GL_INCR Increments the current stencil buffer value. Clamps to the maximum representable unsigned value. GL_DECR Decrements the current stencil buffer value. Clamps to 0. GL_INVERT Bitwise inverts the current stencil buffer value. Stencil buffer values are treated as unsigned integers. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 408
GLXDrawable drawable) Parameters dpy drawable Specifies the connection to the X server. Specifies the window whose buffers are to be swapped. Description . If drawable was not created with respect to a double-buffered visual, glXSwapBuffers has no effect, and no error is generated. Notes - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 409
18 T Chapter 18 409 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 410
T gluTessBeginContour gluTessBeginContour gluTessBeginContour, gluTessEndContour: delimit a contour description. C Specification void gluTessBeginContour( GLUtesselator* tess) void gluTessEndContour( GLUtesselator* tess) Parameters tess Specifies the tessellation object (created with gluNewTess). - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 411
T gluTessBeginPolygon gluTessBeginPolygon gluTessBeginPolygon: delimit a polygon description. C Specification void gluTessBeginPolygon( GLUtesselator* tess, GLvoid* data) Parameters tess data Specifies the tessellation object (created with gluNewTess). Specifies a pointer to user polygon data. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 412
T gluTessCallback gluTessCallback gluTessCallback: define a callback for a tessellation object. C Specification void gluTessCallback( GLUtesselator* tess, GLenum which, GLvoid (*CallBackFunc)() Parameters tess which CallBackFunc Specifies the tessellation object (created with gluNewTess). Specifies - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 413
polygon interior. The edge flag callback (if defined) is invoked before the first vertex callback. Since triangle fans and triangle strips do not support edge flags, the begin callback is not called with GL_TRIANGLE_FAN or GL_TRIANGLE_STRIP if a non-NULL edge flag callback is provided. (If the callback - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 414
interpolate parameters using vertex_data and weight, and return the new vertex pointer in outData. This handle is supplied during rendering callbacks. The user is responsible for freeing the memory some time after gluTessEndPolygon is called. For example, if the polygon lies in an arbitrary plane in - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 415
T gluTessCallback GLU_TESS_ERROR The error callback is called when an error is encountered. The one argument is of type GLenum; it indicates the specific error that occurred and will be set to one of GLU_TESS_MISSING_BEGIN_POLYGON, GLU_TESS_MISSING_END_POLYGON, GLU_TESS_MISSING_BEGIN_CONTOUR, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 416
T gluTessEndPolygon gluTessEndPolygon gluTessEndPolygon: delimit a polygon description. C Specification void gluTessEndPolygon( GLUtesselator* tess) Parameters tess Specifies the tessellation object (created with gluNewTess). Description gluTessBeginPolygon and gluTessEndPolygon delimit the defi - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 417
normal). For example, if you know that all polygons lie in the XY plane, call gluTessNormal(tess, 0.0, 0.0, 1.0) before rendering any polygons. If the supplied normal is (0.0, 0.0, 0.0) (the initial value), the normal is determined as follows. The direction of the normal, up to its sign, is found by - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 418
T gluTessProperty gluTessProperty gluTessProperty: set a tessellation object property. C Specification void gluTessProperty( GLUtesselator* tess, GLenum which, GLdouble data) Parameters tess which data Specifies the tessellation object (created with gluNewTess). Specifies the property to be set. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 419
CW. The GLU_TESS_BEGIN and GLU_TESS_BEGIN_DATA callbacks use the type GL_LINE_LOOP for each contour. GLU_TESS_TOLERANCE Specifies a tolerance for merging features to reduce the size of the output. For example, two vertices that are very close to each other might be replaced by a single vertex. The - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 420
T gluTessVertex gluTessVertex gluTessVertex: specify a vertex on a polygon. C Specification void gluTessVertex( GLUtesselator* tess, GLdouble *location, GLvoid* data) Parameters tess location data Specifies the tessellation object (created with gluNewTess). Specifies the location of the vertex. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 421
T gluTessVertex Two common symptoms of this problem are consists of a single point (when a local variable is used for data) and a GLU_TESS_NEED_COMBINE_CALLBACK error (when a local variable is used for location). See Also gluTessBeginPolygon, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 422
T glTexCoord 422 glTexCoord glTexCoord1d, glTexCoord1f, glTexCoord1i, glTexCoord1s, glTexCoord2d, glTexCoord2f, glTexCoord2i, glTexCoord2s, glTexCoord3d, glTexCoord3f, glTexCoord3i, glTexCoord3s, glTexCoord4d, glTexCoord4f, glTexCoord4i, glTexCoord4s, glTexCoord1dv, glTexCoord1fv, glTexCoord1iv, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 423
GLdouble s, GLdouble t, GLdouble r, GLdouble q) void glTexCoord4f( GLfloat s, GLfloat t, GLfloat r, GLfloat q) void glTexCoord4i( GLint s, GLint t, GLint r, GLint q) void glTexCoord4s( GLshort s, GLshort t, GLshort r, GLshort q) void glTexCoord1dv( const GLdouble *v) void glTexCoord1fv( const - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 424
T glTexCoord Parameters s, t, r, q v Specify s, t, r, and q texture coordinates. Not all parameters are present in all forms of the command. Specifies a pointer to an array of one, two, three, or four elements, which in turn specify the s, t, r, and q texture coordinates. Description glTexCoord - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 425
first element in the array. Description glTexCoordPointer specifies the location and data format of an array of texture coordinates to use when rendering. size specifies the number of coordinates per element, and must be 1, 2, 3, or 4. type specifies the data type of each texture coordinate and stride - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 426
therefore not saved or restored by glPushAttrib and glPopAttrib. Use glPushClientAttrib and glPopClientAttrib instead. Errors • GL_INVALID_VALUE is generated if size is not 1, 2, 3, or 4. • GL_INVALID_ENUM is generated if type is not an accepted value. • GL_INVALID_VALUE is generated if stride is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 427
T glTexEnv glTexEnv glTexEnvf, glTexEnvi, glTexEnvfv, glTexEnviv: set texture environment parameters. C Specification void glTexEnvf( GLenum target, GLenum pname, GLfloat param) void glTexEnvi( GLenum target, GLenum pname, GLint param) void glTexEnvfv( GLenum target, GLenum pname, const GLfloat * - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 428
textured. target must be GL_TEXTURE_ENV. pname can be either GL_TEXTURE_ENV_MODE, GL_TEXTURE_ENV_COLOR or GL_TEXTURE_LIGHTING_MODE_hp (if the extension GL_hp_texture_lighting is supported). If pname is GL_TEXTURE_ENV_MODE, then params is (or points to) the symbolic name of a texture function. Four - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 429
and GL_TEXTURE_ENV_COLOR defaults to (0, 0, 0, 0). GL_TEXTURE_LIGHTING_hp defaults to GL_TEXTURE_POST_SPECULAR_hp. Notes GL_REPLACE may only be used if the GL version is 1.1 or greater. GL_TEXTURE_LIGHTING_MODE_hp may only be used if the GL_hp_texture_lighting extension is supported. Internal - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 430
T glTexEnv glCopyTexSubImage2D, glTexImage1D, glTexImage2D, glTexParameter, glTexSubImage1D, glTexSubImage2D 430 Chapter 18 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 431
T glTexGen glTexGen glTexGend, glTexGenf, glTexGeni, glTexGendv, glTexGenfv, glTexGeniv: control the generation of texture coordinates. C Specification void glTexGend( GLenum coord, GLenum pname, GLdouble param) void glTexGenf( GLenum coord, GLenum pname, GLfloat param) void glTexGeni( GLenum coord - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 432
' ) = ( p1 p2 p3 p4) M-1 and xe, ye, ze, and we are the eye coordinates of the vertex, p1, p2, p3, and p4 are the values supplied in params, and M is the modelview matrix when glTexGen is invoked. If M is poorly conditioned or singular, texture coordinates generated by the resulting function may - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 433
T glTexGen Finally, let m = 2 sqrt(fx2 + fy2 + (fz + 1)2). Then the values assigned to the s and t texture coordinates are s = fx/m + 1/2 t = fy/m + 1/2 To enable or disable a texture-coordinate generation function, call glEnable or glDisable with one of the symbolic texture-coordinate names ( - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 434
, GL_DEPTH_COMPONENT24_EXT, or GL_DEPTH_COMPONENT32_EXT. Specifies the width of the texture image. Must be 2n + 2 × border for some integer n. All implementations support texture images that are at least 64 texels wide. The height of the 1D texture image is 1. Specifies the width of the border - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 435
the extension GL_EXT_shadow is supported, the symbolic value last three arguments describe how the image is represented in memory; they are identical to the pixel formats used for glDrawPixels implementation cannot handle a texture of the requested texture size, it sets all of the image state to 0, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 436
T glTexImage1D Each element is a single red component. The GL converts it to floating point and assembles it into an RGBA element by attaching 0 for green and blue, and 1 for alpha. Each component is then multiplied by the signed scale factor GL_c_SCALE, added to the signed bias GL_c_BIAS, and - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 437
only be used if the GL_EXT_shadow extension is supported. GL_PROXY_TEXTURE_1D may only be used if the GL null pointer. In this case texture memory is allocated to accommodate a texture of width width. You can then download subtextures to initialize the texture memory. The image is undefined if the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 438
T glTexImage1D • GL_INVALID_VALUE may be generated if level is greater than log2max, where max is the returned value of GL_MAX_TEXTURE_SIZE. • GL_INVALID_VALUE is generated if internalformat is not 1, 2, 3, 4, or one of the accepted resolution and format symbolic constants. • GL_INVALID_VALUE is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 439
or GL_RGBA16. Additionally, if the extension GL_EXT_shadow is supported, may be one of the symbolic constants GL_DEPTH_COMPONENT, the texture image. Must be 2n + 2 × border for some integer n. All implementations support texture images that are at least 64 texels wide. Specifies the height of the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 440
If the extension GL_EXT_shadow is supported, the symbolic value GL_DEPTH_COMPONENT is three arguments describe how the image is represented in memory; they are identical to the pixel formats used implementation cannot handle a texture of the requested texture size, it sets all of the image state to - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 441
T glTexImage2D color components using the GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B, and GL_PIXEL_MAP_I_TO_A tables, and clamped to the range [0,1]. GL_RED Each element is a single red component. The GL converts it to floating point and assembles it into an RGBA element by - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 442
only be used if the GL_EXT_shadow extension is supported. glTexImage2D and GL_PROXY_TEXTURE_2D are only available if the of width width and height height. You can then download subtextures to initialize this texture memory. The image is undefined if the user tries to apply an uninitialized portion of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 443
T glTexImage2D • GL_INVALID_ENUM is generated if type is not a type constant. • GL_INVALID_ENUM is generated if type is GL_BITMAP and format is not GL_COLOR_INDEX. • GL_INVALID_VALUE is generated if level is less than 0. • GL_INVALID_VALUE may be generated if level is greater than log2max, where max - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 444
, GL_RGBA, GL_RGBA2, GL_RGBA4, GL_RGB5_A1, GL_RGBA8, GL_RGB10_A2, GL_RGBA12, or GL_RGBA16. Additionally, if the extension GL_EXT_shadow is supported, may be one of the symbolic constants GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT16_EXT, GL_DEPTH_COMPONENT24_EXT, or GL_DEPTH_COMPONENT32_EXT. Specifies the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 445
GL_LUMINANCE_ALPHA. If the extension GL_EXT_shadow is supported, the symbolic value GL_DEPTH_COMPONENT is also three arguments describe the way the image is represented in memory, and they are identical to the pixel formats used for a texture of the requested texture size, it will set all of the - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 446
This resolution and format can be requested by internalformat, but the implementation may not support that resolution (the formats of GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_RGB, and GL_RGBA must be supported). When a resolution and storage format is specified, the implementation will update the texture - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 447
the corresponding execution of glEnd. • GL_TEXTURE_TOO_LARGE_EXT is generated if the implementation cannot accommodate a texture of the size requested. Associated Gets glGetTexImage glIsEnabled with argument GL_TEXTURE_3D_EXT See Also glDrawPixels, glFog, glPixelStore, glPixelTransfer, glTexEnv, 447 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 448
T glTexImage3DEXT glTexGen, glTexImage1D, glTexImage2D, glTexParameter. 448 Chapter 18 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 449
T glTexParameter glTexParameter glTexParameterf, glTexParameteri, glTexParameterfv, glTexParameteriv: set texture parameters. C Specification void glTexParameterf( GLenum target, GLenum pname, GLfloat param) void glTexParameteri( GLenum target, GLenum pname, GLint param) void glTexParameterfv( - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 450
texture; level max(m, n ) is the final 1× 1 mipmap. params supplies a function for minifying the texture as one of the following: GL_NEAREST Returns the value. GL_LINEAR_MIPMAP_NEAREST Chooses the mipmap that most closely matches the size of the pixel being textured and uses the GL_LINEAR criterion - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 451
each mipmap. The final texture value is a weighted average of those two values. GL_LINEAR_MIPMAP_LINEAR Chooses the two mipmaps that most closely match the size of the pixel being textured and uses the GL_LINEAR criterion (a weighted average of the four texture elements that are closest to the center - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 452
in effect. param is either GL_TRUE or GL_FALSE. The default is GL_FALSE, meaning that the depth texture comparison operator (note that only GL_LINEAR and GL_NEAREST minification and magnification filters are supported for depth texture comparison). This result is passed down as the alpha component of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 453
the extension GL_EXT_texture3D is supported. GL_GENERATE_MIPMAP_EXTis only supported if the extension GL_EXT_generate_mipmap is supported. GL_TEXTURE_COMPARE_EXT and GL_TEXTURE_COMPARE_OPERATOR_EXT are only supported if the extension GL_EXT_shadow is supported. Errors • GL_INVALID_ENUM is generated - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 454
T glTexParameter glDrawPixels, glPixelStore, glPixelTransfer, glPrioritizeTextures, glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexSubImage1D, glTexSubImage2D 454 Chapter 18 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 455
, GL_RGBA, GL_LUMINANCE, and GL_LUMINANCE_ALPHA. If the extension GL_EXT_shadow is supported, then the symbolic value GL_DEPTH_COMPONENT is also accepted. Specifies , and GL_FLOAT. Specifies a pointer to the image data in memory. Description Texturing maps a portion of a specified texture image onto - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 456
greater. Texturing has no effect in color index mode. The format GL_DEPTH_COMPONENT may only be used if the GL_EXT_shadow extension is supported. glPixelStore and glPixelTransfer modes affect texture images in exactly the way they affect glDrawPixels. Errors • GL_INVALID_ENUM is generated if target - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 457
glTexImage2D, glTexParameter, glTexSubImage2D T glTexSubImage1D Chapter 18 457 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 458
, GL_RGBA, GL_LUMINANCE, and GL_LUMINANCE_ALPHA. If the extension GL_EXT_shadow is supported, then the symbolic value GL_DEPTH_COMPONENT is also accepted. Specifies , and GL_FLOAT. Specifies a pointer to the image data in memory. Description Texturing maps a portion of a specified texture image onto - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 459
greater. Texturing has no effect in color index mode. The format GL_DEPTH_COMPONENT may only be used if the GL_EXT_shadow extension is supported. glPixelStore and glPixelTransfer modes affect texture images in exactly the way they affect glDrawPixels. Errors • GL_INVALID_ENUM is generated if target - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 460
T glTexSubImage2D glPixelStore, glPixelTransfer, glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexSubImage1D, glTexParameter 460 Chapter 18 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 461
, GL_ALPHA, GL_RGB, GL_RGBA,GL_LUMINANCE, and GL_LUMINANCE_ALPHA. If the extension GL_EXT_shadow is supported, the symbolic value GL_DEPTH_COMPONENT is also accepted. Specifies the data type of , GL_UNSIGNED_INT, GL_INT, and GL_FLOAT. Specifies a pointer to the image data in memory. Chapter 18 461 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 462
T glTexSubImage3DEXT Description Texturing maps a portion of a specified texture image onto each graphical primitive for which texturing is enabled. Three-dimensional texturing is enabled and disabled using glEnable and glDisable with argument GL_TEXTURE_3D_EXT. glTexSubImage3DEXT redefines a - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 463
See Also glDrawPixels, glFog, glPixelStore, glPixelTransfer, glTexEnv, glTexGen, glTexImage3D, glTexParameter. T glTexSubImage3DEXT Chapter 18 463 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 464
T glTranslate glTranslate glTranslated, glTranslatef: multiply the current matrix by a translation matrix. C Specification void glTranslated( GLdouble x, GLdouble y, GLdouble z) void glTranslatef( GLfloat x, GLfloat y, GLfloat z) Parameters x, y, z Specify the x, y, and z coordinates of a - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 465
See Also glMatrixMode, glMultMatrix, glPushMatrix, glScale T glTranslate Chapter 18 465 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 466
T glTranslate 466 Chapter 18 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 467
19 U Chapter 19 467 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 468
*proj, const GLint *view, GLdouble* objX, GLdouble* objY, GLdouble* objZ) Parameters winX, winY, winZ Specify the window coordinates to be mapped. model Specifies the modelview matrix (as from a glGetDoublev call). proj Specifies the projection matrix (as from a glGetDoublev call). view Speci - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 469
See Also glGet, gluProject U gluUnProject Chapter 19 469 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 470
accessing the X font and generating the display lists explicitly, both because the display lists are created on the server without requiring a round trip of the glyph data, and because the server may choose to delay the creation of each bitmap until it is accessed. Empty display lists are created - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 471
See Also glBitmap, glXMakeCurrent U glXUseXFont Chapter 19 471 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 472
U glXUseXFont 472 Chapter 19 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 473
20 V Chapter 20 473 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 474
V glVertex 474 glVertex glVertex2d, glVertex2f, glVertex2i, glVertex2s, glVertex3d, glVertex3f, glVertex3i, glVertex3s, glVertex4d, glVertex4f, glVertex4i, glVertex4s,glVertex2dv, glVertex2fv, glVertex2iv, glVertex2sv, glVertex3dv, glVertex3fv, glVertex3iv, glVertex3sv, glVertex4dv, glVertex4fv, - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 475
, normal, and texture coordinates are associated with the vertex when glVertex is called. When only x and y are specified, z defaults to 0 and w defaults to 1. When x, y, and z are specified, w defaults to 1. Notes Invoking glVertex outside of a glBegin/glEnd pair results in undefined behavior. 475 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 476
V glVertex See Also glBegin, glCallList, glColor, glEdgeFlag, glEvalCoord, glIndex, glMaterial, glNormal, glRect, glTexCoord, glVertexPointer 476 Chapter 20 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 477
and data format of an array of vertex coordinates to use when rendering. size specifies the number of coordinates per vertex and type the data type of some implementations; see glInterleavedArrays.) When a vertex array is specified, size, type, stride, and pointer are saved as client-side state. - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 478
are therefore not saved or restored by glPushAttrib and glPopAttrib. Use glPushClientAttrib and glPopClientAttrib instead. Errors • GL_INVALID_VALUE is generated if size is not 2, 3, or 4. • GL_INVALID_ENUM is generated if type is not an accepted value. • GL_INVALID_VALUE is generated if stride is - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 479
V glViewport glViewport glViewport: set the viewport. C Specification void glViewport( GLint x, GLint y, GLsizei width, GLsizei height) Parameters x, y width, height Specify the lower left corner of the viewport rectangle, in pixels. The initial value is (0, 0). Specify the width and height of - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 480
before returning to the calling program. Description glVisibilityBuffer has three arguments: 'buffer' is a pointer to an array of Boolean, and 'size' indicates the size of the array. 'buffer' returns values of GL_TRUE or GL_FALSE for each Visibility Test issued. A Visibility Test begins when a call - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 481
of 'buffer' become valid. The programmer is responsible for allocating the memory for 'buffer'. If an incorrect 'size' is specified, memory corruption may occur. Errors • GL_INVALID_VALUE is generated if 'size' is negative. • GL_INVALID_OPERATION is generated if glVisibilityBufferhp is called while - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 482
V glVisibilityBufferhp 482 Chapter 20 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 483
21 W Chapter 21 483 - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 484
glXWaitGL. Although this same result can be achieved using glFinish, glXWaitGL does not require a round trip to the server, and it is therefore more efficient in cases where client and server are on separate machines. glXWaitGL is ignored if there is no current GLX context. Notes glXWaitGL may or may - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 485
after glXWaitX. Although the same result can be achieved using XSync, glXWaitX does not require a round trip to the server, and it is therefore more efficient in cases where client and server are on separate machines. glXWaitX is ignored if there is no current GLX context. Note glXWaitX may or may - HP Workstation c3650 | OpenGL 1.1 Reference for HP-UX 11.x - Page 486
W glXWaitX 486 Chapter 21
OpenGL 1.1 Reference
for HP-UX 11.x
Manufacturing Part Number: B2355-IE001
Edition E0302
© Copyright 2002 by Hewlett-Packard