texture_descriptor.h

/*****************************************************************************
 * VCLib                                                                     *
 * Visual Computing Library                                                  *
 *                                                                           *
 * Copyright(C) 2021-2025                                                    *
 * Visual Computing Lab                                                      *
 * ISTI - Italian National Research Council                                  *
 *                                                                           *
 * All rights reserved.                                                      *
 *                                                                           *
 * This program is free software; you can redistribute it and/or modify      *
 * it under the terms of the Mozilla Public License Version 2.0 as published *
 * by the Mozilla Foundation; either version 2 of the License, or            *
 * (at your option) any later version.                                       *
 *                                                                           *
 * This program is distributed in the hope that it will be useful,           *
 * but WITHOUT ANY WARRANTY; without even the implied warranty of            *
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the              *
 * Mozilla Public License Version 2.0                                        *
 * (https://www.mozilla.org/en-US/MPL/2.0/) for more details.                *
 ****************************************************************************/
 
#ifndef VCL_SPACE_CORE_TEXTURE_DESCRIPTOR_H
#define VCL_SPACE_CORE_TEXTURE_DESCRIPTOR_H
 
#include <vclib/base.h>
 
namespace vcl {
 
class TextureDescriptor
{
public:
    enum class MinificationFilter {
        NONE    = -1,   
        NEAREST = 9728, 
        LINEAR,         
        NEAREST_MIPMAP_NEAREST =
            9984, 
        LINEAR_MIPMAP_NEAREST, 
        NEAREST_MIPMAP_LINEAR, 
        LINEAR_MIPMAP_LINEAR   
    };
 
    enum class MagnificationFilter {
        NONE    = -1,   
        NEAREST = 9728, 
        LINEAR          
    };
 
    enum class WrapMode {
        REPEAT        = 10497,  
        CLAMP_TO_EDGE = 33071,  
        MIRRORED_REPEAT = 33648 
    };
 
private:
    std::string        mPath; 
    MinificationFilter mMinFilter =
        MinificationFilter::NONE; 
    MagnificationFilter mMagFilter =
        MagnificationFilter::NONE; 
    WrapMode mWrapU =
        WrapMode::REPEAT; 
    WrapMode mWrapV =
        WrapMode::REPEAT; 
 
public:
    TextureDescriptor() {}
 
    TextureDescriptor(const std::string& path) : mPath(path) {}
 
    bool isNull() const { return mPath.empty(); }
 
    const std::string& path() const { return mPath; }
 
    std::string& path() { return mPath; }
 
    MinificationFilter minFilter() const { return mMinFilter; }
 
    MinificationFilter& minFilter() { return mMinFilter; }
 
    MagnificationFilter magFilter() const { return mMagFilter; }
 
    MagnificationFilter& magFilter() { return mMagFilter; }
 
    WrapMode wrapU() const { return mWrapU; }
 
    WrapMode& wrapU() { return mWrapU; }
 
    WrapMode wrapV() const { return mWrapV; }
 
    WrapMode& wrapV() { return mWrapV; }
 
    void serialize(std::ostream& os) const
    {
        vcl::serialize(os, mPath);
        vcl::serialize(os, mMinFilter, mMagFilter, mWrapU, mWrapV);
    }
 
    void deserialize(std::istream& is)
    {
        vcl::deserialize(is, mPath);
        vcl::deserialize(is, mMinFilter, mMagFilter, mWrapU, mWrapV);
    }
 
    bool operator==(const TextureDescriptor& other) const = default;
};
 
/* Concepts */
 
template<typename T>
concept TextureDescriptorConcept =
    std::derived_from<std::remove_cvref_t<T>, TextureDescriptor>;
 
} // namespace vcl
 
#endif // VCL_SPACE_CORE_TEXTURE_DESCRIPTOR_H