1 # -*- coding: utf-8 -*- 2 3 #------------------------------------------------------------------------- 4 # drawElements Quality Program utilities 5 # -------------------------------------- 6 # 7 # Copyright 2015-2017 The Android Open Source Project 8 # 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 12 # 13 # http://www.apache.org/licenses/LICENSE-2.0 14 # 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. 20 # 21 #------------------------------------------------------------------------- 22 23 import os 24 import re 25 import sys 26 27 sys.path.append(os.path.dirname(os.path.dirname(__file__))) 28 29 import khr_util.format 30 import khr_util.registry 31 import khr_util.registry_cache 32 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") 37 38 GL_SOURCE = khr_util.registry_cache.RegistrySource( 39 "https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry", 40 "xml/gl.xml", 41 "7ac9c857db1e3a6065485e4e2144151f48a4f1c4", 42 "2475e1ff6d69048e67a49188d8be09195b261ed96b2b4108a0f7d7a459834674") 43 44 EXTENSIONS = [ 45 'GL_KHR_texture_compression_astc_ldr', 46 'GL_KHR_blend_equation_advanced', 47 'GL_KHR_blend_equation_advanced_coherent', 48 'GL_KHR_debug', 49 'GL_EXT_geometry_point_size', 50 'GL_EXT_tessellation_shader', 51 'GL_EXT_geometry_shader', 52 'GL_EXT_robustness', 53 'GL_EXT_texture_buffer', 54 'GL_EXT_texture_snorm', 55 'GL_EXT_primitive_bounding_box', 56 'GL_OES_EGL_image', 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', 64 'GL_EXT_copy_image', 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', 71 'GL_EXT_robustness', 72 'GL_KHR_robustness', 73 'GL_EXT_draw_elements_base_vertex', 74 'GL_OES_draw_elements_base_vertex', 75 ] 76 77 def getGLRegistry (): 78 return khr_util.registry_cache.getRegistry(GL_SOURCE) 79 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) 85 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() 93 94 for feature in registry.getFeatures('gl'): 95 spec.addFeature(feature, 'gl', 'core') 96 97 for feature in registry.getFeatures('gles2'): 98 spec.addFeature(feature, 'gles2') 99 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) 105 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) 111 112 return khr_util.registry.createInterface(registry, spec, 'gles2') 113 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) 121 122 def getVersionToken (api, version): 123 prefixes = { 'gles2': "ES", 'gl': "GL" } 124 return prefixes[api] + version.replace(".", "") 125 126 def genCommandList(iface, renderCommand, directory, filename, align=False): 127 lines = map(renderCommand, iface.commands) 128 lines = filter(lambda l: l != None, lines) 129 if align: 130 lines = indentLines(lines) 131 writeInlFile(os.path.join(directory, filename), lines) 132 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) 138 if profile is True: 139 profile = None 140 elif profile is False: 141 continue 142 iface = getInterface(registry, api, version=version, profile=profile) 143 filename = filePattern % getVersionToken(api, version) 144 genCommandList(iface, renderCommand, directory, filename, align) 145 146 def getFunctionTypeName (funcName): 147 return "%sFunc" % funcName 148 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:] 154 else: 155 return "%c%s" % (funcName[2].lower(), funcName[3:]) 156 157 INL_HEADER = khr_util.format.genInlHeader("Khronos GL API description (gl.xml)", GL_SOURCE.getRevision()) 158 159 def writeInlFile (filename, source): 160 khr_util.format.writeInlFile(filename, INL_HEADER, source) 161 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 167