Descent3/lib/IMeshBuilder.h

#ifndef __IMESH_BUILDER_H__
#define __IMESH_BUILDER_H__

#include "IMeshHandle.h"

namespace RZ {
namespace Renderer {
class IMeshBuilder {
public:
  enum PrimitiveType {
    kTriangle,
    kTriangleFan,
    kTriangleStrip,
  };

  enum VertexType {
    kPosition = 0x01,
    kColor = 0x02,
    kTexture1 = 0x04,
    // kTexture2 = 0x08,
    kNormal = 0x10,
  };

  virtual ~IMeshBuilder() {}

  // Begin
  // Begins the generation of a mesh. You must supply
  // the primitive type, size of the vertex buffer, and
  // the number of primitives.
  // vertexFlags are a combination of VertexType values
  // that represent what data should be stored in the verts.
  virtual void Begin(PrimitiveType type, unsigned int vertexFlags, unsigned int numPrims, unsigned int numVerts,
                     bool autogenNormals) = 0;

  // End
  // Ends the build process which will cause the generation of the mesh data.
  // Returned will be a handle to the mesh
  virtual MeshHandle End(void) = 0;

  // SetStreamData
  // Stores stream data for one or more vertex fields.
  //	streamId: Which field we are setting data for
  //	startVertIndex: Which vertex in vertex buffer are we starting at
  //	numVerts: How many full verts of data are we processing
  //	dataPtr: Incoming data. All data is float based.
  //	elementsPerField: How many floats-per-field for this data.
  //					  NOTE: This is for verification purposes. Positions and
  //					  Normals are 3 elements. Texture UVs are 2 elements. Colors
  //					  are 4 elements.
  //	stride: The number of bytes from the START of one field to the next on the incoming stream.
  virtual void SetStreamData(VertexType streamId, unsigned int startVertIndex, unsigned int numVerts,
                             const float *dataPtr, unsigned int elementsPerField, unsigned int stride) = 0;

  // AddPrimitive
  // Adds another primitive to the buffer.
  virtual void AddPrimitive(unsigned int numVerts, unsigned int *vertexIndices) = 0;
};
} // namespace Renderer
} // namespace RZ

#endif