Texture.h

// Copyright 2022 ShenMian
// License(Apache-2.0)
 
#pragma once
 
#include "Core/Platform.h"
#include "Format.h"
#include "math/math.hpp"
#include <cstdint>
#include <filesystem>
#include <memory>
#include <unordered_map>
#include <vector>
 
// TODO: 一个想法
// create(const std::vector<Image>& image /* mipmaps */, Format fmt = Format::Unknown, Type type = Type::_2D);
 
class Image;
 
uint32_t GetMaxMipmapLevel(const Vector2i& size);
 
class Texture
{
public:
    // 纹理过滤方式
    enum class Filter
    {
        Nearest,  
        Bilinear, 
        Trilinear 
    };
 
    // 纹理环绕方式(纹理寻址方式)
    enum class Warp
    {
        Repeat,      
        ClampToEdge, 
        MirrorRepeat 
    };
 
    // 纹理类型
    enum class Type
    {
        _2D,
        _3D,
        Cube,
    };
 
    [[nodiscard]] static std::shared_ptr<Texture> create(const std::filesystem::path& path,
                                                         Format fmt = Format::Unknown, uint32_t mipmapLevel = -1,
                                                         Type type = Type::_2D);
 
    [[nodiscard]] static std::shared_ptr<Texture> create(const Image& image, Format fmt = Format::Unknown,
                                                         uint32_t mipmapLevel = -1, Type type = Type::_2D);
 
    [[nodiscard]] static std::shared_ptr<Texture> create(const std::vector<Image>& images);
 
    virtual void bind(uint32_t binding) = 0;
 
    virtual void set_min_filter(Filter filter) = 0;
 
    virtual void set_mag_filter(Filter filter) = 0;
 
    virtual void set_s_warp(Warp warp) = 0;
 
    virtual void set_t_warp(Warp warp) = 0;
 
    virtual void set_r_warp(Warp warp) = 0;
 
    [[nodiscard]] Type get_type() const;
 
    [[nodiscard]] Format get_format() const;
 
protected:
    Texture(Type type, Format fmt);
 
    Type   type_;
    Format format_;
 
    inline static std::unordered_map<std::filesystem::path, std::shared_ptr<Texture>> cache_;
};