135 lines
6.1 KiB
C++
135 lines
6.1 KiB
C++
// Copyright (C) 2015 Jérôme Leclercq
|
|
// This file is part of the "Nazara Engine - Renderer module"
|
|
// For conditions of distribution and use, see copyright notice in Config.hpp
|
|
|
|
#pragma once
|
|
|
|
#ifndef NAZARA_TEXTURE_HPP
|
|
#define NAZARA_TEXTURE_HPP
|
|
|
|
#include <Nazara/Prerequesites.hpp>
|
|
#include <Nazara/Core/ObjectLibrary.hpp>
|
|
#include <Nazara/Core/ObjectRef.hpp>
|
|
#include <Nazara/Core/RefCounted.hpp>
|
|
#include <Nazara/Core/Resource.hpp>
|
|
#include <Nazara/Core/ResourceManager.hpp>
|
|
#include <Nazara/Core/Signal.hpp>
|
|
#include <Nazara/Renderer/Config.hpp>
|
|
#include <Nazara/Renderer/Enums.hpp>
|
|
#include <Nazara/Utility/AbstractImage.hpp>
|
|
#include <Nazara/Utility/CubemapParams.hpp>
|
|
#include <Nazara/Utility/Image.hpp>
|
|
|
|
class NzTexture;
|
|
|
|
using NzTextureConstRef = NzObjectRef<const NzTexture>;
|
|
using NzTextureLibrary = NzObjectLibrary<NzTexture>;
|
|
using NzTextureManager = NzResourceManager<NzTexture, NzImageParams>;
|
|
using NzTextureRef = NzObjectRef<NzTexture>;
|
|
|
|
struct NzTextureImpl;
|
|
|
|
class NAZARA_RENDERER_API NzTexture : public NzAbstractImage, public NzRefCounted, public NzResource
|
|
{
|
|
friend NzTextureLibrary;
|
|
friend NzTextureManager;
|
|
friend class NzRenderer;
|
|
|
|
public:
|
|
NzTexture() = default;
|
|
NzTexture(nzImageType type, nzPixelFormat format, unsigned int width, unsigned int height, unsigned int depth = 1, nzUInt8 levelCount = 1);
|
|
explicit NzTexture(const NzImage& image);
|
|
NzTexture(const NzTexture&) = delete;
|
|
NzTexture(NzTexture&&) = delete;
|
|
~NzTexture();
|
|
|
|
bool Create(nzImageType type, nzPixelFormat format, unsigned int width, unsigned int height, unsigned int depth = 1, nzUInt8 levelCount = 1);
|
|
void Destroy();
|
|
|
|
bool Download(NzImage* image) const;
|
|
|
|
bool EnableMipmapping(bool enable);
|
|
|
|
void EnsureMipmapsUpdate() const;
|
|
|
|
unsigned int GetDepth(nzUInt8 level = 0) const;
|
|
nzPixelFormat GetFormat() const;
|
|
unsigned int GetHeight(nzUInt8 level = 0) const;
|
|
nzUInt8 GetLevelCount() const;
|
|
nzUInt8 GetMaxLevel() const;
|
|
unsigned int GetMemoryUsage() const;
|
|
unsigned int GetMemoryUsage(nzUInt8 level) const;
|
|
NzVector3ui GetSize(nzUInt8 level = 0) const;
|
|
nzImageType GetType() const;
|
|
unsigned int GetWidth(nzUInt8 level = 0) const;
|
|
|
|
bool HasMipmaps() const;
|
|
|
|
void InvalidateMipmaps();
|
|
bool IsValid() const;
|
|
|
|
// Load
|
|
bool LoadFromFile(const NzString& filePath, const NzImageParams& params = NzImageParams(), bool generateMipmaps = true);
|
|
bool LoadFromImage(const NzImage& image, bool generateMipmaps = true);
|
|
bool LoadFromMemory(const void* data, std::size_t size, const NzImageParams& params = NzImageParams(), bool generateMipmaps = true);
|
|
bool LoadFromStream(NzInputStream& stream, const NzImageParams& params = NzImageParams(), bool generateMipmaps = true);
|
|
|
|
// LoadArray
|
|
bool LoadArrayFromFile(const NzString& filePath, const NzImageParams& imageParams = NzImageParams(), bool generateMipmaps = true, const NzVector2ui& atlasSize = NzVector2ui(2, 2));
|
|
bool LoadArrayFromImage(const NzImage& image, bool generateMipmaps = true, const NzVector2ui& atlasSize = NzVector2ui(2, 2));
|
|
bool LoadArrayFromMemory(const void* data, std::size_t size, const NzImageParams& imageParams = NzImageParams(), bool generateMipmaps = true, const NzVector2ui& atlasSize = NzVector2ui(2, 2));
|
|
bool LoadArrayFromStream(NzInputStream& stream, const NzImageParams& imageParams = NzImageParams(), bool generateMipmaps = true, const NzVector2ui& atlasSize = NzVector2ui(2, 2));
|
|
|
|
// LoadCubemap
|
|
bool LoadCubemapFromFile(const NzString& filePath, const NzImageParams& imageParams = NzImageParams(), bool generateMipmaps = true, const NzCubemapParams& cubemapParams = NzCubemapParams());
|
|
bool LoadCubemapFromImage(const NzImage& image, bool generateMipmaps = true, const NzCubemapParams& params = NzCubemapParams());
|
|
bool LoadCubemapFromMemory(const void* data, std::size_t size, const NzImageParams& imageParams = NzImageParams(), bool generateMipmaps = true, const NzCubemapParams& cubemapParams = NzCubemapParams());
|
|
bool LoadCubemapFromStream(NzInputStream& stream, const NzImageParams& imageParams = NzImageParams(), bool generateMipmaps = true, const NzCubemapParams& cubemapParams = NzCubemapParams());
|
|
|
|
// LoadFace
|
|
bool LoadFaceFromFile(nzCubemapFace face, const NzString& filePath, const NzImageParams& params = NzImageParams());
|
|
bool LoadFaceFromMemory(nzCubemapFace face, const void* data, std::size_t size, const NzImageParams& params = NzImageParams());
|
|
bool LoadFaceFromStream(nzCubemapFace face, NzInputStream& stream, const NzImageParams& params = NzImageParams());
|
|
|
|
bool SetMipmapRange(nzUInt8 minLevel, nzUInt8 maxLevel);
|
|
|
|
bool Update(const NzImage& image, nzUInt8 level = 0);
|
|
bool Update(const NzImage& image, const NzBoxui& box, nzUInt8 level = 0);
|
|
bool Update(const NzImage& image, const NzRectui& rect, unsigned int z = 0, nzUInt8 level = 0);
|
|
bool Update(const nzUInt8* pixels, unsigned int srcWidth = 0, unsigned int srcHeight = 0, nzUInt8 level = 0);
|
|
bool Update(const nzUInt8* pixels, const NzBoxui& box, unsigned int srcWidth = 0, unsigned int srcHeight = 0, nzUInt8 level = 0);
|
|
bool Update(const nzUInt8* pixels, const NzRectui& rect, unsigned int z = 0, unsigned int srcWidth = 0, unsigned int srcHeight = 0, nzUInt8 level = 0);
|
|
|
|
// Fonctions OpenGL
|
|
unsigned int GetOpenGLID() const;
|
|
|
|
NzTexture& operator=(const NzTexture&) = delete;
|
|
NzTexture& operator=(NzTexture&&) = delete;
|
|
|
|
static unsigned int GetValidSize(unsigned int size);
|
|
static bool IsFormatSupported(nzPixelFormat format);
|
|
static bool IsMipmappingSupported();
|
|
static bool IsTypeSupported(nzImageType type);
|
|
template<typename... Args> static NzTextureRef New(Args&&... args);
|
|
|
|
// Signals:
|
|
NazaraSignal(OnTextureDestroy, const NzTexture* /*texture*/);
|
|
NazaraSignal(OnTextureRelease, const NzTexture* /*texture*/);
|
|
|
|
private:
|
|
bool CreateTexture(bool proxy);
|
|
|
|
static bool Initialize();
|
|
static void Uninitialize();
|
|
|
|
NzTextureImpl* m_impl = nullptr;
|
|
|
|
static NzTextureLibrary::LibraryMap s_library;
|
|
static NzTextureManager::ManagerMap s_managerMap;
|
|
static NzTextureManager::ManagerParams s_managerParameters;
|
|
};
|
|
|
|
#include <Nazara/Renderer/Texture.inl>
|
|
|
|
#endif // NAZARA_TEXTURE_HPP
|