QPic functions

Functions
qpic_t *	Draw_CachePic (const char *path, qboolean alpha)
	Load a qpic from the filesystem. More...
void	Draw_DestroyPic (qpic_t *pic)
	Destroy a qpic created by Draw_MakePic. More...
qpic_t *	Draw_MakePic (int width, int height, const byte *data)
	Create a qpic from raw data. More...
void	Draw_Pic (int x, int y, qpic_t *pic)
	Draw a qpic to the screen. More...
void	Draw_Picf (float x, float y, qpic_t *pic)
	Draw a qpic to the screen. More...
qpic_t *	Draw_PicFromWad (const char *name)
	Load a qpic from gfx.wad. More...
void	Draw_SubPic (int x, int y, qpic_t *pic, int srcx, int srcy, int width, int height)
	Draw a sub-region of a qpic to the screan. More...
void	Draw_UncachePic (const char *path)
	Remove a qpic from the qpic cache. More...

Detailed Description

Function Documentation

qpic_t* Draw_CachePic	(	const char *	path,
		qboolean	alpha
	)

Load a qpic from the filesystem.

Parameters

path	path of the file within the quake filesystem
alpha	transparency level of the pic.

Returns

pointer qpic data.

Note

Up to MAX_CACHED_PICS qpics can be loaded at a time this way

void Draw_DestroyPic

(

qpic_t *

pic

)

Destroy a qpic created by Draw_MakePic.

Parameters

pic	The qpic to destory.

qpic_t* Draw_MakePic	(	int	width,
		int	height,
		const byte *	data
	)

Create a qpic from raw data.

Parameters

width	The width of the pic.
height	The height of the pic.
data	The raw data bytes. The system palette will be used for colors.

Returns

pointer qpic data.

void Draw_Pic	(	int	x,
		int	y,
		qpic_t *	pic
	)

Draw a qpic to the screen.

Parameters

x	horizontal location of the upper left corner of the qpic
y	vertical location of the upper left corner of the qpic
pic	qpic to draw

void Draw_Picf	(	float	x,
		float	y,
		qpic_t *	pic
	)

Draw a qpic to the screen.

Parameters

x	horizontal location of the upper left corner of the qpic
y	vertical location of the upper left corner of the qpic
pic	qpic to draw

qpic_t* Draw_PicFromWad

(

const char *

name

)

Load a qpic from gfx.wad.

Parameters

name	name of the was lump to load

Returns

pointer qpic data.

void Draw_SubPic	(	int	x,
		int	y,
		qpic_t *	pic,
		int	srcx,
		int	srcy,
		int	width,
		int	height
	)

Draw a sub-region of a qpic to the screan.

Parameters

x	horizontal screen location of the upper left corner of the sub-region
y	vertical screen location of the upper left corner of the sub-region
pic	qpic to draw
srcx	horizontal qpic location of the upper left corner of the sub-region
srcy	vertical qpic location of the upper left corner of the sub-region
width	horizontal size of the sub-region to be drawn
height	vertical size of the sub-region to be drawn

void Draw_UncachePic

(

const char *

path

)

Remove a qpic from the qpic cache.

This affects only those qpics that were loaded via Draw_CachePic.

Parameters

path	path of the file within the quake filesystem