Update and improve documentation

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

diff --git a/source/core/texture1d.h b/source/core/texture1d.h
index c4230d3162d08e85d2ae046d94250f22c9a3578a..7ef55f80fdf17ec9c295efff74f2e914dd91e975 100644 (file)
--- a/source/core/texture1d.h
+++ b/source/core/texture1d.h
@@ -7,6 +7,9 @@
 namespace Msp {
 namespace GL {
 
+/**
+One-dimensional texture, consisting of a single row of texels.
+*/
 class Texture1D: public Texture1DBackend
 {
        friend Texture1DBackend;
@@ -30,10 +33,21 @@ private:
        unsigned levels = 0;
 
 public:
-       void storage(PixelFormat, unsigned, unsigned = 0);
+       /** Sets storage format and size 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 lv = 0);
+
+       /** Replaces contents of an entire mipmap level.  Allocated storage must
+       exist.  The image data is interpreted according to the storage format and
+       must have size matching the selected mipmap level. */
+       void image(unsigned level, const void *);
+
+       /** Replaces a range of texels in the texture.  Allocated storage must
+       exist.  The image data is interpreted according to the storage format and
+       the range must be fully inside the selected mipmap level. */
+       void sub_image(unsigned level, int x, unsigned wd, const void *);
 
-       void image(unsigned, const void *);
-       void sub_image(unsigned, int, unsigned, const void *);
        virtual void image(const Graphics::Image &, unsigned = 0);
 
        unsigned get_width() const { return width; }