X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=src%2Fmesa%2Fglapi%2FglX_XML.py;h=e0f07e576e4de7dc18fb0222db34f23b1300324c;hb=711555d1e347f0e64e6b1b2d0e402e0ee72ace07;hp=9a34111efe78ee5a0a82a8eec8453fcb964018e2;hpb=c2803587b6f2533514e1cfa9793d0a448e9c2c85;p=mesa.git diff --git a/src/mesa/glapi/glX_XML.py b/src/mesa/glapi/glX_XML.py index 9a34111efe7..e0f07e576e4 100644 --- a/src/mesa/glapi/glX_XML.py +++ b/src/mesa/glapi/glX_XML.py @@ -1,4 +1,4 @@ -#!/usr/bin/python2 +#!/usr/bin/env python # (C) Copyright IBM Corporation 2004, 2005 # All Rights Reserved. @@ -25,449 +25,324 @@ # Authors: # Ian Romanick -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 +import sys, getopt, string -class glXItemFactory(gl_XML.glItemFactory): - """Factory to create GLX protocol oriented objects derived from glItem.""" +class glx_item_factory(gl_XML.gl_item_factory): + """Factory to create GLX protocol oriented objects derived from gl_item.""" - def create(self, context, name, attrs): + def create_item(self, name, element, context): if name == "function": - return glXFunction(context, name, attrs) + return glx_function(element, context) 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, context): - self.name = name - self.context = context - self.mode = 0 - self.sig = None - - # "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) + return glx_enum(element, context) + elif name == "api": + return glx_api(self) 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 ): - if self.sig == None: - self.sig = "" - for i in self.count: - self.count[i].sort() - for e in self.count[i]: - self.sig += "%04x,%u," % (e, i) - - return self.sig - - - def set_mode( self, mode ): - """Mark an enum-function as a 'set' function.""" - - self.mode = mode - + return gl_XML.gl_item_factory.create_item(self, name, element, context) - def is_set( self ): - return self.mode - - 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. +class glx_enum(gl_XML.gl_enum): + def __init__(self, element, context): + gl_XML.gl_enum.__init__(self, element, context) - 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 ' }' + self.functions = {} + + child = element.children + while child: + if child.type == "element" and child.name == "size": + n = child.nsProp( "name", None ) + c = child.nsProp( "count", None ) + m = child.nsProp( "mode", None ) + + if not c: + c = self.default_count + + if m == "get": + mode = 0 + else: + mode = 1 + if not self.functions.has_key(n): + self.functions[ n ] = [c, mode] - def Print(self, name): - print 'INTERNAL PURE FASTCALL GLint' - print '__gl%s_size( GLenum e )' % (name) - print '{' + child = child.next - if not self.PrintUsingTable(): - self.PrintUsingSwitch() + return - print '}' - print '' +class glx_function(gl_XML.gl_function): + def __init__(self, element, context): + self.glx_rop = 0 + self.glx_sop = 0 + self.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. -class glXEnum(gl_XML.glEnum): - def __init__(self, context, name, attrs): - gl_XML.glEnum.__init__(self, context, name, attrs) + self.glx_doubles_in_order = 0 + self.vectorequiv = None + self.output = None + self.can_be_large = 0 + self.reply_always_array = 0 + self.dimensions_in_reply = 0 + self.img_reset = None - def startElement(self, name, attrs): - if name == "size": - [n, c, mode] = self.process_attributes(attrs) + self.server_handcode = 0 + self.client_handcode = 0 + self.ignore = 0 - if not self.context.glx_enum_functions.has_key( n ): - f = self.context.createEnumFunction( n ) - f.set_mode( mode ) - self.context.glx_enum_functions[ f.name ] = f + self.count_parameter_list = [] + self.counter_list = [] + self.parameters_by_name = {} + self.offsets_calculated = 0 - self.context.glx_enum_functions[ n ].append( c, self.value, self.name ) - else: - gl_XML.glEnum.startElement(self, context, name, attrs) + gl_XML.gl_function.__init__(self, element, context) return -class glXParameter(gl_XML.glParameter): - def __init__(self, context, name, attrs): - self.order = 1; - gl_XML.glParameter.__init__(self, context, name, attrs); - - -class glXParameterIterator: - """Class to iterate over a list of glXParameters. - - Objects of this class are returned by the parameterIterator method of - the glXFunction class. They are used to iterate over the list of - parameters to the function.""" + def process_element(self, element): + gl_XML.gl_function.process_element(self, element) - def __init__(self, data, skip_output, max_order): - self.data = data - self.index = 0 - self.order = 0 - self.skip_output = skip_output - self.max_order = max_order + self.vectorequiv = element.nsProp( "vectorequiv", None ) - def __iter__(self): - return self - def next(self): - if len( self.data ) == 0: - raise StopIteration + if element.nsProp( "name", None ) == self.name: + for param in self.parameters: + self.parameters_by_name[ param.name ] = param + + if len(param.count_parameter_list): + self.count_parameter_list.extend( param.count_parameter_list ) + + if param.counter and param.counter not in self.counter_list: + self.counter_list.append(param.counter) - while 1: - if self.index == len( self.data ): - if self.order == self.max_order: - raise StopIteration - else: - self.order += 1 - self.index = 0 - i = self.index - self.index += 1 + child = element.children + while child: + if child.type == "element": + if child.name == "glx": + rop = child.nsProp( 'rop', None ) + sop = child.nsProp( 'sop', None ) + vop = child.nsProp( 'vendorpriv', None ) - if self.data[i].order == self.order and not (self.data[i].is_output and self.skip_output): - return self.data[i] + if rop: + self.glx_rop = int(rop) + else: + self.glx_rop = 0 + if sop: + self.glx_sop = int(sop) + else: + self.glx_sop = 0 -class glXFunction(gl_XML.glFunction): - glx_rop = 0 - glx_sop = 0 - glx_vendorpriv = 0 + if vop: + self.glx_vendorpriv = int(vop) + else: + self.glx_vendorpriv = 0 + + self.img_reset = child.nsProp( 'img_reset', None ) + + # The 'handcode' attribute can be one of 'true', + # 'false', 'client', or 'server'. + + handcode = child.nsProp( 'handcode', None ) + if handcode == "false": + self.server_handcode = 0 + self.client_handcode = 0 + elif handcode == "true": + self.server_handcode = 1 + self.client_handcode = 1 + elif handcode == "client": + self.server_handcode = 0 + self.client_handcode = 1 + elif handcode == "server": + self.server_handcode = 1 + self.client_handcode = 0 + else: + raise RuntimeError('Invalid handcode mode "%s" in function "%s".' % (handcode, self.name)) - # 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. + self.ignore = gl_XML.is_attr_true( child, 'ignore' ) + self.can_be_large = gl_XML.is_attr_true( child, 'large' ) + self.glx_doubles_in_order = gl_XML.is_attr_true( child, 'doubles_in_order' ) + self.reply_always_array = gl_XML.is_attr_true( child, 'always_array' ) + self.dimensions_in_reply = gl_XML.is_attr_true( child, 'dimensions_in_reply' ) - glx_doubles_in_order = 0 + child = child.next - vectorequiv = None - 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 + # Do some validation of the GLX protocol information. As + # new tests are discovered, they should be added here. - self.server_handcode = 0 - self.client_handcode = 0 - self.ignore = 0 + for param in self.parameters: + if param.is_output and self.glx_rop != 0: + raise RuntimeError("Render / RenderLarge commands cannot have outputs (%s)." % (self.name)) - gl_XML.glFunction.__init__(self, context, name, attrs) return - def parameterIterator(self, skip_output, max_order): - return glXParameterIterator(self.fn_parameters, skip_output, max_order) + def has_variable_size_request(self): + """Determine if the GLX request packet is variable sized. + The GLX request packet is variable sized in several common + situations. - 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")) - - # The 'handcode' attribute can be one of 'true', - # 'false', 'client', or 'server'. - - handcode = attrs.get('handcode', "false") - if handcode == "false": - self.server_handcode = 0 - self.client_handcode = 0 - elif handcode == "true": - self.server_handcode = 1 - self.client_handcode = 1 - elif handcode == "client": - self.server_handcode = 0 - self.client_handcode = 1 - elif handcode == "server": - self.server_handcode = 1 - self.client_handcode = 0 - else: - raise RuntimeError('Invalid handcode mode "%s" in function "%s".' % (handcode, self.name)) - - - if attrs.get('ignore', "false") == "true": - self.ignore = 1 - else: - self.ignore = 0 + 1. The function has a non-output parameter that is counted + by another parameter (e.g., the 'textures' parameter of + glDeleteTextures). + + 2. The function has a non-output parameter whose count is + determined by another parameter that is an enum (e.g., the + 'params' parameter of glLightfv). + + 3. The function has a non-output parameter that is an + image. + + 4. The function must be hand-coded on the server. + """ + + if self.glx_rop == 0: + return 0 - if attrs.get('large', "false") == "true": - self.can_be_large = 1 - else: - self.can_be_large = 0 + if self.server_handcode or self.images: + return 1 - if attrs.get('doubles_in_order', "false") == "true": - self.glx_doubles_in_order = 1 - else: - self.glx_doubles_in_order = 0 + for param in self.parameters: + if not param.is_output: + if param.counter or len(param.count_parameter_list): + return 1 - if attrs.get('always_array', "false") == "true": - self.reply_always_array = 1 - else: - self.reply_always_array = 0 + return 0 - else: - gl_XML.glFunction.startElement(self, name, attrs) + def variable_length_parameter(self): + for param in self.parameters: + if not param.is_output: + if param.counter or len(param.count_parameter_list): + return param + + return None - def endElement(self, name): - if name == "function": - # Mark any function that does not have GLX protocol - # defined as "ignore". This prevents bad things from - # happening when people add new functions to the GL - # API XML without adding any GLX section. - # - # This will also mark functions that don't have a - # dispatch offset at ignored. - if (self.fn_offset == -1 and not self.fn_alias) or not (self.client_handcode or self.server_handcode or self.glx_rop or self.glx_sop or self.glx_vendorpriv or self.vectorequiv or self.fn_alias): - #if not self.ignore: - # if self.fn_offset == -1: - # print '/* %s ignored becuase no offset assigned. */' % (self.name) - # else: - # print '/* %s ignored becuase no GLX opcode assigned. */' % (self.name) + def calculate_offsets(self): + if not self.offsets_calculated: + # Calculate the offset of the first function parameter + # in the GLX command packet. This byte offset is + # measured from the end of the Render / RenderLarge + # header. The offset for all non-pixel commends is + # zero. The offset for pixel commands depends on the + # number of dimensions of the pixel data. - self.ignore = 1 + if len(self.images) and not self.images[0].is_output: + [dim, junk, junk, junk, junk] = self.images[0].get_dimensions() - return gl_XML.glFunction.endElement(self, name) + # The base size is the size of the pixel pack info + # header used by images with the specified number + # of dimensions. + if dim <= 2: + offset = 20 + elif dim <= 4: + offset = 36 + else: + raise RuntimeError('Invalid number of dimensions %u for parameter "%s" in function "%s".' % (dim, self.image.name, self.name)) + else: + offset = 0 - def append(self, tag_name, p): - gl_XML.glFunction.append(self, tag_name, p) + for param in self.parameterIterateGlxSend(): + if param.img_null_flag: + offset += 4 - 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 param.name != self.img_reset: + param.offset = offset + if not param.is_variable_length(): + offset += param.size() + + if self.pad_after( param ): + offset += 4 - 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 + self.offsets_calculated = 1 return - def variable_length_parameter(self): - for param in self.fn_parameters: - if param.is_variable_length_array(): - return param - - return None + def offset_of(self, param_name): + self.calculate_offsets() + return self.parameters_by_name[ param_name ].offset - def output_parameter(self): - for param in self.fn_parameters: - if param.is_output: - return param + def parameterIterateGlxSend(self, include_variable_parameters = 1): + """Create an iterator for parameters in GLX request order.""" - return None + # The parameter lists are usually quite short, so it's easier + # (i.e., less code) to just generate a new list with the + # required elements than it is to create a new iterator class. + + temp = [ [], [], [] ] + for param in self.parameters: + if param.is_output: continue + + if param.is_variable_length(): + temp[2].append( param ) + elif not self.glx_doubles_in_order and param.is_64_bit(): + temp[0].append( param ) + else: + temp[1].append( param ) + parameters = temp[0] + parameters.extend( temp[1] ) + if include_variable_parameters: + parameters.extend( temp[2] ) + return parameters.__iter__() - def offset_of_first_parameter(self): - """Get the offset of the first parameter in the command. - Gets the offset of the first function parameter in the GLX - command packet. This byte offset is measured from the end - of the Render / RenderLarge header. The offset for all non- - pixel commends is zero. The offset for pixel commands depends - on the number of dimensions of the pixel data.""" + def parameterIterateCounters(self): + temp = [] + for name in self.counter_list: + temp.append( self.parameters_by_name[ name ] ) - if self.image: - [dim, junk, junk, junk, junk] = self.dimensions() + return temp.__iter__() - # The base size is the size of the pixel pack info - # header used by images with the specified number - # of dimensions. - if dim <= 2: - return 20 - elif dim <= 4: - return 36 - else: - raise RuntimeError('Invalid number of dimensions %u for parameter "%s" in function "%s".' % (dim, self.image.name, self.name)) - else: - return 0 + def parameterIterateOutputs(self): + temp = [] + for p in self.parameters: + if p.is_output: + temp.append( p ) + + return temp def command_fixed_length(self): """Return the length, in bytes as an integer, of the fixed-size portion of the command.""" - size = self.offset_of_first_parameter() + if len(self.parameters) == 0: + return 0 + + self.calculate_offsets() + + size = 0 + for param in self.parameterIterateGlxSend(0): + if param.name != self.img_reset: + if size == 0: + size = param.offset + param.size() + else: + size += param.size() - for p in gl_XML.glFunction.parameterIterator(self): - if not p.is_output: - size += p.size() - if self.pad_after(p): + if self.pad_after( param ): size += 4 - if self.image and self.image.img_null_flag: - size += 4 + for param in self.images: + if param.img_null_flag or param.is_output: + size += 4 return size @@ -477,9 +352,15 @@ class glXFunction(gl_XML.glFunction): portion of the command.""" size_string = "" - for p in gl_XML.glFunction.parameterIterator(self): - if (not p.is_output) and (p.size() == 0): - size_string = size_string + " + __GLX_PAD(%s)" % (p.size_string()) + for p in self.parameterIterateGlxSend(): + if (not p.is_output) and (p.is_variable_length() or p.is_image()): + # FIXME Replace the 1 in the size_string call + # FIXME w/0 to eliminate some un-needed parnes + # FIXME This would already be done, but it + # FIXME adds some extra diffs to the generated + # FIXME code. + + size_string = size_string + " + __GLX_PAD(%s)" % (p.size_string(1)) return size_string @@ -513,9 +394,15 @@ class glXFunction(gl_XML.glFunction): else: return self.opcode_value() + def opcode_value(self): """Get the unique protocol opcode for the glXFunction""" + if (self.glx_rop == 0) and self.vectorequiv: + equiv = self.context.functions_by_name[ self.vectorequiv ] + self.glx_rop = equiv.glx_rop + + if self.glx_rop != 0: return self.glx_rop elif self.glx_sop != 0: @@ -525,6 +412,7 @@ class glXFunction(gl_XML.glFunction): else: return -1 + def opcode_rop_basename(self): """Return either the name to be used for GLX protocol enum. @@ -537,9 +425,16 @@ class glXFunction(gl_XML.glFunction): else: return self.vectorequiv + def opcode_name(self): """Get the unique protocol enum name for the glXFunction""" + if (self.glx_rop == 0) and self.vectorequiv: + equiv = self.context.functions_by_name[ self.vectorequiv ] + self.glx_rop = equiv.glx_rop + self.glx_doubles_in_order = equiv.glx_doubles_in_order + + if self.glx_rop != 0: return "X_GLrop_%s" % (self.opcode_rop_basename()) elif self.glx_sop != 0: @@ -547,7 +442,8 @@ class glXFunction(gl_XML.glFunction): elif self.glx_vendorpriv != 0: return "X_GLvop_%s" % (self.name) else: - return "ERROR" + raise RuntimeError('Function "%s" has no opcode.' % (self.name)) + def opcode_real_name(self): """Get the true protocol enum name for the GLX opcode @@ -568,99 +464,66 @@ class glXFunction(gl_XML.glFunction): 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 - - - def dimensions(self): - """Determine the dimensions of an image. - - Returns a tuple representing the number of dimensions and the - string name of each of the dimensions of an image, If the - function is not a pixel function, the number of dimensions - will be zero.""" + try: + x = self._needs_reply + except Exception, e: + x = 0 + if self.return_type != 'void': + x = 1 - if not self.image: - return [0, "0", "0", "0", "0"] - else: - dim = 1 - w = self.image.width - - if self.image.height: - dim = 2 - h = self.image.height - else: - h = "1" + for param in self.parameters: + if param.is_output: + x = 1 + break - if self.image.depth: - dim = 3 - d = self.image.depth - else: - d = "1" - - if self.image.extent: - dim = 4 - e = self.image.extent - else: - e = "1" + self._needs_reply = x - return [dim, w, h, d, e] + return x def pad_after(self, p): """Returns the name of the field inserted after the specified field to pad out the command header.""" - if self.image and self.image.img_pad_dimensions: - if not self.image.height: - if p.name == self.image.width: - return "height" - elif p.name == self.image.img_xoff: - return "yoffset" - elif not self.image.extent: - if p.name == self.image.depth: - # Should this be "size4d"? - return "extent" - elif p.name == self.image.img_zoff: - return "woffset" + for image in self.images: + if image.img_pad_dimensions: + if not image.height: + if p.name == image.width: + return "height" + elif p.name == image.img_xoff: + return "yoffset" + elif not image.extent: + if p.name == image.depth: + # Should this be "size4d"? + return "extent" + elif p.name == image.img_zoff: + return "woffset" + return 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) + +class glx_function_iterator: + """Class to iterate over a list of glXFunctions""" + + def __init__(self, context): + self.iterator = context.functionIterateByOffset() return - def createEnumFunction(self, n): - return glXEnumFunction(n, self) + def __iter__(self): + return self + + + def next(self): + f = self.iterator.next() + if f.ignore or not (f.glx_rop or f.glx_sop or f.glx_vendorpriv or f.vectorequiv or f.client_handcode): + return self.next() + else: + return f + + +class glx_api(gl_XML.gl_api): + def functionIterateGlx(self): + return glx_function_iterator(self) +