1 ##########################################################################
3 # Copyright 2011 Jose Fonseca
6 # Permission is hereby granted, free of charge, to any person obtaining a copy
7 # of this software and associated documentation files (the "Software"), to deal
8 # in the Software without restriction, including without limitation the rights
9 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 # copies of the Software, and to permit persons to whom the Software is
11 # furnished to do so, subject to the following conditions:
13 # The above copyright notice and this permission notice shall be included in
14 # all copies or substantial portions of the Software.
16 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 ##########################################################################/
27 '''Describe GL types.'''
35 GLboolean = Alias("GLboolean", Bool)
36 GLvoid = Alias("GLvoid", Void)
37 GLbyte = Alias("GLbyte", SChar)
38 GLshort = Alias("GLshort", Short)
39 GLint = Alias("GLint", Int)
40 GLint64 = Alias("GLint64", Int64)
41 GLubyte = Alias("GLubyte", UChar)
42 GLushort = Alias("GLushort", UShort)
43 GLuint = Alias("GLuint", UInt)
44 GLuint64 = Alias("GLuint64", UInt64)
45 GLsizei = Alias("GLsizei", Int)
46 GLintptr = Alias("GLintptr", Int)
47 GLsizeiptr = Alias("GLsizeiptr", Int)
48 GLfloat = Alias("GLfloat", Float)
49 GLclampf = Alias("GLclampf", Float)
50 GLdouble = Alias("GLdouble", Double)
51 GLclampd = Alias("GLclampd", Double)
52 GLchar = Alias("GLchar", SChar)
53 GLstring = String("GLchar *")
55 GLcharARB = Alias("GLcharARB", SChar)
56 GLstringARB = String("GLcharARB *")
57 GLintptrARB = Alias("GLintptrARB", Int)
58 GLsizeiptrARB = Alias("GLsizeiptrARB", Int)
59 GLhandleARB = Handle("handleARB", Alias("GLhandleARB", UInt))
60 GLhalfARB = Alias("GLhalfARB", UShort)
61 GLhalfNV = Alias("GLhalfNV", UShort)
62 GLint64EXT = Alias("GLint64EXT", Int64)
63 GLuint64EXT = Alias("GLuint64EXT", UInt64)
64 GLDEBUGPROCARB = Opaque("GLDEBUGPROCARB")
65 GLDEBUGPROCAMD = Opaque("GLDEBUGPROCAMD")
67 GLpointer = OpaquePointer(GLvoid)
68 GLpointerConst = OpaquePointer(Const(GLvoid))
70 GLlist = Handle("list", GLuint)
71 GLtexture = Handle("texture", GLuint)
72 GLbuffer = Handle("buffer", GLuint)
73 GLquery = Handle("query", GLuint)
74 GLfenceNV = Handle("fenceNV", GLuint)
75 GLprogram = Handle("program", GLuint)
76 GLshader = Handle("shader", GLuint)
78 # Share the same mapping table for uniform locations of both core and
79 # GL_ARB_shader_objects programs. For a combination of reasons:
81 # - all OpenGL implementations appear to alias the names for both kind of
84 # - most applications will use only one kind of shader programs;
86 # - some applications actually mix glUniformXxx calls with
87 # GL_ARB_shader_objects programs and glUniformXxxARB calls with core
88 # programs, and therefore, rely on a joint implementation.
90 # We use GLhandleARB as program key, since it is wider (void *) on MacOSX.
92 GLlocation = Handle("location", GLint, key=('program', GLhandleARB))
93 GLlocationARB = Handle("location", GLint, key=('programObj', GLhandleARB))
95 GLprogramARB = Handle("programARB", GLuint)
96 GLframebuffer = Handle("framebuffer", GLuint)
97 GLrenderbuffer = Handle("renderbuffer", GLuint)
98 GLfragmentShaderATI = Handle("fragmentShaderATI", GLuint)
99 GLarray = Handle("array", GLuint)
100 GLregion = Handle("region", GLuint)
101 GLpipeline = Handle("pipeline", GLuint)
102 GLsampler = Handle("sampler", GLuint)
103 GLfeedback = Handle("feedback", GLuint)
105 # GL mappings are pointers to linear memory regions.
107 # The map length is not always available in the function prototype, and must be
108 # reconstructed from other state.
109 GLmap = LinearPointer(GLvoid, "length")
111 GLsync_ = IntPointer("GLsync")
112 GLsync = Handle("sync", GLsync_)
114 GLenum = Enum("GLenum", [
115 # Parameters are added later from glparams.py's parameter table
118 # Some functions take GLenum disguised as GLint, and need special treatment so
119 # that symbolic names are traced correctly.
120 GLenum_int = Alias("GLint", GLenum)
122 GLenum_mode = FakeEnum(GLenum, [
123 "GL_POINTS", # 0x0000
125 "GL_LINE_LOOP", # 0x0002
126 "GL_LINE_STRIP", # 0x0003
127 "GL_TRIANGLES", # 0x0004
128 "GL_TRIANGLE_STRIP", # 0x0005
129 "GL_TRIANGLE_FAN", # 0x0006
131 "GL_QUAD_STRIP", # 0x0008
132 "GL_POLYGON", # 0x0009
133 "GL_LINES_ADJACENCY", # 0x000A
134 "GL_LINE_STRIP_ADJACENCY", # 0x000B
135 "GL_TRIANGLES_ADJACENCY", # 0x000C
136 "GL_TRIANGLE_STRIP_ADJACENCY", # 0x000D
137 "GL_PATCHES", # 0x000E
140 GLenum_error = FakeEnum(GLenum, [
142 "GL_INVALID_ENUM", # 0x0500
143 "GL_INVALID_VALUE", # 0x0501
144 "GL_INVALID_OPERATION", # 0x0502
145 "GL_STACK_OVERFLOW", # 0x0503
146 "GL_STACK_UNDERFLOW", # 0x0504
147 "GL_OUT_OF_MEMORY", # 0x0505
148 "GL_INVALID_FRAMEBUFFER_OPERATION", # 0x0506
149 "GL_TABLE_TOO_LARGE", # 0x8031
152 GLbitfield = Alias("GLbitfield", UInt)
154 GLbitfield_attrib = Flags(GLbitfield, [
155 "GL_ALL_ATTRIB_BITS", # 0x000FFFFF
156 "GL_CURRENT_BIT", # 0x00000001
157 "GL_POINT_BIT", # 0x00000002
158 "GL_LINE_BIT", # 0x00000004
159 "GL_POLYGON_BIT", # 0x00000008
160 "GL_POLYGON_STIPPLE_BIT", # 0x00000010
161 "GL_PIXEL_MODE_BIT", # 0x00000020
162 "GL_LIGHTING_BIT", # 0x00000040
163 "GL_FOG_BIT", # 0x00000080
164 "GL_DEPTH_BUFFER_BIT", # 0x00000100
165 "GL_ACCUM_BUFFER_BIT", # 0x00000200
166 "GL_STENCIL_BUFFER_BIT", # 0x00000400
167 "GL_VIEWPORT_BIT", # 0x00000800
168 "GL_TRANSFORM_BIT", # 0x00001000
169 "GL_ENABLE_BIT", # 0x00002000
170 "GL_COLOR_BUFFER_BIT", # 0x00004000
171 "GL_HINT_BIT", # 0x00008000
172 "GL_EVAL_BIT", # 0x00010000
173 "GL_LIST_BIT", # 0x00020000
174 "GL_TEXTURE_BIT", # 0x00040000
175 "GL_SCISSOR_BIT", # 0x00080000
176 "GL_MULTISAMPLE_BIT", # 0x20000000
179 GLbitfield_client_attrib = Flags(GLbitfield, [
180 "GL_CLIENT_ALL_ATTRIB_BITS", # 0xFFFFFFFF
181 "GL_CLIENT_PIXEL_STORE_BIT", # 0x00000001
182 "GL_CLIENT_VERTEX_ARRAY_BIT", # 0x00000002
185 GLbitfield_shader = Flags(GLbitfield, [
186 "GL_ALL_SHADER_BITS", # 0xFFFFFFFF
187 "GL_VERTEX_SHADER_BIT", # 0x00000001
188 "GL_FRAGMENT_SHADER_BIT", # 0x00000002
189 "GL_GEOMETRY_SHADER_BIT", # 0x00000004
190 "GL_TESS_CONTROL_SHADER_BIT", # 0x00000008
191 "GL_TESS_EVALUATION_SHADER_BIT", # 0x00000010
194 GLbitfield_access = Flags(GLbitfield, [
195 "GL_MAP_READ_BIT", # 0x0001
196 "GL_MAP_WRITE_BIT", # 0x0002
197 "GL_MAP_INVALIDATE_RANGE_BIT", # 0x0004
198 "GL_MAP_INVALIDATE_BUFFER_BIT", # 0x0008
199 "GL_MAP_FLUSH_EXPLICIT_BIT", # 0x0010
200 "GL_MAP_UNSYNCHRONIZED_BIT", # 0x0020
203 GLbitfield_sync_flush = Flags(GLbitfield, [
204 "GL_SYNC_FLUSH_COMMANDS_BIT", # 0x00000001
207 GLbitfield_barrier = Flags(GLbitfield, [
208 "GL_ALL_BARRIER_BITS", # 0xFFFFFFFF
209 "GL_VERTEX_ATTRIB_ARRAY_BARRIER_BIT", # 0x00000001
210 "GL_ELEMENT_ARRAY_BARRIER_BIT", # 0x00000002
211 "GL_UNIFORM_BARRIER_BIT", # 0x00000004
212 "GL_TEXTURE_FETCH_BARRIER_BIT", # 0x00000008
213 "GL_SHADER_GLOBAL_ACCESS_BARRIER_BIT_NV", # 0x00000010
214 "GL_SHADER_IMAGE_ACCESS_BARRIER_BIT", # 0x00000020
215 "GL_COMMAND_BARRIER_BIT", # 0x00000040
216 "GL_PIXEL_BUFFER_BARRIER_BIT", # 0x00000080
217 "GL_TEXTURE_UPDATE_BARRIER_BIT", # 0x00000100
218 "GL_BUFFER_UPDATE_BARRIER_BIT", # 0x00000200
219 "GL_FRAMEBUFFER_BARRIER_BIT", # 0x00000400
220 "GL_TRANSFORM_FEEDBACK_BARRIER_BIT", # 0x00000800
221 "GL_ATOMIC_COUNTER_BARRIER_BIT", # 0x00001000