Create specialized versions of SPIR-V modules with default spec values

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

diff --git a/source/core/texture2d.h b/source/core/texture2d.h
index 6ae600e767acc2c7999d6523eba964db2d542f74..b13b8b3ca3bd8c274c04056d00999bbd26707b4e 100644 (file)
--- a/source/core/texture2d.h
+++ b/source/core/texture2d.h
@@ -9,9 +9,7 @@ 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 Texture2DBackend
 {
@@ -26,40 +24,68 @@ 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 = 0;
        unsigned height = 0;
-       unsigned levels = 0;
 
 public:
+       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;
 
-       /** 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);
+       /** 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 *);
 
-       /** 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);
+       AsyncTransfer sub_image_async(unsigned level, unsigned x, unsigned y, unsigned wd, unsigned ht);
 
-       /** 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);
+       virtual void image(const Graphics::Image &, unsigned = 0);
 
        unsigned get_width() const { return width; }
        unsigned get_height() const { return height; }
@@ -70,8 +96,6 @@ private:
 
 public:
        virtual Resource::AsyncLoader *load(IO::Seekable &, const Resources * = 0);
-       virtual std::uint64_t get_data_size() const;
-       using Texture2DBackend::unload;
 };
 
 } // namespace GL