7 cvar_t gl_max_size = {CVAR_SAVE, "gl_max_size", "2048", "maximum allowed texture size, can be used to reduce video memory usage, note: this is automatically reduced to match video card capabilities (such as 256 on 3Dfx cards before Voodoo4/5)"};
8 cvar_t gl_picmip = {CVAR_SAVE, "gl_picmip", "0", "reduces resolution of textures by powers of 2, for example 1 will halve width/height, reducing texture memory usage by 75%"};
9 cvar_t r_lerpimages = {CVAR_SAVE, "r_lerpimages", "1", "bilinear filters images when scaling them up to power of 2 size (mode 1), looks better than glquake (mode 0)"};
10 cvar_t r_precachetextures = {CVAR_SAVE, "r_precachetextures", "1", "0 = never upload textures until used, 1 = upload most textures before use (exceptions: rarely used skin colormap layers), 2 = upload all textures before use (can increase texture memory usage significantly)"};
11 cvar_t gl_texture_anisotropy = {CVAR_SAVE, "gl_texture_anisotropy", "1", "anisotropic filtering quality (if supported by hardware), 1 sample (no anisotropy) and 8 sample (8 tap anisotropy) are recommended values"};
12 cvar_t gl_texturecompression = {CVAR_SAVE, "gl_texturecompression", "0", "whether to compress textures, a value of 0 disables compression (even if the individual cvars are 1), 1 enables fast (low quality) compression at startup, 2 enables slow (high quality) compression at startup"};
13 cvar_t gl_texturecompression_color = {CVAR_SAVE, "gl_texturecompression_color", "1", "whether to compress colormap (diffuse) textures"};
14 cvar_t gl_texturecompression_normal = {CVAR_SAVE, "gl_texturecompression_normal", "0", "whether to compress normalmap (normalmap) textures"};
15 cvar_t gl_texturecompression_gloss = {CVAR_SAVE, "gl_texturecompression_gloss", "1", "whether to compress glossmap (specular) textures"};
16 cvar_t gl_texturecompression_glow = {CVAR_SAVE, "gl_texturecompression_glow", "1", "whether to compress glowmap (luma) textures"};
17 cvar_t gl_texturecompression_2d = {CVAR_SAVE, "gl_texturecompression_2d", "0", "whether to compress 2d (hud/menu) textures other than the font"};
18 cvar_t gl_texturecompression_q3bsplightmaps = {CVAR_SAVE, "gl_texturecompression_q3bsplightmaps", "0", "whether to compress lightmaps in q3bsp format levels"};
19 cvar_t gl_texturecompression_q3bspdeluxemaps = {CVAR_SAVE, "gl_texturecompression_q3bspdeluxemaps", "0", "whether to compress deluxemaps in q3bsp format levels (only levels compiled with q3map2 -deluxe have these)"};
20 cvar_t gl_texturecompression_sky = {CVAR_SAVE, "gl_texturecompression_sky", "0", "whether to compress sky textures"};
21 cvar_t gl_texturecompression_lightcubemaps = {CVAR_SAVE, "gl_texturecompression_lightcubemaps", "1", "whether to compress light cubemaps (spotlights and other light projection images)"};
23 int gl_filter_min = GL_LINEAR_MIPMAP_LINEAR;
24 int gl_filter_mag = GL_LINEAR;
27 static mempool_t *texturemempool;
29 // note: this must not conflict with TEXF_ flags in r_textures.h
30 // cleared when a texture is uploaded
31 #define GLTEXF_UPLOAD 0x00010000
32 // bitmask for mismatch checking
33 #define GLTEXF_IMPORTANTBITS (0)
34 // set when image is uploaded and freed
35 #define GLTEXF_DESTROYED 0x00040000
36 // dynamic texture (treat texnum == 0 differently)
37 #define GLTEXF_DYNAMIC 0x00080000
39 typedef struct textypeinfo_s
42 int inputbytesperpixel;
43 int internalbytesperpixel;
44 float glinternalbytesperpixel;
51 static textypeinfo_t textype_palette = {TEXTYPE_PALETTE, 1, 4, 4.0f, GL_BGRA , 3, GL_UNSIGNED_BYTE};
52 static textypeinfo_t textype_palette_alpha = {TEXTYPE_PALETTE, 1, 4, 4.0f, GL_BGRA , 4, GL_UNSIGNED_BYTE};
53 static textypeinfo_t textype_palette_compress = {TEXTYPE_PALETTE, 1, 4, 0.5f, GL_BGRA , GL_COMPRESSED_RGB_ARB, GL_UNSIGNED_BYTE};
54 static textypeinfo_t textype_palette_alpha_compress = {TEXTYPE_PALETTE, 1, 4, 1.0f, GL_BGRA , GL_COMPRESSED_RGBA_ARB, GL_UNSIGNED_BYTE};
55 static textypeinfo_t textype_rgba = {TEXTYPE_RGBA , 4, 4, 4.0f, GL_RGBA , 3, GL_UNSIGNED_BYTE};
56 static textypeinfo_t textype_rgba_alpha = {TEXTYPE_RGBA , 4, 4, 4.0f, GL_RGBA , 4, GL_UNSIGNED_BYTE};
57 static textypeinfo_t textype_rgba_compress = {TEXTYPE_RGBA , 4, 4, 0.5f, GL_RGBA , GL_COMPRESSED_RGB_ARB, GL_UNSIGNED_BYTE};
58 static textypeinfo_t textype_rgba_alpha_compress = {TEXTYPE_RGBA , 4, 4, 1.0f, GL_RGBA , GL_COMPRESSED_RGBA_ARB, GL_UNSIGNED_BYTE};
59 static textypeinfo_t textype_bgra = {TEXTYPE_BGRA , 4, 4, 4.0f, GL_BGRA , 3, GL_UNSIGNED_BYTE};
60 static textypeinfo_t textype_bgra_alpha = {TEXTYPE_BGRA , 4, 4, 4.0f, GL_BGRA , 4, GL_UNSIGNED_BYTE};
61 static textypeinfo_t textype_bgra_compress = {TEXTYPE_BGRA , 4, 4, 0.5f, GL_BGRA , GL_COMPRESSED_RGB_ARB, GL_UNSIGNED_BYTE};
62 static textypeinfo_t textype_bgra_alpha_compress = {TEXTYPE_BGRA , 4, 4, 1.0f, GL_BGRA , GL_COMPRESSED_RGBA_ARB, GL_UNSIGNED_BYTE};
63 static textypeinfo_t textype_shadowmap = {TEXTYPE_SHADOWMAP,4,4, 4.0f, GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT24_ARB, GL_UNSIGNED_INT};
64 static textypeinfo_t textype_alpha = {TEXTYPE_ALPHA , 1, 4, 4.0f, GL_ALPHA , 4, GL_UNSIGNED_BYTE};
65 static textypeinfo_t textype_alpha_compress = {TEXTYPE_ALPHA , 1, 4, 1.0f, GL_ALPHA , GL_COMPRESSED_RGBA_ARB, GL_UNSIGNED_BYTE};
67 typedef enum gltexturetype_e
72 GLTEXTURETYPE_CUBEMAP,
73 GLTEXTURETYPE_RECTANGLE,
78 static int gltexturetypeenums[GLTEXTURETYPE_TOTAL] = {GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_CUBE_MAP_ARB, GL_TEXTURE_RECTANGLE_ARB};
79 static int gltexturetypebindingenums[GLTEXTURETYPE_TOTAL] = {GL_TEXTURE_BINDING_1D, GL_TEXTURE_BINDING_2D, GL_TEXTURE_BINDING_3D, GL_TEXTURE_BINDING_CUBE_MAP_ARB, GL_TEXTURE_BINDING_RECTANGLE_ARB};
80 static int gltexturetypedimensions[GLTEXTURETYPE_TOTAL] = {1, 2, 3, 2, 2};
81 static int cubemapside[6] =
83 GL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB,
84 GL_TEXTURE_CUBE_MAP_NEGATIVE_X_ARB,
85 GL_TEXTURE_CUBE_MAP_POSITIVE_Y_ARB,
86 GL_TEXTURE_CUBE_MAP_NEGATIVE_Y_ARB,
87 GL_TEXTURE_CUBE_MAP_POSITIVE_Z_ARB,
88 GL_TEXTURE_CUBE_MAP_NEGATIVE_Z_ARB
91 typedef struct gltexture_s
93 // this field is exposed to the R_GetTexture macro, for speed reasons
94 // (must be identical in rtexture_t)
95 int texnum; // GL texture slot number
97 // dynamic texture stuff [11/22/2007 Black]
98 // used to hold the texture number of dirty textures
100 updatecallback_t updatecallback;
101 void *updatacallback_data;
102 // --- [11/22/2007 Black]
104 // pointer to texturepool (check this to see if the texture is allocated)
105 struct gltexturepool_s *pool;
106 // pointer to next texture in texturepool chain
107 struct gltexture_s *chain;
108 // name of the texture (this might be removed someday), no duplicates
109 char identifier[MAX_QPATH + 32];
110 // original data size in *inputtexels
111 int inputwidth, inputheight, inputdepth;
112 // copy of the original texture(s) supplied to the upload function, for
113 // delayed uploads (non-precached)
114 unsigned char *inputtexels;
115 // original data size in *inputtexels
117 // flags supplied to the LoadTexture function
118 // (might be altered to remove TEXF_ALPHA), and GLTEXF_ private flags
120 // pointer to one of the textype_ structs
121 textypeinfo_t *textype;
122 // one of the GLTEXTURETYPE_ values
124 // palette if the texture is TEXTYPE_PALETTE
125 const unsigned int *palette;
126 // actual stored texture size after gl_picmip and gl_max_size are applied
127 // (power of 2 if gl_support_arb_texture_non_power_of_two is not supported)
128 int tilewidth, tileheight, tiledepth;
129 // 1 or 6 depending on texturetype
133 // GL_RGB or GL_RGBA or GL_DEPTH_COMPONENT
136 int glinternalformat;
137 // GL_UNSIGNED_BYTE or GL_UNSIGNED_INT or GL_UNSIGNED_SHORT or GL_FLOAT
142 #define TEXTUREPOOL_SENTINEL 0xC0DEDBAD
144 typedef struct gltexturepool_s
146 unsigned int sentinel;
147 struct gltexture_s *gltchain;
148 struct gltexturepool_s *next;
152 static gltexturepool_t *gltexturepoolchain = NULL;
154 static unsigned char *resizebuffer = NULL, *colorconvertbuffer;
155 static int resizebuffersize = 0;
156 static const unsigned char *texturebuffer;
157 static int texturebuffersize = 0;
159 static textypeinfo_t *R_GetTexTypeInfo(textype_t textype, int flags)
161 if ((flags & TEXF_COMPRESS) && gl_texturecompression.integer >= 1 && gl_support_texture_compression)
163 if (flags & TEXF_ALPHA)
167 case TEXTYPE_PALETTE:
168 return &textype_palette_alpha_compress;
170 return &textype_rgba_alpha_compress;
172 return &textype_bgra_alpha_compress;
174 return &textype_alpha_compress;
176 Host_Error("R_GetTexTypeInfo: unknown texture format");
184 case TEXTYPE_PALETTE:
185 return &textype_palette_compress;
187 return &textype_rgba_compress;
189 return &textype_bgra_compress;
191 return &textype_alpha_compress;
193 Host_Error("R_GetTexTypeInfo: unknown texture format");
200 if (flags & TEXF_ALPHA)
204 case TEXTYPE_PALETTE:
205 return &textype_palette_alpha;
207 return &textype_rgba_alpha;
209 return &textype_bgra_alpha;
211 return &textype_alpha;
213 Host_Error("R_GetTexTypeInfo: unknown texture format");
221 case TEXTYPE_PALETTE:
222 return &textype_palette;
224 return &textype_rgba;
226 return &textype_bgra;
227 case TEXTYPE_SHADOWMAP:
228 return &textype_shadowmap;
230 return &textype_alpha;
232 Host_Error("R_GetTexTypeInfo: unknown texture format");
237 return NULL; // this line only to hush compiler warnings
240 // dynamic texture code [11/22/2007 Black]
241 void R_MarkDirtyTexture(rtexture_t *rt) {
242 gltexture_t *glt = (gltexture_t*) rt;
247 // dont do anything if the texture is already dirty (and make sure this *is* a dynamic texture after all!)
248 if( !glt->dirtytexnum && glt->flags & GLTEXF_DYNAMIC ) {
249 glt->dirtytexnum = glt->texnum;
250 // mark it as dirty, so R_RealGetTexture gets called
255 void R_MakeTextureDynamic(rtexture_t *rt, updatecallback_t updatecallback, void *data) {
256 gltexture_t *glt = (gltexture_t*) rt;
261 glt->flags |= GLTEXF_DYNAMIC;
262 glt->updatecallback = updatecallback;
263 glt->updatacallback_data = data;
264 glt->dirtytexnum = 0;
267 static void R_UpdateDynamicTexture(gltexture_t *glt) {
268 glt->texnum = glt->dirtytexnum;
269 // reset dirtytexnum again (not dirty anymore)
270 glt->dirtytexnum = 0;
271 // TODO: now assert that t->texnum != 0 ?
272 if( glt->updatecallback ) {
273 glt->updatecallback( (rtexture_t*) glt, glt->updatacallback_data );
277 static void R_UploadTexture(gltexture_t *t);
279 static void R_PrecacheTexture(gltexture_t *glt)
283 if (glt->flags & TEXF_ALWAYSPRECACHE)
285 else if (r_precachetextures.integer >= 2)
287 else if (r_precachetextures.integer >= 1)
288 if (glt->flags & TEXF_PRECACHE)
292 R_UploadTexture(glt);
295 int R_RealGetTexture(rtexture_t *rt)
300 glt = (gltexture_t *)rt;
301 if (glt->flags & GLTEXF_DYNAMIC)
302 R_UpdateDynamicTexture(glt);
303 if (glt->flags & GLTEXF_UPLOAD)
304 R_UploadTexture(glt);
312 void R_PurgeTexture(rtexture_t *rt)
314 if(rt && !(((gltexture_t*) rt)->flags & TEXF_PERSISTENT)) {
319 void R_FreeTexture(rtexture_t *rt)
321 gltexture_t *glt, **gltpointer;
323 glt = (gltexture_t *)rt;
325 Host_Error("R_FreeTexture: texture == NULL");
327 for (gltpointer = &glt->pool->gltchain;*gltpointer && *gltpointer != glt;gltpointer = &(*gltpointer)->chain);
328 if (*gltpointer == glt)
329 *gltpointer = glt->chain;
331 Host_Error("R_FreeTexture: texture \"%s\" not linked in pool", glt->identifier);
333 if (!(glt->flags & GLTEXF_UPLOAD))
336 qglDeleteTextures(1, (GLuint *)&glt->texnum);CHECKGLERROR
339 if (glt->inputtexels)
340 Mem_Free(glt->inputtexels);
344 rtexturepool_t *R_AllocTexturePool(void)
346 gltexturepool_t *pool;
347 if (texturemempool == NULL)
349 pool = (gltexturepool_t *)Mem_Alloc(texturemempool, sizeof(gltexturepool_t));
352 pool->next = gltexturepoolchain;
353 gltexturepoolchain = pool;
354 pool->sentinel = TEXTUREPOOL_SENTINEL;
355 return (rtexturepool_t *)pool;
358 void R_FreeTexturePool(rtexturepool_t **rtexturepool)
360 gltexturepool_t *pool, **poolpointer;
361 if (rtexturepool == NULL)
363 if (*rtexturepool == NULL)
365 pool = (gltexturepool_t *)(*rtexturepool);
366 *rtexturepool = NULL;
367 if (pool->sentinel != TEXTUREPOOL_SENTINEL)
368 Host_Error("R_FreeTexturePool: pool already freed");
369 for (poolpointer = &gltexturepoolchain;*poolpointer && *poolpointer != pool;poolpointer = &(*poolpointer)->next);
370 if (*poolpointer == pool)
371 *poolpointer = pool->next;
373 Host_Error("R_FreeTexturePool: pool not linked");
374 while (pool->gltchain)
375 R_FreeTexture((rtexture_t *)pool->gltchain);
380 typedef struct glmode_s
383 int minification, magnification;
387 static glmode_t modes[6] =
389 {"GL_NEAREST", GL_NEAREST, GL_NEAREST},
390 {"GL_LINEAR", GL_LINEAR, GL_LINEAR},
391 {"GL_NEAREST_MIPMAP_NEAREST", GL_NEAREST_MIPMAP_NEAREST, GL_NEAREST},
392 {"GL_LINEAR_MIPMAP_NEAREST", GL_LINEAR_MIPMAP_NEAREST, GL_LINEAR},
393 {"GL_NEAREST_MIPMAP_LINEAR", GL_NEAREST_MIPMAP_LINEAR, GL_NEAREST},
394 {"GL_LINEAR_MIPMAP_LINEAR", GL_LINEAR_MIPMAP_LINEAR, GL_LINEAR}
397 static void GL_TextureMode_f (void)
402 gltexturepool_t *pool;
406 for (i = 0;i < 6;i++)
408 if (gl_filter_min == modes[i].minification)
410 Con_Printf("%s\n", modes[i].name);
414 Con_Print("current filter is unknown???\n");
418 for (i = 0;i < 6;i++)
419 if (!strcasecmp (modes[i].name, Cmd_Argv(1) ) )
423 Con_Print("bad filter name\n");
427 gl_filter_min = modes[i].minification;
428 gl_filter_mag = modes[i].magnification;
430 // change all the existing mipmap texture objects
431 // FIXME: force renderer(/client/something?) restart instead?
433 for (pool = gltexturepoolchain;pool;pool = pool->next)
435 for (glt = pool->gltchain;glt;glt = glt->chain)
437 // only update already uploaded images
438 if (!(glt->flags & (GLTEXF_UPLOAD | TEXF_FORCENEAREST | TEXF_FORCELINEAR)))
440 qglGetIntegerv(gltexturetypebindingenums[glt->texturetype], &oldbindtexnum);CHECKGLERROR
441 qglBindTexture(gltexturetypeenums[glt->texturetype], glt->texnum);CHECKGLERROR
442 if (glt->flags & TEXF_MIPMAP)
444 qglTexParameteri(gltexturetypeenums[glt->texturetype], GL_TEXTURE_MIN_FILTER, gl_filter_min);CHECKGLERROR
448 qglTexParameteri(gltexturetypeenums[glt->texturetype], GL_TEXTURE_MIN_FILTER, gl_filter_mag);CHECKGLERROR
450 qglTexParameteri(gltexturetypeenums[glt->texturetype], GL_TEXTURE_MAG_FILTER, gl_filter_mag);CHECKGLERROR
451 qglBindTexture(gltexturetypeenums[glt->texturetype], oldbindtexnum);CHECKGLERROR
457 static void GL_Texture_CalcImageSize(int texturetype, int flags, int inwidth, int inheight, int indepth, int *outwidth, int *outheight, int *outdepth)
459 int picmip = 0, maxsize = 0, width2 = 1, height2 = 1, depth2 = 1;
461 if (gl_max_size.integer > gl_max_texture_size)
462 Cvar_SetValue("gl_max_size", gl_max_texture_size);
467 case GLTEXTURETYPE_1D:
468 case GLTEXTURETYPE_2D:
469 maxsize = gl_max_texture_size;
471 case GLTEXTURETYPE_3D:
472 maxsize = gl_max_3d_texture_size;
474 case GLTEXTURETYPE_CUBEMAP:
475 maxsize = gl_max_cube_map_texture_size;
479 if (flags & TEXF_PICMIP)
481 maxsize = min(maxsize, gl_max_size.integer);
482 picmip = gl_picmip.integer;
487 if (gl_support_arb_texture_non_power_of_two)
488 width2 = min(inwidth >> picmip, maxsize);
491 for (width2 = 1;width2 < inwidth;width2 <<= 1);
492 for (width2 >>= picmip;width2 > maxsize;width2 >>= 1);
494 *outwidth = max(1, width2);
498 if (gl_support_arb_texture_non_power_of_two)
499 height2 = min(inheight >> picmip, maxsize);
502 for (height2 = 1;height2 < inheight;height2 <<= 1);
503 for (height2 >>= picmip;height2 > maxsize;height2 >>= 1);
505 *outheight = max(1, height2);
509 if (gl_support_arb_texture_non_power_of_two)
510 depth2 = min(indepth >> picmip, maxsize);
513 for (depth2 = 1;depth2 < indepth;depth2 <<= 1);
514 for (depth2 >>= picmip;depth2 > maxsize;depth2 >>= 1);
516 *outdepth = max(1, depth2);
521 static int R_CalcTexelDataSize (gltexture_t *glt)
523 int width2, height2, depth2, size;
525 GL_Texture_CalcImageSize(glt->texturetype, glt->flags, glt->inputwidth, glt->inputheight, glt->inputdepth, &width2, &height2, &depth2);
527 size = width2 * height2 * depth2;
529 if (glt->flags & TEXF_MIPMAP)
531 while (width2 > 1 || height2 > 1 || depth2 > 1)
539 size += width2 * height2 * depth2;
543 return (int)(size * glt->textype->glinternalbytesperpixel) * glt->sides;
546 void R_TextureStats_Print(qboolean printeach, qboolean printpool, qboolean printtotal)
550 int pooltotal = 0, pooltotalt = 0, pooltotalp = 0, poolloaded = 0, poolloadedt = 0, poolloadedp = 0;
551 int sumtotal = 0, sumtotalt = 0, sumtotalp = 0, sumloaded = 0, sumloadedt = 0, sumloadedp = 0;
553 gltexturepool_t *pool;
555 Con_Print("glsize input loaded mip alpha name\n");
556 for (pool = gltexturepoolchain;pool;pool = pool->next)
564 for (glt = pool->gltchain;glt;glt = glt->chain)
566 glsize = R_CalcTexelDataSize(glt);
567 isloaded = !(glt->flags & GLTEXF_UPLOAD);
569 pooltotalt += glsize;
570 pooltotalp += glt->inputdatasize;
574 poolloadedt += glsize;
575 poolloadedp += glt->inputdatasize;
578 Con_Printf("%c%4i%c%c%4i%c %s %s %s %s\n", isloaded ? '[' : ' ', (glsize + 1023) / 1024, isloaded ? ']' : ' ', glt->inputtexels ? '[' : ' ', (glt->inputdatasize + 1023) / 1024, glt->inputtexels ? ']' : ' ', isloaded ? "loaded" : " ", (glt->flags & TEXF_MIPMAP) ? "mip" : " ", (glt->flags & TEXF_ALPHA) ? "alpha" : " ", glt->identifier);
581 Con_Printf("texturepool %10p total: %i (%.3fMB, %.3fMB original), uploaded %i (%.3fMB, %.3fMB original), upload on demand %i (%.3fMB, %.3fMB original)\n", (void *)pool, pooltotal, pooltotalt / 1048576.0, pooltotalp / 1048576.0, poolloaded, poolloadedt / 1048576.0, poolloadedp / 1048576.0, pooltotal - poolloaded, (pooltotalt - poolloadedt) / 1048576.0, (pooltotalp - poolloadedp) / 1048576.0);
582 sumtotal += pooltotal;
583 sumtotalt += pooltotalt;
584 sumtotalp += pooltotalp;
585 sumloaded += poolloaded;
586 sumloadedt += poolloadedt;
587 sumloadedp += poolloadedp;
590 Con_Printf("textures total: %i (%.3fMB, %.3fMB original), uploaded %i (%.3fMB, %.3fMB original), upload on demand %i (%.3fMB, %.3fMB original)\n", sumtotal, sumtotalt / 1048576.0, sumtotalp / 1048576.0, sumloaded, sumloadedt / 1048576.0, sumloadedp / 1048576.0, sumtotal - sumloaded, (sumtotalt - sumloadedt) / 1048576.0, (sumtotalp - sumloadedp) / 1048576.0);
593 static void R_TextureStats_f(void)
595 R_TextureStats_Print(true, true, true);
598 static void r_textures_start(void)
600 // LordHavoc: allow any alignment
602 qglPixelStorei(GL_UNPACK_ALIGNMENT, 1);CHECKGLERROR
603 qglPixelStorei(GL_PACK_ALIGNMENT, 1);CHECKGLERROR
605 texturemempool = Mem_AllocPool("texture management", 0, NULL);
607 // Disable JPEG screenshots if the DLL isn't loaded
608 if (! JPEG_OpenLibrary ())
609 Cvar_SetValueQuick (&scr_screenshot_jpeg, 0);
610 // TODO: support png screenshots?
614 static void r_textures_shutdown(void)
616 rtexturepool_t *temp;
618 JPEG_CloseLibrary ();
620 while(gltexturepoolchain)
622 temp = (rtexturepool_t *) gltexturepoolchain;
623 R_FreeTexturePool(&temp);
626 resizebuffersize = 0;
627 texturebuffersize = 0;
629 colorconvertbuffer = NULL;
630 texturebuffer = NULL;
631 Mem_FreePool(&texturemempool);
634 static void r_textures_newmap(void)
638 void R_Textures_Init (void)
640 Cmd_AddCommand("gl_texturemode", &GL_TextureMode_f, "set texture filtering mode (GL_NEAREST, GL_LINEAR, GL_LINEAR_MIPMAP_LINEAR, etc)");
641 Cmd_AddCommand("r_texturestats", R_TextureStats_f, "print information about all loaded textures and some statistics");
642 Cvar_RegisterVariable (&gl_max_size);
643 Cvar_RegisterVariable (&gl_picmip);
644 Cvar_RegisterVariable (&r_lerpimages);
645 Cvar_RegisterVariable (&r_precachetextures);
646 Cvar_RegisterVariable (&gl_texture_anisotropy);
647 Cvar_RegisterVariable (&gl_texturecompression);
648 Cvar_RegisterVariable (&gl_texturecompression_color);
649 Cvar_RegisterVariable (&gl_texturecompression_normal);
650 Cvar_RegisterVariable (&gl_texturecompression_gloss);
651 Cvar_RegisterVariable (&gl_texturecompression_glow);
652 Cvar_RegisterVariable (&gl_texturecompression_2d);
653 Cvar_RegisterVariable (&gl_texturecompression_q3bsplightmaps);
654 Cvar_RegisterVariable (&gl_texturecompression_q3bspdeluxemaps);
655 Cvar_RegisterVariable (&gl_texturecompression_sky);
656 Cvar_RegisterVariable (&gl_texturecompression_lightcubemaps);
658 R_RegisterModule("R_Textures", r_textures_start, r_textures_shutdown, r_textures_newmap);
661 void R_Textures_Frame (void)
663 static int old_aniso = 0;
665 // could do procedural texture animation here, if we keep track of which
666 // textures were accessed this frame...
668 // free the resize buffers
669 resizebuffersize = 0;
672 Mem_Free(resizebuffer);
675 if (colorconvertbuffer)
677 Mem_Free(colorconvertbuffer);
678 colorconvertbuffer = NULL;
681 if (old_aniso != gl_texture_anisotropy.integer)
684 gltexturepool_t *pool;
687 old_aniso = bound(1, gl_texture_anisotropy.integer, gl_max_anisotropy);
689 Cvar_SetValueQuick(&gl_texture_anisotropy, old_aniso);
692 for (pool = gltexturepoolchain;pool;pool = pool->next)
694 for (glt = pool->gltchain;glt;glt = glt->chain)
696 // only update already uploaded images
697 if ((glt->flags & (GLTEXF_UPLOAD | TEXF_MIPMAP)) == TEXF_MIPMAP)
699 qglGetIntegerv(gltexturetypebindingenums[glt->texturetype], &oldbindtexnum);CHECKGLERROR
701 qglBindTexture(gltexturetypeenums[glt->texturetype], glt->texnum);CHECKGLERROR
702 qglTexParameteri(gltexturetypeenums[glt->texturetype], GL_TEXTURE_MAX_ANISOTROPY_EXT, old_aniso);CHECKGLERROR
704 qglBindTexture(gltexturetypeenums[glt->texturetype], oldbindtexnum);CHECKGLERROR
711 void R_MakeResizeBufferBigger(int size)
713 if (resizebuffersize < size)
715 resizebuffersize = size;
717 Mem_Free(resizebuffer);
718 if (colorconvertbuffer)
719 Mem_Free(colorconvertbuffer);
720 resizebuffer = (unsigned char *)Mem_Alloc(texturemempool, resizebuffersize);
721 colorconvertbuffer = (unsigned char *)Mem_Alloc(texturemempool, resizebuffersize);
722 if (!resizebuffer || !colorconvertbuffer)
723 Host_Error("R_Upload: out of memory");
727 static void GL_SetupTextureParameters(int flags, textype_t textype, int texturetype)
729 int textureenum = gltexturetypeenums[texturetype];
730 int wrapmode = ((flags & TEXF_CLAMP) && gl_support_clamptoedge) ? GL_CLAMP_TO_EDGE : GL_REPEAT;
734 if (gl_support_anisotropy && (flags & TEXF_MIPMAP))
736 int aniso = bound(1, gl_texture_anisotropy.integer, gl_max_anisotropy);
737 if (gl_texture_anisotropy.integer != aniso)
738 Cvar_SetValueQuick(&gl_texture_anisotropy, aniso);
739 qglTexParameteri(textureenum, GL_TEXTURE_MAX_ANISOTROPY_EXT, aniso);CHECKGLERROR
741 qglTexParameteri(textureenum, GL_TEXTURE_WRAP_S, wrapmode);CHECKGLERROR
742 qglTexParameteri(textureenum, GL_TEXTURE_WRAP_T, wrapmode);CHECKGLERROR
743 if (gltexturetypedimensions[texturetype] >= 3)
745 qglTexParameteri(textureenum, GL_TEXTURE_WRAP_R, wrapmode);CHECKGLERROR
749 if (flags & TEXF_FORCENEAREST)
751 if (flags & TEXF_MIPMAP)
753 qglTexParameteri(textureenum, GL_TEXTURE_MIN_FILTER, GL_NEAREST_MIPMAP_NEAREST);CHECKGLERROR
757 qglTexParameteri(textureenum, GL_TEXTURE_MIN_FILTER, GL_NEAREST);CHECKGLERROR
759 qglTexParameteri(textureenum, GL_TEXTURE_MAG_FILTER, GL_NEAREST);CHECKGLERROR
761 else if (flags & TEXF_FORCELINEAR)
763 if (flags & TEXF_MIPMAP)
765 if (gl_filter_min == GL_NEAREST_MIPMAP_LINEAR || gl_filter_min == GL_LINEAR_MIPMAP_LINEAR)
767 qglTexParameteri(textureenum, GL_TEXTURE_MIN_FILTER, GL_LINEAR_MIPMAP_LINEAR);CHECKGLERROR
771 qglTexParameteri(textureenum, GL_TEXTURE_MIN_FILTER, GL_LINEAR_MIPMAP_NEAREST);CHECKGLERROR
776 qglTexParameteri(textureenum, GL_TEXTURE_MIN_FILTER, GL_LINEAR);CHECKGLERROR
778 qglTexParameteri(textureenum, GL_TEXTURE_MAG_FILTER, GL_LINEAR);CHECKGLERROR
782 if (flags & TEXF_MIPMAP)
784 qglTexParameteri(textureenum, GL_TEXTURE_MIN_FILTER, gl_filter_min);CHECKGLERROR
788 qglTexParameteri(textureenum, GL_TEXTURE_MIN_FILTER, gl_filter_mag);CHECKGLERROR
790 qglTexParameteri(textureenum, GL_TEXTURE_MAG_FILTER, gl_filter_mag);CHECKGLERROR
793 if (textype == TEXTYPE_SHADOWMAP)
795 if (gl_support_arb_shadow)
797 if (flags & TEXF_COMPARE)
799 qglTexParameteri(textureenum, GL_TEXTURE_COMPARE_MODE_ARB, GL_COMPARE_R_TO_TEXTURE_ARB);CHECKGLERROR
803 qglTexParameteri(textureenum, GL_TEXTURE_COMPARE_MODE_ARB, GL_NONE);CHECKGLERROR
805 qglTexParameteri(textureenum, GL_TEXTURE_COMPARE_FUNC_ARB, GL_LEQUAL);CHECKGLERROR
807 qglTexParameteri(textureenum, GL_DEPTH_TEXTURE_MODE_ARB, GL_LUMINANCE);CHECKGLERROR
813 static void R_Upload(gltexture_t *glt, const unsigned char *data, int fragx, int fragy, int fragz, int fragwidth, int fragheight, int fragdepth)
815 int i, mip, width, height, depth;
817 const unsigned char *prevbuffer;
822 // we need to restore the texture binding after finishing the upload
823 qglGetIntegerv(gltexturetypebindingenums[glt->texturetype], &oldbindtexnum);CHECKGLERROR
824 qglBindTexture(gltexturetypeenums[glt->texturetype], glt->texnum);CHECKGLERROR
826 // these are rounded up versions of the size to do better resampling
827 if (gl_support_arb_texture_non_power_of_two || glt->texturetype == GLTEXTURETYPE_RECTANGLE)
829 width = glt->inputwidth;
830 height = glt->inputheight;
831 depth = glt->inputdepth;
835 for (width = 1;width < glt->inputwidth ;width <<= 1);
836 for (height = 1;height < glt->inputheight;height <<= 1);
837 for (depth = 1;depth < glt->inputdepth ;depth <<= 1);
840 R_MakeResizeBufferBigger(width * height * depth * glt->sides * glt->bytesperpixel);
841 R_MakeResizeBufferBigger(fragwidth * fragheight * fragdepth * glt->sides * glt->bytesperpixel);
843 if (prevbuffer == NULL)
845 memset(resizebuffer, 0, fragwidth * fragheight * fragdepth * glt->bytesperpixel);
846 prevbuffer = resizebuffer;
848 else if (glt->textype->textype == TEXTYPE_PALETTE)
850 // promote paletted to BGRA, so we only have to worry about BGRA in the rest of this code
851 Image_Copy8bitBGRA(prevbuffer, colorconvertbuffer, fragwidth * fragheight * fragdepth * glt->sides, glt->palette);
852 prevbuffer = colorconvertbuffer;
855 if ((glt->flags & (TEXF_MIPMAP | TEXF_PICMIP | GLTEXF_UPLOAD)) == 0 && glt->inputwidth == glt->tilewidth && glt->inputheight == glt->tileheight && glt->inputdepth == glt->tiledepth)
857 // update a portion of the image
858 switch(glt->texturetype)
860 case GLTEXTURETYPE_1D:
861 qglTexSubImage1D(GL_TEXTURE_1D, 0, fragx, fragwidth, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
863 case GLTEXTURETYPE_2D:
864 qglTexSubImage2D(GL_TEXTURE_2D, 0, fragx, fragy, fragwidth, fragheight, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
866 case GLTEXTURETYPE_3D:
867 qglTexSubImage3D(GL_TEXTURE_3D, 0, fragx, fragy, fragz, fragwidth, fragheight, fragdepth, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
870 Host_Error("R_Upload: partial update of type other than 1D, 2D, or 3D");
876 if (fragx || fragy || fragz || glt->inputwidth != fragwidth || glt->inputheight != fragheight || glt->inputdepth != fragdepth)
877 Host_Error("R_Upload: partial update not allowed on initial upload or in combination with PICMIP or MIPMAP\n");
879 // upload the image for the first time
880 glt->flags &= ~GLTEXF_UPLOAD;
882 // cubemaps contain multiple images and thus get processed a bit differently
883 if (glt->texturetype != GLTEXTURETYPE_CUBEMAP)
885 if (glt->inputwidth != width || glt->inputheight != height || glt->inputdepth != depth)
887 Image_Resample32(prevbuffer, glt->inputwidth, glt->inputheight, glt->inputdepth, resizebuffer, width, height, depth, r_lerpimages.integer);
888 prevbuffer = resizebuffer;
891 while (width > glt->tilewidth || height > glt->tileheight || depth > glt->tiledepth)
893 Image_MipReduce32(prevbuffer, resizebuffer, &width, &height, &depth, glt->tilewidth, glt->tileheight, glt->tiledepth);
894 prevbuffer = resizebuffer;
898 if (gl_support_texture_compression)
900 if (gl_texturecompression.integer >= 2)
901 qglHint(GL_TEXTURE_COMPRESSION_HINT_ARB, GL_NICEST);
903 qglHint(GL_TEXTURE_COMPRESSION_HINT_ARB, GL_FASTEST);
906 switch(glt->texturetype)
908 case GLTEXTURETYPE_1D:
909 qglTexImage1D(GL_TEXTURE_1D, mip++, glt->glinternalformat, width, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
910 if (glt->flags & TEXF_MIPMAP)
912 while (width > 1 || height > 1 || depth > 1)
914 Image_MipReduce32(prevbuffer, resizebuffer, &width, &height, &depth, 1, 1, 1);
915 prevbuffer = resizebuffer;
916 qglTexImage1D(GL_TEXTURE_1D, mip++, glt->glinternalformat, width, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
920 case GLTEXTURETYPE_2D:
921 qglTexImage2D(GL_TEXTURE_2D, mip++, glt->glinternalformat, width, height, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
922 if (glt->flags & TEXF_MIPMAP)
924 while (width > 1 || height > 1 || depth > 1)
926 Image_MipReduce32(prevbuffer, resizebuffer, &width, &height, &depth, 1, 1, 1);
927 prevbuffer = resizebuffer;
928 qglTexImage2D(GL_TEXTURE_2D, mip++, glt->glinternalformat, width, height, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
932 case GLTEXTURETYPE_3D:
933 qglTexImage3D(GL_TEXTURE_3D, mip++, glt->glinternalformat, width, height, depth, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
934 if (glt->flags & TEXF_MIPMAP)
936 while (width > 1 || height > 1 || depth > 1)
938 Image_MipReduce32(prevbuffer, resizebuffer, &width, &height, &depth, 1, 1, 1);
939 prevbuffer = resizebuffer;
940 qglTexImage3D(GL_TEXTURE_3D, mip++, glt->glinternalformat, width, height, depth, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
944 case GLTEXTURETYPE_CUBEMAP:
945 // convert and upload each side in turn,
946 // from a continuous block of input texels
947 texturebuffer = (unsigned char *)prevbuffer;
948 for (i = 0;i < 6;i++)
950 prevbuffer = texturebuffer;
951 texturebuffer += glt->inputwidth * glt->inputheight * glt->inputdepth * glt->textype->inputbytesperpixel;
952 if (glt->inputwidth != width || glt->inputheight != height || glt->inputdepth != depth)
954 Image_Resample32(prevbuffer, glt->inputwidth, glt->inputheight, glt->inputdepth, resizebuffer, width, height, depth, r_lerpimages.integer);
955 prevbuffer = resizebuffer;
958 while (width > glt->tilewidth || height > glt->tileheight || depth > glt->tiledepth)
960 Image_MipReduce32(prevbuffer, resizebuffer, &width, &height, &depth, glt->tilewidth, glt->tileheight, glt->tiledepth);
961 prevbuffer = resizebuffer;
964 qglTexImage2D(cubemapside[i], mip++, glt->glinternalformat, width, height, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
965 if (glt->flags & TEXF_MIPMAP)
967 while (width > 1 || height > 1 || depth > 1)
969 Image_MipReduce32(prevbuffer, resizebuffer, &width, &height, &depth, 1, 1, 1);
970 prevbuffer = resizebuffer;
971 qglTexImage2D(cubemapside[i], mip++, glt->glinternalformat, width, height, 0, glt->glformat, glt->gltype, prevbuffer);CHECKGLERROR
976 case GLTEXTURETYPE_RECTANGLE:
977 qglTexImage2D(GL_TEXTURE_RECTANGLE_ARB, mip++, glt->glinternalformat, width, height, 0, glt->glformat, glt->gltype, NULL);CHECKGLERROR
980 GL_SetupTextureParameters(glt->flags, glt->textype->textype, glt->texturetype);
982 qglBindTexture(gltexturetypeenums[glt->texturetype], oldbindtexnum);CHECKGLERROR
985 static void R_UploadTexture (gltexture_t *glt)
987 if (!(glt->flags & GLTEXF_UPLOAD))
991 qglGenTextures(1, (GLuint *)&glt->texnum);CHECKGLERROR
992 R_Upload(glt, glt->inputtexels, 0, 0, 0, glt->inputwidth, glt->inputheight, glt->inputdepth);
993 if (glt->inputtexels)
995 Mem_Free(glt->inputtexels);
996 glt->inputtexels = NULL;
997 glt->flags |= GLTEXF_DESTROYED;
999 else if (glt->flags & GLTEXF_DESTROYED)
1000 Con_Printf("R_UploadTexture: Texture %s already uploaded and destroyed. Can not upload original image again. Uploaded blank texture.\n", glt->identifier);
1003 static rtexture_t *R_SetupTexture(rtexturepool_t *rtexturepool, const char *identifier, int width, int height, int depth, int sides, int flags, textype_t textype, int texturetype, const unsigned char *data, const unsigned int *palette)
1007 gltexturepool_t *pool = (gltexturepool_t *)rtexturepool;
1008 textypeinfo_t *texinfo;
1010 if (cls.state == ca_dedicated)
1013 if (texturetype == GLTEXTURETYPE_RECTANGLE && !gl_texturerectangle)
1015 Con_Printf ("R_LoadTexture: rectangle texture not supported by driver\n");
1018 if (texturetype == GLTEXTURETYPE_CUBEMAP && !gl_texturecubemap)
1020 Con_Printf ("R_LoadTexture: cubemap texture not supported by driver\n");
1023 if (texturetype == GLTEXTURETYPE_3D && !gl_texture3d)
1025 Con_Printf ("R_LoadTexture: 3d texture not supported by driver\n");
1029 texinfo = R_GetTexTypeInfo(textype, flags);
1030 size = width * height * depth * sides * texinfo->inputbytesperpixel;
1033 Con_Printf ("R_LoadTexture: bogus texture size (%dx%dx%dx%dbppx%dsides = %d bytes)\n", width, height, depth, texinfo->inputbytesperpixel * 8, sides, size);
1037 // clear the alpha flag if the texture has no transparent pixels
1040 case TEXTYPE_PALETTE:
1041 if (flags & TEXF_ALPHA)
1043 flags &= ~TEXF_ALPHA;
1046 for (i = 0;i < size;i++)
1048 if (((unsigned char *)&palette[data[i]])[3] < 255)
1050 flags |= TEXF_ALPHA;
1059 if (flags & TEXF_ALPHA)
1061 flags &= ~TEXF_ALPHA;
1064 for (i = 3;i < size;i += 4)
1068 flags |= TEXF_ALPHA;
1075 case TEXTYPE_SHADOWMAP:
1078 flags |= TEXF_ALPHA;
1081 Host_Error("R_LoadTexture: unknown texture type");
1084 glt = (gltexture_t *)Mem_Alloc(texturemempool, sizeof(gltexture_t));
1086 strlcpy (glt->identifier, identifier, sizeof(glt->identifier));
1088 glt->chain = pool->gltchain;
1089 pool->gltchain = glt;
1090 glt->inputwidth = width;
1091 glt->inputheight = height;
1092 glt->inputdepth = depth;
1093 glt->flags = flags | GLTEXF_UPLOAD;
1094 glt->textype = texinfo;
1095 glt->texturetype = texturetype;
1096 glt->inputdatasize = size;
1097 glt->palette = palette;
1098 glt->glinternalformat = texinfo->glinternalformat;
1099 glt->glformat = texinfo->glformat;
1100 glt->gltype = texinfo->gltype;
1101 glt->bytesperpixel = texinfo->internalbytesperpixel;
1102 glt->sides = glt->texturetype == GLTEXTURETYPE_CUBEMAP ? 6 : 1;
1104 // init the dynamic texture attributes, too [11/22/2007 Black]
1105 glt->dirtytexnum = 0;
1106 glt->updatecallback = NULL;
1107 glt->updatacallback_data = NULL;
1111 glt->inputtexels = (unsigned char *)Mem_Alloc(texturemempool, size);
1112 memcpy(glt->inputtexels, data, size);
1115 glt->inputtexels = NULL;
1117 GL_Texture_CalcImageSize(glt->texturetype, glt->flags, glt->inputwidth, glt->inputheight, glt->inputdepth, &glt->tilewidth, &glt->tileheight, &glt->tiledepth);
1118 R_PrecacheTexture(glt);
1120 // texture converting and uploading can take a while, so make sure we're sending keepalives
1121 CL_KeepaliveMessage(false);
1123 return (rtexture_t *)glt;
1126 rtexture_t *R_LoadTexture1D(rtexturepool_t *rtexturepool, const char *identifier, int width, const unsigned char *data, textype_t textype, int flags, const unsigned int *palette)
1128 return R_SetupTexture(rtexturepool, identifier, width, 1, 1, 1, flags, textype, GLTEXTURETYPE_1D, data, palette);
1131 rtexture_t *R_LoadTexture2D(rtexturepool_t *rtexturepool, const char *identifier, int width, int height, const unsigned char *data, textype_t textype, int flags, const unsigned int *palette)
1133 return R_SetupTexture(rtexturepool, identifier, width, height, 1, 1, flags, textype, GLTEXTURETYPE_2D, data, palette);
1136 rtexture_t *R_LoadTexture3D(rtexturepool_t *rtexturepool, const char *identifier, int width, int height, int depth, const unsigned char *data, textype_t textype, int flags, const unsigned int *palette)
1138 return R_SetupTexture(rtexturepool, identifier, width, height, depth, 1, flags, textype, GLTEXTURETYPE_3D, data, palette);
1141 rtexture_t *R_LoadTextureCubeMap(rtexturepool_t *rtexturepool, const char *identifier, int width, const unsigned char *data, textype_t textype, int flags, const unsigned int *palette)
1143 return R_SetupTexture(rtexturepool, identifier, width, width, 1, 6, flags, textype, GLTEXTURETYPE_CUBEMAP, data, palette);
1146 rtexture_t *R_LoadTextureShadowMapRectangle(rtexturepool_t *rtexturepool, const char *identifier, int width, int height, qboolean filter)
1148 return R_SetupTexture(rtexturepool, identifier, width, height, 1, 1, TEXF_ALWAYSPRECACHE | TEXF_CLAMP | (filter ? TEXF_FORCELINEAR | TEXF_COMPARE : TEXF_FORCENEAREST), TEXTYPE_SHADOWMAP, GLTEXTURETYPE_RECTANGLE, NULL, NULL);
1151 rtexture_t *R_LoadTextureShadowMap2D(rtexturepool_t *rtexturepool, const char *identifier, int width, int height, qboolean filter)
1153 return R_SetupTexture(rtexturepool, identifier, width, height, 1, 1, TEXF_ALWAYSPRECACHE | TEXF_CLAMP | (filter ? TEXF_FORCELINEAR | TEXF_COMPARE : TEXF_FORCENEAREST), TEXTYPE_SHADOWMAP, GLTEXTURETYPE_2D, NULL, NULL);
1156 rtexture_t *R_LoadTextureShadowMapCube(rtexturepool_t *rtexturepool, const char *identifier, int width, qboolean filter)
1158 return R_SetupTexture(rtexturepool, identifier, width, width, 1, 6, TEXF_ALWAYSPRECACHE | TEXF_CLAMP | (filter ? TEXF_FORCELINEAR | TEXF_COMPARE : TEXF_FORCENEAREST), TEXTYPE_SHADOWMAP, GLTEXTURETYPE_CUBEMAP, NULL, NULL);
1161 int R_TextureHasAlpha(rtexture_t *rt)
1163 return rt ? (((gltexture_t *)rt)->flags & TEXF_ALPHA) != 0 : false;
1166 int R_TextureWidth(rtexture_t *rt)
1168 return rt ? ((gltexture_t *)rt)->inputwidth : 0;
1171 int R_TextureHeight(rtexture_t *rt)
1173 return rt ? ((gltexture_t *)rt)->inputheight : 0;
1176 void R_UpdateTexture(rtexture_t *rt, const unsigned char *data, int x, int y, int width, int height)
1180 Host_Error("R_UpdateTexture: no texture supplied");
1182 Host_Error("R_UpdateTexture: no data supplied");
1183 glt = (gltexture_t *)rt;
1185 // we need it to be uploaded before we can update a part of it
1186 if (glt->flags & GLTEXF_UPLOAD)
1187 R_UploadTexture(glt);
1189 // update part of the texture
1190 R_Upload(glt, data, x, y, 0, width, height, 1);
1193 void R_ClearTexture (rtexture_t *rt)
1195 gltexture_t *glt = (gltexture_t *)rt;
1197 R_Upload( glt, NULL, 0, 0, 0, glt->tilewidth, glt->tileheight, glt->tiledepth );