Function RenderScript_EnableTexture

engine/render/src/render/render_script.cpp:1362–1450

sets a texture to the render state * * Sets the specified texture handle for a render target attachment or a regular texture * that should be used for rendering. The texture can be bound to either a texture unit * or to a sampler name by a hash or a string. * A texture can be bound to multiple units and sampler names at the same time, * the actual binding will be appl

     * ```
     */
    int RenderScript_EnableTexture(lua_State* L)
    {
        DM_LUA_STACK_CHECK(L, 0);

        RenderScriptInstance* i = RenderScriptInstance_Check(L);
        dmhash_t sampler_hash   = 0;
        uint32_t unit           = 0;

        if (lua_isnumber(L, 1))
        {
            unit = lua_tointeger(L, 1);
        }
        else
        {
            sampler_hash = dmScript::CheckHashOrString(L, 1);
        }

        dmGraphics::HAssetHandle asset_handle;
        dmGraphics::AssetType asset_type;

        if (lua_isnumber(L, 2))
        {
            asset_handle = (dmGraphics::HAssetHandle) lua_tonumber(L, 2);
            asset_type   = dmGraphics::GetAssetType(asset_handle);
        }
        else if (dmScript::IsHash(L, 2) || lua_isstring(L, 2))
        {
            dmhash_t rt_id                  = dmScript::CheckHashOrString(L, 2);
            RenderResource* render_resource = i->m_RenderResources.Get(rt_id);

            if (render_resource->m_Type != RENDER_RESOURCE_TYPE_RENDER_TARGET)
            {
                return DM_LUA_ERROR("Render resource is not a render target");
            }

            asset_handle = (dmGraphics::HRenderTarget) render_resource->m_Resource;
            asset_type   = dmGraphics::ASSET_TYPE_RENDER_TARGET;
        }
        else
        {
            return DM_LUA_ERROR("%s.enable_texture(unit, handle, buffer_type) for unit %d called with illegal parameters.", RENDER_SCRIPT_LIB_NAME, unit);
        }

        if (!dmGraphics::IsAssetHandleValid(i->m_RenderContext->m_GraphicsContext, asset_handle))
        {
            char buf[128];
            return DM_LUA_ERROR("Texture handle '%s' is not valid.", AssetHandleToString(asset_handle, buf, sizeof(buf)));
        }

        dmGraphics::HTexture texture = 0;

        if (asset_type == dmGraphics::ASSET_TYPE_RENDER_TARGET)
        {
            dmGraphics::BufferType buffer_type = dmGraphics::BUFFER_TYPE_COLOR0_BIT;
            if (lua_isnumber(L, 3))
            {
                buffer_type = CheckBufferType(L, 3);
            }