- /**
- Defines the texture storage. This function may only be successfully called
- once.
- */
- void storage(PixelFormat fmt, unsigned wd, unsigned ht, int brd);
+ /** Defines storage structure for the texture. 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);
+
+ /** Allocates storage for the texture. The contents are initially
+ undefined. If storage has already been allocated, does nothing. */
+ void allocate(unsigned level);