Framebuffer Objects support. More...

#include "r_local.h"
#include "r_framebuffer.h"
#include "r_error.h"

Include dependency graph for r_framebuffer.cpp:

Functions
static GLuint	R_GetFreeFBOTexture (void)
static void	R_FreeFBOTexture (int texnum)
void	R_InitFBObjects (void)
void	R_DeleteFBObject (r_framebuffer_t *buf)
	Delete framebuffer object along with attached render buffer.
void	R_ShutdownFBObjects (void)
	Delete all registered framebuffer and render buffer objects, clear memory.
r_framebuffer_t *	R_CreateFramebuffer (int width, int height, int ntextures, bool depth, bool halfFloat, unsigned int *filters)
	create a new framebuffer object
void	R_ResolveMSAA (const r_framebuffer_t *buf)
	Forces multisample antialiasing resolve on given framebuffer, if needed.
void	R_UseFramebuffer (const r_framebuffer_t *buf)
	bind specified framebuffer object so we render to it
void	R_SetupViewport (r_framebuffer_t *buf, int x, int y, int width, int height)
	Sets the framebuffer dimensions of the viewport.
void	R_UseViewport (const r_framebuffer_t *buf)
	Set the viewport to the dimensions of the given framebuffer.
void	R_DrawBuffers (unsigned int drawBufferNum)
	Activate draw buffer(s).
void	R_BindColorAttachments (unsigned int n, unsigned int *attachments)
	Activate draw buffer(s).
bool	R_EnableRenderbuffer (bool enable)
	Enable the render to the framebuffer.
bool	R_RenderbufferEnabled (void)

Variables
static int	frameBufferObjectCount
static r_framebuffer_t	frameBufferObjects [MAX_GL_FRAMEBUFFERS]
static GLuint	frameBufferTextures [MAX_GL_FRAMEBUFFERS]
static r_framebuffer_t	screenBuffer
static GLenum *	colorAttachments

Detailed Description

Framebuffer Objects support.

Definition in file r_framebuffer.cpp.

Function Documentation

◆ R_BindColorAttachments()

void R_BindColorAttachments	(	unsigned int	n,
		unsigned int *	attachments )

Activate draw buffer(s).

Parameters

n	The number of buffers to activate
attachments	The buffers we are rendering into

Note: The order of the attachments define the gl_FragData order in the shaders

Definition at line 404 of file r_framebuffer.cpp.

References Com_DPrintf(), DEBUG_RENDERER, r_config, r_postprocess, r_programs, and r_state.

Referenced by R_DrawBuffers(), and R_UpdateGlowBufferBinding().

◆ R_CreateFramebuffer()

r_framebuffer_t * R_CreateFramebuffer	(	int	width,
		int	height,
		int	ntextures,
		bool	depth,
		bool	halfFloat,
		unsigned int *	filters )

create a new framebuffer object

Parameters

[in]	width	The width of the framebuffer
[in]	height	The height of the framebuffer
[in]	ntextures	The amount of textures for this framebuffer. See also the filters array.
[in]	depth	Also generate a depth buffer
[in]	halfFloat	Use half float pixel format
[in]	filters	Filters for the textures. Must have `ntextures` entries

Todo: also check if we are running on older (SM2.0) hardware, which doesn't support antialiased MRT

Definition at line 175 of file r_framebuffer.cpp.

References colorAttachments, Com_Printf(), frameBufferObjectCount, frameBufferObjects, GL_CLAMP, GL_DEPTH_ATTACHMENT_EXT, GL_DEPTH_COMPONENT, GL_FRAMEBUFFER_EXT, GL_RENDERBUFFER_EXT, glBindTexture(), glTexImage2D(), i, lengthof, Mem_AllocTypeN, OBJZERO, R_CheckError, r_config, R_GetFreeFBOTexture(), r_multisample, R_SetupViewport(), r_state, and Vector4Clear.

Referenced by R_InitFBObjects().

◆ R_DeleteFBObject()

void R_DeleteFBObject ( r_framebuffer_t * buf )

Delete framebuffer object along with attached render buffer.

Definition at line 126 of file r_framebuffer.cpp.

References i, Mem_Free, and R_FreeFBOTexture().

Referenced by R_ShutdownFBObjects().

◆ R_DrawBuffers()

void R_DrawBuffers ( unsigned int drawBufferNum )

Activate draw buffer(s).

Parameters

[in] drawBufferNum The number of buffers to activate

Todo: introduce enum or speaking constants for the buffer numbers that are drawn here and elsewhere

Definition at line 393 of file r_framebuffer.cpp.

References colorAttachments, and R_BindColorAttachments().

Referenced by R_Draw3DGlobe(), R_EnableRenderbuffer(), and R_UpdateGlowBufferBinding().

◆ R_EnableRenderbuffer()

bool R_EnableRenderbuffer ( bool enable )

Enable the render to the framebuffer.

Parameters

enable If true we are enabling the rendering to fbo_render, if false we are rendering to fbo that represents the screen

See also: R_DrawBuffers

Returns: true if the fbo was bound, false if not supported or deactivated

Definition at line 425 of file r_framebuffer.cpp.

References fbo_render, fbo_screen, r_config, R_DrawBuffers(), r_postprocess, r_programs, r_state, and R_UseFramebuffer().

Referenced by uiGeoscapeNode::draw(), R_DrawBloom(), R_Setup2D(), and R_Setup3D().

◆ R_FreeFBOTexture()

void R_FreeFBOTexture ( int texnum )

static

Definition at line 50 of file r_framebuffer.cpp.

References frameBufferTextures, i, and MAX_GL_FRAMEBUFFERS.

Referenced by R_DeleteFBObject().

◆ R_GetFreeFBOTexture()

GLuint R_GetFreeFBOTexture ( void )

static

Definition at line 36 of file r_framebuffer.cpp.

References Com_Error(), ERR_FATAL, frameBufferTextures, glGenTextures(), GLuint, i, and MAX_GL_FRAMEBUFFERS.

Referenced by R_CreateFramebuffer().

◆ R_InitFBObjects()

void R_InitFBObjects ( void )

Definition at line 65 of file r_framebuffer.cpp.

References colorAttachments, DOWNSAMPLE_PASSES, DOWNSAMPLE_SCALE, fbo_bloom0, fbo_bloom1, frameBufferObjectCount, frameBufferObjects, frameBufferTextures, GL_COLOR_ATTACHMENT0_EXT, GL_FRAMEBUFFER_EXT, GLenum, i, int(), Mem_AllocTypeN, OBJZERO, R_CheckError, r_config, R_CreateFramebuffer(), r_programs, R_SetupViewport(), r_state, screenBuffer, Vector4Clear, and viddef.

Referenced by R_Init(), R_ReinitOpenglContext(), R_RestartPrograms_f(), and R_SetMode().

◆ R_RenderbufferEnabled()

bool R_RenderbufferEnabled ( void )

Definition at line 443 of file r_framebuffer.cpp.

References r_state.

Referenced by R_DrawBloom().

◆ R_ResolveMSAA()

void R_ResolveMSAA ( const r_framebuffer_t * buf )

Forces multisample antialiasing resolve on given framebuffer, if needed.

Parameters

[in] buf the framebuffer to use

Definition at line 296 of file r_framebuffer.cpp.

References GL_COLOR_ATTACHMENT0_EXT, GL_DRAW_FRAMEBUFFER_EXT, GL_FRAMEBUFFER_EXT, GL_READ_FRAMEBUFFER_EXT, i, R_CheckError, and screenBuffer.

Referenced by R_DrawBloom().

◆ R_SetupViewport()

void R_SetupViewport	(	r_framebuffer_t *	buf,
		int	x,
		int	y,
		int	width,
		int	height )

Sets the framebuffer dimensions of the viewport.

Parameters

[out]	buf	The framebuffer to initialize the viewport for. If `nullptr` the screen buffer will be taken.
[in]	x,y	The position
[in]	width,height	The dimensions