-/* $Id$
-
-This file is part of libmspgl
-Copyright © 2007-2010 Mikko Rasa, Mikkosoft Productions
-Distributed under the LGPL
-*/
-
#ifndef MSP_GL_VERTEXARRAY_H_
#define MSP_GL_VERTEXARRAY_H_
#include <vector>
#include <msp/core/refptr.h>
#include <msp/datafile/loader.h>
+#include "bindable.h"
+#include "bufferable.h"
#include "datatype.h"
#include "primitivetype.h"
#include "vertexarraybuilder.h"
class Buffer;
-class VertexArray
+/**
+Stores vertex data. Both legacy and generic attributes are supported. Mixing
+the two is possible but discouraged, as driver-specific issues may arise.
+
+The array's contents can be modified with the append and modify methods. To
+obtain the location of an individual component within the vertex, use
+VertexFormat::offset.
+
+A higher-level interface for filling in vertex data is available in the
+VertexArrayBuilder class.
+*/
+class VertexArray: public Bindable<VertexArray>, public Bufferable
{
public:
class Loader: public DataFile::Loader, public VertexArrayBuilder
};
private:
- struct ArrayMask
+ struct Array
{
- enum
- {
- B = (sizeof(unsigned)*CHAR_BIT),
- N = (63+B)/B
- };
-
- unsigned mask[N];
+ unsigned char component;
+ unsigned char offset;
- ArrayMask();
-
- void set(unsigned);
- bool is_set(unsigned) const;
+ Array();
};
VertexFormat format;
std::vector<float> data;
unsigned stride;
- RefPtr<Buffer> vbuf;
- bool defer_vbuf;
- mutable bool dirty;
+ std::vector<Array> arrays;
+ bool legacy;
- static ArrayMask enabled_arrays;
+ static bool legacy_used;
VertexArray(const VertexArray &);
VertexArray &operator=(const VertexArray &);
VertexArray(const VertexFormat &);
~VertexArray();
- const VertexFormat &get_format() const { return format; }
- const std::vector<float> &get_data() const { return data; }
- void use_vertex_buffer();
- void use_vertex_buffer(Buffer *);
- void reserve(unsigned);
- unsigned size() const { return data.size()/stride; }
- void clear();
- void reset(const VertexFormat &);
- void apply() const;
- float *append();
- float *modify(unsigned);
- float *operator[](unsigned i) { return modify(i); }
- const float *operator[](unsigned i) const { return &data[0]+i*stride; }
+ /// Resets the VertexArray to a different format. All data is cleared.
+ void reset(const VertexFormat &);
+ const VertexFormat &get_format() const { return format; }
private:
- void set_dirty();
-};
+ static unsigned get_array_slot(unsigned char);
-void array_element(int);
-void draw_arrays(PrimitiveType, int, unsigned);
-void draw_elements(PrimitiveType, unsigned, DataType, const void *);
-void draw_range_elements(PrimitiveType, unsigned, unsigned, unsigned, DataType, const void *);
+public:
+ /// Deprecated alias for use_buffer
+ void use_vertex_buffer(Buffer *b) { use_buffer(b); }
+
+ /// Clears all vertices from the array.
+ void clear();
+
+ /// Reserve space for vertices.
+ void reserve(unsigned);
+
+ /// Append a new vertex at the end of the array and return its location.
+ float *append();
+
+ /// Returns the location of a vertex for modification.
+ float *modify(unsigned);
+private:
+ virtual unsigned get_data_size() const;
+ virtual const void *get_data_pointer() const { return &data[0]; }
-inline void draw_elements(PrimitiveType mode, unsigned count, const unsigned *indices)
-{ draw_elements(mode, count, UNSIGNED_INT, indices); }
+public:
+ unsigned size() const { return data.size()/stride; }
+ const std::vector<float> &get_data() const { return data; }
+ const float *operator[](unsigned i) const { return &data[0]+i*stride; }
-inline void draw_elements(PrimitiveType mode, unsigned count, const unsigned short *indices)
-{ draw_elements(mode, count, UNSIGNED_SHORT, indices); }
+ /** Equivalent to apply(true). For compatibility with the Bindable
+ interface. */
+ void bind() const { apply(); }
-inline void draw_range_elements(PrimitiveType mode, unsigned low, unsigned high, unsigned count, const unsigned short *indices)
-{ draw_range_elements(mode, low, high, count, UNSIGNED_SHORT, indices); }
+ /** Applies component arrays to the GL. If legacy is true, they are applied
+ as is. If legacy is false, any legacy attributes are converted to generic
+ attributes. */
+ void apply(bool legacy = true) const;
-inline void draw_range_elements(PrimitiveType mode, unsigned low, unsigned high, unsigned count, const unsigned *indices)
-{ draw_range_elements(mode, low, high, count, UNSIGNED_INT, indices); }
+private:
+ static void apply_arrays(const std::vector<Array> *, const std::vector<Array> *, const float *, unsigned, bool);
+public:
+ static void unbind();
+};
} // namespace GL
} // namespace Msp