swrast.h File Reference

---

Detailed Description

Public interface to the software rasterization functions.

Author:

Keith Whitwell <keith@tungstengraphics.com>

#include "main/mtypes.h"

Data Structures
struct	SWvertex
	Data-structure to handle vertices in the software rasterizer. More...
struct	swrast_device_driver
	The driver interface for the software rasterizer. More...
Defines
#define	FRAG_ATTRIB_CI   FRAG_ATTRIB_COL0
Typedefs
typedef int	GLfixed
	Fixed point data type.
Functions
GLboolean	_swrast_CreateContext (GLcontext *ctx)
void	_swrast_DestroyContext (GLcontext *ctx)
struct swrast_device_driver *	_swrast_GetDeviceDriverReference (GLcontext *ctx)
void	_swrast_Bitmap (GLcontext *ctx, GLint px, GLint py, GLsizei width, GLsizei height, const struct gl_pixelstore_attrib *unpack, const GLubyte *bitmap)
	Render a bitmap.
void	_swrast_CopyPixels (GLcontext *ctx, GLint srcx, GLint srcy, GLint destx, GLint desty, GLsizei width, GLsizei height, GLenum type)
void	_swrast_DrawPixels (GLcontext *ctx, GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, const struct gl_pixelstore_attrib *unpack, const GLvoid *pixels)
	Execute software-based glDrawPixels.
void	_swrast_ReadPixels (GLcontext *ctx, GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, const struct gl_pixelstore_attrib *unpack, GLvoid *pixels)
	Software fallback routine for ctx->Driver.ReadPixels().
void	_swrast_BlitFramebuffer (GLcontext *ctx, GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1, GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1, GLbitfield mask, GLenum filter)
	Software fallback for glBlitFramebufferEXT().
void	_swrast_Clear (GLcontext *ctx, GLbitfield buffers)
	Called via the device driver's ctx->Driver.Clear() function if the device driver can't clear one or more of the buffers itself.
void	_swrast_Accum (GLcontext *ctx, GLenum op, GLfloat value)
	Software fallback for glAccum.
void	_swrast_ResetLineStipple (GLcontext *ctx)
void	_swrast_SetFacing (GLcontext *ctx, GLuint facing)
	Indicates front/back facing for subsequent points/lines when drawing unfilled polygons.
void	_swrast_Point (GLcontext *ctx, const SWvertex *v)
void	_swrast_Line (GLcontext *ctx, const SWvertex *v0, const SWvertex *v1)
void	_swrast_Triangle (GLcontext *ctx, const SWvertex *v0, const SWvertex *v1, const SWvertex *v2)
void	_swrast_Quad (GLcontext *ctx, const SWvertex *v0, const SWvertex *v1, const SWvertex *v2, const SWvertex *v3)
void	_swrast_flush (GLcontext *ctx)
void	_swrast_render_primitive (GLcontext *ctx, GLenum mode)
void	_swrast_render_start (GLcontext *ctx)
void	_swrast_render_finish (GLcontext *ctx)
void	_swrast_InvalidateState (GLcontext *ctx, GLbitfield new_state)
void	_swrast_allow_vertex_fog (GLcontext *ctx, GLboolean value)
void	_swrast_allow_pixel_fog (GLcontext *ctx, GLboolean value)
void	_swrast_print_vertex (GLcontext *ctx, const SWvertex *v)
void	_swrast_eject_texture_images (GLcontext *ctx)
	Free the texture image data attached to all currently enabled textures.

---

Define Documentation

#define FRAG_ATTRIB_CI   FRAG_ATTRIB_COL0

---

Typedef Documentation

typedef int GLfixed

Fixed point data type.

---

Function Documentation

void _swrast_Accum	(	GLcontext *	ctx,
		GLenum	op,
		GLfloat	value
	)

Software fallback for glAccum.

void _swrast_allow_pixel_fog	(	GLcontext *	ctx,
		GLboolean	value
	)

void _swrast_allow_vertex_fog	(	GLcontext *	ctx,
		GLboolean	value
	)

void _swrast_Bitmap	(	GLcontext *	ctx,
		GLint	px,
		GLint	py,
		GLsizei	width,
		GLsizei	height,
		const struct gl_pixelstore_attrib *	unpack,
		const GLubyte *	bitmap
	)

Render a bitmap.

Called via ctx->Driver.Bitmap() All parameter error checking will have been done before this is called.

void _swrast_BlitFramebuffer	(	GLcontext *	ctx,
		GLint	srcX0,
		GLint	srcY0,
		GLint	srcX1,
		GLint	srcY1,
		GLint	dstX0,
		GLint	dstY0,
		GLint	dstX1,
		GLint	dstY1,
		GLbitfield	mask,
		GLenum	filter
	)

Software fallback for glBlitFramebufferEXT().

void _swrast_Clear	(	GLcontext *	ctx,
		GLbitfield	buffers
	)

Called via the device driver's ctx->Driver.Clear() function if the device driver can't clear one or more of the buffers itself.

Parameters:

	buffers	bitfield of BUFFER_BIT_* values indicating which renderbuffers are to be cleared.
	all	if GL_TRUE, clear whole buffer, else clear specified region.

void _swrast_CopyPixels	(	GLcontext *	ctx,
		GLint	srcx,
		GLint	srcy,
		GLint	destx,
		GLint	desty,
		GLsizei	width,
		GLsizei	height,
		GLenum	type
	)

GLboolean _swrast_CreateContext

(

GLcontext *

ctx

)

void _swrast_DestroyContext

(

GLcontext *

ctx

)

void _swrast_DrawPixels	(	GLcontext *	ctx,
		GLint	x,
		GLint	y,
		GLsizei	width,
		GLsizei	height,
		GLenum	format,
		GLenum	type,
		const struct gl_pixelstore_attrib *	unpack,
		const GLvoid *	pixels
	)

Execute software-based glDrawPixels.

By time we get here, all error checking will have been done.

void _swrast_eject_texture_images

(

GLcontext *

ctx

)

Free the texture image data attached to all currently enabled textures.

Meant to be called by device drivers when transitioning from software to hardware rendering.

void _swrast_flush

(

GLcontext *

ctx

)

struct swrast_device_driver* _swrast_GetDeviceDriverReference

(

GLcontext *

ctx

)

[read]

void _swrast_InvalidateState	(	GLcontext *	ctx,
		GLbitfield	new_state
	)

void _swrast_Line	(	GLcontext *	ctx,
		const SWvertex *	v0,
		const SWvertex *	v1
	)

void _swrast_Point	(	GLcontext *	ctx,
		const SWvertex *	v
	)

void _swrast_print_vertex	(	GLcontext *	ctx,
		const SWvertex *	v
	)

void _swrast_Quad	(	GLcontext *	ctx,
		const SWvertex *	v0,
		const SWvertex *	v1,
		const SWvertex *	v2,
		const SWvertex *	v3
	)

void _swrast_ReadPixels	(	GLcontext *	ctx,
		GLint	x,
		GLint	y,
		GLsizei	width,
		GLsizei	height,
		GLenum	format,
		GLenum	type,
		const struct gl_pixelstore_attrib *	packing,
		GLvoid *	pixels
	)

Software fallback routine for ctx->Driver.ReadPixels().

By time we get here, all error checking will have been done.

void _swrast_render_finish

(

GLcontext *

ctx

)

void _swrast_render_primitive	(	GLcontext *	ctx,
		GLenum	mode
	)

void _swrast_render_start

(

GLcontext *

ctx

)

void _swrast_ResetLineStipple

(

GLcontext *

ctx

)

void _swrast_SetFacing	(	GLcontext *	ctx,
		GLuint	facing
	)

Indicates front/back facing for subsequent points/lines when drawing unfilled polygons.

Needed for two-side stencil.

void _swrast_Triangle	(	GLcontext *	ctx,
		const SWvertex *	v0,
		const SWvertex *	v1,
		const SWvertex *	v2
	)

---