Add an asynchronous version of Texture2D::sub_image

[libs/gl.git] / source / core / texture2d.h

diff --git a/source/core/texture2d.h b/source/core/texture2d.h
index 05c3283b73bd1aba1dd98f348c0c620753611114..02cdade57e30e1b19cc771b2a0df4030d3b0a3fe 100644 (file)
--- a/source/core/texture2d.h
+++ b/source/core/texture2d.h
@@ -28,6 +28,38 @@ public:
                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:
        unsigned width = 0;
        unsigned height = 0;
@@ -49,6 +81,8 @@ public:
        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 *);
 
+       AsyncTransfer sub_image_async(unsigned level, unsigned x, unsigned y, unsigned wd, unsigned ht);
+
        virtual void image(const Graphics::Image &, unsigned = 0);
 
        unsigned get_width() const { return width; }