globjects::Framebuffer Class Reference

Enables creation of arbitrary render targets that are not directly drawn on the screen. More...

#include <globjects/include/globjects/Framebuffer.h>

Inheritance diagram for globjects::Framebuffer:

Public Types
enum	BindlessImplementation { BindlessImplementation::DirectStateAccessARB, BindlessImplementation::DirectStateAccessEXT, BindlessImplementation::Legacy }
Public Types inherited from globjects::Object
enum	NameImplementation { NameImplementation::DebugKHR, NameImplementation::Legacy }

Public Member Functions
	Framebuffer ()
virtual void	accept (ObjectVisitor &visitor) override
void	bind () const
void	bind (gl::GLenum target) const
void	setParameter (gl::GLenum pname, gl::GLint param)
gl::GLint	getAttachmentParameter (gl::GLenum attachment, gl::GLenum pname) const
void	attachTexture (gl::GLenum attachment, Texture *texture, gl::GLint level=0)
void	attachTextureLayer (gl::GLenum attachment, Texture *texture, gl::GLint level=0, gl::GLint layer=0)
void	attachRenderBuffer (gl::GLenum attachment, Renderbuffer *renderBuffer)
bool	detach (gl::GLenum attachment)
void	setReadBuffer (gl::GLenum mode) const
void	setDrawBuffer (gl::GLenum mode) const
void	setDrawBuffers (gl::GLsizei n, const gl::GLenum *modes) const
void	setDrawBuffers (const std::vector< gl::GLenum > &modes) const
void	clear (gl::ClearBufferMask mask)
void	clearBufferiv (gl::GLenum buffer, gl::GLint drawBuffer, const gl::GLint *value)
void	clearBufferuiv (gl::GLenum buffer, gl::GLint drawBuffer, const gl::GLuint *value)
void	clearBufferfv (gl::GLenum buffer, gl::GLint drawBuffer, const gl::GLfloat *value)
void	clearBufferfi (gl::GLenum buffer, gl::GLint drawBuffer, gl::GLfloat depth, gl::GLint stencil)
void	clearBuffer (gl::GLenum buffer, gl::GLint drawBuffer, const glm::ivec4 &value)
void	clearBuffer (gl::GLenum buffer, gl::GLint drawBuffer, const glm::uvec4 &value)
void	clearBuffer (gl::GLenum buffer, gl::GLint drawBuffer, const glm::vec4 &value)
void	readPixels (gl::GLint x, gl::GLint y, gl::GLsizei width, gl::GLsizei height, gl::GLenum format, gl::GLenum type, gl::GLvoid *data=nullptr) const
void	readPixels (const std::array< gl::GLint, 4 > &rect, gl::GLenum format, gl::GLenum type, gl::GLvoid *data=nullptr) const
void	readPixels (gl::GLenum readBuffer, const std::array< gl::GLint, 4 > &rect, gl::GLenum format, gl::GLenum type, gl::GLvoid *data=nullptr) const
std::vector< unsigned char >	readPixelsToByteArray (const std::array< gl::GLint, 4 > &rect, gl::GLenum format, gl::GLenum type) const
std::vector< unsigned char >	readPixelsToByteArray (gl::GLenum readBuffer, const std::array< gl::GLint, 4 > &rect, gl::GLenum format, gl::GLenum type) const
void	readPixelsToBuffer (const std::array< gl::GLint, 4 > &rect, gl::GLenum format, gl::GLenum type, Buffer *pbo) const
gl::GLenum	checkStatus () const
std::string	statusString () const
void	printStatus (bool onlyErrors=false) const
FramebufferAttachment *	getAttachment (gl::GLenum attachment)
std::vector< FramebufferAttachment * >	attachments ()
void	blit (gl::GLenum readBuffer, const std::array< gl::GLint, 4 > &srcRect, Framebuffer *destFbo, gl::GLenum drawBuffer, const std::array< gl::GLint, 4 > &destRect, gl::ClearBufferMask mask, gl::GLenum filter) const
void	blit (gl::GLenum readBuffer, const std::array< gl::GLint, 4 > &srcRect, Framebuffer *destFbo, const std::vector< gl::GLenum > &drawBuffers, const std::array< gl::GLint, 4 > &destRect, gl::ClearBufferMask mask, gl::GLenum filter) const
virtual gl::GLenum	objectType () const override
Public Member Functions inherited from globjects::Object
gl::GLuint	id () const
std::string	name () const
void	setName (const std::string &name)
bool	hasName () const
bool	isDefault () const
void	detach ()
Public Member Functions inherited from globjects::Referenced
	Referenced ()
void	ref () const
void	unref () const
int	refCounter () const
Public Member Functions inherited from globjects::HeapOnly
	HeapOnly ()
void	destroy () const

Static Public Member Functions
static void	hintBindlessImplementation (BindlessImplementation impl)
static Framebuffer *	fromId (gl::GLuint id)
static Framebuffer *	defaultFBO ()
static void	unbind ()
static void	unbind (gl::GLenum target)
static void	colorMask (gl::GLboolean red, gl::GLboolean green, gl::GLboolean blue, gl::GLboolean alpha)
static void	colorMask (const glm::bvec4 &mask)
static void	colorMaski (gl::GLuint buffer, gl::GLboolean red, gl::GLboolean green, gl::GLboolean blue, gl::GLboolean alpha)
static void	colorMaski (gl::GLuint buffer, const glm::bvec4 &mask)
static void	clearColor (gl::GLfloat red, gl::GLfloat green, gl::GLfloat blue, gl::GLfloat alpha)
static void	clearColor (const glm::vec4 &color)
static void	clearDepth (gl::GLclampd depth)
Static Public Member Functions inherited from globjects::Object
static void	hintNameImplementation (NameImplementation impl)

Protected Member Functions
	Framebuffer (IDResource *resource)
virtual	~Framebuffer ()
void	addAttachment (FramebufferAttachment *attachment)
Protected Member Functions inherited from globjects::Object
	Object (IDResource *resource)
virtual	~Object ()
Protected Member Functions inherited from globjects::Referenced
virtual	~Referenced ()
Protected Member Functions inherited from globjects::HeapOnly
virtual	~HeapOnly ()

Static Protected Member Functions
static void	blit (gl::GLint srcX0, gl::GLint srcY0, gl::GLint srcX1, gl::GLint srcY1, gl::GLint destX0, gl::GLint destY0, gl::GLint destX1, gl::GLint destY1, gl::ClearBufferMask mask, gl::GLenum filter)
static void	blit (const std::array< gl::GLint, 4 > &srcRect, const std::array< gl::GLint, 4 > &destRect, gl::ClearBufferMask mask, gl::GLenum filter)

Protected Attributes
std::map< gl::GLenum, ref_ptr< FramebufferAttachment > >	m_attachments
Protected Attributes inherited from globjects::Object
IDResource *	m_resource
void *	m_objectLabelState

Detailed Description

Enables creation of arbitrary render targets that are not directly drawn on the screen.

Different attachments can be added with attachTexture(), attachTexture1D(), attachTexture2D, attachTextureLayer() and attachRenderBuffer() and queried using attachment() and attachments().

To access the default FBO (e.g. if you want to blit an FBO to it), call defaultFBO(). To blit between two FBOs, prepare them with setReadBuffer() and setDrawBuffer() and blit with blit().

Draw restrictions can be done with setDrawBuffers(). To read pixels from an FBO direct into RAM, use readPixels() and to read into an OpenGL buffer use readPixelsToBuffer(). To check if an FBO is setup correctly, the status can be checked using checkStatus(), statusString() and printStatus().

See also

http://www.opengl.org/wiki/Framebuffer_Object

FrameBufferAttachment

TextureAttachment

RenderBufferAttachment

Member Enumeration Documentation

enum globjects::Framebuffer::BindlessImplementation

strong

Enumerator
DirectStateAccessARB
DirectStateAccessEXT
Legacy

Constructor & Destructor Documentation

globjects::Framebuffer::Framebuffer

(

)

globjects::Framebuffer::Framebuffer ( IDResource *  resource )

protected

virtual globjects::Framebuffer::~Framebuffer ( )

protectedvirtual

Member Function Documentation

static void globjects::Framebuffer::hintBindlessImplementation ( BindlessImplementation  impl )

static

static Framebuffer* globjects::Framebuffer::fromId ( gl::GLuint  id )

static

static Framebuffer* globjects::Framebuffer::defaultFBO ( )

static

virtual void globjects::Framebuffer::accept ( ObjectVisitor &  visitor )

overridevirtual

Implements globjects::Object.

void globjects::Framebuffer::bind

(

)

const

uses GL_FRAMEBUFFER as target

void globjects::Framebuffer::bind

(

gl::GLenum

target

)

const

static void globjects::Framebuffer::unbind ( )

static

uses GL_FRAMEBUFFER as target

static void globjects::Framebuffer::unbind ( gl::GLenum  target )

static

void globjects::Framebuffer::setParameter	(	gl::GLenum	pname,
		gl::GLint	param
	)

gl::GLint globjects::Framebuffer::getAttachmentParameter	(	gl::GLenum	attachment,
		gl::GLenum	pname
	)		const

void globjects::Framebuffer::attachTexture	(	gl::GLenum	attachment,
		Texture *	texture,
		gl::GLint	level = 0
	)

void globjects::Framebuffer::attachTextureLayer	(	gl::GLenum	attachment,
		Texture *	texture,
		gl::GLint	level = 0,
		gl::GLint	layer = 0
	)

void globjects::Framebuffer::attachRenderBuffer	(	gl::GLenum	attachment,
		Renderbuffer *	renderBuffer
	)

bool globjects::Framebuffer::detach

(

gl::GLenum

attachment

)

void globjects::Framebuffer::setReadBuffer

(

gl::GLenum

mode

)

const

void globjects::Framebuffer::setDrawBuffer

(

gl::GLenum

mode

)

const

void globjects::Framebuffer::setDrawBuffers	(	gl::GLsizei	n,
		const gl::GLenum *	modes
	)		const

void globjects::Framebuffer::setDrawBuffers

(

const std::vector< gl::GLenum > &

modes

)

const

void globjects::Framebuffer::clear

(

gl::ClearBufferMask

mask

)

void globjects::Framebuffer::clearBufferiv	(	gl::GLenum	buffer,
		gl::GLint	drawBuffer,
		const gl::GLint *	value
	)

void globjects::Framebuffer::clearBufferuiv	(	gl::GLenum	buffer,
		gl::GLint	drawBuffer,
		const gl::GLuint *	value
	)

void globjects::Framebuffer::clearBufferfv	(	gl::GLenum	buffer,
		gl::GLint	drawBuffer,
		const gl::GLfloat *	value
	)

void globjects::Framebuffer::clearBufferfi	(	gl::GLenum	buffer,
		gl::GLint	drawBuffer,
		gl::GLfloat	depth,
		gl::GLint	stencil
	)

void globjects::Framebuffer::clearBuffer	(	gl::GLenum	buffer,
		gl::GLint	drawBuffer,
		const glm::ivec4 &	value
	)

void globjects::Framebuffer::clearBuffer	(	gl::GLenum	buffer,
		gl::GLint	drawBuffer,
		const glm::uvec4 &	value
	)

void globjects::Framebuffer::clearBuffer	(	gl::GLenum	buffer,
		gl::GLint	drawBuffer,
		const glm::vec4 &	value
	)

static void globjects::Framebuffer::colorMask ( gl::GLboolean  red, gl::GLboolean  green, gl::GLboolean  blue, gl::GLboolean  alpha  )

static

static void globjects::Framebuffer::colorMask ( const glm::bvec4 &  mask )

static

static void globjects::Framebuffer::colorMaski ( gl::GLuint  buffer, gl::GLboolean  red, gl::GLboolean  green, gl::GLboolean  blue, gl::GLboolean  alpha  )

static

static void globjects::Framebuffer::colorMaski ( gl::GLuint  buffer, const glm::bvec4 &  mask  )

static

static void globjects::Framebuffer::clearColor ( gl::GLfloat  red, gl::GLfloat  green, gl::GLfloat  blue, gl::GLfloat  alpha  )

static

static void globjects::Framebuffer::clearColor ( const glm::vec4 &  color )

static

static void globjects::Framebuffer::clearDepth ( gl::GLclampd  depth )

static

void globjects::Framebuffer::readPixels	(	gl::GLint	x,
		gl::GLint	y,
		gl::GLsizei	width,
		gl::GLsizei	height,
		gl::GLenum	format,
		gl::GLenum	type,
		gl::GLvoid *	data = nullptr
	)		const

void globjects::Framebuffer::readPixels	(	const std::array< gl::GLint, 4 > &	rect,
		gl::GLenum	format,
		gl::GLenum	type,
		gl::GLvoid *	data = nullptr
	)		const

void globjects::Framebuffer::readPixels	(	gl::GLenum	readBuffer,
		const std::array< gl::GLint, 4 > &	rect,
		gl::GLenum	format,
		gl::GLenum	type,
		gl::GLvoid *	data = nullptr
	)		const

std::vector<unsigned char> globjects::Framebuffer::readPixelsToByteArray	(	const std::array< gl::GLint, 4 > &	rect,
		gl::GLenum	format,
		gl::GLenum	type
	)		const

std::vector<unsigned char> globjects::Framebuffer::readPixelsToByteArray	(	gl::GLenum	readBuffer,
		const std::array< gl::GLint, 4 > &	rect,
		gl::GLenum	format,
		gl::GLenum	type
	)		const

void globjects::Framebuffer::readPixelsToBuffer	(	const std::array< gl::GLint, 4 > &	rect,
		gl::GLenum	format,
		gl::GLenum	type,
		Buffer *	pbo
	)		const

gl::GLenum globjects::Framebuffer::checkStatus

(

)

const

std::string globjects::Framebuffer::statusString

(

)

const

void globjects::Framebuffer::printStatus

(

bool

onlyErrors = false

)

const

FramebufferAttachment* globjects::Framebuffer::getAttachment

(

gl::GLenum

attachment

)

std::vector<FramebufferAttachment*> globjects::Framebuffer::attachments

(

)

void globjects::Framebuffer::blit	(	gl::GLenum	readBuffer,
		const std::array< gl::GLint, 4 > &	srcRect,
		Framebuffer *	destFbo,
		gl::GLenum	drawBuffer,
		const std::array< gl::GLint, 4 > &	destRect,
		gl::ClearBufferMask	mask,
		gl::GLenum	filter
	)		const

void globjects::Framebuffer::blit	(	gl::GLenum	readBuffer,
		const std::array< gl::GLint, 4 > &	srcRect,
		Framebuffer *	destFbo,
		const std::vector< gl::GLenum > &	drawBuffers,
		const std::array< gl::GLint, 4 > &	destRect,
		gl::ClearBufferMask	mask,
		gl::GLenum	filter
	)		const

virtual gl::GLenum globjects::Framebuffer::objectType ( ) const

overridevirtual

Implements globjects::Object.

void globjects::Framebuffer::addAttachment ( FramebufferAttachment *  attachment )

protected

static void globjects::Framebuffer::blit ( gl::GLint  srcX0, gl::GLint  srcY0, gl::GLint  srcX1, gl::GLint  srcY1, gl::GLint  destX0, gl::GLint  destY0, gl::GLint  destX1, gl::GLint  destY1, gl::ClearBufferMask  mask, gl::GLenum  filter  )

staticprotected

static void globjects::Framebuffer::blit ( const std::array< gl::GLint, 4 > &  srcRect, const std::array< gl::GLint, 4 > &  destRect, gl::ClearBufferMask  mask, gl::GLenum  filter  )

staticprotected

Member Data Documentation

std::map<gl::GLenum, ref_ptr<FramebufferAttachment> > globjects::Framebuffer::m_attachments

protected

---

The documentation for this class was generated from the following file:

• Framebuffer.h