Edit

IABSD.fr/xenocara/lib/mesa/src/mapi/glapi/gen/gl_table.py

Branch :

  • Show log

    Commit

  • Author : jsg
    Date : 2025-06-05 14:17:56
    Hash : 452696b8
    Message : Merge Mesa 25.0.7

  • lib/mesa/src/mapi/glapi/gen/gl_table.py
  • # (C) Copyright IBM Corporation 2004
    # All Rights Reserved.
    # Copyright (c) 2014 Intel Corporation
    #
    # 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 <idr@us.ibm.com>
    
    import argparse
    
    import gl_XML
    import license
    
    
    class PrintGlTable(gl_XML.gl_print_base):
        def __init__(self):
            gl_XML.gl_print_base.__init__(self)
    
            self.header_tag = '_GLAPI_TABLE_H_'
            self.name = "gl_table.py (from Mesa)"
            self.license = license.bsd_license_template % ( \
    """Copyright (C) 1999-2003  Brian Paul   All Rights Reserved.
    (C) Copyright IBM Corporation 2004""", "BRIAN PAUL, IBM")
            return
    
        def printBody(self, api):
            for f in api.functionIterateByOffset():
                arg_string = f.get_parameter_string()
                print('   %s (GLAPIENTRYP %s)(%s); /* %d */' % (
                    f.return_type, f.name, arg_string, f.offset))
    
        def printRealHeader(self):
            print('#include "util/glheader.h"')
            print('')
            print('#ifdef __cplusplus')
            print('extern "C" {')
            print('#endif')
            print('')
            print('#if defined(_WIN32) && defined(_WINDOWS_)')
            print('#error "Should not include <windows.h> here"')
            print('#endif')
            print('')
            print('struct _glapi_table')
            print('{')
            return
    
        def printRealFooter(self):
            print('};')
            print('')
            print('#ifdef __cplusplus')
            print('}')
            print('#endif')
            return
    
    
    class PrintRemapTable(gl_XML.gl_print_base):
        def __init__(self):
            gl_XML.gl_print_base.__init__(self)
    
            self.header_tag = '_DISPATCH_H_'
            self.name = "gl_table.py (from Mesa)"
            self.license = license.bsd_license_template % (
                "(C) Copyright IBM Corporation 2005", "IBM")
            return
    
    
        def printRealHeader(self):
            print("""
    /**
     * \\file main/dispatch.h
     * Macros for handling GL dispatch tables.
     *
     * For each known GL function, there are 3 macros in this file.  The first
     * macro is named CALL_FuncName and is used to call that GL function using
     * the specified dispatch table.  The other 2 macros, called GET_FuncName
     * can SET_FuncName, are used to get and set the dispatch pointer for the
     * named function in the specified dispatch table.
     */
    
    #include "util/glheader.h"
    """)
            return
    
    
        def printBody(self, api):
            print('#define CALL_by_offset(disp, cast, offset, parameters) \\')
            print('    (*(cast (GET_by_offset(disp, offset)))) parameters')
            print('#define GET_by_offset(disp, offset) \\')
            print('    (offset >= 0) ? (((_glapi_proc *)(disp))[offset]) : NULL')
            print('#define SET_by_offset(disp, offset, fn) \\')
            print('    do { \\')
            print('        if ( (offset) < 0 ) { \\')
            print('            /* fprintf( stderr, "[%s:%u] SET_by_offset(%p, %d, %s)!\\n", */ \\')
            print('            /*         __func__, __LINE__, disp, offset, # fn); */ \\')
            print('            /* abort(); */ \\')
            print('        } \\')
            print('        else { \\')
            print('            ( (_glapi_proc *) (disp) )[offset] = (_glapi_proc) fn; \\')
            print('        } \\')
            print('    } while(0)')
            print('')
    
            abi_functions = [f for f in api.functionIterateByOffset()]
    
            print('/* total number of offsets below */')
            print('#define _gloffset_COUNT %d' % (len(abi_functions)))
            print('')
    
            for f in abi_functions:
                print('#define _gloffset_%s %d' % (f.name, f.offset))
    
            print('')
    
            for f in abi_functions:
                arg_string = gl_XML.create_parameter_string(f.parameters, 0)
    
                print('typedef %s (GLAPIENTRYP _glptr_%s)(%s);' % (f.return_type, f.name, arg_string))
                print('#define CALL_{0}(disp, parameters) (* GET_{0}(disp)) parameters'.format(f.name))
                print('#define GET_{0}(disp) ((_glptr_{0})(GET_by_offset((disp), _gloffset_{0})))'.format(f.name))
                print("""#define SET_{0}(disp, func) do {{ \\
       {1} (GLAPIENTRYP fn)({2}) = func; \\
       SET_by_offset(disp, _gloffset_{0}, fn); \\
    }} while (0)
    """.format(f.name, f.return_type, arg_string))
    
            return
    
    
    def _parser():
        """Parse arguments and return a namespace."""
        parser = argparse.ArgumentParser()
        parser.add_argument('-f', '--filename',
                            default='gl_API.xml',
                            metavar="input_file_name",
                            dest='file_name',
                            help="Path to an XML description of OpenGL API.")
        parser.add_argument('-m', '--mode',
                            choices=['table', 'dispatch'],
                            default='table',
                            metavar="mode",
                            help="Generate either a table or a dispatch")
        return parser.parse_args()
    
    
    def main():
        """Main function."""
        args = _parser()
    
        api = gl_XML.parse_GL_API(args.file_name)
    
        if args.mode == "table":
            printer = PrintGlTable()
        elif args.mode == "dispatch":
            printer = PrintRemapTable()
    
        printer.Print(api)
    
    
    if __name__ == '__main__':
        main()