1 #ifndef MSP_GL_TEXTURE2D_H_
2 #define MSP_GL_TEXTURE2D_H_
5 #include <msp/graphics/image.h>
6 #include <msp/linal/vector.h>
13 Two-dimensional texture. Consists of an array of texels in the shape of a
14 rectangle. Texture coordinate have a range of [0, 1]. Coordinates outside of
15 this range are subject to wrapping. This is the most common type of texture.
17 class Texture2D: public Texture
20 class Loader: public Msp::DataFile::DerivedObjectLoader<Texture2D, Texture::Loader>
24 Loader(Texture2D &, Collection &);
28 void raw_data(const std::string &);
29 void storage(PixelFormat, unsigned, unsigned);
30 void storage_levels(PixelFormat, unsigned, unsigned, unsigned);
42 Texture2D(ResourceManager * = 0);
45 /** Defines storage structure for the texture. If lv is zero, the number
46 of mipmap levels is automatically determined from storage dimensions.
48 Must be called before an image can be uploaded. Once storage is defined,
49 it can't be changed. */
50 void storage(PixelFormat fmt, unsigned wd, unsigned ht, unsigned lv = 0);
52 DEPRECATED void storage(PixelComponents cm, unsigned wd, unsigned ht, unsigned lv = 0)
53 { storage(make_pixelformat(cm, UNSIGNED_BYTE), wd, ht, lv); }
55 /** Allocates storage for the texture. The contents are initially
56 undefined. If storage has already been allocated, does nothing. */
57 void allocate(unsigned level);
60 void allocate_(unsigned level);
63 /** Updates the contents of the entire texture. Storage must be defined
64 beforehand. The image data must have dimensions and format matching the
66 virtual void image(unsigned level, const void *data);
69 void image_(unsigned level, const void *data);
72 DEPRECATED void image(unsigned level, PixelComponents fmt, DataType type, const void *data);
74 /** Updates a rectangular region of the texture. Storage must be defined
75 beforehand. The image data must be in a format mathing the defined storage
76 and the update region must be fully inside the texture. */
77 void sub_image(unsigned level, int x, int y, unsigned wd, unsigned ht, const void *data);
79 DEPRECATED void sub_image(unsigned level, int x, int y, unsigned wd, unsigned ht,
80 PixelComponents fmt, DataType type, const void *data);
82 /** Updates the contents of the entire texture from an image. If storage
83 has not been defined, it will be set to match the image. Otherwise the
84 image must match the defined storage. */
85 virtual void image(const Graphics::Image &, unsigned lv = 0);
90 void image(const Graphics::Image &, unsigned, bool);
93 unsigned get_width() const { return width; }
94 unsigned get_height() const { return height; }
97 unsigned get_n_levels() const;
98 LinAl::Vector<unsigned, 2> get_level_size(unsigned) const;
101 virtual Resource::AsyncLoader *load(IO::Seekable &, const Resources * = 0);
102 virtual UInt64 get_data_size() const;
103 virtual void unload();