workbench/libs/mesa/src/mapi/glapi/gen/gl_procs.py

   1 #!/usr/bin/env python
   2
   3 # (C) Copyright IBM Corporation 2004, 2005
   4 # All Rights Reserved.
   5 #
   6 # Permission is hereby granted, free of charge, to any person obtaining a
   7 # copy of this software and associated documentation files (the "Software"),
   8 # to deal in the Software without restriction, including without limitation
   9 # on the rights to use, copy, modify, merge, publish, distribute, sub
  10 # license, and/or sell copies of the Software, and to permit persons to whom
  11 # the Software is furnished to do so, subject to the following conditions:
  12 #
  13 # The above copyright notice and this permission notice (including the next
  14 # paragraph) shall be included in all copies or substantial portions of the
  15 # Software.
  16 #
  17 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19 # FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
  20 # IBM AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  21 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  22 # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  23 # IN THE SOFTWARE.
  24 #
  25 # Authors:
  26 #    Ian Romanick <idr@us.ibm.com>
  27
  28 import license
  29 import gl_XML, glX_XML
  30 import sys, getopt
  31
  32 class PrintGlProcs(gl_XML.gl_print_base):
  33         def __init__(self, long_strings, es=False):
  34                 gl_XML.gl_print_base.__init__(self)
  35
  36                 self.es = es
  37                 self.long_strings = long_strings
  38                 self.name = "gl_procs.py (from Mesa)"
  39                 self.license = license.bsd_license_template % ( \
  40 """Copyright (C) 1999-2001  Brian Paul   All Rights Reserved.
  41 (C) Copyright IBM Corporation 2004, 2006""", "BRIAN PAUL, IBM")
  42
  43
  44         def printRealHeader(self):
  45                 print """
  46 /* This file is only included by glapi.c and is used for
  47  * the GetProcAddress() function
  48  */
  49
  50 typedef struct {
  51     GLint Name_offset;
  52 #if defined(NEED_FUNCTION_POINTER) || defined(GLX_INDIRECT_RENDERING)
  53     _glapi_proc Address;
  54 #endif
  55     GLuint Offset;
  56 } glprocs_table_t;
  57
  58 #if   !defined(NEED_FUNCTION_POINTER) && !defined(GLX_INDIRECT_RENDERING)
  59 #  define NAME_FUNC_OFFSET(n,f1,f2,f3,o) { n , o }
  60 #elif  defined(NEED_FUNCTION_POINTER) && !defined(GLX_INDIRECT_RENDERING)
  61 #  define NAME_FUNC_OFFSET(n,f1,f2,f3,o) { n , (_glapi_proc) f1 , o }
  62 #elif  defined(NEED_FUNCTION_POINTER) &&  defined(GLX_INDIRECT_RENDERING)
  63 #  define NAME_FUNC_OFFSET(n,f1,f2,f3,o) { n , (_glapi_proc) f2 , o }
  64 #elif !defined(NEED_FUNCTION_POINTER) &&  defined(GLX_INDIRECT_RENDERING)
  65 #  define NAME_FUNC_OFFSET(n,f1,f2,f3,o) { n , (_glapi_proc) f3 , o }
  66 #endif
  67
  68 """
  69                 return
  70
  71         def printRealFooter(self):
  72                 print ''
  73                 print '#undef NAME_FUNC_OFFSET'
  74                 return
  75
  76         def printFunctionString(self, name):
  77                 if self.long_strings:
  78                         print '    "gl%s\\0"' % (name)
  79                 else:
  80                         print "    'g','l',",
  81                         for c in name:
  82                                 print "'%s'," % (c),
  83
  84                         print "'\\0',"
  85
  86
  87         def printBody(self, api):
  88                 print ''
  89                 if self.long_strings:
  90                         print 'static const char gl_string_table[] ='
  91                 else:
  92                         print 'static const char gl_string_table[] = {'
  93
  94                 base_offset = 0
  95                 table = []
  96                 for func in api.functionIterateByOffset():
  97                         name = func.dispatch_name()
  98                         self.printFunctionString(func.name)
  99                         table.append((base_offset, "gl" + name, "gl" + name, "NULL", func.offset))
 100
 101                         # The length of the function's name, plus 2 for "gl",
 102                         # plus 1 for the NUL.
 103
 104                         base_offset += len(func.name) + 3
 105
 106
 107                 for func in api.functionIterateByOffset():
 108                         for n in func.entry_points:
 109                                 if n != func.name:
 110                                         # AROS: call into a static dispach instead of alliased function dispatch
 111                                         # This will be needed as long as gl_procs.h is used to generate the
 112                                         # AROSMesaGetProcAddress function table which is located in libGL.a
 113                                         # name = func.dispatch_name()
 114                                         name = n
 115                                         self.printFunctionString( n )
 116
 117                                         if func.has_different_protocol(n):
 118                                                 alt_name = "gl" + func.static_glx_name(n)
 119                                                 table.append((base_offset, "gl" + name, alt_name, alt_name, func.offset))
 120                                         else:
 121                                                 table.append((base_offset, "gl" + name, "gl" + name, "NULL", func.offset))
 122
 123                                         base_offset += len(n) + 3
 124
 125
 126                 if self.long_strings:
 127                         print '    ;'
 128                 else:
 129                         print '};'
 130
 131                 print ''
 132                 print ''
 133                 print "#ifdef USE_MGL_NAMESPACE"
 134                 for func in api.functionIterateByOffset():
 135                         for n in func.entry_points:
 136                                 if (not func.is_static_entry_point(func.name)) or (func.has_different_protocol(n) and not func.is_static_entry_point(n)):
 137                                         print '#define gl_dispatch_stub_%u mgl_dispatch_stub_%u' % (func.offset, func.offset)
 138                                         break
 139                 print "#endif /* USE_MGL_NAMESPACE */"
 140                 print ''
 141                 print ''
 142                 print '#if defined(NEED_FUNCTION_POINTER) || defined(GLX_INDIRECT_RENDERING)'
 143                 for func in api.functionIterateByOffset():
 144                         for n in func.entry_points:
 145                                 if (not func.is_static_entry_point(func.name)) or (func.has_different_protocol(n) and not func.is_static_entry_point(n)):
 146                                         print '%s GLAPIENTRY gl_dispatch_stub_%u(%s);' % (func.return_type, func.offset, func.get_parameter_string())
 147                                         break
 148
 149                 if self.es:
 150                         categories = {}
 151                         for func in api.functionIterateByOffset():
 152                                 for n in func.entry_points:
 153                                         cat, num = api.get_category_for_name(n)
 154                                         if (cat.startswith("es") or cat.startswith("GL_OES")):
 155                                                 if not categories.has_key(cat):
 156                                                         categories[cat] = []
 157                                                 proto = 'GLAPI %s GLAPIENTRY %s(%s);' \
 158                                                                 % (func.return_type, "gl" + n, func.get_parameter_string(n))
 159                                                 categories[cat].append(proto)
 160                         if categories:
 161                                 print ''
 162                                 print '/* OpenGL ES specific prototypes */'
 163                                 print ''
 164                                 keys = categories.keys()
 165                                 keys.sort()
 166                                 for key in keys:
 167                                         print '/* category %s */' % key
 168                                         print "\n".join(categories[key])
 169                                 print ''
 170
 171                 print '#endif /* defined(NEED_FUNCTION_POINTER) || defined(GLX_INDIRECT_RENDERING) */'
 172
 173                 print ''
 174                 print 'static const glprocs_table_t static_functions[] = {'
 175
 176                 for info in table:
 177                         print '    NAME_FUNC_OFFSET(%5u, %s, %s, %s, %d),' % info
 178
 179                 print '    NAME_FUNC_OFFSET(-1, NULL, NULL, NULL, 0)'
 180                 print '};'
 181                 return
 182
 183
 184 def show_usage():
 185         print "Usage: %s [-f input_file_name] [-m mode] [-c]" % sys.argv[0]
 186         print "-c          Enable compatibility with OpenGL ES."
 187         print "-m mode     mode can be one of:"
 188         print "    long  - Create code for compilers that can handle very"
 189         print "            long string constants. (default)"
 190         print "    short - Create code for compilers that can only handle"
 191         print "            ANSI C89 string constants."
 192         sys.exit(1)
 193
 194 if __name__ == '__main__':
 195         file_name = "gl_API.xml"
 196
 197         try:
 198                 (args, trail) = getopt.getopt(sys.argv[1:], "f:m:c")
 199         except Exception,e:
 200                 show_usage()
 201
 202         long_string = 1
 203         es = False
 204         for (arg,val) in args:
 205                 if arg == "-f":
 206                         file_name = val
 207                 elif arg == "-m":
 208                         if val == "short":
 209                                 long_string = 0
 210                         elif val == "long":
 211                                 long_string = 1
 212                         else:
 213                                 show_usage()
 214                 elif arg == "-c":
 215                     es = True
 216
 217         api = gl_XML.parse_GL_API(file_name, glX_XML.glx_item_factory())
 218         printer = PrintGlProcs(long_string, es)
 219         printer.Print(api)