source/texture2d.h

   1 #ifndef MSP_GL_TEXTURE2D_H_
   2 #define MSP_GL_TEXTURE2D_H_
   3
   4 #include <string>
   5 #include <msp/graphics/image.h>
   6 #include "resource.h"
   7 #include "texture.h"
   8
   9 namespace Msp {
  10 namespace GL {
  11
  12 /**
  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.
  16 */
  17 class Texture2D: public Texture
  18 {
  19 public:
  20         class Loader: public Msp::DataFile::DerivedObjectLoader<Texture2D, Texture::Loader>
  21         {
  22         public:
  23                 Loader(Texture2D &);
  24                 Loader(Texture2D &, Collection &);
  25         private:
  26                 void init();
  27
  28                 void image_data(const std::string &);
  29                 void raw_data(const std::string &);
  30                 void storage(PixelFormat, unsigned, unsigned);
  31                 void storage_b(PixelFormat, unsigned, unsigned, unsigned);
  32         };
  33
  34 private:
  35         class AsyncLoader;
  36
  37         PixelFormat ifmt;
  38         unsigned width;
  39         unsigned height;
  40         unsigned allocated;
  41
  42 public:
  43         Texture2D(ResourceManager * = 0);
  44         virtual ~Texture2D();
  45
  46         /** Defines storage structure for the texture.  Must be called before an
  47         image can be uploaded.  Once storage is defined, it can't be changed. */
  48         void storage(PixelFormat fmt, unsigned wd, unsigned ht);
  49
  50         /** Allocates storage for the texture.  The contents are initially
  51         undefined.  If storage has already been allocated, does nothing. */
  52         void allocate(unsigned level);
  53
  54         /** Uploads an image to the texture.  Storage must be defined beforehand.
  55         The image data must have dimensions and format compatible with the defined
  56         storage. */
  57         void image(unsigned level, PixelFormat fmt, DataType type, const void *data);
  58
  59         /** Updates a rectangular region of the texture.  Storage must be defined
  60         and allocated beforehand.  The update region must be fully inside the
  61         texture. */
  62         void sub_image(unsigned level, int x, int y, unsigned wd, unsigned ht,
  63                 PixelFormat fmt, DataType type, const void *data);
  64
  65         /// Loads a Graphics::Image from a file and uploads it to the texture.
  66         void load_image(const std::string &fn, bool srgb = false);
  67
  68         /** Uploads an image to the texture.  If storage has not been defined, it
  69         will be set to match the image.  Otherwise the image must be compatible with
  70         the defined storage.
  71
  72         If srgb is true and storage is determined by this call, then an sRGB pixel
  73         format will be used. */
  74         void image(const Graphics::Image &, bool srgb = false);
  75
  76 private:
  77         void image(const Graphics::Image &, bool, bool);
  78
  79 public:
  80         unsigned get_width() const { return width; }
  81         unsigned get_height() const { return height; }
  82
  83 private:
  84         void get_level_size(unsigned, unsigned &, unsigned &);
  85
  86 public:
  87         virtual Resource::AsyncLoader *load(IO::Seekable &, const Resources * = 0);
  88         virtual UInt64 get_data_size() const;
  89         virtual void unload();
  90 };
  91
  92 } // namespace GL
  93 } // namespace Msp
  94
  95 #endif