mirror of
https://github.com/love2d/love.git
synced 2026-08-16 00:02:12 +02:00
Alex Szpakowski
167 lines
3.8 KiB
C++
167 lines
3.8 KiB
C++
/**
|
|
* Copyright (c) 2006-2016 LOVE Development Team
|
|
*
|
|
* This software is provided 'as-is', without any express or implied
|
|
* warranty. In no event will the authors be held liable for any damages
|
|
* arising from the use of this software.
|
|
*
|
|
* Permission is granted to anyone to use this software for any purpose,
|
|
* including commercial applications, and to alter it and redistribute it
|
|
* freely, subject to the following restrictions:
|
|
*
|
|
* 1. The origin of this software must not be misrepresented; you must not
|
|
* claim that you wrote the original software. If you use this software
|
|
* in a product, an acknowledgment in the product documentation would be
|
|
* appreciated but is not required.
|
|
* 2. Altered source versions must be plainly marked as such, and must not be
|
|
* misrepresented as being the original software.
|
|
* 3. This notice may not be removed or altered from any source distribution.
|
|
**/
|
|
|
|
#ifndef LOVE_IMAGE_COMPRESSED_IMAGE_DATA_H
|
|
#define LOVE_IMAGE_COMPRESSED_IMAGE_DATA_H
|
|
|
|
// LOVE
|
|
#include "common/Data.h"
|
|
#include "common/StringMap.h"
|
|
#include "common/int.h"
|
|
|
|
// STL
|
|
#include <vector>
|
|
|
|
namespace love
|
|
{
|
|
namespace image
|
|
{
|
|
|
|
/**
|
|
* CompressedImageData represents image data which is designed to be uploaded to
|
|
* the GPU and rendered in its compressed form, without being decompressed.
|
|
* http://renderingpipeline.com/2012/07/texture-compression/
|
|
**/
|
|
class CompressedImageData : public Data
|
|
{
|
|
public:
|
|
|
|
// Recognized compressed image data formats.
|
|
enum Format
|
|
{
|
|
FORMAT_UNKNOWN,
|
|
FORMAT_DXT1,
|
|
FORMAT_DXT3,
|
|
FORMAT_DXT5,
|
|
FORMAT_BC4,
|
|
FORMAT_BC4s,
|
|
FORMAT_BC5,
|
|
FORMAT_BC5s,
|
|
FORMAT_BC6H,
|
|
FORMAT_BC6Hs,
|
|
FORMAT_BC7,
|
|
FORMAT_PVR1_RGB2,
|
|
FORMAT_PVR1_RGB4,
|
|
FORMAT_PVR1_RGBA2,
|
|
FORMAT_PVR1_RGBA4,
|
|
FORMAT_ETC1,
|
|
FORMAT_ETC2_RGB,
|
|
FORMAT_ETC2_RGBA,
|
|
FORMAT_ETC2_RGBA1,
|
|
FORMAT_EAC_R,
|
|
FORMAT_EAC_Rs,
|
|
FORMAT_EAC_RG,
|
|
FORMAT_EAC_RGs,
|
|
FORMAT_ASTC_4x4,
|
|
FORMAT_ASTC_5x4,
|
|
FORMAT_ASTC_5x5,
|
|
FORMAT_ASTC_6x5,
|
|
FORMAT_ASTC_6x6,
|
|
FORMAT_ASTC_8x5,
|
|
FORMAT_ASTC_8x6,
|
|
FORMAT_ASTC_8x8,
|
|
FORMAT_ASTC_10x5,
|
|
FORMAT_ASTC_10x6,
|
|
FORMAT_ASTC_10x8,
|
|
FORMAT_ASTC_10x10,
|
|
FORMAT_ASTC_12x10,
|
|
FORMAT_ASTC_12x12,
|
|
FORMAT_MAX_ENUM
|
|
};
|
|
|
|
// Compressed image data can have multiple mipmap levels, each represented
|
|
// by a sub-image.
|
|
struct SubImage
|
|
{
|
|
int width, height;
|
|
size_t size;
|
|
uint8 *data; // Should not have ownership of the data.
|
|
};
|
|
|
|
CompressedImageData();
|
|
virtual ~CompressedImageData();
|
|
|
|
// Implements Data.
|
|
virtual void *getData() const;
|
|
virtual size_t getSize() const;
|
|
|
|
/**
|
|
* Gets the number of mipmaps in this Compressed Image Data.
|
|
* Includes the base image level.
|
|
**/
|
|
int getMipmapCount() const;
|
|
|
|
/**
|
|
* Gets the size in bytes of a sub-image at the specified mipmap level.
|
|
**/
|
|
size_t getSize(int miplevel) const;
|
|
|
|
/**
|
|
* Gets the byte data of a sub-image at the specified mipmap level.
|
|
**/
|
|
void *getData(int miplevel) const;
|
|
|
|
/**
|
|
* Gets the width of a sub-image at the specified mipmap level.
|
|
**/
|
|
int getWidth(int miplevel = 0) const;
|
|
|
|
/**
|
|
* Gets the height of a sub-image at the specified mipmap level.
|
|
**/
|
|
int getHeight(int miplevel = 0) const;
|
|
|
|
/**
|
|
* Gets the format of the compressed data.
|
|
**/
|
|
Format getFormat() const;
|
|
|
|
bool isSRGB() const;
|
|
|
|
static bool getConstant(const char *in, Format &out);
|
|
static bool getConstant(Format in, const char *&out);
|
|
|
|
protected:
|
|
|
|
Format format;
|
|
|
|
bool sRGB;
|
|
|
|
// Single block of memory containing all of the sub-images.
|
|
uint8 *data;
|
|
size_t dataSize;
|
|
|
|
// Texture info for each mipmap level.
|
|
std::vector<SubImage> dataImages;
|
|
|
|
void checkMipmapLevelExists(int miplevel) const;
|
|
|
|
private:
|
|
|
|
static StringMap<Format, FORMAT_MAX_ENUM>::Entry formatEntries[];
|
|
static StringMap<Format, FORMAT_MAX_ENUM> formats;
|
|
|
|
}; // CompressedImageData
|
|
|
|
} // image
|
|
} // love
|
|
|
|
#endif // LOVE_IMAGE_COMPRESSED_IMAGE_DATA_H
|