| # -*- coding: utf-8 -*- |
| |
| #------------------------------------------------------------------------- |
| # drawElements Quality Program utilities |
| # -------------------------------------- |
| # |
| # Copyright 2015-2017 The Android Open Source Project |
| # |
| # Licensed under the Apache License, Version 2.0 (the "License"); |
| # you may not use this file except in compliance with the License. |
| # You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # |
| #------------------------------------------------------------------------- |
| |
| import os |
| import re |
| import sys |
| |
| sys.path.append(os.path.dirname(os.path.dirname(__file__))) |
| |
| import khr_util.format |
| import khr_util.registry |
| import khr_util.registry_cache |
| |
| SCRIPTS_DIR = os.path.dirname(__file__) |
| OPENGL_DIR = os.path.normpath(os.path.join(SCRIPTS_DIR, "..", "..", "framework", "opengl")) |
| EGL_DIR = os.path.normpath(os.path.join(SCRIPTS_DIR, "..", "..", "framework", "egl")) |
| OPENGL_INC_DIR = os.path.join(OPENGL_DIR, "wrapper") |
| |
| GL_SOURCE = khr_util.registry_cache.RegistrySource( |
| "https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry", |
| "xml/gl.xml", |
| "9d534f9312e56c72df763207e449c6719576fd54", |
| "245e90331c83c4c743a2b9d0dad51e27a699f2040ebd34dd5338637adf276752") |
| |
| EXTENSIONS = [ |
| 'GL_KHR_texture_compression_astc_ldr', |
| 'GL_KHR_blend_equation_advanced', |
| 'GL_KHR_blend_equation_advanced_coherent', |
| 'GL_KHR_debug', |
| 'GL_EXT_robustness', |
| 'GL_KHR_robustness', |
| 'GL_KHR_no_error', |
| 'GL_KHR_parallel_shader_compile', |
| 'GL_KHR_shader_subgroup', |
| 'GL_EXT_bgra', |
| 'GL_EXT_geometry_point_size', |
| 'GL_EXT_tessellation_shader', |
| 'GL_EXT_geometry_shader', |
| 'GL_EXT_texture_buffer', |
| 'GL_EXT_texture_filter_anisotropic', |
| 'GL_EXT_texture_cube_map_array', |
| 'GL_EXT_texture_snorm', |
| 'GL_EXT_primitive_bounding_box', |
| 'GL_EXT_texture_compression_s3tc', |
| 'GL_EXT_texture_type_2_10_10_10_REV', |
| 'GL_EXT_clip_control', |
| 'GL_EXT_copy_image', |
| 'GL_EXT_depth_bounds_test', |
| 'GL_EXT_direct_state_access', |
| 'GL_EXT_draw_buffers_indexed', |
| 'GL_EXT_draw_elements_base_vertex', |
| 'GL_EXT_direct_state_access', |
| 'GL_EXT_read_format_bgra', |
| 'GL_EXT_texture_storage', |
| 'GL_EXT_texture_sRGB_decode', |
| 'GL_EXT_texture_border_clamp', |
| 'GL_EXT_texture_sRGB_R8', |
| 'GL_EXT_texture_sRGB_RG8', |
| 'GL_EXT_multisampled_render_to_texture', |
| 'GL_EXT_debug_marker', |
| 'GL_EXT_polygon_offset_clamp', |
| 'GL_IMG_texture_compression_pvrtc', |
| 'GL_OES_EGL_image', |
| 'GL_OES_EGL_image_external', |
| 'GL_OES_compressed_ETC1_RGB8_texture', |
| 'GL_OES_compressed_paletted_texture', |
| 'GL_OES_required_internalformat', |
| 'GL_OES_packed_depth_stencil', |
| 'GL_OES_texture_3D', |
| 'GL_OES_texture_half_float', |
| 'GL_OES_texture_storage_multisample_2d_array', |
| 'GL_OES_sample_shading', |
| 'GL_OES_standard_derivatives', |
| 'GL_OES_stencil1', |
| 'GL_OES_stencil4', |
| 'GL_OES_surfaceless_context', |
| 'GL_OES_mapbuffer', |
| 'GL_OES_vertex_array_object', |
| 'GL_OES_viewport_array', |
| 'GL_ARB_clip_control', |
| 'GL_ARB_buffer_storage', |
| 'GL_ARB_compute_shader', |
| 'GL_ARB_draw_indirect', |
| 'GL_ARB_draw_instanced', |
| 'GL_ARB_draw_elements_base_vertex', |
| 'GL_ARB_direct_state_access', |
| 'GL_ARB_get_program_binary', |
| 'GL_ARB_gl_spirv', |
| 'GL_ARB_indirect_parameters', |
| 'GL_ARB_internalformat_query', |
| 'GL_ARB_instanced_arrays', |
| 'GL_ARB_multi_draw_indirect', |
| 'GL_ARB_parallel_shader_compile', |
| 'GL_ARB_program_interface_query', |
| 'GL_ARB_separate_shader_objects', |
| 'GL_ARB_shader_ballot', |
| 'GL_ARB_shader_image_load_store', |
| 'GL_ARB_shader_viewport_layer_array', |
| 'GL_ARB_sparse_buffer', |
| 'GL_ARB_sparse_texture', |
| 'GL_ARB_spirv_extensions', |
| 'GL_ARB_tessellation_shader', |
| 'GL_ARB_texture_barrier', |
| 'GL_ARB_texture_filter_minmax', |
| 'GL_ARB_texture_gather', |
| 'GL_ARB_texture_storage', |
| 'GL_ARB_texture_storage_multisample', |
| 'GL_ARB_texture_multisample', |
| 'GL_ARB_texture_view', |
| 'GL_ARB_transform_feedback2', |
| 'GL_ARB_transform_feedback3', |
| 'GL_ARB_transform_feedback_instanced', |
| 'GL_ARB_transform_feedback_overflow_query', |
| 'GL_ARB_vertex_array_bgra', |
| 'GL_ARB_vertex_attrib_64bit', |
| 'GL_ARB_vertex_attrib_binding', |
| 'GL_NV_deep_texture3D', |
| 'GL_NV_gpu_multicast', |
| 'GL_NV_internalformat_sample_query', |
| 'GL_NV_shader_subgroup_partitioned', |
| 'GL_NVX_cross_process_interop', |
| 'GL_OES_draw_elements_base_vertex', |
| 'GL_OVR_multiview', |
| 'GL_OVR_multiview_multisampled_render_to_texture', |
| ] |
| |
| ALIASING_EXCEPTIONS = [ |
| # registry insists that this aliases glRenderbufferStorageMultisample, |
| # and from a desktop GL / GLX perspective it *must*, but for ES they are |
| # unfortunately separate functions with different semantics. |
| 'glRenderbufferStorageMultisampleEXT', |
| ] |
| |
| def getGLRegistry (): |
| return khr_util.registry_cache.getRegistry(GL_SOURCE) |
| |
| def getHybridInterface (stripAliasedExtCommands = True): |
| # This is a bit awkward, since we have to create a strange hybrid |
| # interface that includes both GL and ES features and extensions. |
| registry = getGLRegistry() |
| glFeatures = registry.getFeatures('gl') |
| esFeatures = registry.getFeatures('gles2') |
| spec = khr_util.registry.InterfaceSpec() |
| |
| for feature in registry.getFeatures('gl'): |
| spec.addFeature(feature, 'gl', 'core') |
| |
| for feature in registry.getFeatures('gles2'): |
| spec.addFeature(feature, 'gles2') |
| |
| for extName in EXTENSIONS: |
| extension = registry.extensions[extName] |
| # Add all extensions using the ES2 api, but force even non-ES2 |
| # extensions to be included. |
| spec.addExtension(extension, 'gles2', 'core', force=True) |
| |
| iface = khr_util.registry.createInterface(registry, spec, 'gles2') |
| |
| if stripAliasedExtCommands: |
| # Remove redundant extension commands that are already provided by core. |
| strippedCmds = [] |
| |
| for command in iface.commands: |
| if command.alias == None or command.name in ALIASING_EXCEPTIONS: |
| strippedCmds.append(command) |
| |
| iface.commands = strippedCmds |
| |
| return iface |
| |
| def versionCheck(version): |
| if type(version) is bool: |
| if version == False: |
| return True |
| if type(version) is str: |
| return version < "3.2" |
| raise "Version check failed" |
| |
| def getInterface (registry, api, version=None, profile=None, **kwargs): |
| spec = khr_util.registry.spec(registry, api, version, profile, **kwargs) |
| if api == 'gl' and profile == 'core' and versionCheck(version): |
| gl32 = registry.features['GL_VERSION_3_2'] |
| for eRemove in gl32.xpath('remove'): |
| spec.addComponent(eRemove) |
| return khr_util.registry.createInterface(registry, spec, api) |
| |
| def getVersionToken (api, version): |
| prefixes = { 'gles2': "ES", 'gl': "GL" } |
| return prefixes[api] + version.replace(".", "") |
| |
| def genCommandList(iface, renderCommand, directory, filename, align=False): |
| lines = map(renderCommand, iface.commands) |
| lines = filter(lambda l: l != None, lines) |
| if align: |
| lines = indentLines(lines) |
| writeInlFile(os.path.join(directory, filename), lines) |
| |
| def genCommandLists(registry, renderCommand, check, directory, filePattern, align=False): |
| for eFeature in registry.features: |
| api = eFeature.get('api') |
| version = eFeature.get('number') |
| profile = check(api, version) |
| if profile is True: |
| profile = None |
| elif profile is False: |
| continue |
| iface = getInterface(registry, api, version=version, profile=profile) |
| filename = filePattern % getVersionToken(api, version) |
| genCommandList(iface, renderCommand, directory, filename, align) |
| |
| def getFunctionTypeName (funcName): |
| return "%sFunc" % funcName |
| |
| def getFunctionMemberName (funcName): |
| assert funcName[:2] == "gl" |
| if funcName[:5] == "glEGL": |
| # Otherwise we end up with gl.eGLImage... |
| return "egl%s" % funcName[5:] |
| else: |
| return "%c%s" % (funcName[2].lower(), funcName[3:]) |
| |
| INL_HEADER = khr_util.format.genInlHeader("Khronos GL API description (gl.xml)", GL_SOURCE.getRevision()) |
| |
| def writeInlFile (filename, source): |
| khr_util.format.writeInlFile(filename, INL_HEADER, source) |
| |
| # Aliases from khr_util.common |
| indentLines = khr_util.format.indentLines |
| normalizeConstant = khr_util.format.normalizeConstant |
| commandParams = khr_util.format.commandParams |
| commandArgs = khr_util.format.commandArgs |
