diff options
Diffstat (limited to 'src/mesa/glapi/glX_XML.py')
-rw-r--r-- | src/mesa/glapi/glX_XML.py | 466 |
1 files changed, 466 insertions, 0 deletions
diff --git a/src/mesa/glapi/glX_XML.py b/src/mesa/glapi/glX_XML.py new file mode 100644 index 00000000000..44f945a9ee4 --- /dev/null +++ b/src/mesa/glapi/glX_XML.py @@ -0,0 +1,466 @@ +#!/usr/bin/python2 + +# (C) Copyright IBM Corporation 2004 +# All Rights Reserved. +# +# Permission is hereby granted, free of charge, to any person obtaining a +# copy of this software and associated documentation files (the "Software"), +# to deal in the Software without restriction, including without limitation +# on the rights to use, copy, modify, merge, publish, distribute, sub +# license, and/or sell copies of the Software, and to permit persons to whom +# the Software is furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice (including the next +# paragraph) shall be included in all copies or substantial portions of the +# Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL +# IBM AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +# IN THE SOFTWARE. +# +# Authors: +# Ian Romanick <[email protected]> + +from xml.sax import saxutils +from xml.sax import make_parser +from xml.sax.handler import feature_namespaces + +import gl_XML +import license +import sys, getopt + + +def printPure(): + print """# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) +# define PURE __attribute__((pure)) +# else +# define PURE +# endif""" + +def printFastcall(): + print """# if defined(__i386__) && defined(__GNUC__) +# define FASTCALL __attribute__((fastcall)) +# else +# define FASTCALL +# endif""" + +def printVisibility(S, s): + print """# if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 3) +# define %s __attribute__((visibility("%s"))) +# else +# define %s +# endif""" % (S, s, S) + +def printNoinline(): + print """# if defined(__GNUC__) +# define NOINLINE __attribute__((noinline)) +# else +# define NOINLINE +# endif""" + + +class glXItemFactory(gl_XML.glItemFactory): + """Factory to create GLX protocol oriented objects derived from glItem.""" + + def create(self, context, name, attrs): + if name == "function": + return glXFunction(context, name, attrs) + elif name == "enum": + return glXEnum(context, name, attrs) + elif name == "param": + return glXParameter(context, name, attrs) + else: + return gl_XML.glItemFactory.create(self, context, name, attrs) + +class glXEnumFunction: + def __init__(self, name): + self.name = name + + # "enums" is a set of lists. The element in the set is the + # value of the enum. The list is the list of names for that + # value. For example, [0x8126] = {"POINT_SIZE_MIN", + # "POINT_SIZE_MIN_ARB", "POINT_SIZE_MIN_EXT", + # "POINT_SIZE_MIN_SGIS"}. + + self.enums = {} + + # "count" is indexed by count values. Each element of count + # is a list of index to "enums" that have that number of + # associated data elements. For example, [4] = + # {GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR, GL_EMISSION, + # GL_AMBIENT_AND_DIFFUSE} (the enum names are used here, + # but the actual hexadecimal values would be in the array). + + self.count = {} + + + def append(self, count, value, name): + if self.enums.has_key( value ): + self.enums[value].append(name) + else: + if not self.count.has_key(count): + self.count[count] = [] + + self.enums[value] = [] + self.enums[value].append(name) + self.count[count].append(value) + + + def signature( self ): + sig = "" + for i in self.count: + for e in self.count[i]: + sig += "%04x,%u," % (e, i) + + return sig; + + + def PrintUsingTable(self): + """Emit the body of the __gl*_size function using a pair + of look-up tables and a mask. The mask is calculated such + that (e & mask) is unique for all the valid values of e for + this function. The result of (e & mask) is used as an index + into the first look-up table. If it matches e, then the + same entry of the second table is returned. Otherwise zero + is returned. + + It seems like this should cause better code to be generated. + However, on x86 at least, the resulting .o file is about 20% + larger then the switch-statment version. I am leaving this + code in because the results may be different on other + platforms (e.g., PowerPC or x86-64).""" + + return 0 + count = 0 + for a in self.enums: + count += 1 + + # Determine if there is some mask M, such that M = (2^N) - 1, + # that will generate unique values for all of the enums. + + mask = 0 + for i in [1, 2, 3, 4, 5, 6, 7, 8]: + mask = (1 << i) - 1 + + fail = 0; + for a in self.enums: + for b in self.enums: + if a != b: + if (a & mask) == (b & mask): + fail = 1; + + if not fail: + break; + else: + mask = 0 + + if (mask != 0) and (mask < (2 * count)): + masked_enums = {} + masked_count = {} + + for i in range(0, mask + 1): + masked_enums[i] = "0"; + masked_count[i] = 0; + + for c in self.count: + for e in self.count[c]: + i = e & mask + masked_enums[i] = '0x%04x /* %s */' % (e, self.enums[e][0]) + masked_count[i] = c + + + print ' static const GLushort a[%u] = {' % (mask + 1) + for e in masked_enums: + print ' %s, ' % (masked_enums[e]) + print ' };' + + print ' static const GLubyte b[%u] = {' % (mask + 1) + for c in masked_count: + print ' %u, ' % (masked_count[c]) + print ' };' + + print ' const unsigned idx = (e & 0x%02xU);' % (mask) + print '' + print ' return (e == a[idx]) ? (GLint) b[idx] : 0;' + return 1; + else: + return 0; + + def PrintUsingSwitch(self): + """Emit the body of the __gl*_size function using a + switch-statement.""" + + print ' switch( e ) {' + + for c in self.count: + for e in self.count[c]: + first = 1 + + # There may be multiple enums with the same + # value. This happens has extensions are + # promoted from vendor-specific or EXT to + # ARB and to the core. Emit the first one as + # a case label, and emit the others as + # commented-out case labels. + + for j in self.enums[e]: + if first: + print ' case %s:' % (j) + first = 0 + else: + print '/* case %s:*/' % (j) + + print ' return %u;' % (c) + + print ' default: return 0;' + print ' }' + + + def Print(self, name): + print 'INTERNAL PURE FASTCALL GLint' + print '__gl%s_size( GLenum e )' % (name) + print '{' + + if not self.PrintUsingTable(): + self.PrintUsingSwitch() + + print '}' + print '' + + + +class glXEnum(gl_XML.glEnum): + def __init__(self, context, name, attrs): + gl_XML.glEnum.__init__(self, context, name, attrs) + self.glx_functions = [] + + def startElement(self, name, attrs): + if name == "size": + n = attrs.get('name', None) + if not self.context.glx_enum_functions.has_key( n ): + f = glXEnumFunction( n ) + self.context.glx_enum_functions[ f.name ] = f + + temp = attrs.get('count', None) + try: + c = int(temp) + except Exception,e: + raise RuntimeError('Invalid count value "%s" for enum "%s" in function "%s" when an integer was expected.' % (temp, self.name, n)) + + self.context.glx_enum_functions[ n ].append( c, self.value, self.name ) + else: + gl_XML.glEnum.startElement(self, context, name, attrs) + return + + +class glXParameter(gl_XML.glParameter): + def __init__(self, context, name, attrs): + self.order = 1; + gl_XML.glParameter.__init__(self, context, name, attrs); + + +class glXFunction(gl_XML.glFunction): + glx_rop = 0 + glx_sop = 0 + glx_vendorpriv = 0 + + # If this is set to true, it means that GLdouble parameters should be + # written to the GLX protocol packet in the order they appear in the + # prototype. This is different from the "classic" ordering. In the + # classic ordering GLdoubles are written to the protocol packet first, + # followed by non-doubles. NV_vertex_program was the first extension + # to break with this tradition. + + glx_doubles_in_order = 0 + + vectorequiv = None + handcode = 0 + ignore = 0 + can_be_large = 0 + + def __init__(self, context, name, attrs): + self.vectorequiv = attrs.get('vectorequiv', None) + self.count_parameters = None + self.counter = None + self.output = None + self.can_be_large = 0 + self.reply_always_array = 0 + + gl_XML.glFunction.__init__(self, context, name, attrs) + return + + def startElement(self, name, attrs): + """Process elements within a function that are specific to GLX.""" + + if name == "glx": + self.glx_rop = int(attrs.get('rop', "0")) + self.glx_sop = int(attrs.get('sop', "0")) + self.glx_vendorpriv = int(attrs.get('vendorpriv', "0")) + + if attrs.get('handcode', "false") == "true": + self.handcode = 1 + else: + self.handcode = 0 + + if attrs.get('ignore', "false") == "true": + self.ignore = 1 + else: + self.ignore = 0 + + if attrs.get('large', "false") == "true": + self.can_be_large = 1 + else: + self.can_be_large = 0 + + if attrs.get('doubles_in_order', "false") == "true": + self.glx_doubles_in_order = 1 + else: + self.glx_doubles_in_order = 0 + + if attrs.get('always_array', "false") == "true": + self.reply_always_array = 1 + else: + self.reply_always_array = 0 + + else: + gl_XML.glFunction.startElement(self, name, attrs) + + + def append(self, tag_name, p): + gl_XML.glFunction.append(self, tag_name, p) + + if p.is_variable_length_array(): + p.order = 2; + elif not self.glx_doubles_in_order and p.p_type.size == 8: + p.order = 0; + + if p.p_count_parameters != None: + self.count_parameters = p.p_count_parameters + + if p.is_counter: + self.counter = p.name + + if p.is_output: + self.output = p + + return + + def variable_length_parameter(self): + for param in self.fn_parameters: + if param.is_variable_length_array(): + return param + + return None + + + def command_payload_length(self): + size = 0 + size_string = "" + for p in self: + if p.is_output: continue + temp = p.size_string() + try: + s = int(temp) + size += s + except Exception,e: + size_string = size_string + " + __GLX_PAD(%s)" % (temp) + + return [size, size_string] + + def command_length(self): + [size, size_string] = self.command_payload_length() + + if self.glx_rop != 0: + size += 4 + + size = ((size + 3) & ~3) + return "%u%s" % (size, size_string) + + + def opcode_real_value(self): + if self.glx_vendorpriv != 0: + if self.needs_reply(): + return 17 + else: + return 16 + else: + return self.opcode_value() + + def opcode_value(self): + if self.glx_rop != 0: + return self.glx_rop + elif self.glx_sop != 0: + return self.glx_sop + elif self.glx_vendorpriv != 0: + return self.glx_vendorpriv + else: + return -1 + + def opcode_rop_basename(self): + if self.vectorequiv == None: + return self.name + else: + return self.vectorequiv + + def opcode_name(self): + if self.glx_rop != 0: + return "X_GLrop_%s" % (self.opcode_rop_basename()) + elif self.glx_sop != 0: + return "X_GLsop_%s" % (self.name) + elif self.glx_vendorpriv != 0: + return "X_GLvop_%s" % (self.name) + else: + return "ERROR" + + def opcode_real_name(self): + if self.glx_vendorpriv != 0: + if self.needs_reply(): + return "X_GLXVendorPrivateWithReply" + else: + return "X_GLXVendorPrivate" + else: + return self.opcode_name() + + + def return_string(self): + if self.fn_return_type != 'void': + return "return retval;" + else: + return "return;" + + + def needs_reply(self): + return self.fn_return_type != 'void' or self.output != None + + +class GlxProto(gl_XML.FilterGLAPISpecBase): + name = "glX_proto_send.py (from Mesa)" + + def __init__(self): + gl_XML.FilterGLAPISpecBase.__init__(self) + self.factory = glXItemFactory() + self.glx_enum_functions = {} + + + def endElement(self, name): + if name == 'OpenGLAPI': + # Once all the parsing is done, we have to go back and + # fix-up some cross references between different + # functions. + + for k in self.functions: + f = self.functions[k] + if f.vectorequiv != None: + equiv = self.find_function(f.vectorequiv) + if equiv != None: + f.glx_doubles_in_order = equiv.glx_doubles_in_order + f.glx_rop = equiv.glx_rop + else: + raise RuntimeError("Could not find the vector equiv. function %s for %s!" % (f.name, f.vectorequiv)) + else: + gl_XML.FilterGLAPISpecBase.endElement(self, name) + return |