1 # -*- coding: utf-8 -*-
3 #-------------------------------------------------------------------------
4 # drawElements Quality Program utilities
5 # --------------------------------------
7 # Copyright 2015-2017 The Android Open Source Project
9 # Licensed under the Apache License, Version 2.0 (the "License");
10 # you may not use this file except in compliance with the License.
11 # You may obtain a copy of the License at
13 # http://www.apache.org/licenses/LICENSE-2.0
15 # Unless required by applicable law or agreed to in writing, software
16 # distributed under the License is distributed on an "AS IS" BASIS,
17 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 # See the License for the specific language governing permissions and
19 # limitations under the License.
21 #-------------------------------------------------------------------------
27 sys.path.append(os.path.dirname(os.path.dirname(__file__)))
29 import khr_util.format
30 import khr_util.registry
31 import khr_util.registry_cache
33 SCRIPTS_DIR = os.path.dirname(__file__)
34 OPENGL_DIR = os.path.normpath(os.path.join(SCRIPTS_DIR, "..", "..", "framework", "opengl"))
35 EGL_DIR = os.path.normpath(os.path.join(SCRIPTS_DIR, "..", "..", "framework", "egl"))
36 OPENGL_INC_DIR = os.path.join(OPENGL_DIR, "wrapper")
38 GL_SOURCE = khr_util.registry_cache.RegistrySource(
39 "https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry",
41 "7ac9c857db1e3a6065485e4e2144151f48a4f1c4",
42 "2475e1ff6d69048e67a49188d8be09195b261ed96b2b4108a0f7d7a459834674")
45 'GL_KHR_texture_compression_astc_ldr',
46 'GL_KHR_blend_equation_advanced',
47 'GL_KHR_blend_equation_advanced_coherent',
49 'GL_EXT_geometry_point_size',
50 'GL_EXT_tessellation_shader',
51 'GL_EXT_geometry_shader',
53 'GL_EXT_texture_buffer',
54 'GL_EXT_texture_snorm',
55 'GL_EXT_primitive_bounding_box',
57 'GL_OES_compressed_ETC1_RGB8_texture',
58 'GL_OES_compressed_paletted_texture',
59 'GL_OES_texture_half_float',
60 'GL_OES_texture_storage_multisample_2d_array',
61 'GL_OES_sample_shading',
62 'GL_EXT_texture_compression_s3tc',
63 'GL_IMG_texture_compression_pvrtc',
65 'GL_EXT_draw_buffers_indexed',
66 'GL_EXT_texture_sRGB_decode',
67 'GL_EXT_texture_border_clamp',
68 'GL_EXT_texture_sRGB_R8',
69 'GL_EXT_texture_sRGB_RG8',
70 'GL_EXT_debug_marker',
73 'GL_EXT_draw_elements_base_vertex',
74 'GL_OES_draw_elements_base_vertex',
78 return khr_util.registry_cache.getRegistry(GL_SOURCE)
80 # return the name of a core command corresponding to an extension command.
81 # Ideally this should be done using the alias attribute of commands, but dEQP
82 # just strips the extension suffix.
83 def getCoreName (name):
84 return re.sub('[A-Z]+$', '', name)
86 def getHybridInterface ():
87 # This is a bit awkward, since we have to create a strange hybrid
88 # interface that includes both GL and ES features and extensions.
89 registry = getGLRegistry()
90 glFeatures = registry.getFeatures('gl')
91 esFeatures = registry.getFeatures('gles2')
92 spec = khr_util.registry.InterfaceSpec()
94 for feature in registry.getFeatures('gl'):
95 spec.addFeature(feature, 'gl', 'core')
97 for feature in registry.getFeatures('gles2'):
98 spec.addFeature(feature, 'gles2')
100 for extName in EXTENSIONS:
101 extension = registry.extensions[extName]
102 # Add all extensions using the ES2 api, but force even non-ES2
103 # extensions to be included.
104 spec.addExtension(extension, 'gles2', 'core', force=True)
106 # Remove redundant extension commands that are already provided by core.
107 for commandName in list(spec.commands):
108 coreName = getCoreName(commandName)
109 if coreName != commandName and coreName in spec.commands:
110 spec.commands.remove(commandName)
112 return khr_util.registry.createInterface(registry, spec, 'gles2')
114 def getInterface (registry, api, version=None, profile=None, **kwargs):
115 spec = khr_util.registry.spec(registry, api, version, profile, **kwargs)
116 if api == 'gl' and profile == 'core' and version < "3.2":
117 gl32 = registry.features['GL_VERSION_3_2']
118 for eRemove in gl32.xpath('remove'):
119 spec.addComponent(eRemove)
120 return khr_util.registry.createInterface(registry, spec, api)
122 def getVersionToken (api, version):
123 prefixes = { 'gles2': "ES", 'gl': "GL" }
124 return prefixes[api] + version.replace(".", "")
126 def genCommandList(iface, renderCommand, directory, filename, align=False):
127 lines = map(renderCommand, iface.commands)
128 lines = filter(lambda l: l != None, lines)
130 lines = indentLines(lines)
131 writeInlFile(os.path.join(directory, filename), lines)
133 def genCommandLists(registry, renderCommand, check, directory, filePattern, align=False):
134 for eFeature in registry.features:
135 api = eFeature.get('api')
136 version = eFeature.get('number')
137 profile = check(api, version)
140 elif profile is False:
142 iface = getInterface(registry, api, version=version, profile=profile)
143 filename = filePattern % getVersionToken(api, version)
144 genCommandList(iface, renderCommand, directory, filename, align)
146 def getFunctionTypeName (funcName):
147 return "%sFunc" % funcName
149 def getFunctionMemberName (funcName):
150 assert funcName[:2] == "gl"
151 if funcName[:5] == "glEGL":
152 # Otherwise we end up with gl.eGLImage...
153 return "egl%s" % funcName[5:]
155 return "%c%s" % (funcName[2].lower(), funcName[3:])
157 INL_HEADER = khr_util.format.genInlHeader("Khronos GL API description (gl.xml)", GL_SOURCE.getRevision())
159 def writeInlFile (filename, source):
160 khr_util.format.writeInlFile(filename, INL_HEADER, source)
162 # Aliases from khr_util.common
163 indentLines = khr_util.format.indentLines
164 normalizeConstant = khr_util.format.normalizeConstant
165 commandParams = khr_util.format.commandParams
166 commandArgs = khr_util.format.commandArgs