vtkOpenGLBufferObject.h

Go to the documentation of this file.

/*=========================================================================
 
  Program:   Visualization Toolkit
 
  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.
 
=========================================================================*/
#ifndef vtkOpenGLBufferObject_h
#define vtkOpenGLBufferObject_h
 
#include "vtkObject.h"
#include "vtkRenderingOpenGL2Module.h" // for export macro
#include <string>                      // used for std::string
#include <vector>                      // used for method args
 
class vtkCellArray;
class vtkDataArray;
class vtkPoints;
 
class VTKRENDERINGOPENGL2_EXPORT vtkOpenGLBufferObject : public vtkObject
{
public:
  static vtkOpenGLBufferObject* New();
  vtkTypeMacro(vtkOpenGLBufferObject, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
  enum ObjectType
  {
    ArrayBuffer,
    ElementArrayBuffer,
    TextureBuffer
  };
 
  ObjectType GetType() const;
 
  void SetType(ObjectType value);
 
  int GetHandle() const;
 
  bool IsReady() const { return this->Dirty == false; }
 
  bool GenerateBuffer(ObjectType type);
 
  template <class T>
  bool Upload(const T& array, ObjectType type);
 
  // non vector version
  template <class T>
  bool Upload(const T* array, size_t numElements, ObjectType type);
 
  bool Bind();
 
  bool Release();
 
  // Description:
  // Release any graphics resources that are being consumed by this class.
  void ReleaseGraphicsResources();
 
  std::string GetError() const { return Error; }
 
protected:
  vtkOpenGLBufferObject();
  ~vtkOpenGLBufferObject() override;
  bool Dirty;
  std::string Error;
 
  bool UploadInternal(const void* buffer, size_t size, ObjectType objectType);
 
private:
  vtkOpenGLBufferObject(const vtkOpenGLBufferObject&) = delete;
  void operator=(const vtkOpenGLBufferObject&) = delete;
  struct Private;
  Private* Internal;
};
 
template <class T>
inline bool vtkOpenGLBufferObject::Upload(
  const T& array, vtkOpenGLBufferObject::ObjectType objectType)
{
  if (array.empty())
  {
    this->Error = "Refusing to upload empty array.";
    return false;
  }
 
  return this->UploadInternal(&array[0], array.size() * sizeof(typename T::value_type), objectType);
}
 
template <class T>
inline bool vtkOpenGLBufferObject::Upload(
  const T* array, size_t numElements, vtkOpenGLBufferObject::ObjectType objectType)
{
  if (!array)
  {
    this->Error = "Refusing to upload empty array.";
    return false;
  }
  return this->UploadInternal(array, numElements * sizeof(T), objectType);
}
 
#endif