2004-05-24 18:48:21 +01:00
|
|
|
|
|
|
|
# (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 <idr@us.ibm.com>
|
|
|
|
|
2015-02-13 23:49:16 +00:00
|
|
|
import argparse
|
|
|
|
|
2006-10-11 23:37:14 +01:00
|
|
|
import license
|
|
|
|
import gl_XML, glX_XML
|
2004-05-24 18:48:21 +01:00
|
|
|
|
Mammoth update to the Python code generator scripts that live in
src/mesa/glapi. Basically, the scripts that did simple things (like
gl_offsets.py) were simple, and the scripts that did more complicated things
(like glX_proto_send.py) were getting progressively more and more out of
control. So, I re-write the foundation classes on which everything is based.
One problem with the existing code is that the division between the GL API
database representation and the way the output code is generated was either
blury or nonexistant. The new code somewhat follows the
Model-View-Controller pattern, minus the Controller. There is a distinct
set of classes that model the API data, and there is a distinct set of
classes that generate code from that data.
One big change is in the class that represents GL functions (was glFunction,
is now gl_function). There used to be an instance of this calls for each
function and for each alias to that function. For example, there was an
instance for PointParameterivSGIS, PointParameterivEXT, PointParameterivARB,
and PointParameteriv. In the new code, there is one instance. Each
instance has a list of entrypoint names for the function. In the next
revision, this will allow a couple useful things. The script will be able
to verify that the parameters, return type, and GLX protocol for a function
and all it's aliases match.
It will also allow aliases to be represented in the XML more compactly.
Instead of repeating all the information, an alias can be listed as:
<function name="PointParameterivARB" alias="PointParameterivEXT"/>
Because the data representation was changed, the order that the alias
functions are processed by the scripts also changed. This accounts for at
least 2,700 of the ~3,600 lines of diffs in the generated code.
Most of the remaining ~900 lines of diffs are the result of bugs *fixed* by
the new scripts. The old scripts also generated code with some bugs in it.
These bugs were discovered while the new code was being written.
These changes were discussed on the mesa3d-dev mailing list back at the end
of May:
http://marc.theaimsgroup.com/?t=111714569000004&r=1&w=2
Xorg bug: 3197, 3208
2005-06-22 00:42:43 +01:00
|
|
|
class PrintGenericStubs(gl_XML.gl_print_base):
|
2012-10-10 15:20:57 +01:00
|
|
|
def __init__(self):
|
|
|
|
gl_XML.gl_print_base.__init__(self)
|
|
|
|
self.name = "gl_SPARC_asm.py (from Mesa)"
|
|
|
|
self.license = license.bsd_license_template % ( \
|
2004-05-24 18:48:21 +01:00
|
|
|
"""Copyright (C) 1999-2003 Brian Paul All Rights Reserved.
|
|
|
|
(C) Copyright IBM Corporation 2004""", "BRIAN PAUL, IBM")
|
|
|
|
|
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
def printRealHeader(self):
|
2018-07-05 14:17:32 +01:00
|
|
|
print('#ifdef __arch64__')
|
|
|
|
print('#define GL_OFF(N)\t((N) * 8)')
|
|
|
|
print('#define GL_LL\t\tldx')
|
|
|
|
print('#define GL_TIE_LD(SYM)\t%tie_ldx(SYM)')
|
|
|
|
print('#define GL_STACK_SIZE\t128')
|
|
|
|
print('#else')
|
|
|
|
print('#define GL_OFF(N)\t((N) * 4)')
|
|
|
|
print('#define GL_LL\t\tld')
|
|
|
|
print('#define GL_TIE_LD(SYM)\t%tie_ld(SYM)')
|
|
|
|
print('#define GL_STACK_SIZE\t64')
|
|
|
|
print('#endif')
|
|
|
|
print('')
|
|
|
|
print('#define GLOBL_FN(x) .globl x ; .type x, @function')
|
|
|
|
print('#define HIDDEN(x) .hidden x')
|
|
|
|
print('')
|
|
|
|
print('\t.register %g2, #scratch')
|
|
|
|
print('\t.register %g3, #scratch')
|
|
|
|
print('')
|
|
|
|
print('\t.text')
|
|
|
|
print('')
|
|
|
|
print('\tGLOBL_FN(__glapi_sparc_icache_flush)')
|
|
|
|
print('\tHIDDEN(__glapi_sparc_icache_flush)')
|
|
|
|
print('\t.type\t__glapi_sparc_icache_flush, @function')
|
|
|
|
print('__glapi_sparc_icache_flush: /* %o0 = insn_addr */')
|
|
|
|
print('\tflush\t%o0')
|
|
|
|
print('\tretl')
|
|
|
|
print('\t nop')
|
|
|
|
print('')
|
|
|
|
print('\t.align\t32')
|
|
|
|
print('')
|
|
|
|
print('\t.type\t__glapi_sparc_get_pc, @function')
|
|
|
|
print('__glapi_sparc_get_pc:')
|
|
|
|
print('\tretl')
|
|
|
|
print('\t add\t%o7, %g2, %g2')
|
|
|
|
print('\t.size\t__glapi_sparc_get_pc, .-__glapi_sparc_get_pc')
|
|
|
|
print('')
|
2019-08-03 17:44:44 +01:00
|
|
|
print('#ifdef USE_ELF_TLS')
|
2018-07-05 14:17:32 +01:00
|
|
|
print('')
|
|
|
|
print('\tGLOBL_FN(__glapi_sparc_get_dispatch)')
|
|
|
|
print('\tHIDDEN(__glapi_sparc_get_dispatch)')
|
|
|
|
print('__glapi_sparc_get_dispatch:')
|
|
|
|
print('\tmov\t%o7, %g1')
|
|
|
|
print('\tsethi\t%hi(_GLOBAL_OFFSET_TABLE_-4), %g2')
|
|
|
|
print('\tcall\t__glapi_sparc_get_pc')
|
|
|
|
print('\tadd\t%g2, %lo(_GLOBAL_OFFSET_TABLE_+4), %g2')
|
|
|
|
print('\tmov\t%g1, %o7')
|
|
|
|
print('\tsethi\t%tie_hi22(_glapi_tls_Dispatch), %g1')
|
|
|
|
print('\tadd\t%g1, %tie_lo10(_glapi_tls_Dispatch), %g1')
|
|
|
|
print('\tGL_LL\t[%g2 + %g1], %g2, GL_TIE_LD(_glapi_tls_Dispatch)')
|
|
|
|
print('\tretl')
|
|
|
|
print('\t mov\t%g2, %o0')
|
|
|
|
print('')
|
|
|
|
print('\t.data')
|
|
|
|
print('\t.align\t32')
|
|
|
|
print('')
|
|
|
|
print('\t/* --> sethi %hi(_glapi_tls_Dispatch), %g1 */')
|
|
|
|
print('\t/* --> or %g1, %lo(_glapi_tls_Dispatch), %g1 */')
|
|
|
|
print('\tGLOBL_FN(__glapi_sparc_tls_stub)')
|
|
|
|
print('\tHIDDEN(__glapi_sparc_tls_stub)')
|
|
|
|
print('__glapi_sparc_tls_stub: /* Call offset in %g3 */')
|
|
|
|
print('\tmov\t%o7, %g1')
|
|
|
|
print('\tsethi\t%hi(_GLOBAL_OFFSET_TABLE_-4), %g2')
|
|
|
|
print('\tcall\t__glapi_sparc_get_pc')
|
|
|
|
print('\tadd\t%g2, %lo(_GLOBAL_OFFSET_TABLE_+4), %g2')
|
|
|
|
print('\tmov\t%g1, %o7')
|
|
|
|
print('\tsrl\t%g3, 10, %g3')
|
|
|
|
print('\tsethi\t%tie_hi22(_glapi_tls_Dispatch), %g1')
|
|
|
|
print('\tadd\t%g1, %tie_lo10(_glapi_tls_Dispatch), %g1')
|
|
|
|
print('\tGL_LL\t[%g2 + %g1], %g2, GL_TIE_LD(_glapi_tls_Dispatch)')
|
|
|
|
print('\tGL_LL\t[%g7+%g2], %g1')
|
|
|
|
print('\tGL_LL\t[%g1 + %g3], %g1')
|
|
|
|
print('\tjmp\t%g1')
|
|
|
|
print('\t nop')
|
|
|
|
print('\t.size\t__glapi_sparc_tls_stub, .-__glapi_sparc_tls_stub')
|
|
|
|
print('')
|
|
|
|
print('#define GL_STUB(fn, off)\t\t\t\t\\')
|
|
|
|
print('\tGLOBL_FN(fn);\t\t\t\t\t\\')
|
|
|
|
print('fn:\tba\t__glapi_sparc_tls_stub;\t\t\t\\')
|
|
|
|
print('\t sethi\tGL_OFF(off), %g3;\t\t\t\\')
|
|
|
|
print('\t.size\tfn,.-fn;')
|
|
|
|
print('')
|
|
|
|
print('#elif defined(HAVE_PTHREAD)')
|
|
|
|
print('')
|
|
|
|
print('\t/* 64-bit 0x00 --> sethi %hh(_glapi_Dispatch), %g1 */')
|
|
|
|
print('\t/* 64-bit 0x04 --> sethi %lm(_glapi_Dispatch), %g2 */')
|
|
|
|
print('\t/* 64-bit 0x08 --> or %g1, %hm(_glapi_Dispatch), %g1 */')
|
|
|
|
print('\t/* 64-bit 0x0c --> sllx %g1, 32, %g1 */')
|
|
|
|
print('\t/* 64-bit 0x10 --> add %g1, %g2, %g1 */')
|
|
|
|
print('\t/* 64-bit 0x14 --> ldx [%g1 + %lo(_glapi_Dispatch)], %g1 */')
|
|
|
|
print('')
|
|
|
|
print('\t/* 32-bit 0x00 --> sethi %hi(_glapi_Dispatch), %g1 */')
|
|
|
|
print('\t/* 32-bit 0x04 --> ld [%g1 + %lo(_glapi_Dispatch)], %g1 */')
|
|
|
|
print('')
|
|
|
|
print('\t.data')
|
|
|
|
print('\t.align\t32')
|
|
|
|
print('')
|
|
|
|
print('\tGLOBL_FN(__glapi_sparc_pthread_stub)')
|
|
|
|
print('\tHIDDEN(__glapi_sparc_pthread_stub)')
|
|
|
|
print('__glapi_sparc_pthread_stub: /* Call offset in %g3 */')
|
|
|
|
print('\tmov\t%o7, %g1')
|
|
|
|
print('\tsethi\t%hi(_GLOBAL_OFFSET_TABLE_-4), %g2')
|
|
|
|
print('\tcall\t__glapi_sparc_get_pc')
|
|
|
|
print('\t add\t%g2, %lo(_GLOBAL_OFFSET_TABLE_+4), %g2')
|
|
|
|
print('\tmov\t%g1, %o7')
|
|
|
|
print('\tsethi\t%hi(_glapi_Dispatch), %g1')
|
|
|
|
print('\tor\t%g1, %lo(_glapi_Dispatch), %g1')
|
|
|
|
print('\tsrl\t%g3, 10, %g3')
|
|
|
|
print('\tGL_LL\t[%g2+%g1], %g2')
|
|
|
|
print('\tGL_LL\t[%g2], %g1')
|
|
|
|
print('\tcmp\t%g1, 0')
|
|
|
|
print('\tbe\t2f')
|
|
|
|
print('\t nop')
|
|
|
|
print('1:\tGL_LL\t[%g1 + %g3], %g1')
|
|
|
|
print('\tjmp\t%g1')
|
|
|
|
print('\t nop')
|
|
|
|
print('2:\tsave\t%sp, GL_STACK_SIZE, %sp')
|
|
|
|
print('\tmov\t%g3, %l0')
|
|
|
|
print('\tcall\t_glapi_get_dispatch')
|
|
|
|
print('\t nop')
|
|
|
|
print('\tmov\t%o0, %g1')
|
|
|
|
print('\tmov\t%l0, %g3')
|
|
|
|
print('\tba\t1b')
|
|
|
|
print('\t restore %g0, %g0, %g0')
|
|
|
|
print('\t.size\t__glapi_sparc_pthread_stub, .-__glapi_sparc_pthread_stub')
|
|
|
|
print('')
|
|
|
|
print('#define GL_STUB(fn, off)\t\t\t\\')
|
|
|
|
print('\tGLOBL_FN(fn);\t\t\t\t\\')
|
|
|
|
print('fn:\tba\t__glapi_sparc_pthread_stub;\t\\')
|
|
|
|
print('\t sethi\tGL_OFF(off), %g3;\t\t\\')
|
|
|
|
print('\t.size\tfn,.-fn;')
|
|
|
|
print('')
|
|
|
|
print('#else /* Non-threaded version. */')
|
|
|
|
print('')
|
|
|
|
print('\t.type __glapi_sparc_nothread_stub, @function')
|
|
|
|
print('__glapi_sparc_nothread_stub: /* Call offset in %g3 */')
|
|
|
|
print('\tmov\t%o7, %g1')
|
|
|
|
print('\tsethi\t%hi(_GLOBAL_OFFSET_TABLE_-4), %g2')
|
|
|
|
print('\tcall\t__glapi_sparc_get_pc')
|
|
|
|
print('\t add\t%g2, %lo(_GLOBAL_OFFSET_TABLE_+4), %g2')
|
|
|
|
print('\tmov\t%g1, %o7')
|
|
|
|
print('\tsrl\t%g3, 10, %g3')
|
|
|
|
print('\tsethi\t%hi(_glapi_Dispatch), %g1')
|
|
|
|
print('\tor\t%g1, %lo(_glapi_Dispatch), %g1')
|
|
|
|
print('\tGL_LL\t[%g2+%g1], %g2')
|
|
|
|
print('\tGL_LL\t[%g2], %g1')
|
|
|
|
print('\tGL_LL\t[%g1 + %g3], %g1')
|
|
|
|
print('\tjmp\t%g1')
|
|
|
|
print('\t nop')
|
|
|
|
print('\t.size\t__glapi_sparc_nothread_stub, .-__glapi_sparc_nothread_stub')
|
|
|
|
print('')
|
|
|
|
print('#define GL_STUB(fn, off)\t\t\t\\')
|
|
|
|
print('\tGLOBL_FN(fn);\t\t\t\t\\')
|
|
|
|
print('fn:\tba\t__glapi_sparc_nothread_stub;\t\\')
|
|
|
|
print('\t sethi\tGL_OFF(off), %g3;\t\t\\')
|
|
|
|
print('\t.size\tfn,.-fn;')
|
|
|
|
print('')
|
|
|
|
print('#endif')
|
|
|
|
print('')
|
|
|
|
print('#define GL_STUB_ALIAS(fn, alias) \\')
|
|
|
|
print(' .globl fn; \\')
|
|
|
|
print(' .set fn, alias')
|
|
|
|
print('')
|
|
|
|
print('\t.text')
|
|
|
|
print('\t.align\t32')
|
|
|
|
print('')
|
|
|
|
print('\t.globl\tgl_dispatch_functions_start')
|
|
|
|
print('\tHIDDEN(gl_dispatch_functions_start)')
|
|
|
|
print('gl_dispatch_functions_start:')
|
|
|
|
print('')
|
2012-10-10 15:20:57 +01:00
|
|
|
return
|
Mammoth update to the Python code generator scripts that live in
src/mesa/glapi. Basically, the scripts that did simple things (like
gl_offsets.py) were simple, and the scripts that did more complicated things
(like glX_proto_send.py) were getting progressively more and more out of
control. So, I re-write the foundation classes on which everything is based.
One problem with the existing code is that the division between the GL API
database representation and the way the output code is generated was either
blury or nonexistant. The new code somewhat follows the
Model-View-Controller pattern, minus the Controller. There is a distinct
set of classes that model the API data, and there is a distinct set of
classes that generate code from that data.
One big change is in the class that represents GL functions (was glFunction,
is now gl_function). There used to be an instance of this calls for each
function and for each alias to that function. For example, there was an
instance for PointParameterivSGIS, PointParameterivEXT, PointParameterivARB,
and PointParameteriv. In the new code, there is one instance. Each
instance has a list of entrypoint names for the function. In the next
revision, this will allow a couple useful things. The script will be able
to verify that the parameters, return type, and GLX protocol for a function
and all it's aliases match.
It will also allow aliases to be represented in the XML more compactly.
Instead of repeating all the information, an alias can be listed as:
<function name="PointParameterivARB" alias="PointParameterivEXT"/>
Because the data representation was changed, the order that the alias
functions are processed by the scripts also changed. This accounts for at
least 2,700 of the ~3,600 lines of diffs in the generated code.
Most of the remaining ~900 lines of diffs are the result of bugs *fixed* by
the new scripts. The old scripts also generated code with some bugs in it.
These bugs were discovered while the new code was being written.
These changes were discussed on the mesa3d-dev mailing list back at the end
of May:
http://marc.theaimsgroup.com/?t=111714569000004&r=1&w=2
Xorg bug: 3197, 3208
2005-06-22 00:42:43 +01:00
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
def printRealFooter(self):
|
2018-07-05 14:17:32 +01:00
|
|
|
print('')
|
|
|
|
print('\t.globl\tgl_dispatch_functions_end')
|
|
|
|
print('\tHIDDEN(gl_dispatch_functions_end)')
|
|
|
|
print('gl_dispatch_functions_end:')
|
2012-10-10 15:20:57 +01:00
|
|
|
return
|
Mammoth update to the Python code generator scripts that live in
src/mesa/glapi. Basically, the scripts that did simple things (like
gl_offsets.py) were simple, and the scripts that did more complicated things
(like glX_proto_send.py) were getting progressively more and more out of
control. So, I re-write the foundation classes on which everything is based.
One problem with the existing code is that the division between the GL API
database representation and the way the output code is generated was either
blury or nonexistant. The new code somewhat follows the
Model-View-Controller pattern, minus the Controller. There is a distinct
set of classes that model the API data, and there is a distinct set of
classes that generate code from that data.
One big change is in the class that represents GL functions (was glFunction,
is now gl_function). There used to be an instance of this calls for each
function and for each alias to that function. For example, there was an
instance for PointParameterivSGIS, PointParameterivEXT, PointParameterivARB,
and PointParameteriv. In the new code, there is one instance. Each
instance has a list of entrypoint names for the function. In the next
revision, this will allow a couple useful things. The script will be able
to verify that the parameters, return type, and GLX protocol for a function
and all it's aliases match.
It will also allow aliases to be represented in the XML more compactly.
Instead of repeating all the information, an alias can be listed as:
<function name="PointParameterivARB" alias="PointParameterivEXT"/>
Because the data representation was changed, the order that the alias
functions are processed by the scripts also changed. This accounts for at
least 2,700 of the ~3,600 lines of diffs in the generated code.
Most of the remaining ~900 lines of diffs are the result of bugs *fixed* by
the new scripts. The old scripts also generated code with some bugs in it.
These bugs were discovered while the new code was being written.
These changes were discussed on the mesa3d-dev mailing list back at the end
of May:
http://marc.theaimsgroup.com/?t=111714569000004&r=1&w=2
Xorg bug: 3197, 3208
2005-06-22 00:42:43 +01:00
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
def printBody(self, api):
|
|
|
|
for f in api.functionIterateByOffset():
|
|
|
|
name = f.dispatch_name()
|
2006-08-22 17:34:38 +01:00
|
|
|
|
2018-07-05 14:17:32 +01:00
|
|
|
print('\tGL_STUB(gl%s, %d)' % (name, f.offset))
|
2005-07-28 01:11:10 +01:00
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
if not f.is_static_entry_point(f.name):
|
2018-07-05 14:17:32 +01:00
|
|
|
print('\tHIDDEN(gl%s)' % (name))
|
2004-05-24 18:48:21 +01:00
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
for f in api.functionIterateByOffset():
|
|
|
|
name = f.dispatch_name()
|
Mammoth update to the Python code generator scripts that live in
src/mesa/glapi. Basically, the scripts that did simple things (like
gl_offsets.py) were simple, and the scripts that did more complicated things
(like glX_proto_send.py) were getting progressively more and more out of
control. So, I re-write the foundation classes on which everything is based.
One problem with the existing code is that the division between the GL API
database representation and the way the output code is generated was either
blury or nonexistant. The new code somewhat follows the
Model-View-Controller pattern, minus the Controller. There is a distinct
set of classes that model the API data, and there is a distinct set of
classes that generate code from that data.
One big change is in the class that represents GL functions (was glFunction,
is now gl_function). There used to be an instance of this calls for each
function and for each alias to that function. For example, there was an
instance for PointParameterivSGIS, PointParameterivEXT, PointParameterivARB,
and PointParameteriv. In the new code, there is one instance. Each
instance has a list of entrypoint names for the function. In the next
revision, this will allow a couple useful things. The script will be able
to verify that the parameters, return type, and GLX protocol for a function
and all it's aliases match.
It will also allow aliases to be represented in the XML more compactly.
Instead of repeating all the information, an alias can be listed as:
<function name="PointParameterivARB" alias="PointParameterivEXT"/>
Because the data representation was changed, the order that the alias
functions are processed by the scripts also changed. This accounts for at
least 2,700 of the ~3,600 lines of diffs in the generated code.
Most of the remaining ~900 lines of diffs are the result of bugs *fixed* by
the new scripts. The old scripts also generated code with some bugs in it.
These bugs were discovered while the new code was being written.
These changes were discussed on the mesa3d-dev mailing list back at the end
of May:
http://marc.theaimsgroup.com/?t=111714569000004&r=1&w=2
Xorg bug: 3197, 3208
2005-06-22 00:42:43 +01:00
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
if f.is_static_entry_point(f.name):
|
|
|
|
for n in f.entry_points:
|
|
|
|
if n != f.name:
|
|
|
|
text = '\tGL_STUB_ALIAS(gl%s, gl%s)' % (n, f.name)
|
2006-10-11 23:37:14 +01:00
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
if f.has_different_protocol(n):
|
2018-07-05 14:17:32 +01:00
|
|
|
print('#ifndef GLX_INDIRECT_RENDERING')
|
|
|
|
print(text)
|
|
|
|
print('#endif')
|
2012-10-10 15:20:57 +01:00
|
|
|
else:
|
2018-07-05 14:17:32 +01:00
|
|
|
print(text)
|
2004-05-24 18:48:21 +01:00
|
|
|
|
2012-10-10 15:20:57 +01:00
|
|
|
return
|
2004-05-24 18:48:21 +01:00
|
|
|
|
Mammoth update to the Python code generator scripts that live in
src/mesa/glapi. Basically, the scripts that did simple things (like
gl_offsets.py) were simple, and the scripts that did more complicated things
(like glX_proto_send.py) were getting progressively more and more out of
control. So, I re-write the foundation classes on which everything is based.
One problem with the existing code is that the division between the GL API
database representation and the way the output code is generated was either
blury or nonexistant. The new code somewhat follows the
Model-View-Controller pattern, minus the Controller. There is a distinct
set of classes that model the API data, and there is a distinct set of
classes that generate code from that data.
One big change is in the class that represents GL functions (was glFunction,
is now gl_function). There used to be an instance of this calls for each
function and for each alias to that function. For example, there was an
instance for PointParameterivSGIS, PointParameterivEXT, PointParameterivARB,
and PointParameteriv. In the new code, there is one instance. Each
instance has a list of entrypoint names for the function. In the next
revision, this will allow a couple useful things. The script will be able
to verify that the parameters, return type, and GLX protocol for a function
and all it's aliases match.
It will also allow aliases to be represented in the XML more compactly.
Instead of repeating all the information, an alias can be listed as:
<function name="PointParameterivARB" alias="PointParameterivEXT"/>
Because the data representation was changed, the order that the alias
functions are processed by the scripts also changed. This accounts for at
least 2,700 of the ~3,600 lines of diffs in the generated code.
Most of the remaining ~900 lines of diffs are the result of bugs *fixed* by
the new scripts. The old scripts also generated code with some bugs in it.
These bugs were discovered while the new code was being written.
These changes were discussed on the mesa3d-dev mailing list back at the end
of May:
http://marc.theaimsgroup.com/?t=111714569000004&r=1&w=2
Xorg bug: 3197, 3208
2005-06-22 00:42:43 +01:00
|
|
|
|
2015-02-13 23:49:16 +00:00
|
|
|
def _parser():
|
|
|
|
"""Parse arguments and return a namespace."""
|
|
|
|
parser = argparse.ArgumentParser()
|
|
|
|
parser.add_argument('-f',
|
|
|
|
dest='filename',
|
|
|
|
default='gl_API.xml',
|
|
|
|
help='An XML description of an API.')
|
|
|
|
return parser.parse_args()
|
2004-05-24 18:48:21 +01:00
|
|
|
|
|
|
|
|
2015-02-13 23:54:17 +00:00
|
|
|
def main():
|
|
|
|
"""Main function."""
|
2015-02-13 23:49:16 +00:00
|
|
|
args = _parser()
|
|
|
|
printer = PrintGenericStubs()
|
2004-05-24 18:48:21 +01:00
|
|
|
|
2015-02-13 23:49:16 +00:00
|
|
|
api = gl_XML.parse_GL_API(args.filename, glX_XML.glx_item_factory())
|
2012-10-10 15:20:57 +01:00
|
|
|
printer.Print(api)
|
2015-02-13 23:54:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
if __name__ == '__main__':
|
|
|
|
main()
|