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

Include dependency graph for r_image.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	image_t

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

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.
void	R_SoftenTexture (byte *in, int width, int height, int bpp)
	Applies blurring to a texture.
void	R_GetScaledTextureSize (int width, int height, int scaledWidth, int scaledHeight)
	Calculates the texture size that should be used to upload the texture data.
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.
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.
void	R_ImageClearMaterials (void)
	Free previously loaded materials and their stages.
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).
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.
image_t *	R_GetImage (const char *name)
image_t *	R_FindImage (const char *pname, imagetype_t type)
	Finds or loads the given image.
const image_t *	R_FindPics (const char *name)
	Searches for an image in the image array.
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.
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.

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

◆ MAX_ENVMAPTEXTURES

#define MAX_ENVMAPTEXTURES 2

Definition at line 111 of file r_image.h.

Referenced by R_InitImages(), and R_ParseStage().

◆ MAX_GL_DELUXEMAPS

#define MAX_GL_DELUXEMAPS 256

Definition at line 78 of file r_image.h.

Referenced by R_UploadLightmapPage().

◆ MAX_GL_FRAMEBUFFERS

#define MAX_GL_FRAMEBUFFERS 256

Definition at line 79 of file r_image.h.

Referenced by R_FreeFBOTexture(), and R_GetFreeFBOTexture().

◆ MAX_GL_LIGHTMAPS

#define MAX_GL_LIGHTMAPS 256

Definition at line 77 of file r_image.h.

Referenced by R_UploadLightmapPage().

◆ MAX_GL_TEXTURES

#define MAX_GL_TEXTURES 1024

Definition at line 76 of file r_image.h.

Referenced by R_ImageList_f(), and R_SortSurfacesArrays_().

◆ NUM_FLARETEXTURES

#define NUM_FLARETEXTURES 10

Definition at line 114 of file r_image.h.

Referenced by R_InitImages(), and R_ParseStage().

Enumeration Type Documentation

◆ imagetype_t

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

◆ R_FindImage()

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_Printf(), Com_StripExtension(), ERR_FATAL, image_t::glowmap, Img_LoadImage(), it_glowmap, it_normalmap, it_roughnessmap, it_specularmap, it_world, MAX_QPATH, image_t::name, image_t::normalmap, R_ChangeImageType(), R_FindImage(), R_GetImage(), R_IsClampedImageType(), R_LoadImageData(), r_noTexture, image_t::roughnessmap, image_t::specularmap, image_t::type, 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().

◆ R_FindPics()

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, name, R_FindImage(), r_noTexture, and va().

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

◆ R_FreeImage()

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_t::glowmap, image_t::normalmap, R_DeleteImage(), image_t::roughnessmap, image_t::specularmap, and image_t::texnum.

Referenced by R_Draw3DGlobe(), and R_FreeWorldImages().

◆ 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, it_world, R_CheckError, R_FreeImage(), and image_t::type.

Referenced by CL_Disconnect().

◆ R_GetImage()

image_t * R_GetImage ( const char * name )

Definition at line 452 of file r_image.cpp.

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

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

◆ R_GetImageAtIndex()

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 i, IMAGE_ARRAY_SIZE, imageArray_t::images, imageArray_t::next, r_images, and r_numImages.

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

◆ R_GetImageIndex()

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_t::images, imageArray_t::next, and r_images.

Referenced by R_ImageExists(), R_SortSurfacesArrays(), and R_SortSurfacesArrays_().

◆ R_GetScaledTextureSize()

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, and r_config.

Referenced by R_UploadData(), and R_UploadTexture().

◆ R_ImageClearMaterials()

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, m, image_t::material, Mem_Free, and materialStage_t::next.

Referenced by R_LoadMaterials().

◆ R_ImageExists()

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

References __attribute__, format(), i, R_GetImageAtIndex(), and R_GetImageIndex().

◆ R_ImageList_f()

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, it_chars, it_effect, it_lightmap, it_material, it_normalmap, it_pic, it_skin, it_static, it_world, it_wrappic, MAX_GL_TEXTURES, image_t::name, r_numImages, image_t::texnum, image_t::type, type, image_t::upload_height, and image_t::upload_width.

◆ R_InitImages()

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_envmaptextures, R_FindImage(), r_flaretextures, r_noTexture, r_numImages, and va().

Referenced by R_Init().

◆ R_LoadImageData()

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