depthstencil.h File Reference

Functions
struct gl_renderbuffer *	_mesa_new_z24_renderbuffer_wrapper (GLcontext *ctx, struct gl_renderbuffer *dsrb)
	Wrap the given GL_DEPTH_STENCIL renderbuffer so that it acts like a depth renderbuffer.
struct gl_renderbuffer *	_mesa_new_s8_renderbuffer_wrapper (GLcontext *ctx, struct gl_renderbuffer *dsrb)
	Wrap the given GL_DEPTH_STENCIL renderbuffer so that it acts like a stencil renderbuffer.
void	_mesa_extract_stencil (GLcontext *ctx, struct gl_renderbuffer *dsRb, struct gl_renderbuffer *stencilRb)
	The following functions are useful for hardware drivers that only implement combined depth/stencil buffers.
void	_mesa_insert_stencil (GLcontext *ctx, struct gl_renderbuffer *dsRb, struct gl_renderbuffer *stencilRb)
	Copy stencil values from a stencil renderbuffer into a combined depth/stencil renderbuffer.
void	_mesa_promote_stencil (GLcontext *ctx, struct gl_renderbuffer *stencilRb)
	Convert the stencil buffer from 8bpp to 32bpp depth/stencil.

---

Function Documentation

void _mesa_extract_stencil	(	GLcontext *	ctx,
		struct gl_renderbuffer *	dsRb,
		struct gl_renderbuffer *	stencilRb
	)

The following functions are useful for hardware drivers that only implement combined depth/stencil buffers.

The GL_EXT_framebuffer_object extension allows indepedent depth and stencil buffers to be used in any combination. Therefore, we sometimes have to merge separate depth and stencil renderbuffers into a single depth+stencil renderbuffer. And sometimes we have to split combined depth+stencil renderbuffers into separate renderbuffers. Extract stencil values from the combined depth/stencil renderbuffer, storing the values into a separate stencil renderbuffer.

Parameters:

	dsRb	the source depth/stencil renderbuffer
	stencilRb	the destination stencil renderbuffer (either 8-bit or 32-bit)

void _mesa_insert_stencil	(	GLcontext *	ctx,
		struct gl_renderbuffer *	dsRb,
		struct gl_renderbuffer *	stencilRb
	)

Copy stencil values from a stencil renderbuffer into a combined depth/stencil renderbuffer.

Parameters:

	dsRb	the destination depth/stencil renderbuffer
	stencilRb	the source stencil buffer (either 8-bit or 32-bit)

struct gl_renderbuffer* _mesa_new_s8_renderbuffer_wrapper	(	GLcontext *	ctx,
		struct gl_renderbuffer *	dsrb
	)			[read]

Wrap the given GL_DEPTH_STENCIL renderbuffer so that it acts like a stencil renderbuffer.

Returns:

new stencil renderbuffer

struct gl_renderbuffer* _mesa_new_z24_renderbuffer_wrapper	(	GLcontext *	ctx,
		struct gl_renderbuffer *	dsrb
	)			[read]

Wrap the given GL_DEPTH_STENCIL renderbuffer so that it acts like a depth renderbuffer.

Returns:

new depth renderbuffer

void _mesa_promote_stencil	(	GLcontext *	ctx,
		struct gl_renderbuffer *	stencilRb
	)

Convert the stencil buffer from 8bpp to 32bpp depth/stencil.

Parameters:

stencilRb

the stencil renderbuffer to promote

---