178 lines
7.3 KiB
C++
178 lines
7.3 KiB
C++
// Copyright (C) 2024 Jérôme "SirLynix" Leclercq (lynix680@gmail.com)
|
|
// This file is part of the "Nazara Engine - Core module"
|
|
// For conditions of distribution and use, see copyright notice in Export.hpp
|
|
|
|
#pragma once
|
|
|
|
#ifndef NAZARA_CORE_IMAGE_HPP
|
|
#define NAZARA_CORE_IMAGE_HPP
|
|
|
|
#include <NazaraUtils/Prerequisites.hpp>
|
|
#include <Nazara/Core/AbstractImage.hpp>
|
|
#include <Nazara/Core/Color.hpp>
|
|
#include <Nazara/Core/CubemapParams.hpp>
|
|
#include <Nazara/Core/ObjectLibrary.hpp>
|
|
#include <Nazara/Core/Resource.hpp>
|
|
#include <Nazara/Core/ResourceLoader.hpp>
|
|
#include <Nazara/Core/ResourceManager.hpp>
|
|
#include <Nazara/Core/ResourceParameters.hpp>
|
|
#include <Nazara/Core/ResourceSaver.hpp>
|
|
#include <Nazara/Core/Serialization.hpp>
|
|
#include <NazaraUtils/MovablePtr.hpp>
|
|
#include <NazaraUtils/Signal.hpp>
|
|
#include <atomic>
|
|
|
|
///TODO: Filtres
|
|
|
|
namespace Nz
|
|
{
|
|
struct NAZARA_CORE_API ImageParams : ResourceParameters
|
|
{
|
|
// Le format dans lequel l'image doit être chargée (Undefined pour le format le plus proche de l'original)
|
|
PixelFormat loadFormat = PixelFormat::Undefined;
|
|
|
|
// Le nombre de niveaux de mipmaps maximum devant être créé
|
|
UInt8 levelCount = 0;
|
|
|
|
bool IsValid() const;
|
|
void Merge(const ImageParams& params);
|
|
};
|
|
|
|
NAZARA_CORE_API bool Serialize(SerializationContext& context, ImageParams& params, TypeTag<ImageParams>);
|
|
NAZARA_CORE_API bool Unserialize(SerializationContext& context, ImageParams* params, TypeTag<ImageParams>);
|
|
|
|
class Image;
|
|
|
|
using ImageLibrary = ObjectLibrary<Image>;
|
|
using ImageLoader = ResourceLoader<Image, ImageParams>;
|
|
using ImageManager = ResourceManager<Image, ImageParams>;
|
|
using ImageSaver = ResourceSaver<Image, ImageParams>;
|
|
|
|
class NAZARA_CORE_API Image : public AbstractImage, public Resource
|
|
{
|
|
public:
|
|
using Params = ImageParams;
|
|
struct SharedImage;
|
|
|
|
Image();
|
|
Image(ImageType type, PixelFormat format, unsigned int width, unsigned int height, unsigned int depth = 1, UInt8 levelCount = 1);
|
|
Image(SharedImage* sharedImage);
|
|
Image(const Image& image);
|
|
inline Image(Image&& image) noexcept;
|
|
~Image();
|
|
|
|
bool Convert(PixelFormat format);
|
|
|
|
void Copy(const Image& source, const Boxui& srcBox, const Vector3ui& dstPos);
|
|
|
|
bool Create(ImageType type, PixelFormat format, unsigned int width, unsigned int height, unsigned int depth = 1, UInt8 levelCount = 1);
|
|
void Destroy();
|
|
|
|
bool Fill(const Color& color);
|
|
bool Fill(const Color& color, const Boxui& box);
|
|
bool Fill(const Color& color, const Rectui& rect, unsigned int z = 0);
|
|
|
|
bool FlipHorizontally();
|
|
bool FlipVertically();
|
|
|
|
const UInt8* GetConstPixels(unsigned int x = 0, unsigned int y = 0, unsigned int z = 0, UInt8 level = 0) const;
|
|
unsigned int GetDepth(UInt8 level = 0) const;
|
|
PixelFormat GetFormat() const override;
|
|
unsigned int GetHeight(UInt8 level = 0) const;
|
|
UInt8 GetLevelCount() const override;
|
|
UInt8 GetMaxLevel() const;
|
|
std::size_t GetMemoryUsage() const;
|
|
std::size_t GetMemoryUsage(UInt8 level) const;
|
|
Color GetPixelColor(unsigned int x, unsigned int y = 0, unsigned int z = 0) const;
|
|
UInt8* GetPixels(unsigned int x = 0, unsigned int y = 0, unsigned int z = 0, UInt8 level = 0);
|
|
Vector3ui GetSize(UInt8 level = 0) const override;
|
|
ImageType GetType() const override;
|
|
unsigned int GetWidth(UInt8 level = 0) const;
|
|
|
|
bool HasAlpha() const;
|
|
|
|
bool IsValid() const;
|
|
|
|
// LoadFace
|
|
bool LoadFaceFromFile(CubemapFace face, const std::filesystem::path& filePath, const ImageParams& params = ImageParams());
|
|
bool LoadFaceFromImage(CubemapFace face, const Image& image);
|
|
bool LoadFaceFromMemory(CubemapFace face, const void* data, std::size_t size, const ImageParams& params = ImageParams());
|
|
bool LoadFaceFromStream(CubemapFace face, Stream& stream, const ImageParams& params = ImageParams());
|
|
|
|
// Save
|
|
bool SaveToFile(const std::filesystem::path& filePath, const ImageParams& params = ImageParams());
|
|
bool SaveToStream(Stream& stream, std::string_view format, const ImageParams& params = ImageParams());
|
|
|
|
//TODO: SaveArray, SaveCubemap, SaveFace
|
|
|
|
void SetLevelCount(UInt8 levelCount);
|
|
bool SetPixelColor(const Color& color, unsigned int x, unsigned int y = 0, unsigned int z = 0);
|
|
|
|
using AbstractImage::Update;
|
|
bool Update(const void* pixels, const Boxui& box, unsigned int srcWidth = 0, unsigned int srcHeight = 0, UInt8 level = 0) override;
|
|
|
|
Image& operator=(const Image& image);
|
|
inline Image& operator=(Image&& image) noexcept;
|
|
|
|
static inline void ArrayToRegion(ImageType type, unsigned int baseLayer, unsigned int layerCount, Boxui& region);
|
|
static void Copy(UInt8* destination, const UInt8* source, PixelFormat format, unsigned int width, unsigned int height, unsigned int depth = 1, unsigned int dstWidth = 0, unsigned int dstHeight = 0, unsigned int srcWidth = 0, unsigned int srcHeight = 0);
|
|
static UInt8 GetMaxLevel(unsigned int width, unsigned int height, unsigned int depth = 1);
|
|
static UInt8 GetMaxLevel(ImageType type, unsigned int width, unsigned int height, unsigned int depth = 1);
|
|
static inline Boxui RegionToArray(ImageType type, Boxui region, unsigned int& baseLayer, unsigned int& layerCount);
|
|
|
|
// Load
|
|
static std::shared_ptr<Image> LoadFromFile(const std::filesystem::path& filePath, const ImageParams& params = ImageParams());
|
|
static std::shared_ptr<Image> LoadFromMemory(const void* data, std::size_t size, const ImageParams& params = ImageParams());
|
|
static std::shared_ptr<Image> LoadFromStream(Stream& stream, const ImageParams& params = ImageParams());
|
|
|
|
// Load (array)
|
|
static std::shared_ptr<Image> LoadFromFile(const std::filesystem::path& filePath, const ImageParams& imageParams, const Vector2ui& atlasSize);
|
|
static std::shared_ptr<Image> LoadFromImage(const Image& image, const Vector2ui& atlasSize);
|
|
static std::shared_ptr<Image> LoadFromMemory(const void* data, std::size_t size, const ImageParams& imageParams, const Vector2ui& atlasSize);
|
|
static std::shared_ptr<Image> LoadFromStream(Stream& stream, const ImageParams& imageParams, const Vector2ui& atlasSize);
|
|
|
|
// Load (cubemap)
|
|
static std::shared_ptr<Image> LoadFromFile(const std::filesystem::path& filePath, const ImageParams& imageParams, const CubemapParams& cubemapParams);
|
|
static std::shared_ptr<Image> LoadFromImage(const Image& image, const CubemapParams& params);
|
|
static std::shared_ptr<Image> LoadFromMemory(const void* data, std::size_t size, const ImageParams& imageParams, const CubemapParams& cubemapParams);
|
|
static std::shared_ptr<Image> LoadFromStream(Stream& stream, const ImageParams& imageParams, const CubemapParams& cubemapParams);
|
|
|
|
struct SharedImage
|
|
{
|
|
using PixelContainer = std::vector<std::unique_ptr<UInt8[]>>;
|
|
|
|
SharedImage(unsigned short RefCount, ImageType Type, PixelFormat Format, PixelContainer&& Levels, unsigned int Width, unsigned int Height, unsigned int Depth) :
|
|
type(Type),
|
|
format(Format),
|
|
levels(std::move(Levels)),
|
|
depth(Depth),
|
|
height(Height),
|
|
width(Width),
|
|
refCount(RefCount)
|
|
{
|
|
}
|
|
|
|
ImageType type;
|
|
PixelFormat format;
|
|
PixelContainer levels;
|
|
unsigned int depth;
|
|
unsigned int height;
|
|
unsigned int width;
|
|
|
|
std::atomic_ushort refCount;
|
|
};
|
|
|
|
static SharedImage emptyImage;
|
|
|
|
private:
|
|
void EnsureOwnership();
|
|
void ReleaseImage();
|
|
|
|
SharedImage* m_sharedImage;
|
|
};
|
|
}
|
|
|
|
#include <Nazara/Core/Image.inl>
|
|
|
|
#endif // NAZARA_CORE_IMAGE_HPP
|