3 This file is part of libmspgl
4 Copyright © 2007 Mikko Rasa, Mikkosoft Productions
5 Distributed under the LGPL
8 #ifndef MSP_GL_TEXTURE2D_H_
9 #define MSP_GL_TEXTURE2D_H_
12 #include <msp/gbase/image.h>
14 #include "pixelformat.h"
21 Two-dimensional texture class. This is the most common type of texture.
23 class Texture2D: public Texture
26 class Loader: public Texture::Loader
31 void image_data(const std::string &);
32 void raw_data(const std::string &);
33 void storage(PixelFormat, unsigned, unsigned);
34 void storage_b(PixelFormat, unsigned, unsigned, unsigned);
47 Defines the texture storage. This function may only be successfully called
50 void storage(PixelFormat fmt, unsigned wd, unsigned ht);
52 /** Allocates texture storage. If storage has already been allocated, this
53 function does nothing. */
54 void allocate(unsigned level);
56 /** Uploads an image to the texture. storage() must have been called prior to
57 this, and the image must have dimensions conforming to the specified
58 storage. For level>0, mipmapping rules apply to the image dimensions. */
59 void image(unsigned level, PixelFormat fmt, DataType type, const void *data);
62 Uploads a sub-image into the texture. Unlike full image upload, there are
63 no constraints on the size of the sub-image.
65 void sub_image(unsigned level, int x, int y, unsigned wd, unsigned ht, PixelFormat fmt, DataType type, const void *data);
68 Loads an image from a file and uploads it to the texture. If storage() has
69 not been called, the storage format will be set to match the loaded image.
71 void load_image(const std::string &fn);
73 unsigned get_width() const { return width; }
74 unsigned get_height() const { return height; }
77 void image(const Graphics::Image &);
78 void require_storage();
79 void get_level_size(unsigned, unsigned &, unsigned &);