Test/linux-devkit/sysroots/armv7ahf-neon-linux-gnueabi/usr/include/voxel-0.6.8/FrameBuffer.h

/*
 * TI Voxel Lib component.
 *
 * Copyright (c) 2014 Texas Instruments Inc.
 */

#ifndef VOXEL_FRAMEBUFFER_H
#define VOXEL_FRAMEBUFFER_H

#include <Ptr.h>
#include <Common.h>

#include <algorithm>

#define MAX_FRAME_BUFFERS 3

namespace Voxel
{
  
/**
 * \addtogroup Frm
 * @{
 */


template <typename BufferType>
class FrameBufferManager;

// Auto-releases the obtained buffer when FrameBuffer<> instance is terminated
template <typename BufferType>
class FrameBuffer: public Ptr<BufferType>
{
public:
  typedef Ptr<BufferType> BufferPtr;
  
protected:
  BufferPtr &_buffer;
  
  FrameBufferManager<BufferType> &_manager;
  
public:
  FrameBuffer(BufferPtr &buffer, FrameBufferManager<BufferType> &manager): _buffer(buffer), _manager(manager), 
    Ptr<BufferType>(nullptr, [&manager, &buffer](BufferType *) { manager.release(buffer); }) // The deleter gets called when FrameBuffer<> goes out of scope. Deleter releases the held buffer
    {}
  
  inline BufferPtr &operator *() { return _buffer; }
  
  virtual ~FrameBuffer() {}
};
  
// This maintains a minimum number of buffers for use and re-use.
// Call to release() on unused buffers is important for it be either freed or reused 
template <typename BufferType>
class FrameBufferManager
{
public:
  typedef Ptr<BufferType> BufferPtr;
  typedef FrameBuffer<BufferType> FrameBufferType;
  
protected:
  List<BufferPtr> _inUse;
  List<BufferPtr> _available;
  
  SizeType _minimumBufferCount;
  
public:
  FrameBufferManager(SizeType minBufferCount): _minimumBufferCount(minBufferCount)
  {
    for(auto i = 0; i < minBufferCount; i++)
      _available.push_back(BufferPtr());
  }
  
  inline void setMinimumBufferCount(SizeType minBufferCount)
  {
    _minimumBufferCount = (minBufferCount > 0)?minBufferCount:MAX_FRAME_BUFFERS;
  }
  
  inline SizeType getMinimumBufferCount() const
  {
    return _minimumBufferCount;
  }
  
  FrameBufferType get()
  {
    if(_available.size() > 0)
      _inUse.splice(_inUse.begin(), _available, _available.begin());
    else
      _inUse.push_front(BufferPtr());
    
    return FrameBufferType(*_inUse.begin(), *this);
  }
  
  bool release(BufferPtr &p)
  {
    auto f = std::find(_inUse.begin(), _inUse.end(), p);
    
    if(f == _inUse.end())
      return false;
    
    if(_available.size() < _minimumBufferCount)
      _available.splice(_available.begin(), _inUse, f);
    else
      _inUse.erase(f);
    
    return true;
  }
  
  void clear()
  {
    _inUse.clear();
    _available.clear();
  }
  
  virtual ~FrameBufferManager() { clear(); }
};

/**
 * @}
 */

}

#endif // FRAMEBUFFER_H