- void storage(PixelFormat, unsigned, unsigned, unsigned, int);
- void image(int, PixelFormat, DataType, const void *);
- void sub_image(int, int, int, unsigned, unsigned, unsigned, PixelFormat, DataType, const void *);
- void load_image(const std::string &fn, int dp = -1);
+
+ /** Defines storage structure for the texture. If lv is zero, the number
+ of mipmap levels is automatically determined from storage dimensions.
+
+ 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 dp, unsigned lv = 0);
+
+ DEPRECATED void storage(PixelComponents c, unsigned w, unsigned h, unsigned d, unsigned l = 0)
+ { storage(make_pixelformat(c, UNSIGNED_BYTE), w, h, d, l); }
+
+ /** Allocates storage for the texture. The contents are initially
+ undefined. If storage has already been allocated, does nothing. */
+ void allocate(unsigned level);
+
+ /** Uploads an image to the texture. Storage must be defined beforehand.
+ The image data must have dimensions and format compatible with the defined
+ storage. */
+ void image(unsigned level, PixelComponents, DataType type, const void *data);
+
+ /** Updates a cuboid-shaped region of the texture. Storage must be defined
+ and allocated beforehand. The update region must be fully inside the
+ texture. */
+ void sub_image(unsigned level,
+ int x, int y, int z, unsigned wd, unsigned ht, unsigned dp,
+ PixelComponents comp, DataType type, const void *data);
+
+ /** Uploads an image to the texture. If storage has not been defined, it
+ will be set to match the image. In this case the image will be treated as
+ a stack of square layers and its height must be divisible by its width.
+ Otherwise the image must be compatible with the defined storage.
+
+ If srgb is true and storage is determined by this call, then an sRGB pixel
+ format will be used. */
+ virtual void image(const Graphics::Image &, unsigned, bool = false);
+
+ using Texture::image;
+