Material related code. More...

#include "r_local.h"
#include "r_error.h"
#include "r_lightmap.h"
#include "../../shared/parse.h"

Include dependency graph for r_material.cpp:

Macros
#define	UPDATE_THRESHOLD 0.02

Functions
static void	R_UpdateMaterial (material_t *m)
	Materials "think" every few milliseconds to advance animations. More...

static void	R_StageGlow (const materialStage_t *stage)

static void	R_StageLighting (const mBspSurface_t surf, const materialStage_t stage)
	Manages state for stages supporting static, dynamic, and per-pixel lighting. More...

static void	R_StageVertex (const mBspSurface_t surf, const materialStage_t stage, const vec3_t in, vec3_t out)
	Vertex deformation. More...

static void	R_StageTextureMatrix (const mBspSurface_t surf, const materialStage_t stage)
	Manages texture matrix manipulations for stages supporting rotations, scrolls, and stretches (rotate, translate, scale). More...

static void	R_StageTexCoord (const materialStage_t *stage, const vec3_t v, const vec2_t in, vec2_t out)
	Generates a single texture coordinate for the specified stage and vertex. More...

static void	R_StageColor (const materialStage_t *stage, const vec3_t v, vec4_t color)
	Generates a single color for the specified stage and vertex. More...

static void	R_SetSurfaceStageState (const mBspSurface_t surf, const materialStage_t stage)
	Manages all state for the specified surface and stage. More...

static void	R_DrawSurfaceStage (mBspSurface_t surf, materialStage_t stage)
	Render the specified stage for the surface. Resolve vertex attributes via helper functions, outputting to the default vertex arrays. More...

void	R_DrawMaterialSurfaces (const mBspSurfaces_t surfs, glElementIndex_t indexPtr)
	Iterates the specified surfaces list, updating materials as they are encountered, and rendering all visible stages. State is lazily managed throughout the iteration, so there is a concerted effort to restore the state after all surface stages have been rendered. More...

static GLenum	R_ConstByName (const char *c)
	Translate string into glmode. More...

static void	R_CreateMaterialData_ (model_t *mod)

static void	R_CreateMaterialData (void)

static int	R_LoadAnimImages (materialStage_t *s)

static int	R_ParseStage (materialStage_t s, const char *buffer)
	Material stage parser. More...

void	R_LoadMaterials (const char *map)
	Load material definitions for each map that has one. More...

void	R_UpdateDefaultMaterial (const char cvarName, const char oldValue, const char newValue, void data)
	Change listener callback for material value cvars. More...

Variables
mBspSurfaces_t	r_material_surfaces

material_t	defaultMaterial = {0, 0.0f, DEFAULT_BUMP, DEFAULT_PARALLAX, DEFAULT_HARDNESS, DEFAULT_SPECULAR, DEFAULT_GLOWSCALE, nullptr, 0}

static const float	dirtmap []
	Array with 'random' alpha values for the dirtmap. More...

Detailed Description

Material related code.

Definition in file r_material.cpp.

Macro Definition Documentation

◆ UPDATE_THRESHOLD

#define UPDATE_THRESHOLD 0.02

Definition at line 36 of file r_material.cpp.

Function Documentation

◆ R_ConstByName()

static GLenum R_ConstByName ( const char * c )

static

Translate string into glmode.

Definition at line 480 of file r_material.cpp.

References Com_Printf(), and Q_streq.

Referenced by R_ParseStage().

◆ R_CreateMaterialData()

static void R_CreateMaterialData ( void )

static

Definition at line 512 of file r_material.cpp.

References i, R_CreateMaterialData_(), r_mapTiles, r_modelsInline, r_numMapTiles, and r_numModelsInline.

Referenced by R_LoadMaterials().

◆ R_CreateMaterialData_()

static void R_CreateMaterialData_ ( model_t * mod )

static

Definition at line 503 of file r_material.cpp.

References model_t::bsp, i, mBspModel_t::numsurfaces, R_CreateSurfaceFlare(), and mBspModel_t::surfaces.

Referenced by R_CreateMaterialData().

◆ R_DrawMaterialSurfaces()

void R_DrawMaterialSurfaces	(	const mBspSurfaces_t *	surfs,
		glElementIndex_t *	indexPtr
	)

Iterates the specified surfaces list, updating materials as they are encountered, and rendering all visible stages. State is lazily managed throughout the iteration, so there is a concerted effort to restore the state after all surface stages have been rendered.

Todo:

integrate BSP lighting with model lighting

Definition at line 399 of file r_material.cpp.

References rstate_t::blend_enabled, mBspSurfaces_t::count, rlocals_t::frame, mBspSurface_t::frame, i, mBspTexInfo_t::image, cvar_t::integer, m, image_t::material, R_BlendFunc(), R_Color(), R_DrawSurfaceStage(), R_EnableBumpmap(), R_EnableColorArray(), R_EnableFog(), R_EnableGlowMap(), R_EnableLighting(), R_EnableModelLights(), R_EnableTexture(), r_locals, r_materials, R_ResetArrayState(), R_SetSurfaceStageState(), r_state, R_UpdateMaterial(), r_wire, STAGE_RENDER, mBspSurfaces_t::surfaces, mBspSurface_t::texinfo, and texunit_lightmap.

Referenced by R_RenderMaterialBspRRefs().

◆ R_DrawSurfaceStage()

static void R_DrawSurfaceStage	(	mBspSurface_t *	surf,
		materialStage_t *	stage
	)

static

Render the specified stage for the surface. Resolve vertex attributes via helper functions, outputting to the default vertex arrays.

Definition at line 349 of file r_material.cpp.

References rstate_t::active_normalmap, rendererData_t::batchCount, model_t::bsp, rstate_t::color_array, rstate_t::color_array_enabled, i, mBspSurface_t::index, rstate_t::lighting_enabled, mBspModel_t::lmtexcoords, rstate_t::normal_array, mBspModel_t::normals, mBspSurface_t::numedges, R_CheckError, r_mapTiles, R_ReallocateStateArrays(), R_ReallocateTexunitArray(), R_StageColor(), R_StageTexCoord(), R_StageVertex(), r_state, refdef, rstate_t::tangent_array, mBspModel_t::tangents, mBspModel_t::texcoords, texunit_diffuse, texunit_lightmap, mBspSurface_t::tile, v, rstate_t::vertex_array_3d, and mBspModel_t::verts.

Referenced by R_DrawMaterialSurfaces().

◆ R_LoadAnimImages()

static int R_LoadAnimImages ( materialStage_t * s )

static

Definition at line 523 of file r_material.cpp.

References materialStage_t::anim, Com_Printf(), i, materialStage_t::image, anim_t::images, it_material, MAX_QPATH, name, anim_t::num_frames, Q_strncpyz(), R_FindImage(), r_noTexture, and va().

Referenced by R_LoadMaterials().

◆ R_LoadMaterials()

void R_LoadMaterials ( const char * map )

Load material definitions for each map that has one.

Parameters

[in] map the base name of the map to load the material for

Definition at line 920 of file r_material.cpp.

References material_t::bump, Com_DPrintf(), Com_Parse(), Com_Printf(), Com_SkipPath(), Com_sprintf(), DEBUG_RENDERER, defaultMaterial, materialStage_t::flags, FS_FreeFile(), FS_LoadFile(), image_t::glowmap, materialStage_t::glowscale, material_t::glowscale, material_t::hardness, cvar_t::integer, it_glowmap, it_normalmap, m, image_t::material, MAX_QPATH, Mem_Free, Mem_PoolAllocType, image_t::name, materialStage_t::next, image_t::normalmap, material_t::parallax, Q_streq, Q_strvalid, R_CreateMaterialData(), R_FindImage(), R_GetImage(), R_ImageClearMaterials(), R_LoadAnimImages(), r_materials, r_noTexture, r_overridematerial, R_ParseStage(), material_t::specular, STAGE_ANIM, cvar_t::string, va(), and vid_imagePool.

Referenced by R_ModEndLoading().

◆ R_ParseStage()

static int R_ParseStage	(	materialStage_t *	s,
		const char **	buffer
	)

static

Material stage parser.

See also: R_LoadMaterials

Definition at line 563 of file r_material.cpp.

References stretch_t::amp, materialStage_t::anim, ANIM_ALTERNATE, ANIM_BACKWARDS, ANIM_NORMAL, ANIM_RANDOM, ANIM_RANDOMFORCE, materialStage_t::blend, terrain_t::ceil, tape_t::ceil, tape_t::center, materialStage_t::color, Com_DPrintf(), Com_Parse(), Com_Printf(), DEBUG_RENDERER, defaultMaterial, blendmode_t::dest, materialStage_t::dirt, pulse_t::dutycycle, materialStage_t::flags, terrain_t::floor, tape_t::floor, anim_t::fps, materialStage_t::glowscale, material_t::glowscale, terrain_t::height, tape_t::height, rotate_t::hz, pulse_t::hz, stretch_t::hz, i, materialStage_t::image, dirt_t::intensity, it_material, tape_t::max, MAX_ANIM_FRAMES, MAX_ENVMAPTEXTURES, tape_t::min, NUM_FLARETEXTURES, anim_t::num_frames, materialStage_t::pulse, Q_streq, Q_strstart(), R_ConstByName(), r_envmaptextures, R_FindImage(), r_flaretextures, r_noTexture, materialStage_t::rotate, scroll_t::s, scale_t::s, materialStage_t::scale, materialStage_t::scroll, blendmode_t::src, STAGE_ANIM, STAGE_BLEND, STAGE_COLOR, STAGE_DIRTMAP, STAGE_ENVMAP, STAGE_FLARE, STAGE_GLOWMAPLINK, STAGE_LIGHTING, STAGE_LIGHTMAP, STAGE_PULSE, STAGE_RENDER, STAGE_ROTATE, STAGE_SCALE_S, STAGE_SCALE_T, STAGE_SCROLL_S, STAGE_SCROLL_T, STAGE_STRETCH, STAGE_TAPE, STAGE_TERRAIN, STAGE_TEXTURE, materialStage_t::stretch, scroll_t::t, scale_t::t, materialStage_t::tape, materialStage_t::terrain, anim_t::type, and va().

Referenced by R_LoadMaterials().

◆ R_SetSurfaceStageState()

static void R_SetSurfaceStageState	(	const mBspSurface_t *	surf,
		const materialStage_t *	stage
	)

static

Manages all state for the specified surface and stage.

See also: R_DrawMaterialSurfaces

Todo:: WTF? surely it was supposed to use the specular color

Definition at line 292 of file r_material.cpp.

References materialStage_t::blend, materialStage_t::color, rstate_t::color_array_enabled, blendmode_t::dest, pulse_t::dhz, materialStage_t::flags, materialStage_t::image, mBspSurface_t::lightColor, materialStage_t::pulse, R_BindTexture, R_BlendFunc(), R_Color(), R_EnableColorArray(), R_EnableFog(), R_StageGlow(), R_StageLighting(), R_StageTextureMatrix(), r_state, blendmode_t::src, STAGE_BLEND, STAGE_COLOR, STAGE_DIRTMAP, STAGE_ENVMAP, STAGE_PULSE, STAGE_TAPE, STAGE_TERRAIN, VectorCopy, and VectorSet.

Referenced by R_DrawMaterialSurfaces().

◆ R_StageColor()

static void R_StageColor	(	const materialStage_t *	stage,
		const vec3_t	v,
		vec4_t	color
	)

static

Generates a single color for the specified stage and vertex.

Definition at line 240 of file r_material.cpp.

References terrain_t::ceil, tape_t::center, materialStage_t::color, materialStage_t::dirt, dirtmap, DotProduct, materialStage_t::flags, terrain_t::floor, terrain_t::height, index, int(), dirt_t::intensity, lengthof, tape_t::max, tape_t::min, STAGE_COLOR, STAGE_DIRTMAP, STAGE_TAPE, STAGE_TERRAIN, materialStage_t::tape, materialStage_t::terrain, v, Vector4Set, VectorCopy, and VectorSet.

Referenced by R_DrawSurfaceStage().

◆ R_StageGlow()

static void R_StageGlow ( const materialStage_t * stage )

static

Definition at line 109 of file r_material.cpp.

References materialStage_t::flags, rstate_t::glowmap_enabled, materialStage_t::glowscale, materialStage_t::image, R_EnableGlowMap(), R_ProgramParameter1f(), r_state, and STAGE_GLOWMAPLINK.

Referenced by R_SetSurfaceStageState().

◆ R_StageLighting()

static void R_StageLighting	(	const mBspSurface_t *	surf,
		const materialStage_t *	stage
	)

static

Manages state for stages supporting static, dynamic, and per-pixel lighting.

Todo:: fix it and enable it back for r_materials 1

Definition at line 130 of file r_material.cpp.

References materialStage_t::flags, mBspSurface_t::flags, materialStage_t::image, cvar_t::integer, rstate_t::lighting_enabled, mBspSurface_t::lightmap_texnum, MSURF_LIGHTMAP, R_BindLightmapTexture(), R_EnableLighting(), R_EnableTexture(), r_materials, R_SetSurfaceBumpMappingParameters(), r_state, STAGE_LIGHTING, STAGE_LIGHTMAP, texunit_lightmap, and rstate_t::world_program.

Referenced by R_SetSurfaceStageState().

◆ R_StageTexCoord()

static void R_StageTexCoord	(	const materialStage_t *	stage,
		const vec3_t	v,
		const vec2_t	in,
		vec2_t	out
	)

static

Generates a single texture coordinate for the specified stage and vertex.

Definition at line 219 of file r_material.cpp.

References materialStage_t::flags, refdef, STAGE_ENVMAP, v, Vector2Copy, VectorNormalizeFast(), VectorSubtract, and rendererData_t::viewOrigin.

Referenced by R_DrawSurfaceStage().

◆ R_StageTextureMatrix()

static void R_StageTextureMatrix	(	const mBspSurface_t *	surf,
		const materialStage_t *	stage
	)

inlinestatic

Manages texture matrix manipulations for stages supporting rotations, scrolls, and stretches (rotate, translate, scale).

Definition at line 171 of file r_material.cpp.

References stretch_t::damp, rotate_t::deg, scroll_t::ds, scroll_t::dt, materialStage_t::flags, image_t::height, mBspTexInfo_t::image, materialStage_t::rotate, scale_t::s, materialStage_t::scale, materialStage_t::scroll, STAGE_ROTATE, STAGE_SCALE_S, STAGE_SCALE_T, STAGE_SCROLL_S, STAGE_SCROLL_T, STAGE_STRETCH, STAGE_TEXTURE_MATRIX, mBspSurface_t::stcenter, materialStage_t::stretch, scale_t::t, mBspSurface_t::texinfo, and image_t::width.

Referenced by R_SetSurfaceStageState().

◆ R_StageVertex()

static void R_StageVertex	(	const mBspSurface_t *	surf,
		const materialStage_t *	stage,
		const vec3_t	in,
		vec3_t	out
	)

inlinestatic

Vertex deformation.

Todo:: implement this

Definition at line 162 of file r_material.cpp.

References VectorCopy.

Referenced by R_DrawSurfaceStage().

◆ R_UpdateDefaultMaterial()

void R_UpdateDefaultMaterial	(	const char *	cvarName,
		const char *	oldValue,
		const char *	newValue,
		void *	data
	)

Change listener callback for material value cvars.

Definition at line 1092 of file r_material.cpp.

References defaultMaterial, material_t::hardness, r_default_hardness, r_default_specular, material_t::specular, and cvar_t::value.

Referenced by R_Init(), R_RegisterSystemVars(), and R_ReinitOpenglContext().

◆ R_UpdateMaterial()

static void R_UpdateMaterial ( material_t * m )

static

Materials "think" every few milliseconds to advance animations.

Definition at line 40 of file r_material.cpp.

References ANIM_ALTERNATE, ANIM_BACKWARDS, ANIM_NORMAL, ANIM_RANDOM, ANIM_RANDOMFORCE, m, M_PI, refdef, STAGE_ANIM, STAGE_PULSE, STAGE_ROTATE, STAGE_SCROLL_S, STAGE_SCROLL_T, STAGE_STRETCH, rendererData_t::time, and UPDATE_THRESHOLD.

Referenced by R_DrawMaterialSurfaces().

Variable Documentation

◆ defaultMaterial

material_t defaultMaterial = {0, 0.0f, DEFAULT_BUMP, DEFAULT_PARALLAX, DEFAULT_HARDNESS, DEFAULT_SPECULAR, DEFAULT_GLOWSCALE, nullptr, 0}

Todo:: load this from file, will make tweaking the game much easier

Definition at line 34 of file r_material.cpp.

Referenced by R_EnableBumpmap(), R_EnableModelLights(), R_ImageClearMaterials(), R_InitModelProgram(), R_InitWorldProgram(), R_LoadImageData(), R_LoadMaterials(), R_ParseStage(), R_UpdateDefaultMaterial(), and R_UseMaterial().

◆ dirtmap

const float dirtmap[]

static

Initial value:

= {
        0.6, 0.5, 0.3, 0.4, 0.7, 0.3, 0.0, 0.4,
        0.5, 0.2, 0.8, 0.5, 0.3, 0.2, 0.5, 0.3
}

Array with 'random' alpha values for the dirtmap.

Definition at line 232 of file r_material.cpp.

Referenced by R_StageColor().

◆ r_material_surfaces

mBspSurfaces_t r_material_surfaces

Definition at line 31 of file r_material.cpp.

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ UPDATE_THRESHOLD

Function Documentation

◆ R_ConstByName()

◆ R_CreateMaterialData()

◆ R_CreateMaterialData_()

◆ R_DrawMaterialSurfaces()

◆ R_DrawSurfaceStage()

◆ R_LoadAnimImages()

◆ R_LoadMaterials()

◆ R_ParseStage()

◆ R_SetSurfaceStageState()

◆ R_StageColor()

◆ R_StageGlow()

◆ R_StageLighting()

◆ R_StageTexCoord()

◆ R_StageTextureMatrix()

◆ R_StageVertex()

◆ R_UpdateDefaultMaterial()

◆ R_UpdateMaterial()

Variable Documentation

◆ defaultMaterial

◆ dirtmap

◆ r_material_surfaces