Added love.math.compress(data, format [, level]) and love.math.decompress(compresseddata) / love.math.decompress(compressedstring, format).

Renamed the love.image CompressedData type to CompressedImageData. love.math.compress returns a love.math CompressedData object which holds the newly compressed data. Currently supported formats are "lz4" and "zlib". Note that the formats are not file formats and don't compress filesystem hierarchies.
2026-08-16 16:20:42 +02:00 · 2015-03-23 11:28:14 -03:00
parent 4d92d00aff
commit a29b349014
45 changed files with 3895 additions and 395 deletions
@@ -0,0 +1,152 @@
+/**
+ * Copyright (c) 2006-2015 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_ETC1,
+		FORMAT_ETC2_RGB,
+		FORMAT_ETC2_RGBA,
+		FORMAT_ETC2_RGBA1,
+		FORMAT_EAC_R,
+		FORMAT_EAC_Rs,
+		FORMAT_EAC_RG,
+		FORMAT_EAC_RGs,
+		FORMAT_PVR1_RGB2,
+		FORMAT_PVR1_RGB4,
+		FORMAT_PVR1_RGBA2,
+		FORMAT_PVR1_RGBA4,
+		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) const;
+
+	/**
+	 * Gets the height of a sub-image at the specified mipmap level.
+	 **/
+	int getHeight(int miplevel) 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