BufferState.h

Go to the documentation of this file.

//============================================================================
//  The contents of this file are covered by the Viskores license. See
//  LICENSE.txt for details.
//
//  By contributing to this file, all contributors agree to the Developer
//  Certificate of Origin Version 1.1 (DCO 1.1) as stated in DCO.txt.
//============================================================================
 
//============================================================================
//  Copyright (c) Kitware, Inc.
//  All rights reserved.
//  See LICENSE.txt 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 viskores_interop_BufferState_h
#define viskores_interop_BufferState_h
 
//gl headers needs to be buffer anything to do with buffer's
#include <viskores/interop/internal/BufferTypePicker.h>
#include <viskores/interop/internal/OpenGLHeaders.h>
 
#include <viskores/internal/ExportMacros.h>
 
#include <memory>
 
namespace viskores
{
namespace interop
{
 
namespace internal
{
 
VISKORES_SILENCE_WEAK_VTABLE_WARNING_START
 
class TransferResource
{
public:
  virtual ~TransferResource() {}
};
 
VISKORES_SILENCE_WEAK_VTABLE_WARNING_END
}
 
class BufferState
{
public:
  BufferState(GLuint& gLHandle)
    : OpenGLHandle(&gLHandle)
    , BufferType(GL_INVALID_VALUE)
    , SizeOfActiveSection(0)
    , CapacityOfBuffer(0)
    , DefaultGLHandle(0)
    , Resource()
  {
  }
 
  BufferState(GLuint& gLHandle, GLenum type)
    : OpenGLHandle(&gLHandle)
    , BufferType(type)
    , SizeOfActiveSection(0)
    , CapacityOfBuffer(0)
    , DefaultGLHandle(0)
    , Resource()
  {
  }
 
  BufferState()
    : OpenGLHandle(nullptr)
    , BufferType(GL_INVALID_VALUE)
    , SizeOfActiveSection(0)
    , CapacityOfBuffer(0)
    , DefaultGLHandle(0)
    , Resource()
  {
    this->OpenGLHandle = &this->DefaultGLHandle;
  }
 
  ~BufferState()
  {
    //don't delete this as it points to user memory, or stack allocated
    //memory inside this object instance
    this->OpenGLHandle = nullptr;
  }
 
  GLuint* GetHandle() const { return this->OpenGLHandle; }
 
  bool HasType() const { return this->BufferType != GL_INVALID_VALUE; }
 
  GLenum GetType() const { return this->BufferType; }
 
  void SetType(GLenum type) { this->BufferType = type; }
 
  template <typename T>
  void DeduceAndSetType(T t)
  {
    this->BufferType = viskores::interop::internal::BufferTypePicker(t);
  }
 
  viskores::Int64 GetSize() const { return this->SizeOfActiveSection; }
 
  //Set the size of buffer in bytes
  //This will always needs to be <= the capacity of the buffer
  //Note: This call should only be used internally by viskores
  void SetSize(viskores::Int64 size) { this->SizeOfActiveSection = size; }
 
  viskores::Int64 GetCapacity() const { return this->CapacityOfBuffer; }
 
  // Helper function to compute when we should resize  the capacity of the
  // buffer
  bool ShouldRealloc(viskores::Int64 desiredSize) const
  {
    const bool haveNotEnoughRoom = this->GetCapacity() < desiredSize;
    const bool haveTooMuchRoom = this->GetCapacity() > (desiredSize * 2);
    return (haveNotEnoughRoom || haveTooMuchRoom);
  }
 
  //Set the capacity of buffer in bytes
  //The capacity of a buffer can be larger than the active size of buffer
  //Note: This call should only be used internally by viskores
  void SetCapacity(viskores::Int64 capacity) { this->CapacityOfBuffer = capacity; }
 
  //Note: This call should only be used internally by viskores
  viskores::interop::internal::TransferResource* GetResource() { return this->Resource.get(); }
 
  //Note: This call should only be used internally by viskores
  void SetResource(viskores::interop::internal::TransferResource* resource)
  {
    this->Resource.reset(resource);
  }
 
private:
  // BufferState doesn't support copy or move semantics
  BufferState(const BufferState&) = delete;
  void operator=(const BufferState&) = delete;
 
  GLuint* OpenGLHandle;
  GLenum BufferType;
  viskores::Int64 SizeOfActiveSection; //must be Int64 as size can be over 2billion
  viskores::Int64 CapacityOfBuffer;    //must be Int64 as size can be over 2billion
  GLuint DefaultGLHandle;
  std::unique_ptr<viskores::interop::internal::TransferResource> Resource;
};
}
}
 
#endif //viskores_interop_BufferState_h