Function SetMaterialTexture

engine/gamesys/src/gamesys/scripts/script_material.cpp:898–952

sets textures in a material * Sets textures in a material, if the samplers exist. * * @name material.set_textures * * @param path [type:hash|string] The path to the resource * @param textures [type:table] A table keyed by sampler name with texture resources as values. * * @examples * Set a texture in a material from a resource * * ```lua

     * ```
     */
    static int SetMaterialTexture(lua_State* L, MaterialResource* material_res, dmhash_t name_hash, int texture_index)
    {
        texture_index = texture_index < 0 ? lua_gettop(L) + texture_index + 1 : texture_index;

        uint32_t unit = dmRender::GetMaterialSamplerUnit(material_res->m_Material, name_hash);
        if (unit == dmRender::INVALID_SAMPLER_UNIT)
        {
            return luaL_error(L, "Material sampler '%s' not found", dmHashReverseSafe64(name_hash));
        }

        dmhash_t texture_path        = dmScript::CheckHashOrString(L, texture_index);
        TextureResource* texture_res = (TextureResource*) CheckResource(L, g_MaterialModule.m_Factory, texture_path, "texturec");

        dmGraphics::HContext graphics_context   = dmRender::GetGraphicsContext(dmRender::GetMaterialRenderContext(material_res->m_Material));
        dmGraphics::TextureType texture_type_in = dmGraphics::GetTextureType(graphics_context, texture_res->m_Texture);
        dmRender::HSampler sampler              = dmRender::GetMaterialSampler(material_res->m_Material, unit);

        dmRender::SamplerInfo sampler_info = {};
        dmRender::GetSamplerInfo(sampler, &sampler_info);

        dmGraphics::TextureType normalized_sampler_type = NormalizeBindableTextureType(sampler_info.m_TextureType);

        if (normalized_sampler_type != texture_type_in)
        {
            return luaL_error(L, "Texture type mismatch. Can't bind a %s texture to a %s sampler",
                dmGraphics::GetTextureTypeLiteral(texture_type_in),
                dmGraphics::GetTextureTypeLiteral(normalized_sampler_type));
        }

        material_res->m_TextureResourcePaths[unit] = texture_path;
        material_res->m_SamplerNames[unit]         = name_hash;

        if (material_res->m_Textures[unit] != texture_res)
        {
            if (material_res->m_Textures[unit])
            {
                dmResource::Release(g_MaterialModule.m_Factory, material_res->m_Textures[unit]);
            }
            dmResource::IncRef(g_MaterialModule.m_Factory, texture_res);
            material_res->m_Textures[unit] = texture_res;
        }

        // Recalculate number of textures (similar to res_material.cpp) by checking which samplers exist
        material_res->m_NumTextures = 0;
        for (uint32_t i = 0; i < dmRender::RenderObject::MAX_TEXTURE_COUNT; ++i)
        {
            uint32_t unit = dmRender::GetMaterialSamplerUnit(material_res->m_Material, material_res->m_SamplerNames[i]);
            if (unit == dmRender::INVALID_SAMPLER_UNIT)
            {
                continue;
            }
            material_res->m_NumTextures++;
        }
        return 0;
    }

    static int Material_SetTextures(lua_State* L)
    {