Bull AIX 5.1 - OpenGL 2.1 Reference guide

  • Hello! I am an AI chatbot trained to assist you with the Bull AIX 5.1 - OpenGL 2.1 Reference guide. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
Bull
AIX 5L OpenGL 2.1 Reference Manual
AIX
86 A2 71EF 00
ORDER REFERENCE
Bull
AIX 5L OpenGL 2.1 Reference Manual
AIX
Software
April 2001
BULL CEDOC
357 AVENUE PATTON
B.P.20845
49008 ANGERS CEDEX 01
FRANCE
86 A2 71EF 00
ORDER REFERENCE
The following copyright notice protects this book under the Copyright laws of the United States of America
and other countries which prohibit such actions as, but not limited to, copying, distributing, modifying, and
making derivative works.
Copyright
Bull S.A. 1992, 2001
Printed in France
Suggestions and criticisms concerning the form, content, and presentation of
this book are invited. A form is provided at the end of this book for this purpose.
To order additional copies of this book or other Bull Technical Publications, you
are invited to use the Ordering Form also provided at the end of this book.
Trademarks and Acknowledgements
We acknowledge the right of proprietors of trademarks mentioned in this book.
AIX
R
is a registered trademark of International Business Machines Corporation, and is being used under
licence.
UNIX is a registered trademark in the United States of America and other countries licensed exclusively through
the Open Group.
The information in this document is subject to change without notice. Groupe Bull will not be liable for errors
contained herein, or for incidental or consequential damages in connection with the use of this material.
Contents
About This Book ................................lvii
Who Should Use This Book ............................lvii
Highlighting ..................................lvii
ISO 9000 ...................................lvii
Related Publications ...............................lvii
Trademarks ..................................lviii
Chapter 1. OpenGL Subroutines...........................1
glAccum Subroutine ................................6
Purpose ...................................6
Library ....................................6
C Syntax ...................................6
Description ..................................6
Parameters ..................................7
Notes ....................................7
Errors ....................................7
Associated Gets ................................7
Files.....................................7
Related Information ...............................7
glActiveTextureARB Subroutine ............................8
Purpose ...................................8
Library ....................................8
C Syntax ...................................8
Description ..................................8
Parameters ..................................8
Notes ....................................8
Errors ....................................8
Files.....................................8
Related Information ...............................9
glAlphaFunc Subroutine ..............................9
Purpose ...................................9
Library ....................................9
C Syntax ...................................9
Description ..................................9
Parameters ..................................9
Notes ....................................10
Errors ....................................10
Associated Gets ................................10
Files ....................................10
Related Information...............................10
glAreTexturesResident Subroutine ..........................10
Purpose ...................................10
Library ...................................10
C Syntax ..................................10
Description ..................................10
Parameters ..................................11
Notes ....................................11
Errors ....................................11
Associated Gets ................................11
Related Information ...............................11
glAreTexturesResidentEXT Subroutine .........................11
Purpose ...................................11
Library ...................................11
© Copyright IBM Corp. 1994, 2000 iii
C Syntax ..................................12
Description ..................................12
Parameters..................................12
Notes ....................................12
Errors ....................................12
Associated Gets ................................12
Files ....................................12
Related Information...............................13
glArrayElement Subroutine .............................13
Purpose ...................................13
Library ...................................13
C Syntax ..................................13
Description ..................................13
Parameters..................................13
Notes ....................................13
Related Information...............................13
glArrayElementEXT Subroutine ...........................14
Purpose ...................................14
Library ...................................14
C Syntax ..................................14
Description ..................................14
Parameters..................................14
Notes ....................................14
File.....................................14
Related Information...............................15
glBegin or glEnd Subroutine ............................15
Purpose ...................................15
Library ...................................15
C Syntax ..................................15
Description ..................................15
Parameters..................................16
Errors ....................................16
Files ....................................16
Related Information...............................16
glBindTexture Subroutine..............................16
Purpose ...................................16
Library ...................................16
C Syntax ..................................16
Description ..................................17
Parameters..................................17
Errors ....................................17
Associated Gets ................................17
Related Information...............................18
glBindTextureEXT Subroutine ............................18
Purpose ...................................18
Library ...................................18
C Syntax ..................................18
Description ..................................18
Parameters..................................19
Notes ....................................19
Errors ....................................19
Associated Gets ................................19
Files ....................................19
Related Information...............................19
glBitmap Subroutine ...............................19
Purpose ...................................19
iv OpenGL 2.1 Reference Manual
Library ...................................19
C Syntax ..................................20
Description ..................................20
Parameters..................................20
Errors ....................................21
Associated Gets ................................21
Files ....................................21
Related Information...............................21
glBlendColor Subroutine ..............................21
Purpose ...................................21
Library ...................................21
C Syntax ..................................21
Description ..................................21
Parameters..................................22
Notes ....................................22
Errors ....................................22
Associated Gets ................................22
Related Information...............................22
glBlendColorEXT Subroutine ............................22
Purpose ...................................22
Library ...................................22
C Syntax ..................................22
Description ..................................22
Parameters..................................22
Notes ....................................22
Errors ....................................22
Associated Gets ................................23
Related Information...............................23
glBlendEquation Subroutine.............................23
Purpose ...................................23
Library ...................................23
C Syntax ..................................23
Description ..................................23
Parameters..................................23
Notes ....................................23
Errors ....................................23
Associated Gets ................................24
Related Information...............................24
glBlendEquationEXT Subroutine ...........................24
Purpose ...................................24
Library ...................................24
C Syntax ..................................24
Description ..................................24
Parameters..................................24
Notes ....................................24
Errors ....................................25
Associated Gets ................................25
Related Information...............................25
glBlendFunc Subroutine ..............................25
Purpose ...................................25
Library ...................................25
C Syntax ..................................25
Description ..................................25
Parameters..................................27
Notes ....................................27
Errors ....................................28
Contents v
Associated Gets ................................28
Examples ..................................28
Files ....................................28
Related Information...............................28
glBlendFuncSeparateEXT Subroutine .........................28
Purpose ...................................28
Library ...................................28
C Syntax ..................................29
Description ..................................29
Parameters..................................30
Notes ....................................30
Error Codes .................................30
Files ....................................30
Related Information...............................30
glCallList Subroutine ...............................30
Purpose ...................................30
Library ...................................30
C Syntax ..................................30
Description ..................................30
Parameters..................................31
Notes ....................................31
Associated Gets ................................31
Files ....................................31
Related Information...............................31
glCallLists Subroutine ...............................31
Purpose ...................................31
Library ...................................31
C Syntax ..................................31
Description ..................................32
Parameters..................................32
Notes ....................................33
Associated Gets ................................33
Files ....................................33
Related Information...............................33
glClear Subroutine ................................33
Purpose ...................................33
Library ...................................33
C Syntax ..................................33
Description ..................................33
Parameters..................................34
Notes ....................................34
Errors ....................................34
Associated Gets ................................34
Files ....................................34
Related Information...............................34
glClearAccum Subroutine .............................34
Purpose ...................................34
Library ...................................34
C Syntax ..................................35
Description ..................................35
Parameters..................................35
Errors ....................................35
Associated Gets ................................35
Files ....................................35
Related Information...............................35
glClearColor Subroutine ..............................35
vi OpenGL 2.1 Reference Manual
Purpose ...................................35
Library ...................................35
C Syntax ..................................36
Description ..................................36
Parameters..................................36
Errors ....................................36
Associated Gets ................................36
Files ....................................36
Related Information...............................36
glClearDepth Subroutine ..............................36
Purpose ...................................36
Library ...................................36
C Syntax ..................................36
Description ..................................37
Parameters..................................37
Errors ....................................37
Associated Gets ................................37
Files ....................................37
Related Information...............................37
glClearIndex Subroutine ..............................37
Purpose ...................................37
Library ...................................37
C Syntax ..................................37
Description ..................................37
Parameters..................................37
Errors ....................................38
Associated Gets ................................38
Files ....................................38
Related Information...............................38
glClearStencil Subroutine .............................38
Purpose ...................................38
Library ...................................38
C Syntax ..................................38
Description ..................................38
Parameters..................................38
Errors ....................................38
Associated Gets ................................38
Files ....................................39
Related Information...............................39
glClientActiveTextureARB Subroutine .........................39
Purpose ...................................39
Library ...................................39
C Syntax ..................................39
Description ..................................39
Parameters..................................39
Notes ....................................39
Error Codes .................................40
Files ....................................40
Related Information...............................40
glClipBoundingBoxIBM or glClipBoundingSphereIBM or glClipBoundingVerticesIBM Subroutine ....40
Purpose ...................................40
Library ...................................40
C Syntax ..................................40
Description ..................................40
Parameters..................................41
Notes ....................................41
Contents vii
Error Codes .................................41
Files ....................................41
glClipPlane Subroutine ..............................42
Purpose ...................................42
Library ...................................42
C Syntax ..................................42
Parameters..................................42
Description ..................................42
Notes ....................................42
Errors ....................................42
Associated Gets ................................42
Files ....................................43
Related Information...............................43
glColor Subroutine ................................43
Purpose ...................................43
Library ...................................43
C Syntax ..................................43
Description ..................................45
Parameters..................................45
Notes ....................................46
Associated Gets ................................46
Files ....................................46
Related Information...............................46
glColorMask Subroutine ..............................46
Purpose ...................................46
Library ...................................46
C Syntax ..................................46
Description ..................................46
Parameters..................................47
Errors ....................................47
Associated Gets ................................47
Files ....................................47
Related Information...............................47
glColorMaterial Subroutine .............................47
Purpose ...................................47
Library ...................................47
C Syntax ..................................47
Description ..................................47
Parameters..................................48
Notes ....................................48
Errors ....................................48
Associated Gets ................................48
Files ....................................48
Related Information...............................48
glColorNormalVertexSUN Subroutine .........................48
Purpose ...................................48
Library ...................................49
C Syntax ..................................49
Description ..................................49
Parameters..................................49
Notes ....................................49
Files ....................................50
Related Information...............................50
glColorPointer Subroutine .............................50
Purpose ...................................50
Library ...................................50
viii OpenGL 2.1 Reference Manual
C Syntax ..................................50
Description ..................................50
Parameters..................................50
Notes ....................................51
Error Codes .................................51
Associated Gets ................................51
Related Information...............................51
glColorPointerEXT Subroutine ............................52
Purpose ...................................52
Library ...................................52
C Syntax ..................................52
Description ..................................52
Parameters..................................52
Notes ....................................53
Errors ....................................53
Associated Gets ................................53
File.....................................53
Related Information...............................53
glColorPointerListIBM Subroutine...........................54
Purpose ...................................54
Library ...................................54
C Syntax ..................................54
Description ..................................54
Parameters..................................54
Notes ....................................55
Error Codes .................................55
Associated Gets ................................55
Related Information...............................55
glColorSubTable Subroutine ............................56
Purpose ...................................56
Library ...................................56
C Syntax ..................................56
Description ..................................56
Parameters..................................56
Notes ....................................56
Error Codes .................................57
Associated Gets ................................57
Files ....................................57
Related Information...............................57
glColorTable Subroutine ..............................57
Purpose ...................................57
Library ...................................57
C Syntax ..................................57
Description ..................................58
Parameters..................................59
Notes ....................................60
Error Codes .................................60
Associated Gets ................................60
Files ....................................61
Related Information...............................61
glColorTableParameter Subroutine ..........................61
Purpose ...................................61
Library ...................................61
C Syntax ..................................61
Description ..................................61
Parameters..................................61
Contents ix
Notes ....................................62
Error Codes .................................62
Associated Gets ................................62
Files ....................................62
Related Information...............................62
glColorVertexSUN Subroutine ............................62
Purpose ...................................62
Library ...................................62
C Syntax ..................................62
Description ..................................63
Parameters..................................63
Notes ....................................63
Files ....................................63
Related Information...............................64
glCopyColorSubTable Subroutine...........................64
Purpose ...................................64
Library ...................................64
C Syntax ..................................64
Description ..................................64
Parameters..................................64
Notes ....................................64
Error Codes .................................64
Associated Gets ................................65
Files ....................................65
Related Information...............................65
glCopyColorTable Subroutine ............................65
Purpose ...................................65
Library ...................................65
C Syntax ..................................65
Description ..................................65
Parameters..................................66
Notes ....................................66
Error Codes .................................67
Associated Gets ................................67
Files ....................................67
Related Information...............................67
glCopyPixels Subroutine ..............................67
Purpose ...................................67
Library ...................................67
C Syntax ..................................67
Description ..................................67
Parameters..................................69
Notes ....................................69
Errors ....................................69
Associated Gets ................................70
Examples ..................................70
Files ....................................70
Related Information...............................70
glCopyTexImage1D Subroutine ...........................70
Purpose ...................................70
Library ...................................70
C Syntax ..................................70
Description ..................................70
Parameters..................................71
Notes ....................................71
Errors ....................................71
x OpenGL 2.1 Reference Manual
Associated Gets ................................72
Related Information...............................72
glCopyTexImage2D Subroutine ...........................72
Purpose ...................................72
Library ...................................72
C Syntax ..................................72
Description ..................................72
Parameters..................................73
Notes ....................................73
Errors ....................................73
Associated Gets ................................74
Related Information...............................74
glCopyTexSubImage1D Subroutine ..........................74
Purpose ...................................74
Library ...................................74
C Syntax ..................................74
Description ..................................74
Parameters..................................74
Notes ....................................75
Errors ....................................75
Associated Gets ................................75
Related Information...............................75
glCopyTexSubImage2D Subroutine ..........................75
Purpose ...................................75
Library ...................................75
C Syntax ..................................75
Description ..................................76
Parameters..................................76
Notes ....................................76
Errors ....................................76
Associated Gets ................................77
Related Information...............................77
glCopyTexSubImage3D Subroutine ..........................77
Purpose ...................................77
Library ...................................77
C Syntax ..................................77
Description ..................................77
Parameters..................................78
Notes ....................................78
Errors ....................................78
Associated Gets ................................79
Related Information...............................79
glCopyTexSubImage3DEXT Subroutine ........................79
Purpose ...................................79
Library ...................................79
C Syntax ..................................79
Description ..................................79
Parameters..................................80
Notes ....................................80
Errors ....................................80
Associated Gets ................................80
Related Information...............................80
glCullFace Subroutine ...............................81
Purpose ...................................81
Library ...................................81
C Syntax ..................................81
Contents xi
Parameters..................................81
Description ..................................81
Notes ....................................81
Errors ....................................81
Associated Gets ................................81
Files ....................................81
Related Information...............................81
glDeleteLists Subroutine ..............................82
Purpose ...................................82
Library ...................................82
C Syntax ..................................82
Description ..................................82
Parameters..................................82
Errors ....................................82
Files ....................................82
Related Information...............................82
glDeleteTextures Subroutine ............................82
Purpose ...................................82
Library ...................................82
C Syntax ..................................83
Parameters..................................83
Description ..................................83
Notes ....................................83
Errors ....................................83
Associated Gets ................................83
Related Information...............................83
glDeleteTexturesEXT Subroutine ...........................83
Purpose ...................................83
Library ...................................83
C Syntax ..................................83
Description ..................................84
Parameters..................................84
Notes ....................................84
Errors ....................................84
Associated Gets ................................84
File.....................................84
Related Information...............................84
glDepthFunc Subroutine ..............................84
Purpose ...................................84
Library ...................................84
C Syntax ..................................84
Description ..................................85
Parameters..................................85
Errors ....................................85
Associated Gets ................................85
Files ....................................85
Related Information...............................85
glDepthMask Subroutine ..............................86
Purpose ...................................86
Library ...................................86
C Syntax ..................................86
Description ..................................86
Parameters..................................86
Errors ....................................86
Associated Gets ................................86
Files ....................................86
xii OpenGL 2.1 Reference Manual
Related Information...............................86
glDepthRange Subroutine .............................86
Purpose ...................................86
Library ...................................86
C Syntax ..................................87
Description ..................................87
Parameters..................................87
Notes ....................................87
Errors ....................................87
Associated Gets ................................87
Files ....................................87
Related Information...............................87
glDrawArrays Subroutine..............................87
Purpose ...................................87
Library ...................................87
C Syntax ..................................88
Description ..................................88
Parameters..................................88
Notes ....................................88
Errors ....................................88
Related Information...............................88
glDrawArraysEXT Subroutine ............................89
Purpose ...................................89
Library ...................................89
C Syntax ..................................89
Description ..................................89
Parameters..................................89
Notes ....................................89
Errors ....................................90
File.....................................90
Related Information...............................90
glDrawBuffer Subroutine ..............................90
Purpose ...................................90
Library ...................................90
C Syntax ..................................90
Description ..................................90
Parameters..................................91
Notes ....................................91
Errors ....................................91
Associated Gets ................................91
Files ....................................91
Related Information...............................91
glDrawElements Subroutine.............................92
Purpose ...................................92
Library ...................................92
C Syntax ..................................92
Description ..................................92
Notes ....................................92
Parameters..................................92
Errors ....................................92
Related Information...............................93
glDrawPixels Subroutine ..............................93
Purpose ...................................93
Library ...................................93
C Syntax ..................................93
Description ..................................93
Contents xiii
Parameters..................................99
Notes ....................................99
Errors ....................................99
Associated Gets ...............................100
Files ....................................100
Related Information ..............................100
glDrawRangeElements Subroutine..........................100
Purpose ..................................100
Library ...................................100
C Syntax ..................................100
Description .................................100
Parameters .................................101
Notes ...................................101
Errors ...................................101
Related Information ..............................101
glEdgeFlag Subroutine ..............................101
Purpose ..................................101
Library ...................................101
C Syntax ..................................102
Description .................................102
Parameters .................................102
Notes ...................................102
Associated Gets ...............................102
Files ....................................102
Related Information ..............................102
glEdgeFlagPointer Subroutine ...........................102
Purpose ..................................102
Library ...................................103
C Syntax ..................................103
Description .................................103
Parameters .................................103
Notes ...................................103
Error Codes .................................103
Associated Gets ...............................104
Related Information ..............................104
glEdgeFlagPointerEXT Subroutine ..........................104
Purpose ..................................104
Library ...................................104
C Syntax ..................................104
Description .................................104
Parameters .................................105
Notes ...................................105
Errors ...................................105
Associated Gets ...............................105
File ....................................105
Related Information ..............................105
glEdgeFlagPointerListIBM Subroutine ........................106
Purpose ..................................106
Library ...................................106
C Syntax ..................................106
Description .................................106
Parameters .................................106
Notes ...................................106
Error Codes .................................107
Associated Gets ...............................107
Related Information ..............................107
xiv OpenGL 2.1 Reference Manual
glEnable or glDisable Subroutine ..........................107
Purpose ..................................107
Library ...................................107
C Syntax ..................................107
Description .................................107
Parameters .................................111
Errors ...................................111
Files ....................................112
Related Information ..............................112
glEnableClientState or glDisableClientState Subroutine ..................112
Purpose ..................................112
Library ...................................112
C Syntax ..................................112
Description .................................112
Parameters .................................112
Notes ...................................112
Errors ...................................112
Related Information ..............................113
glEvalCoord Subroutine ..............................113
Purpose ..................................113
Library ...................................113
C Syntax ..................................113
Description .................................113
Parameters .................................114
Associated Gets ...............................114
Files ....................................115
Related Information ..............................115
glEvalMesh Subroutine ..............................115
Purpose ..................................115
Library ...................................115
C Syntax ..................................116
Description .................................116
Parameters .................................117
Errors ...................................117
Associated Gets ...............................117
Files ....................................117
Related Information ..............................118
glEvalPoint Subroutine ..............................118
Purpose ..................................118
Library ...................................118
C Syntax ..................................118
Description .................................118
Parameters .................................118
Associated Gets ...............................118
Files ....................................119
Related Information ..............................119
glFeedbackBuffer Subroutine ............................119
Purpose ..................................119
Library ...................................119
C Syntax ..................................119
Description .................................119
Parameters .................................121
Notes ...................................121
Errors ...................................121
Associated Gets ...............................121
Files ....................................121
Contents xv
Related Information ..............................121
glFinish Subroutine ...............................121
Purpose ..................................121
Library ...................................121
C Syntax ..................................122
Description .................................122
Notes ...................................122
Errors ...................................122
Files ....................................122
Related Information ..............................122
glFlush Subroutine ...............................122
Purpose ..................................122
Library ...................................122
C Syntax ..................................122
Description .................................122
Notes ...................................122
Errors ...................................123
Files ....................................123
Related Information ..............................123
glFog Subroutine ................................123
Purpose ..................................123
Library ...................................123
C Syntax ..................................123
Description .................................123
Parameters .................................125
Errors ...................................125
Associated Gets ...............................125
Files ....................................126
Related Information ..............................126
glFogCoordEXT Subroutine ............................126
Purpose ..................................126
Library ...................................126
C Syntax ..................................126
Description .................................126
Parameters .................................126
Files ....................................126
Related Information ..............................127
glFogCoordPointerEXT Subroutine..........................127
Purpose ..................................127
Library ...................................127
C Syntax ..................................127
Description .................................127
Parameters .................................127
Files ....................................128
Related Information ..............................128
glFogCoordPointerListIBM Subroutine ........................128
Purpose ..................................128
Library ...................................128
C Syntax ..................................128
Description .................................128
Parameters .................................129
Notes ...................................129
Error Codes .................................129
Associated Gets ...............................129
Files ....................................130
Related Information ..............................130
xvi OpenGL 2.1 Reference Manual
glFrontFace Subroutine ..............................130
Purpose ..................................130
Library ...................................130
C Syntax ..................................130
Description .................................130
Parameters .................................130
Errors ...................................130
Associated Gets ...............................131
Files ....................................131
Related Information ..............................131
glFrustum Subroutine ..............................131
Purpose ..................................131
Library ...................................131
C Syntax ..................................131
Description .................................131
Parameters .................................132
Notes ...................................132
Errors ...................................132
Associated Gets ...............................133
Files ....................................133
Related Information ..............................133
glGenLists Subroutine ..............................133
Purpose ..................................133
Library ...................................133
C Syntax ..................................133
Description .................................133
Parameters .................................133
Errors ...................................133
Associated Gets ...............................134
Files ....................................134
Related Information ..............................134
glGenTextures Subroutine .............................134
Purpose ..................................134
Library ...................................134
C Syntax ..................................134
Parameters .................................134
Description .................................134
Notes ...................................135
Errors ...................................135
Associated Gets ...............................135
Related Information ..............................135
glGenTexturesEXT Subroutine ...........................135
Purpose ..................................135
Library ...................................135
C Syntax ..................................135
Description .................................135
Parameters .................................135
Notes ...................................136
Errors ...................................136
Associated Gets ...............................136
File ....................................136
Related Information ..............................136
glGet Subroutine ................................136
Purpose ..................................136
Library ...................................136
C Syntax ..................................136
Contents xvii
Description .................................136
Parameters .................................158
Error Codes .................................158
Files ....................................158
Related Information ..............................158
glGetClipPlane Subroutine.............................158
Purpose ..................................158
Library ...................................158
C Syntax ..................................158
Description .................................158
Parameters .................................158
Notes ...................................159
Errors ...................................159
Files ....................................159
Related Information ..............................159
glGetColorTable Subroutine ............................159
Purpose ..................................159
Library ...................................159
C Syntax ..................................159
Description .................................159
Parameters .................................160
Notes ...................................160
Error Codes .................................160
Files ....................................161
Related Information ..............................161
glGetColorTableParameter Subroutine ........................161
Purpose ..................................161
Library ...................................161
C Syntax ..................................161
Description .................................161
Parameters .................................162
Notes ...................................162
Error Codes .................................162
Files ....................................162
Related Information ..............................162
glGetError Subroutine ..............................163
Purpose ..................................163
Library ...................................163
C Syntax ..................................163
Description .................................163
Errors ...................................164
Files ....................................164
Related Information ..............................164
glGetLight Subroutine ..............................164
Purpose ..................................164
Library ...................................164
C Syntax ..................................164
Description .................................164
Parameters .................................165
Notes ...................................166
Errors ...................................166
Files ....................................166
Related Information ..............................166
glGetMap Subroutine ..............................166
Purpose ..................................166
Library ...................................166
xviii OpenGL 2.1 Reference Manual
/