X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;ds=sidebyside;f=source%2Fbuffer.h;h=cc5e58741c141f1fd5910e1abda23ec68a650a39;hb=bec07999d95b76f4b47cffcc564d0cd0afc0435e;hp=bfbfd14891ff024a7d509198710deffa439e73f7;hpb=1d24ddbc35f9e0480d30c66d47b7ea3834c15fbf;p=libs%2Fgl.git diff --git a/source/buffer.h b/source/buffer.h index bfbfd148..cc5e5874 100644 --- a/source/buffer.h +++ b/source/buffer.h @@ -1,14 +1,26 @@ #ifndef MSP_GL_BUFFER_H_ #define MSP_GL_BUFFER_H_ +#include +#include #include +#include #include "gl.h" +#include #include #include +#include namespace Msp { namespace GL { +class buffer_too_small: public std::logic_error +{ +public: + buffer_too_small(const std::string &w): std::logic_error(w) { } + virtual ~buffer_too_small() throw() { } +}; + enum BufferType { ARRAY_BUFFER = GL_ARRAY_BUFFER, @@ -31,6 +43,13 @@ enum BufferUsage DYNAMIC_COPY = GL_DYNAMIC_COPY }; +enum BufferAccess +{ + READ_ONLY = GL_READ_ONLY, + WRITE_ONLY = GL_WRITE_ONLY, + READ_WRITE = GL_READ_WRITE +}; + class BufferRange; /** @@ -44,7 +63,6 @@ class Buffer private: BufferType type; - BufferUsage usage; unsigned id; unsigned size; @@ -64,22 +82,35 @@ public: /** Returns the default binding type for the buffer. */ BufferType get_type() const { return type; } + /** Defines the storage size of the buffer. Must be called before data can + be uploaded. Storage cannot be changed once set. */ + void storage(unsigned); + /** Sets the usage hint of the buffer. It will take effect the next time the buffer's contents are defined. */ - void set_usage(BufferUsage); + DEPRECATED void set_usage(BufferUsage); /** Uploads data into the buffer, completely replacing any previous - contents. */ - void data(unsigned, const void *); + contents. Storage must be defined beforehand. The data must have size + matching the defined storage. */ + void data(const void *); - /** Overwrites part of the buffer data with new data. The buffer size can - not be changed with this call. */ + DEPRECATED void data(unsigned, const void *); + + /** Overwrites part of the buffer data with new data. Storage must be + defined beforehand. */ void sub_data(unsigned, unsigned, const void *); unsigned get_size() const { return size; } + void require_size(unsigned) const; + BufferRange *create_range(unsigned, unsigned); + void *map(); + DEPRECATED void *map(BufferAccess) { return map(); } + bool unmap(); + /** Binds the buffer in its default slot. */ void bind() const { bind_to(type); } @@ -89,7 +120,7 @@ public: /** Unbinds the buffer from its default slot. */ void unbind() const { unbind_from(type); } - static const Buffer *current(BufferType t) { return binding(t); } + static const Buffer *current(BufferType); static void unbind_from(BufferType); private: static const Buffer *&binding(BufferType); @@ -111,6 +142,7 @@ private: public: BufferRange(Buffer &, unsigned, unsigned); + ~BufferRange(); void data(const void *);