vtkVertexBufferObject.h

  /*=========================================================================
 
  Program:   Visualization Toolkit
  Module:    vtkPixelBufferObject.h
 
  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
 
     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.
 
=========================================================================*/
// .NAME vtkVertexBufferObject - abstracts an OpenGL vertex buffer object.
// .SECTION Description
// Provides low-level access to GPU memory. Used to pass raw data to GPU. 
// The data is uploaded into a vertex buffer.
// .SECTION See Also
// OpenGL Vertex Buffer Object Extension Spec (ARB_vertex_buffer_object):
// http://www.opengl.org/registry/specs/ARB/vertex_buffer_object.txt
// .SECTION Caveats
// Since most GPUs don't support double format all double data is converted to
// float and then uploaded.
// DON'T PLAY WITH IT YET.
 
#pragma once
 
#include "vtkObject.h"
#include "vtkWeakPointer.h"
 
#include "vtkgl.h" // Needed for gl data types exposed in API
#include <pcl/pcl_macros.h>
 
class vtkCellArray;
class vtkDataArray;
class vtkObject;
class vtkPoints;
class vtkUnsignedCharArray;
class vtkOpenGLExtensionManager;
class vtkRenderWindow;
 
class PCL_DEPRECATED(1, 13, "The OpenGL backend of VTK is deprecated. Please switch to the OpenGL2 backend.")
PCL_EXPORTS vtkVertexBufferObject : public vtkObject
{
public:
  
  static vtkVertexBufferObject* New();
  vtkTypeMacro(vtkVertexBufferObject, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
  // Description:
  // Get/Set the context. Context must be a vtkOpenGLRenderWindow.
  // This does not increase the reference count of the
  // context to avoid reference loops.
  // SetContext() may raise an error is the OpenGL context does not support the
  // required OpenGL extensions.
  void SetContext(vtkRenderWindow* context);
  vtkRenderWindow* GetContext();
 
  //BTX
  // Usage values.
  enum 
  {
    StreamDraw=0,
    StreamRead,
    StreamCopy,
    StaticDraw,
    StaticRead,
    StaticCopy,
    DynamicDraw,
    DynamicRead,
    DynamicCopy,
    NumberOfUsages
  };
  //ETX
  
  // Description:
  // Usage is a performance hint.
  // Valid values are:
  // - StreamDraw specified once by A, used few times S
  // - StreamRead specified once by R, queried a few times by A
  // - StreamCopy specified once by R, used a few times S
  // - StaticDraw specified once by A, used many times S
  // - StaticRead specified once by R, queried many times by A
  // - StaticCopy specified once by R, used many times S
  // - DynamicDraw respecified repeatedly by A, used many times S
  // - DynamicRead respecified repeatedly by R, queried many times by A
  // - DynamicCopy respecified repeatedly by R, used many times S
  // A: the application
  // S: as the source for GL drawing and image specification commands.
  // R: reading data from the GL
  // Initial value is StaticDraw, as in OpenGL spec.
  vtkGetMacro(Usage, int);
  vtkSetMacro(Usage, int);
  
  int GetAttributeIndex();
  void SetUserDefinedAttribute(int index, bool normalized=false, int stride=0);
  void ResetUserDefinedAttribute();
 
  void SetAttributeNormalized(bool normalized);
 
  // Description:
  // Set point data
  bool Upload(vtkPoints *points);
 
  // Description:
  // Set indice data
  bool Upload(vtkCellArray *verts);
 
  // Description:
  // Set indice data
  bool Upload(unsigned int *indices, unsigned int count);
 
  // Description:
  // Set color data
  bool Upload(vtkUnsignedCharArray *colors);
 
  // Description:
  // Set color data
  bool Upload(vtkDataArray *array);
  bool Upload(vtkDataArray *array, int attributeType, int arrayType);
  bool UploadNormals(vtkDataArray *normals);
  bool UploadColors(vtkDataArray *colors);
 
 
  // Description:
  // Get the size of the data loaded into the GPU. Size is in the number of
  // elements of the uploaded Type.
  vtkGetMacro(Size, unsigned int);
 
  // Description:
  // Get the size of the data loaded into the GPU. Size is in the number of
  // elements of the uploaded Type.
  vtkGetMacro(Count, unsigned int);
 
  // Description:
  // Get the openGL buffer handle.
  vtkGetMacro(Handle, unsigned int);
 
  // Description:
  // Inactivate the buffer.
  void UnBind();
 
  // Description:
  // Make the buffer active.
  void Bind();
 
  // Description:
  // Allocate the memory. size is in number of bytes. type is a VTK type.
//  void Allocate(unsigned int size, int type);
  
//BTX
 
  // Description:
  // Release the memory allocated without destroying the PBO handle.
  void ReleaseMemory();
 
  // Description:
  // Returns if the context supports the required extensions.
  static bool IsSupported(vtkRenderWindow* renWin);
 
//ETX
//BTX
protected:
  vtkVertexBufferObject();
  ~vtkVertexBufferObject();
 
  // Description:
  // Loads all required OpenGL extensions. Must be called every time a new
  // context is set.
  bool LoadRequiredExtensions(vtkOpenGLExtensionManager* mgr);
 
  // Description:
  // Create the pixel buffer object.
  void CreateBuffer();
 
  // Description:
  // Destroys the pixel buffer object.
  void DestroyBuffer();
 
  // Description:
  // Uploads data to buffer object
  bool Upload(GLvoid* data);
 
  // Description:
  // Get the openGL buffer handle.
  vtkGetMacro(ArrayType, unsigned int);
 
  int Usage;
  unsigned int Size;
  unsigned int Count;
  unsigned int Handle;
  unsigned int ArrayType;
  unsigned int BufferTarget;
 
  int AttributeIndex;
  int AttributeSize;
  int AttributeType;
  int AttributeNormalized;
  int AttributeStride;
 
  vtkWeakPointer<vtkRenderWindow> Context;
 
 
private:
  vtkVertexBufferObject(const vtkVertexBufferObject&); // Not implemented.
  void operator=(const vtkVertexBufferObject&); // Not implemented.
 
  // Helper to get data type sizes when passing to opengl
  int GetDataTypeSize(int type);
  //ETX
};