vtkFrameBufferObject.h

Go to the documentation of this file.

/*=========================================================================
 
  Program:   Visualization Toolkit
  Module:    vtkFrameBufferObject.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.
 
=========================================================================*/
#ifndef vtkFrameBufferObject_h
#define vtkFrameBufferObject_h
 
#include "vtkObject.h"
#include "vtkRenderingOpenGL2Module.h" // For export macro
#include "vtkSmartPointer.h" // needed for vtkSmartPointer.
#include "vtkWeakPointer.h" // needed for vtkWeakPointer.
#include <vector> // for the lists of logical buffers.
 
 
class vtkRenderWindow;
class vtkTextureObject;
class vtkPixelBufferObject;
class vtkOpenGLRenderWindow;
class vtkShaderProgram;
class vtkOpenGLVertexArrayObject;
 
class VTKRENDERINGOPENGL2_EXPORT vtkFrameBufferObject : public vtkObject
{
public:
  static vtkFrameBufferObject* New();
  vtkTypeMacro(vtkFrameBufferObject, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent);
 
 
  void SetContext(vtkOpenGLRenderWindow *context);
  vtkOpenGLRenderWindow *GetContext();
 
 
  bool Start(int width, int height, bool shaderSupportsTextureInt);
  bool StartNonOrtho(int width, int height, bool shaderSupportsTextureInt);
 
 
  void RenderQuad(int minX, int maxX, int minY, int maxY,
    vtkShaderProgram *program, vtkOpenGLVertexArrayObject *vao);
 
  void Bind();
 
  void UnBind();
 
 
  void SetActiveBuffer(unsigned int index)
    {
    this->SetActiveBuffers(1, &index);
    }
 
  void SetActiveBuffers(int numbuffers, unsigned int indices[]);
 
 
  void SetColorBuffer(
        unsigned int index,
        vtkTextureObject *texture,
        unsigned int zslice=0);
 
  vtkTextureObject *GetColorBuffer(unsigned int index);
  void RemoveColorBuffer(unsigned int index);
  void RemoveAllColorBuffers();
 
 
  void SetDepthBuffer(vtkTextureObject *depthTexture);
  void RemoveDepthBuffer();
 
 
  vtkSetMacro(DepthBufferNeeded,bool);
  vtkGetMacro(DepthBufferNeeded,bool);
 
 
  void SetNumberOfRenderTargets(unsigned int);
  vtkGetMacro(NumberOfRenderTargets,unsigned int);
 
  unsigned int GetMaximumNumberOfActiveTargets();
 
  unsigned int GetMaximumNumberOfRenderTargets();
 
 
  vtkGetVector2Macro(LastSize,int);
 
  static bool IsSupported(vtkOpenGLRenderWindow *renWin);
 
  int CheckFrameBufferStatus(unsigned int mode);
 
protected:
 
  static
  bool LoadRequiredExtensions(vtkOpenGLRenderWindow *renWin);
 
  // gen buffer (occurs when context is set)
  void CreateFBO();
 
  // delete buffer (occurs during destruction or context swicth)
  void DestroyFBO();
 
  // create texture or renderbuffer and attach
  // if user provided a texture just use that
  // mode specifies DRAW or READ
  void CreateDepthBuffer(int width, int height, unsigned int mode);
 
  // create textures for each target and attach
  // if user provided textures use those, if the user
  // provides any then they need to provide all
  // mode specifies DRAW or READ
  void CreateColorBuffers(
        int width,
        int height,
        unsigned int mode,
        bool shaderSupportsTextureInt);
 
  // detach and delete our reference(s)
  void DestroyDepthBuffer();
  void DestroyColorBuffers();
 
  // glDrawBuffers
  void ActivateBuffers();
 
  void DisplayFrameBufferAttachments();
 
  void DisplayFrameBufferAttachment(unsigned int uattachment);
 
  void DisplayDrawBuffers();
 
  void DisplayReadBuffer();
 
  void DisplayBuffer(int value);
 
  vtkFrameBufferObject();
  ~vtkFrameBufferObject();
 
  vtkWeakPointer<vtkOpenGLRenderWindow> Context;
 
  bool DepthBufferNeeded;
  bool ColorBuffersDirty;
  unsigned int FBOIndex;
  int PreviousFBOIndex;
  unsigned int DepthBuffer;
  unsigned int NumberOfRenderTargets;
  int LastSize[2];
  std::vector<unsigned int> UserZSlices;
  std::vector<vtkSmartPointer<vtkTextureObject> > UserColorBuffers;
  std::vector<vtkSmartPointer<vtkTextureObject> > ColorBuffers;
  std::vector<unsigned int> ActiveBuffers;
  vtkSmartPointer<vtkTextureObject> UserDepthBuffer;
  bool DepthBufferDirty;
 
private:
  vtkFrameBufferObject(const vtkFrameBufferObject&); // Not implemented.
  void operator=(const vtkFrameBufferObject&); // Not implemented.
};
 
#endif