xref: /aosp_15_r20/external/mesa3d/src/mapi/glapi/gen/apiexec.py (revision 6104692788411f58d303aa86923a9ff6ecaded22)

# Copyright (C) 2015 Intel Corporation
#
# 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
# the rights to use, copy, modify, merge, publish, distribute, sublicense,
# 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 NONINFRINGEMENT.  IN NO EVENT SHALL
# THE AUTHORS OR COPYRIGHT HOLDERS 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.

import argparse
import gl_XML

class exec_info():
    """Information relating GL APIs to a function.

    Each of the four attributes of this class, compatibility, core, es1, and
    es2, specify the minimum API version where a function can possibly exist
    in Mesa.  The version is specified as an integer of (real GL version *
    10).  For example, glCreateProgram was added in OpenGL 2.0, so
    compatibility=20 and core=31.

    If the attribute is None, then it cannot be supported by that
    API.  For example, glNewList was removed from core profiles, so
    compatibility=10 and core=None.

    Each of the attributes that is not None must have a valid value.  The
    valid ranges are:

        compatibility: [10, )
        core: [31, )
        es1: [10, 11]
        es2: [20, )

    These ranges are enforced by the constructor.
    """
    def __init__(self, compatibility=None, core=None, es1=None, es2=None):
        if compatibility is not None:
            assert isinstance(compatibility, int)
            assert compatibility >= 10

        if core is not None:
            assert isinstance(core, int)
            assert core >= 31

        if es1 is not None:
            assert isinstance(es1, int)
            assert es1 == 10 or es1 == 11

        if es2 is not None:
            assert isinstance(es2, int)
            assert es2 >= 20

        self.compatibility = compatibility
        self.core = core
        self.es1 = es1
        self.es2 = es2

functions = {
    # OpenGL 3.1 / GL_ARB_texture_buffer_object.
    "TexBuffer": exec_info(compatibility=20, core=31, es2=31),

    # OpenGL 3.2 / GL_OES_geometry_shader.
    "FramebufferTexture": exec_info(compatibility=32, core=32, es2=31),

    # OpenGL 4.0 / GL_ARB_shader_subroutines. Mesa only exposes this
    # extension with core profile.
    "GetSubroutineUniformLocation": exec_info(compatibility=31, core=31),
    "GetSubroutineIndex": exec_info(compatibility=31, core=31),
    "GetActiveSubroutineUniformiv": exec_info(compatibility=31, core=31),
    "GetActiveSubroutineUniformName": exec_info(compatibility=31, core=31),
    "GetActiveSubroutineName": exec_info(compatibility=31, core=31),
    "UniformSubroutinesuiv": exec_info(compatibility=31, core=31),
    "GetUniformSubroutineuiv": exec_info(compatibility=31, core=31),
    "GetProgramStageiv": exec_info(compatibility=31, core=31),

    # OpenGL 4.0 / GL_ARB_gpu_shader_fp64.  The extension spec says:
    #
    #     "OpenGL 3.2 and GLSL 1.50 are required."
    "Uniform1d": exec_info(compatibility=32, core=32),
    "Uniform2d": exec_info(compatibility=32, core=32),
    "Uniform3d": exec_info(compatibility=32, core=32),
    "Uniform4d": exec_info(compatibility=32, core=32),
    "Uniform1dv": exec_info(compatibility=32, core=32),
    "Uniform2dv": exec_info(compatibility=32, core=32),
    "Uniform3dv": exec_info(compatibility=32, core=32),
    "Uniform4dv": exec_info(compatibility=32, core=32),
    "UniformMatrix2dv": exec_info(compatibility=32, core=32),
    "UniformMatrix3dv": exec_info(compatibility=32, core=32),
    "UniformMatrix4dv": exec_info(compatibility=32, core=32),
    "UniformMatrix2x3dv": exec_info(compatibility=32,core=32),
    "UniformMatrix2x4dv": exec_info(compatibility=32, core=32),
    "UniformMatrix3x2dv": exec_info(compatibility=32, core=32),
    "UniformMatrix3x4dv": exec_info(compatibility=32, core=32),
    "UniformMatrix4x2dv": exec_info(compatibility=32, core=32),
    "UniformMatrix4x3dv": exec_info(compatibility=32, core=32),
    "GetUniformdv": exec_info(compatibility=32, core=32),

    # OpenGL 4.1 / GL_ARB_vertex_attrib_64bit.  The extension spec says:
    #
    #     "OpenGL 3.0 and GLSL 1.30 are required.
    #
    #     ARB_gpu_shader_fp64 (or equivalent functionality) is required."
    #
    # For Mesa this effectively means OpenGL 3.2 is required.  It seems
    # unlikely that Mesa will ever get support for any of the NV extensions
    # that add "equivalent functionality."
    "VertexAttribL1d": exec_info(compatibility=32, core=32),
    "VertexAttribL2d": exec_info(compatibility=32, core=32),
    "VertexAttribL3d": exec_info(compatibility=32, core=32),
    "VertexAttribL4d": exec_info(compatibility=32, core=32),
    "VertexAttribL1dv": exec_info(compatibility=32, core=32),
    "VertexAttribL2dv": exec_info(compatibility=32, core=32),
    "VertexAttribL3dv": exec_info(compatibility=32, core=32),
    "VertexAttribL4dv": exec_info(compatibility=32, core=32),
    "VertexAttribLPointer": exec_info(compatibility=32, core=32),
    "GetVertexAttribLdv": exec_info(compatibility=32, core=32),

    # OpenGL 4.1 / GL_ARB_viewport_array.  The extension spec says:
    #
    #     "OpenGL 3.2 or the EXT_geometry_shader4 or ARB_geometry_shader4
    #     extensions are required."
    #
    # Mesa does not support either of the geometry shader extensions, so
    # OpenGL 3.2 is required.
    "ViewportArrayv": exec_info(compatibility=32, core=32, es2=31),
    "ViewportIndexedf": exec_info(compatibility=32, core=32, es2=31),
    "ViewportIndexedfv": exec_info(compatibility=32, core=32, es2=31),
    "ScissorArrayv": exec_info(compatibility=32, core=32, es2=31),
    "ScissorIndexed": exec_info(compatibility=32, core=32, es2=31),
    "ScissorIndexedv": exec_info(compatibility=32, core=32, es2=31),
    "DepthRangeArrayv": exec_info(compatibility=32, core=32),
    "DepthRangeIndexed": exec_info(compatibility=32, core=32),
    # GetFloati_v also GL_ARB_shader_atomic_counters
    # GetDoublei_v also GL_ARB_shader_atomic_counters

    # OpenGL 4.3 / GL_ARB_texture_buffer_range.
    "TexBufferRange": exec_info(compatibility=20, core=31, es2=31),

    # OpenGL 4.3 / GL_ARB_framebuffer_no_attachments.  Mesa can expose the
    # extension with OpenGL 3.0.
    "FramebufferParameteri": exec_info(compatibility=30, core=31, es2=31),
    "GetFramebufferParameteriv": exec_info(compatibility=30, core=31, es2=31),

    # OpenGL 4.3 / GL_MESA_framebuffer_flip_y.
    "FramebufferParameteriMESA": exec_info(core=31, es2=30),
    "GetFramebufferParameterivMESA": exec_info(core=31, es2=30),

    # OpenGL 4.5 / GL_ARB_direct_state_access.   Mesa can expose the extension
    # with core profile.
    "CreateTransformFeedbacks": exec_info(compatibility=31, core=31),
    "TransformFeedbackBufferBase": exec_info(compatibility=31, core=31),
    "TransformFeedbackBufferRange": exec_info(compatibility=31, core=31),
    "GetTransformFeedbackiv": exec_info(compatibility=31, core=31),
    "GetTransformFeedbacki_v": exec_info(compatibility=31, core=31),
    "GetTransformFeedbacki64_v": exec_info(compatibility=31, core=31),
    "CreateBuffers": exec_info(compatibility=31, core=31),
    "NamedBufferStorage": exec_info(compatibility=31, core=31),
    "NamedBufferData": exec_info(compatibility=31, core=31),
    "NamedBufferSubData": exec_info(compatibility=31, core=31),
    "CopyNamedBufferSubData": exec_info(compatibility=31, core=31),
    "ClearNamedBufferData": exec_info(compatibility=31, core=31),
    "ClearNamedBufferSubData": exec_info(compatibility=31, core=31),
    "MapNamedBuffer": exec_info(compatibility=31, core=31),
    "MapNamedBufferRange": exec_info(compatibility=31, core=31),
    "UnmapNamedBuffer": exec_info(compatibility=31, core=31),
    "FlushMappedNamedBufferRange": exec_info(compatibility=31, core=31),
    "GetNamedBufferParameteriv": exec_info(compatibility=31, core=31),
    "GetNamedBufferParameteri64v": exec_info(compatibility=31, core=31),
    "GetNamedBufferPointerv": exec_info(compatibility=31, core=31),
    "GetNamedBufferSubData": exec_info(compatibility=31, core=31),
    "CreateFramebuffers": exec_info(compatibility=31, core=31),
    "NamedFramebufferRenderbuffer": exec_info(compatibility=31, core=31),
    "NamedFramebufferParameteri": exec_info(compatibility=31, core=31),
    "NamedFramebufferTexture": exec_info(compatibility=31, core=31),
    "NamedFramebufferTextureLayer": exec_info(compatibility=31, core=31),
    "NamedFramebufferDrawBuffer": exec_info(compatibility=31, core=31),
    "NamedFramebufferDrawBuffers": exec_info(compatibility=31, core=31),
    "NamedFramebufferReadBuffer": exec_info(compatibility=31, core=31),
    "InvalidateNamedFramebufferData": exec_info(compatibility=31, core=31),
    "InvalidateNamedFramebufferSubData": exec_info(compatibility=31, core=31),
    "ClearNamedFramebufferiv": exec_info(compatibility=31, core=31),
    "ClearNamedFramebufferuiv": exec_info(compatibility=31, core=31),
    "ClearNamedFramebufferfv": exec_info(compatibility=31, core=31),
    "ClearNamedFramebufferfi": exec_info(compatibility=31, core=31),
    "BlitNamedFramebuffer": exec_info(compatibility=31, core=31),
    "CheckNamedFramebufferStatus": exec_info(compatibility=31, core=31),
    "GetNamedFramebufferParameteriv": exec_info(compatibility=31, core=31),
    "GetNamedFramebufferAttachmentParameteriv": exec_info(compatibility=31, core=31),
    "CreateRenderbuffers": exec_info(compatibility=31, core=31),
    "NamedRenderbufferStorage": exec_info(compatibility=31, core=31),
    "NamedRenderbufferStorageMultisample": exec_info(compatibility=31, core=31),
    "GetNamedRenderbufferParameteriv": exec_info(compatibility=31, core=31),
    "CreateTextures": exec_info(compatibility=31, core=31),
    "TextureBuffer": exec_info(compatibility=31, core=31),
    "TextureBufferRange": exec_info(compatibility=31, core=31),
    "TextureStorage1D": exec_info(compatibility=31, core=31),
    "TextureStorage2D": exec_info(compatibility=31, core=31),
    "TextureStorage3D": exec_info(compatibility=31, core=31),
    "TextureStorage2DMultisample": exec_info(compatibility=31, core=31),
    "TextureStorage3DMultisample": exec_info(compatibility=31, core=31),
    "TextureSubImage1D": exec_info(compatibility=31, core=31),
    "TextureSubImage2D": exec_info(compatibility=31, core=31),
    "TextureSubImage3D": exec_info(compatibility=31, core=31),
    "CompressedTextureSubImage1D": exec_info(compatibility=31, core=31),
    "CompressedTextureSubImage2D": exec_info(compatibility=31, core=31),
    "CompressedTextureSubImage3D": exec_info(compatibility=31, core=31),
    "CopyTextureSubImage1D": exec_info(compatibility=31, core=31),
    "CopyTextureSubImage2D": exec_info(compatibility=31, core=31),
    "CopyTextureSubImage3D": exec_info(compatibility=31, core=31),
    "TextureParameterf": exec_info(compatibility=31, core=31),
    "TextureParameterfv": exec_info(compatibility=31, core=31),
    "TextureParameteri": exec_info(compatibility=31, core=31),
    "TextureParameterIiv": exec_info(compatibility=31, core=31),
    "TextureParameterIuiv": exec_info(compatibility=31, core=31),
    "TextureParameteriv": exec_info(compatibility=31, core=31),
    "GenerateTextureMipmap": exec_info(compatibility=31, core=31),
    "BindTextureUnit": exec_info(compatibility=31, core=31),
    "GetTextureImage": exec_info(compatibility=31, core=31),
    "GetCompressedTextureImage": exec_info(compatibility=31, core=31),
    "GetTextureLevelParameterfv": exec_info(compatibility=31, core=31),
    "GetTextureLevelParameteriv": exec_info(compatibility=31, core=31),
    "GetTextureParameterfv": exec_info(compatibility=31, core=31),
    "GetTextureParameterIiv": exec_info(compatibility=31, core=31),
    "GetTextureParameterIuiv": exec_info(compatibility=31, core=31),
    "GetTextureParameteriv": exec_info(compatibility=31, core=31),
    "CreateVertexArrays": exec_info(compatibility=31, core=31),
    "DisableVertexArrayAttrib": exec_info(compatibility=31, core=31),
    "EnableVertexArrayAttrib": exec_info(compatibility=31, core=31),
    "VertexArrayElementBuffer": exec_info(compatibility=31, core=31),
    "VertexArrayVertexBuffer": exec_info(compatibility=31, core=31),
    "VertexArrayVertexBuffers": exec_info(compatibility=31, core=31),
    "VertexArrayAttribFormat": exec_info(compatibility=31, core=31),
    "VertexArrayAttribIFormat": exec_info(compatibility=31, core=31),
    "VertexArrayAttribLFormat": exec_info(compatibility=31, core=31),
    "VertexArrayAttribBinding": exec_info(compatibility=31, core=31),
    "VertexArrayBindingDivisor": exec_info(compatibility=31, core=31),
    "GetVertexArrayiv": exec_info(compatibility=31, core=31),
    "GetVertexArrayIndexediv": exec_info(compatibility=31, core=31),
    "GetVertexArrayIndexed64iv": exec_info(compatibility=31, core=31),
    "CreateSamplers": exec_info(compatibility=31, core=31),
    "CreateProgramPipelines": exec_info(compatibility=31, core=31),
    "CreateQueries": exec_info(compatibility=31, core=31),
    "GetQueryBufferObjectiv": exec_info(compatibility=31, core=31),
    "GetQueryBufferObjectuiv": exec_info(compatibility=31, core=31),
    "GetQueryBufferObjecti64v": exec_info(compatibility=31, core=31),
    "GetQueryBufferObjectui64v": exec_info(compatibility=31, core=31),

    # GL_ARB_gpu_shader_int64 - nominally requires OpenGL 4.0
    "Uniform1i64ARB": exec_info(compatibility=40, core=31),
    "Uniform2i64ARB": exec_info(compatibility=40, core=31),
    "Uniform3i64ARB": exec_info(compatibility=40, core=31),
    "Uniform4i64ARB": exec_info(compatibility=40, core=31),
    "Uniform1i64vARB": exec_info(compatibility=40, core=31),
    "Uniform2i64vARB": exec_info(compatibility=40, core=31),
    "Uniform3i64vARB": exec_info(compatibility=40, core=31),
    "Uniform4i64vARB": exec_info(compatibility=40, core=31),
    "Uniform1ui64ARB": exec_info(compatibility=40, core=31),
    "Uniform2ui64ARB": exec_info(compatibility=40, core=31),
    "Uniform3ui64ARB": exec_info(compatibility=40, core=31),
    "Uniform4ui64ARB": exec_info(compatibility=40, core=31),
    "Uniform1ui64vARB": exec_info(compatibility=40, core=31),
    "Uniform2ui64vARB": exec_info(compatibility=40, core=31),
    "Uniform3ui64vARB": exec_info(compatibility=40, core=31),
    "Uniform4ui64vARB": exec_info(compatibility=40, core=31),
    "GetUniformi64vARB": exec_info(compatibility=40, core=31),
    "GetUniformui64vARB": exec_info(compatibility=40, core=31),
    "GetnUniformi64vARB": exec_info(compatibility=40, core=31),
    "GetnUniformui64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform1i64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform2i64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform3i64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform4i64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform1i64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform2i64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform3i64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform4i64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform1ui64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform2ui64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform3ui64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform4ui64ARB": exec_info(compatibility=40, core=31),
    "ProgramUniform1ui64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform2ui64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform3ui64vARB": exec_info(compatibility=40, core=31),
    "ProgramUniform4ui64vARB": exec_info(compatibility=40, core=31),

    # GL_ARB_bindless_texture
    "GetVertexAttribLui64vARB": exec_info(compatibility=30, core=31),
}

def get_api_condition(f):
    condition_parts = []
    if f.name in functions:
        ex = functions[f.name]
        unconditional_count = 0

        if ex.compatibility is not None:
            condition_parts.append('_mesa_is_desktop_gl_compat(ctx)')
            unconditional_count += 1

        if ex.core is not None:
            condition_parts.append('_mesa_is_desktop_gl_core(ctx)')
            unconditional_count += 1

        if ex.es1 is not None:
            condition_parts.append('_mesa_is_gles1(ctx)')
            unconditional_count += 1

        if ex.es2 is not None:
            if ex.es2 > 20:
                condition_parts.append('(_mesa_is_gles2(ctx) && ctx->Version >= {0})'.format(ex.es2))
            else:
                condition_parts.append('_mesa_is_gles2(ctx)')
                unconditional_count += 1

        # If the function is unconditionally available in all four
        # APIs, then it is always available.  Replace the complex
        # tautology condition with "true" and let GCC do the right
        # thing.
        if unconditional_count == 4:
            condition_parts = ['true']
    else:
        if f.desktop:
            if f.deprecated:
                condition_parts.append('_mesa_is_desktop_gl_compat(ctx)')
            else:
                condition_parts.append('_mesa_is_desktop_gl(ctx)')
        if 'es1' in f.api_map:
            condition_parts.append('_mesa_is_gles1(ctx)')
        if 'es2' in f.api_map:
            if f.api_map['es2'] > 2.0:
                condition_parts.append('(_mesa_is_gles2(ctx) && ctx->Version >= {0})'.format(int(f.api_map['es2'] * 10)))
            else:
                condition_parts.append('_mesa_is_gles2(ctx)')

    if not condition_parts:
        # This function does not exist in any API.
        return None
    return ' || '.join(condition_parts)

def print_glapi_file(printer):
    parser = argparse.ArgumentParser()
    parser.add_argument('-f',
                        dest='filename',
                        default='gl_and_es_API.xml',
                        help='an xml file describing an API')
    args = parser.parse_args()
    api = gl_XML.parse_GL_API(args.filename)
    printer.Print(api)