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 23import os 24import re 25import sys 26 27sys.path.append(os.path.dirname(os.path.dirname(__file__))) 28 29import khr_util.format 30import khr_util.registry 31import khr_util.registry_cache 32 33SCRIPTS_DIR = os.path.dirname(__file__) 34OPENGL_DIR = os.path.normpath(os.path.join(SCRIPTS_DIR, "..", "..", "framework", "opengl")) 35EGL_DIR = os.path.normpath(os.path.join(SCRIPTS_DIR, "..", "..", "framework", "egl")) 36OPENGL_INC_DIR = os.path.join(OPENGL_DIR, "wrapper") 37 38GL_SOURCE = khr_util.registry_cache.RegistrySource( 39 "https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry", 40 "xml/gl.xml", 41 "a3ee0ed08111d44ac3cb863d9e3e81a7c28f9d90", 42 "bfe070bafe6a0758f23964a078262b45ad163adf7f2dc320f44757908033d107") 43 44EXTENSIONS = [ 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_KHR_robustness', 50 'GL_KHR_no_error', 51 'GL_KHR_parallel_shader_compile', 52 'GL_EXT_bgra', 53 'GL_EXT_geometry_point_size', 54 'GL_EXT_tessellation_shader', 55 'GL_EXT_geometry_shader', 56 'GL_EXT_robustness', 57 'GL_EXT_texture_buffer', 58 'GL_EXT_texture_filter_anisotropic', 59 'GL_EXT_texture_cube_map_array', 60 'GL_EXT_texture_snorm', 61 'GL_EXT_primitive_bounding_box', 62 'GL_EXT_texture_compression_s3tc', 63 'GL_EXT_texture_type_2_10_10_10_REV', 64 'GL_EXT_copy_image', 65 'GL_EXT_depth_bounds_test', 66 'GL_EXT_direct_state_access', 67 'GL_EXT_draw_buffers_indexed', 68 'GL_EXT_draw_elements_base_vertex', 69 'GL_EXT_direct_state_access', 70 'GL_EXT_read_format_bgra', 71 'GL_EXT_texture_storage', 72 'GL_EXT_texture_sRGB_decode', 73 'GL_EXT_texture_border_clamp', 74 'GL_EXT_texture_sRGB_R8', 75 'GL_EXT_texture_sRGB_RG8', 76 'GL_EXT_debug_marker', 77 'GL_EXT_polygon_offset_clamp', 78 'GL_IMG_texture_compression_pvrtc', 79 'GL_OES_EGL_image', 80 'GL_OES_EGL_image_external', 81 'GL_OES_compressed_ETC1_RGB8_texture', 82 'GL_OES_compressed_paletted_texture', 83 'GL_OES_required_internalformat', 84 'GL_OES_packed_depth_stencil', 85 'GL_OES_texture_3D', 86 'GL_OES_texture_half_float', 87 'GL_OES_texture_storage_multisample_2d_array', 88 'GL_OES_sample_shading', 89 'GL_OES_standard_derivatives', 90 'GL_OES_stencil1', 91 'GL_OES_stencil4', 92 'GL_OES_surfaceless_context', 93 'GL_OES_mapbuffer', 94 'GL_OES_vertex_array_object', 95 'GL_OES_viewport_array', 96 'GL_ARB_clip_control', 97 'GL_ARB_buffer_storage', 98 'GL_ARB_compute_shader', 99 'GL_ARB_draw_instanced', 100 'GL_ARB_draw_elements_base_vertex', 101 'GL_ARB_direct_state_access', 102 'GL_ARB_get_program_binary', 103 'GL_ARB_indirect_parameters', 104 'GL_ARB_internalformat_query', 105 'GL_ARB_instanced_arrays', 106 'GL_ARB_multi_draw_indirect', 107 'GL_ARB_parallel_shader_compile', 108 'GL_ARB_program_interface_query', 109 'GL_ARB_separate_shader_objects', 110 'GL_ARB_shader_ballot', 111 'GL_ARB_shader_image_load_store', 112 'GL_ARB_shader_viewport_layer_array', 113 'GL_ARB_sparse_buffer', 114 'GL_ARB_sparse_texture', 115 'GL_ARB_spirv_extensions', 116 'GL_ARB_tessellation_shader', 117 'GL_ARB_texture_barrier', 118 'GL_ARB_texture_filter_minmax', 119 'GL_ARB_texture_gather', 120 'GL_ARB_texture_storage', 121 'GL_ARB_texture_storage_multisample', 122 'GL_ARB_texture_multisample', 123 'GL_ARB_texture_view', 124 'GL_ARB_transform_feedback2', 125 'GL_ARB_transform_feedback3', 126 'GL_ARB_transform_feedback_instanced', 127 'GL_ARB_transform_feedback_overflow_query', 128 'GL_ARB_vertex_array_bgra', 129 'GL_ARB_vertex_attrib_64bit', 130 'GL_ARB_vertex_attrib_binding', 131 'GL_NV_deep_texture3D', 132 'GL_NV_internalformat_sample_query', 133 'GL_OES_draw_elements_base_vertex', 134 'GL_OVR_multiview', 135 'GL_OVR_multiview_multisampled_render_to_texture', 136] 137 138def getGLRegistry (): 139 return khr_util.registry_cache.getRegistry(GL_SOURCE) 140 141def getHybridInterface (stripAliasedExtCommands = True): 142 # This is a bit awkward, since we have to create a strange hybrid 143 # interface that includes both GL and ES features and extensions. 144 registry = getGLRegistry() 145 glFeatures = registry.getFeatures('gl') 146 esFeatures = registry.getFeatures('gles2') 147 spec = khr_util.registry.InterfaceSpec() 148 149 for feature in registry.getFeatures('gl'): 150 spec.addFeature(feature, 'gl', 'core') 151 152 for feature in registry.getFeatures('gles2'): 153 spec.addFeature(feature, 'gles2') 154 155 for extName in EXTENSIONS: 156 extension = registry.extensions[extName] 157 # Add all extensions using the ES2 api, but force even non-ES2 158 # extensions to be included. 159 spec.addExtension(extension, 'gles2', 'core', force=True) 160 161 iface = khr_util.registry.createInterface(registry, spec, 'gles2') 162 163 if stripAliasedExtCommands: 164 # Remove redundant extension commands that are already provided by core. 165 strippedCmds = [] 166 167 for command in iface.commands: 168 if command.alias == None: 169 strippedCmds.append(command) 170 171 iface.commands = strippedCmds 172 173 return iface 174 175def getInterface (registry, api, version=None, profile=None, **kwargs): 176 spec = khr_util.registry.spec(registry, api, version, profile, **kwargs) 177 if api == 'gl' and profile == 'core' and version < "3.2": 178 gl32 = registry.features['GL_VERSION_3_2'] 179 for eRemove in gl32.xpath('remove'): 180 spec.addComponent(eRemove) 181 return khr_util.registry.createInterface(registry, spec, api) 182 183def getVersionToken (api, version): 184 prefixes = { 'gles2': "ES", 'gl': "GL" } 185 return prefixes[api] + version.replace(".", "") 186 187def genCommandList(iface, renderCommand, directory, filename, align=False): 188 lines = map(renderCommand, iface.commands) 189 lines = filter(lambda l: l != None, lines) 190 if align: 191 lines = indentLines(lines) 192 writeInlFile(os.path.join(directory, filename), lines) 193 194def genCommandLists(registry, renderCommand, check, directory, filePattern, align=False): 195 for eFeature in registry.features: 196 api = eFeature.get('api') 197 version = eFeature.get('number') 198 profile = check(api, version) 199 if profile is True: 200 profile = None 201 elif profile is False: 202 continue 203 iface = getInterface(registry, api, version=version, profile=profile) 204 filename = filePattern % getVersionToken(api, version) 205 genCommandList(iface, renderCommand, directory, filename, align) 206 207def getFunctionTypeName (funcName): 208 return "%sFunc" % funcName 209 210def getFunctionMemberName (funcName): 211 assert funcName[:2] == "gl" 212 if funcName[:5] == "glEGL": 213 # Otherwise we end up with gl.eGLImage... 214 return "egl%s" % funcName[5:] 215 else: 216 return "%c%s" % (funcName[2].lower(), funcName[3:]) 217 218INL_HEADER = khr_util.format.genInlHeader("Khronos GL API description (gl.xml)", GL_SOURCE.getRevision()) 219 220def writeInlFile (filename, source): 221 khr_util.format.writeInlFile(filename, INL_HEADER, source) 222 223# Aliases from khr_util.common 224indentLines = khr_util.format.indentLines 225normalizeConstant = khr_util.format.normalizeConstant 226commandParams = khr_util.format.commandParams 227commandArgs = khr_util.format.commandArgs 228