SkinnedRenderer.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "RendererTypes.hpp" // BoneInfluence, SkinnedInstance, RigMeshSource
 
#include <SDL3/SDL.h>
#include <SDL3/SDL_gpu.h>
 
#include <glm/glm.hpp>
#include <vector>

class SkinnedRenderer
{
public:
    SkinnedRenderer() = default;
    ~SkinnedRenderer() = default;
 
    SkinnedRenderer(const SkinnedRenderer&) = delete;
    SkinnedRenderer& operator=(const SkinnedRenderer&) = delete;
    SkinnedRenderer(SkinnedRenderer&&) = delete;
    SkinnedRenderer& operator=(SkinnedRenderer&&) = delete;

    void init(SDL_GPUDevice* device, SDL_GPUTextureFormat& colorTarget, const SDL_GPUShaderFormat& shaderFormat);

    bool setRig(const std::vector<RigMeshSource>& meshes, int numJoints);

    void setFrame(const std::vector<glm::mat4>& palette, const std::vector<SkinnedInstance>& instances);

    void uploadFrame(SDL_GPUCommandBuffer* cmd, SDL_GPUCopyPass* copyPass);

    void draw(SDL_GPURenderPass* renderPass, SDL_GPUCommandBuffer* cmd);

    void shutdown();
 
    // ─── Readback (optional, for debug UI) ───────────────────────────────────

    [[nodiscard]] int numJoints() const { return numJoints_; }

    [[nodiscard]] bool rigInstalled() const { return rigInstalled_; }

    [[nodiscard]] size_t pendingInstanceCount() const { return frameInstances_.size(); }
 
private:
    struct SkinnedMesh
    {
        SDL_GPUBuffer* vb = nullptr;
        SDL_GPUBuffer* boneVb = nullptr;
        SDL_GPUBuffer* ib = nullptr;
        Uint32 indexCount = 0;
        Uint32 vertexCount = 0;
    };
 
    struct SsboInfo
    {
        SDL_GPUBuffer* ssbo_{};
        Uint32 capacityBytes_ = 0;
    };

    bool ensureSsbos(Uint32 paletteBytes, Uint32 instanceBytes);
 
    bool createSkinningPipeline(SDL_GPUTextureFormat& colorTarget, const SDL_GPUShaderFormat& shaderFormat);
 
    // ─── Borrowed ────────────────────────────────────────────────────────────
    SDL_GPUDevice* device_ = nullptr;
 
    // ─── Owned: pipeline (graphics team to create) ───────────────────────────
    SDL_GPUGraphicsPipeline* pipeline_ = nullptr;
 
    // ─── Owned: rig (set once via setRig) ────────────────────────────────────
    bool rigInstalled_ = false;
    int numJoints_ = 0;
    std::vector<SkinnedMesh> skinnedMeshes_;
 
    // ─── Owned: per-frame GPU resources (grow on demand) ─────────────────────
    // SDL_GPUBuffer* palettesSsbo_ = nullptr;  ///< STORAGE_READ, mat4[numInstances * numJoints].
    // SDL_GPUBuffer* instancesSsbo_ = nullptr; ///< STORAGE_READ, SkinnedInstance[numInstances].
    // Uint32 palettesCapacityBytes_ = 0;
    // Uint32 instancesCapacityBytes_ = 0;
    SsboInfo palettesSsboInfo_;
    SsboInfo instancesSsboInfo_;
 
    SDL_GPUTransferBuffer* paletteXfer_ = nullptr;
    SDL_GPUTransferBuffer* instanceXfer_ = nullptr;
    Uint32 paletteXferCapacityBytes_ = 0;
    Uint32 instanceXferCapacityBytes_ = 0;
 
    // ─── CPU staging (filled by setFrame, drained by uploadFrame) ────────────
    std::vector<glm::mat4> framePalette_;
    std::vector<SkinnedInstance> frameInstances_;
    bool frameDirty_ = false;
};