metalTextureBinder.h

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
// Copyright 2025-2026 Arnis Lektauers
//
// Per-pass texture binding deduplication.
// Extracted from MetalGraphicsDevice for single-responsibility decomposition.
//
#pragma once
 
#include <array>
#include <vector>
#include <Metal/Metal.hpp>
 
namespace visutwin::canvas
{
    class Texture;
    struct TextureSlot;

    class MetalTextureBinder
    {
    public:
        static constexpr int kMaxTextureSlots = 19;  // Slots 0-18; 11-12 = spot shadow, 15-16 = omni shadow cubemaps, 17 = height map, 18 = SSAO

        void bindCached(MTL::RenderCommandEncoder* encoder, int slot, Texture* texture);

        void clearCached(MTL::RenderCommandEncoder* encoder, int slot);

        void bindSamplerCached(MTL::RenderCommandEncoder* encoder, MTL::SamplerState* sampler);

        void bindMaterialTextures(MTL::RenderCommandEncoder* encoder,
            const std::vector<TextureSlot>& textureSlots);

        void clearAllMaterialSlots(MTL::RenderCommandEncoder* encoder);

        void bindSceneTextures(MTL::RenderCommandEncoder* encoder,
            Texture* envAtlas, Texture* shadow, Texture* sceneDepth, Texture* skyboxCubeMap,
            Texture* reflection = nullptr, Texture* reflectionDepth = nullptr,
            Texture* ssao = nullptr);

        void bindQuadTextures(MTL::RenderCommandEncoder* encoder,
            const std::array<Texture*, 8>& quadBindings);

        void bindLocalShadowTextures(MTL::RenderCommandEncoder* encoder,
            Texture* shadow0, Texture* shadow1);

        void bindOmniShadowTextures(MTL::RenderCommandEncoder* encoder,
            Texture* cube0, Texture* cube1);

        void markClean() { _dirty = false; }

        void resetPassState();
 
    private:
        std::array<Texture*, kMaxTextureSlots> _boundTextures{};
        bool _dirty = true;
        MTL::SamplerState* _boundSampler = nullptr;
    };
}