World3DGPUScene.hpp

Go to the documentation of this file.

#pragma once
 
#include "MeshGPUResources.hpp"
#include "SequenceWorld3DSlot.hpp"
 
#include <cstdint>
#include <expected>
#include <optional>
#include <vector>
 
namespace monopoly::engine
{
    struct World3DGPUIndexedBatch
    {
        sequence::SequenceNodeId node{};
        data::DataId contentsDataId{};
        std::uint16_t priority{};
        std::int32_t clock{};
        sequence::Matrix3D worldTransform{};
        World3DRect screenBounds{};
        SDL_GPUBuffer* vertexBuffer{};
        SDL_GPUBuffer* indexBuffer{};
        SDL_GPUTexture* gpuTexture{};
        std::uint32_t firstIndex{};
        std::uint32_t indexCount{};
        bool legacyShadow{};
        data::MeshMaterial material{};
        std::optional<data::MeshTextureRegion> texture;
        std::array<SDL_GPUTextureSamplerBinding, 5> modernTextures{};
    };
 
    // Retire stopped mesh assets even when the interface has no 3D view.
    // Active instances remain owners regardless of their current visibility.
    void pruneWorld3DGPUScene(const SequenceWorld3DSlot& slot, MeshGPUCache& cache);
 
    // Final portable scene-data boundary before the SDL_GPU graphics pipeline.
    // It preserves sequencer traversal and per-mesh batch order. Embedded HMD
    // texture pixels are already uploaded by MeshGPUCache at this boundary.
    [[nodiscard]] std::expected<std::vector<World3DGPUIndexedBatch>, MeshGPUError>
        buildWorld3DGPUScene(const SequenceWorld3DSlot& slot, MeshGPUCache& cache);
}