X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=source%2Fcore%2Ftexture2d.h;h=b13b8b3ca3bd8c274c04056d00999bbd26707b4e;hb=3efe3bab1c8290bd49a957ebec0ad97e58a35fcf;hp=7553b6b703c944a2144e989bf605d41b9ae2295c;hpb=7aaec9a70b8d7733429bec043f8e33e02956f266;p=libs%2Fgl.git

diff --git a/source/core/texture2d.h b/source/core/texture2d.h
index 7553b6b7..b13b8b3c 100644
--- a/source/core/texture2d.h
+++ b/source/core/texture2d.h
@@ -2,19 +2,19 @@
 #define MSP_GL_TEXTURE2D_H_
 
 #include <string>
-#include <msp/graphics/image.h>
-#include "texture.h"
+#include <msp/linal/vector.h>
+#include "texture2d_backend.h"
 
 namespace Msp {
 namespace GL {
 
 /**
-Two-dimensional texture.  Consists of an array of texels in the shape of a
-rectangle.  Texture coordinate have a range of [0, 1].  Coordinates outside of
-this range are subject to wrapping.  This is the most common type of texture.
+Two-dimensional texture, consisting of a rectangular array of texels.
 */
-class Texture2D: public Texture
+class Texture2D: public Texture2DBackend
 {
+	friend Texture2DBackend;
+
 public:
 	class Loader: public Msp::DataFile::DerivedObjectLoader<Texture2D, Texture::Loader>
 	{
@@ -24,74 +24,78 @@ public:
 	private:
 		void init();
 
-		void raw_data(const std::string &);
 		void storage(PixelFormat, unsigned, unsigned);
 		void storage_levels(PixelFormat, unsigned, unsigned, unsigned);
 	};
 
+	/**
+	An RAII handle for asynchronously writing texel data into a texture.
+	*/
+	class AsyncTransfer: public Texture2DBackend::AsyncTransfer
+	{
+		friend Texture2DBackend;
+		friend class Texture2D;
+		friend class Texture2DBackend::AsyncTransfer;
+
+	private:
+		Texture2D *texture = 0;
+		unsigned level = 0;
+		unsigned x = 0;
+		unsigned y = 0;
+		unsigned width = 0;
+		unsigned height = 0;
+		std::size_t data_size = 0;
+		void *dest_addr = 0;
+
+		AsyncTransfer(Texture2D &, unsigned, unsigned, unsigned, unsigned, unsigned);
+	public:
+		AsyncTransfer() = default;
+		AsyncTransfer(AsyncTransfer &&);
+		AsyncTransfer &operator=(AsyncTransfer &&);
+		~AsyncTransfer();
+
+	public:
+		/** Returns an address for writing the texel data.  It should not be used
+		beyond the lifetime of the object. */
+		void *get_address() { return dest_addr; }
+	};
+
 private:
 	class AsyncLoader;
 
-	unsigned width;
-	unsigned height;
-	unsigned levels;
-	unsigned allocated;
+	unsigned width = 0;
+	unsigned height = 0;
 
 public:
-	Texture2D(ResourceManager * = 0);
+	Texture2D() = default;
+	Texture2D(Texture2D &&) = default;
 	virtual ~Texture2D();
 
-	/** Defines storage structure for the texture.  If lv is zero, the number
-	of mipmap levels is automatically determined from storage dimensions.
+	/** Sets storage format and dimensions and allocates memory for the texture.
+	If lv is zero, a complete mipmap pyramid is automatically created.  Storage
+	cannot be changed once set. */
+	void storage(PixelFormat, unsigned wd, unsigned ht, unsigned lv = 0);
 
-	Must be called before an image can be uploaded.  Once storage is defined,
-	it can't be changed. */
-	void storage(PixelFormat fmt, unsigned wd, unsigned ht, unsigned lv = 0);
+	void image(unsigned level, const void *) override;
 
-	DEPRECATED void storage(PixelComponents cm, unsigned wd, unsigned ht, unsigned lv = 0)
-	{ storage(make_pixelformat(cm, UNSIGNED_BYTE), wd, ht, lv); }
+	/** Replaces a rectangular region of the texture.  Allocated storage must
+	exist.  The image data is interpreted according to the storage format and
+	the region must be fully inside the selected mipmap level. */
+	void sub_image(unsigned level, unsigned x, unsigned y, unsigned wd, unsigned ht, const void *);
 
-	/** Allocates storage for the texture.  The contents are initially
-	undefined.  If storage has already been allocated, does nothing. */
-	void allocate(unsigned level);
+	AsyncTransfer sub_image_async(unsigned level, unsigned x, unsigned y, unsigned wd, unsigned ht);
 
-	/** Updates the contents of the entire texture.  Storage must be defined
-	beforehand.  The image data must have dimensions and format matching the
-	defined storage. */
-	virtual void image(unsigned level, const void *data);
+	virtual void image(const Graphics::Image &, unsigned = 0);
 
-	DEPRECATED void image(unsigned level, PixelComponents fmt, DataType type, const void *data);
-
-	/** Updates a rectangular region of the texture.  Storage must be defined
-	beforehand.  The image data must be in a format mathing the defined storage
-	and the update region must be fully inside the texture. */
-	void sub_image(unsigned level, int x, int y, unsigned wd, unsigned ht, const void *data);
-
-	DEPRECATED void sub_image(unsigned level, int x, int y, unsigned wd, unsigned ht,
-		PixelComponents fmt, DataType type, const void *data);
-
-	/** Updates the contents of the entire texture from an image.  If storage
-	has not been defined, it will be set to match the image.  Otherwise the
-	image must match the defined storage. */
-	virtual void image(const Graphics::Image &, unsigned lv = 0);
-
-	using Texture::image;
-
-private:
-	void image(const Graphics::Image &, unsigned, bool);
-
-public:
 	unsigned get_width() const { return width; }
 	unsigned get_height() const { return height; }
 
 private:
 	unsigned get_n_levels() const;
-	void get_level_size(unsigned, unsigned &, unsigned &) const;
+	LinAl::Vector<unsigned, 2> get_level_size(unsigned) const;
 
 public:
 	virtual Resource::AsyncLoader *load(IO::Seekable &, const Resources * = 0);
-	virtual UInt64 get_data_size() const;
-	virtual void unload();
 };
 
 } // namespace GL