#include "r_gl.h"
#include "r_material.h"

Go to the source code of this file.

Data Structures
struct	image_s

Macros
#define	MAX_GL_TEXTURES 1024

#define	MAX_GL_LIGHTMAPS 256

#define	MAX_GL_DELUXEMAPS 256

#define	MAX_GL_FRAMEBUFFERS 256

#define	MAX_ENVMAPTEXTURES 2

#define	NUM_FLARETEXTURES 10

Typedefs
typedef struct image_s	image_t

Enumerations
enum	imagetype_t { it_chars, it_effect, it_static, it_pic, it_wrappic, it_skin, it_normalmap, it_glowmap, it_specularmap, it_roughnessmap, it_world, it_lightmap, it_deluxemap, it_material, it_worldrelated }

Functions
void	R_UploadTexture (const unsigned data, int width, int height, image_t image)
	Uploads the opengl texture to the server. More...

void	R_SoftenTexture (byte *in, int width, int height, int bpp)
	Applies blurring to a texture. More...

void	R_GetScaledTextureSize (int width, int height, int scaledWidth, int scaledHeight)
	Calculates the texture size that should be used to upload the texture data. More...

void	R_ScaleTexture (const unsigned in, int inwidth, int inheight, unsigned out, int outwidth, int outheight)

image_t *	R_RenderToTexture (const char *name, int x, int y, int w, int h)

void	R_ImageList_f (void)
	Shows all loaded images. More...

void	R_InitImages (void)

void	R_ShutdownImages (void)

void	R_ReloadImages (void)

void	R_FreeWorldImages (void)
	Any image that is a mesh or world texture will be removed here. More...

void	R_ImageClearMaterials (void)
	Free previously loaded materials and their stages. More...

void	R_UploadAlpha (const image_t image, const byte alphaData)

void	R_TextureMode (const char *string)

void	R_TextureAlphaMode (const char *string)

void	R_TextureSolidMode (const char *string)

void	R_FreeImage (image_t *image)
	Free the image and its assigned maps (roughness, normal, specular, glow - if there are any) More...

image_t *	R_LoadImageData (const char name, const byte pic, int width, int height, imagetype_t type)
	Creates a new image from RGBA data. Stores it in the gltextures array and also uploads it. More...

image_t *	R_GetImage (const char *name)

image_t *	R_FindImage (const char *pname, imagetype_t type)
	Finds or loads the given image. More...

const image_t *	R_FindPics (const char *name)
	Searches for an image in the image array. More...

bool	R_ImageExists (const char *pname,...) __attribute__((format(__printf__

bool image_t *	R_GetImageAtIndex (int i)
	Returns an image pointer from the r_images linked list, as if r_images would be a plain contiguous array. More...

int	R_GetImageIndex (image_t *image)
	Returns an index of the image pointer in the r_images linked list, as if r_images would be a plain contiguous array. More...

Variables
int	r_numImages

image_t *	r_envmaptextures [MAX_ENVMAPTEXTURES]

image_t *	r_flaretextures [NUM_FLARETEXTURES]

image_t *	shadow

image_t *	r_noTexture

image_t *	r_warpTexture

image_t *	r_dummyTexture

Macro Definition Documentation

#define MAX_ENVMAPTEXTURES 2

Definition at line 111 of file r_image.h.

Referenced by R_InitImages(), and R_ParseStage().

#define MAX_GL_DELUXEMAPS 256

Definition at line 78 of file r_image.h.

Referenced by R_UploadLightmapPage().

#define MAX_GL_FRAMEBUFFERS 256

Definition at line 79 of file r_image.h.

Referenced by R_FreeFBOTexture(), and R_GetFreeFBOTexture().

#define MAX_GL_LIGHTMAPS 256

Definition at line 77 of file r_image.h.

Referenced by R_UploadLightmapPage().

#define MAX_GL_TEXTURES 1024

Definition at line 76 of file r_image.h.

Referenced by R_ImageList_f(), and R_SortSurfacesArrays_().

#define NUM_FLARETEXTURES 10

Definition at line 114 of file r_image.h.

Referenced by R_InitImages(), and R_ParseStage().

Typedef Documentation

typedef struct image_s image_t

Enumeration Type Documentation

enum imagetype_t

Enumerator
it_chars
it_effect
it_static
it_pic
it_wrappic
it_skin
it_normalmap
it_glowmap
it_specularmap
it_roughnessmap
it_world	the following are freed with every mapchange
it_lightmap
it_deluxemap
it_material
it_worldrelated

Definition at line 41 of file r_image.h.

Function Documentation

image_t* R_FindImage	(	const char *	pname,
		imagetype_t	type
	)

Finds or loads the given image.

See also: R_RegisterImage

Parameters

[in]	pname	Image name Path relative to the game dir (e.g. textures/tex_common/nodraw)
[in]	type	The type of the image. This has influence on image filters and texture parameters when uploading the image data

Note: the image name has to be at least 5 chars long

See also: R_LoadTGA; R_LoadJPG; R_LoadPNG

Todo:: should also check the mipmapping

Definition at line 603 of file r_image.cpp.

References Com_Error(), Com_Printf(), Com_StripExtension(), ERR_FATAL, image_s::glowmap, Img_LoadImage(), it_glowmap, it_normalmap, it_roughnessmap, it_specularmap, it_world, MAX_QPATH, image_s::name, image_s::normalmap, R_ChangeImageType(), R_FindImage(), R_GetImage(), R_IsClampedImageType(), R_LoadImageData(), r_noTexture, image_s::roughnessmap, image_s::specularmap, image_s::type, and va().

Referenced by CL_AddActor(), Con_DrawConsole(), HUD_UpdateCursor(), R_AliasModelGetSkin(), R_Draw3DGlobe(), R_DrawEntityEffects(), R_DrawFlatGeoscape(), R_DrawFloor(), R_DrawGrass(), R_DrawImageCentered(), R_DrawInitLocal(), R_FindImage(), R_FindPics(), R_InitImages(), R_LoadAnimImages(), R_LoadMaterials(), R_ModLoadTexinfo(), R_ParseStage(), R_UploadData(), SCR_DrawCursor(), SCR_DrawLoadingScreen(), SCR_TouchPics(), SEQ_Render2D(), UI_InitRadar(), UI_LoadImage(), and UI_LoadWrappedImage().

const image_t* R_FindPics ( const char * name )

Searches for an image in the image array.

Parameters

[in] name The name of the image relative to pics/

Note: name may not be null and has to be longer than 4 chars

Returns: nullptr on error or image_t pointer on success

See also: R_FindImage

Definition at line 673 of file r_image.cpp.

References it_pic, R_FindImage(), r_noTexture, and va().

Referenced by CL_ParticleLoadArt(), LE_BrushModelAction(), and SEQ_ExecutePrecache().

void R_FreeImage ( image_t * image )

Free the image and its assigned maps (roughness, normal, specular, glow - if there are any)

Parameters

image The image that should be freed

Definition at line 735 of file r_image.cpp.

References image_s::glowmap, image_s::normalmap, R_DeleteImage(), image_s::roughnessmap, image_s::specularmap, and image_s::texnum.

Referenced by R_Draw3DGlobe(), and R_FreeWorldImages().

void R_FreeWorldImages ( void )

Any image that is a mesh or world texture will be removed here.

See also: R_ShutdownImages

Definition at line 757 of file r_image.cpp.

References FOR_EACH_IMAGE, i, imageArray_s::images, it_world, R_CheckError, R_FreeImage(), and image_s::type.

Referenced by CL_Disconnect().

image_t* R_GetImage ( const char * name )

Definition at line 452 of file r_image.cpp.

References Com_HashKey(), hash, image_s::hash_next, MAX_IMAGEHASH, image_s::name, and Q_streq.

Referenced by R_FindImage(), R_LoadImageData(), R_LoadMaterials(), R_RenderToTexture(), and R_UploadAlpha_().

bool image_t* R_GetImageAtIndex ( int i )

Returns an image pointer from the r_images linked list, as if r_images would be a plain contiguous array.

Parameters

i	The image index inside r_images

Definition at line 718 of file r_image.cpp.

References IMAGE_ARRAY_SIZE, imageArray_s::images, imageArray_s::next, and r_numImages.

Referenced by uiMaterialEditorNode::draw(), uiMaterialEditorNode::onMouseDown(), UI_MaterialEditorChangeValue_f(), UI_MaterialEditorNewStage_f(), UI_MaterialEditorNodeGetImageAtPosition(), UI_MaterialEditorNodeGetImageCount(), UI_MaterialEditorRemoveStage_f(), and UI_MaterialEditorSelectStage_f().

int R_GetImageIndex ( image_t * imagePtr )

Returns an index of the image pointer in the r_images linked list, as if r_images would be a plain contiguous array.

Parameters

imagePtr The image pointer

Definition at line 702 of file r_image.cpp.

References IMAGE_ARRAY_SIZE, imageArray_s::images, and imageArray_s::next.

Referenced by R_SortSurfacesArrays(), and R_SortSurfacesArrays_().

void R_GetScaledTextureSize	(	int	width,
		int	height,
		int *	scaledWidth,
		int *	scaledHeight
	)

Calculates the texture size that should be used to upload the texture data.

Parameters

[in]	width	The width of the source texture data
[in]	height	The heigt of the source texture data
[out]	scaledWidth	The resulting width - can be the same as the given `width`
[out]	scaledHeight	The resulting height - can be the same as the given `height`

Definition at line 220 of file r_image.cpp.

References MAX_TEXTURE_SIZE, rconfig_t::maxTextureSize, and r_config.

Referenced by R_UploadData(), and R_UploadTexture().

void R_ImageClearMaterials ( void )

Free previously loaded materials and their stages.

See also: R_LoadMaterials

Definition at line 61 of file r_image.cpp.

References defaultMaterial, FOR_EACH_IMAGE, i, imageArray_s::images, m, image_s::material, Mem_Free, materialStage_s::next, and material_s::stages.

Referenced by R_LoadMaterials().

bool R_ImageExists	(	const char *	pname,
			...
	)

void R_ImageList_f ( void )

Shows all loaded images.

Definition at line 85 of file r_image.cpp.

References Com_Printf(), FOR_EACH_IMAGE, i, imageArray_s::images, it_chars, it_effect, it_lightmap, it_material, it_normalmap, it_pic, it_skin, it_static, it_world, it_wrappic, MAX_GL_TEXTURES, image_s::name, r_numImages, image_s::texnum, image_s::type, type, image_s::upload_height, and image_s::upload_width.

void R_InitImages ( void )

Definition at line 774 of file r_image.cpp.

References Com_Error(), ERR_FATAL, i, it_effect, MAX_ENVMAPTEXTURES, NUM_FLARETEXTURES, R_FindImage(), r_noTexture, r_numImages, and va().

Referenced by R_Init().

image_t* R_LoadImageData	(	const char *	name,
		const byte *	pic,
		int	width,
		int	height,
		imagetype_t	type
	)

Creates a new image from RGBA data. Stores it in the gltextures array and also uploads it.

Note: This is also used as an entry point for the generated r_noTexture

Parameters

[in]	name	The name of the newly created image
[in]	pic	The RGBA data of the image
[in]	width	The width of the image (power of two, please)
[in]	height	The height of the image (power of two, please)
[in]	type	The image type