Function Graphics_GetAdapterInfo

engine/script/src/script_graphics.cpp:800–916

get information about the currently installed graphics adapter * * Returns a table describing the active graphics context: the adapter family, * its hardware limits, the list of driver-reported extensions, and the set of * optional context features supported by the backend. * * @name graphics.get_adapter_info * @return info [type:table] table with the following f

     *     `graphics.CONTEXT_FEATURE_BLEND_EQUATION_MIN_MAX`  min/max blend equations
     */
    static int Graphics_GetAdapterInfo(lua_State* L)
    {
        DM_LUA_STACK_CHECK(L, 1);

        dmGraphics::HContext context = g_GraphicsModule.m_GraphicsContext;

        lua_newtable(L);

        // adapter family literal
        {
            const char* family_name = "none";
            if (context)
            {
                family_name = AdapterFamilyToName(dmGraphics::GetInstalledAdapterFamily());
            }
            lua_pushstring(L, family_name);
            lua_setfield(L, -2, "family");
        }

        // adapter API version
        {
            uint16_t major = 0, minor = 0;
            if (context)
            {
                dmGraphics::GetAdapterVersion(context, major, minor);
            }
            lua_pushinteger(L, (lua_Integer) major);
            lua_setfield(L, -2, "version_major");
            lua_pushinteger(L, (lua_Integer) minor);
            lua_setfield(L, -2, "version_minor");
        }

        // limits sub-table
        {
            lua_newtable(L);

            dmGraphics::GraphicsContextLimits limits = {};
            if (context)
            {
                dmGraphics::GetGraphicsContextLimits(context, limits);
            }

            // Lua numbers are doubles, so uint64_t fields can lose precision above
            // 2^53. The buffer ranges we report fit comfortably below that today,
            // but cast through lua_Number deliberately so a future change shows
            // up in code review.
        #define PUSH_LIMIT(field, key) \
            lua_pushnumber(L, (lua_Number) limits.field); \
            lua_setfield(L, -2, key);

            // Texture limits
            PUSH_LIMIT(m_MaxTextureSize2D,                "max_texture_size_2d");
            PUSH_LIMIT(m_MaxTextureSize3D,                "max_texture_size_3d");
            PUSH_LIMIT(m_MaxTextureSizeCube,              "max_texture_size_cube");
            PUSH_LIMIT(m_MaxTextureArrayLayers,           "max_texture_array_layers");

            // Framebuffer limits
            PUSH_LIMIT(m_MaxFramebufferWidth,             "max_framebuffer_width");