/* =========================================================================== Doom 3 BFG Edition GPL Source Code Copyright (C) 1993-2012 id Software LLC, a ZeniMax Media company. This file is part of the Doom 3 BFG Edition GPL Source Code ("Doom 3 BFG Edition Source Code"). Doom 3 BFG Edition Source Code is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Doom 3 BFG Edition Source Code is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Doom 3 BFG Edition Source Code. If not, see . In addition, the Doom 3 BFG Edition Source Code is also subject to certain additional terms. You should have received a copy of these additional terms immediately following the terms and conditions of the GNU General Public License which accompanied the Doom 3 BFG Edition Source Code. If not, please request a copy in writing from id Software at the address below. If you have questions concerning this license or the applicable additional terms, you may contact in writing id Software LLC, c/o ZeniMax Media Inc., Suite 120, Rockville, Maryland 20850 USA. =========================================================================== */ #pragma hdrstop #include "../idlib/precompiled.h" #include "tr_local.h" // do this with a pointer, in case we want to make the actual manager // a private virtual subclass idImageManager imageManager; idImageManager * globalImages = &imageManager; idCVar preLoad_Images( "preLoad_Images", "1", CVAR_SYSTEM | CVAR_BOOL, "preload images during beginlevelload" ); /* =============== R_ReloadImages_f Regenerate all images that came directly from files that have changed, so any saved changes will show up in place. New r_texturesize/r_texturedepth variables will take effect on reload reloadImages =============== */ void R_ReloadImages_f( const idCmdArgs &args ) { bool all = false; if ( args.Argc() == 2 ) { if ( !idStr::Icmp( args.Argv(1), "all" ) ) { all = true; } else { common->Printf( "USAGE: reloadImages \n" ); return; } } globalImages->ReloadImages( all ); } typedef struct { idImage *image; int size; int index; } sortedImage_t; /* ======================= R_QsortImageSizes ======================= */ static int R_QsortImageSizes( const void *a, const void *b ) { const sortedImage_t *ea, *eb; ea = (sortedImage_t *)a; eb = (sortedImage_t *)b; if ( ea->size > eb->size ) { return -1; } if ( ea->size < eb->size ) { return 1; } return idStr::Icmp( ea->image->GetName(), eb->image->GetName() ); } /* ======================= R_QsortImageName ======================= */ static int R_QsortImageName( const void* a, const void* b ) { const sortedImage_t *ea, *eb; ea = (sortedImage_t *)a; eb = (sortedImage_t *)b; return idStr::Icmp( ea->image->GetName(), eb->image->GetName() ); } /* =============== R_ListImages_f =============== */ void R_ListImages_f( const idCmdArgs &args ) { int i, partialSize; idImage *image; int totalSize; int count = 0; bool uncompressedOnly = false; bool unloaded = false; bool failed = false; bool sorted = false; bool duplicated = false; bool overSized = false; bool sortByName = false; if ( args.Argc() == 1 ) { } else if ( args.Argc() == 2 ) { if ( idStr::Icmp( args.Argv( 1 ), "uncompressed" ) == 0 ) { uncompressedOnly = true; } else if ( idStr::Icmp( args.Argv( 1 ), "sorted" ) == 0 ) { sorted = true; } else if ( idStr::Icmp( args.Argv( 1 ), "namesort" ) == 0 ) { sortByName = true; } else if ( idStr::Icmp( args.Argv( 1 ), "unloaded" ) == 0 ) { unloaded = true; } else if ( idStr::Icmp( args.Argv( 1 ), "duplicated" ) == 0 ) { duplicated = true; } else if ( idStr::Icmp( args.Argv( 1 ), "oversized" ) == 0 ) { sorted = true; overSized = true; } else { failed = true; } } else { failed = true; } if ( failed ) { common->Printf( "usage: listImages [ sorted | namesort | unloaded | duplicated | showOverSized ]\n" ); return; } const char *header = " -w-- -h-- filt -fmt-- wrap size --name-------\n"; common->Printf( "\n%s", header ); totalSize = 0; sortedImage_t *sortedArray = (sortedImage_t *)alloca( sizeof( sortedImage_t ) * globalImages->images.Num() ); for ( i = 0 ; i < globalImages->images.Num() ; i++ ) { image = globalImages->images[ i ]; if ( uncompressedOnly ) { if ( image->IsCompressed() ) { continue; } } if ( unloaded == image->IsLoaded() ) { continue; } // only print duplicates (from mismatched wrap / clamp, etc) if ( duplicated ) { int j; for ( j = i+1 ; j < globalImages->images.Num() ; j++ ) { if ( idStr::Icmp( image->GetName(), globalImages->images[ j ]->GetName() ) == 0 ) { break; } } if ( j == globalImages->images.Num() ) { continue; } } if ( sorted || sortByName ) { sortedArray[count].image = image; sortedArray[count].size = image->StorageSize(); sortedArray[count].index = i; } else { common->Printf( "%4i:", i ); image->Print(); } totalSize += image->StorageSize(); count++; } if ( sorted || sortByName ) { if ( sortByName) { qsort( sortedArray, count, sizeof( sortedImage_t ), R_QsortImageName ); } else { qsort( sortedArray, count, sizeof( sortedImage_t ), R_QsortImageSizes ); } partialSize = 0; for ( i = 0 ; i < count ; i++ ) { common->Printf( "%4i:", sortedArray[i].index ); sortedArray[i].image->Print(); partialSize += sortedArray[i].image->StorageSize(); if ( ( (i+1) % 10 ) == 0 ) { common->Printf( "-------- %5.1f of %5.1f megs --------\n", partialSize / (1024*1024.0), totalSize / (1024*1024.0) ); } } } common->Printf( "%s", header ); common->Printf( " %i images (%i total)\n", count, globalImages->images.Num() ); common->Printf( " %5.1f total megabytes of images\n\n\n", totalSize / (1024*1024.0) ); } /* ============== AllocImage Allocates an idImage, adds it to the list, copies the name, and adds it to the hash chain. ============== */ idImage *idImageManager::AllocImage( const char *name ) { if (strlen(name) >= MAX_IMAGE_NAME ) { common->Error ("idImageManager::AllocImage: \"%s\" is too long\n", name); } int hash = idStr( name ).FileNameHash(); idImage * image = new (TAG_IMAGE) idImage( name ); imageHash.Add( hash, images.Append( image ) ); return image; } /* ============== AllocStandaloneImage Allocates an idImage,does not add it to the list or hash chain ============== */ idImage *idImageManager::AllocStandaloneImage( const char *name ) { if (strlen(name) >= MAX_IMAGE_NAME ) { common->Error ("idImageManager::AllocImage: \"%s\" is too long\n", name); } idImage * image = new (TAG_IMAGE) idImage( name ); return image; } /* ================== ImageFromFunction Images that are procedurally generated are allways specified with a callback which must work at any time, allowing the OpenGL system to be completely regenerated if needed. ================== */ idImage *idImageManager::ImageFromFunction( const char *_name, void (*generatorFunction)( idImage *image ) ) { // strip any .tga file extensions from anywhere in the _name idStr name = _name; name.Replace( ".tga", "" ); name.BackSlashesToSlashes(); // see if the image already exists int hash = name.FileNameHash(); for ( int i = imageHash.First( hash ); i != -1; i = imageHash.Next( i ) ) { idImage * image = images[i]; if ( name.Icmp( image->GetName() ) == 0 ) { if ( image->generatorFunction != generatorFunction ) { common->DPrintf( "WARNING: reused image %s with mixed generators\n", name.c_str() ); } return image; } } // create the image and issue the callback idImage * image = AllocImage( name ); image->generatorFunction = generatorFunction; // check for precompressed, load is from the front end image->referencedOutsideLevelLoad = true; image->ActuallyLoadImage( false ); return image; } /* =============== GetImageWithParameters ============== */ idImage *idImageManager::GetImageWithParameters( const char *_name, textureFilter_t filter, textureRepeat_t repeat, textureUsage_t usage, cubeFiles_t cubeMap ) const { if ( !_name || !_name[0] || idStr::Icmp( _name, "default" ) == 0 || idStr::Icmp( _name, "_default" ) == 0 ) { declManager->MediaPrint( "DEFAULTED\n" ); return globalImages->defaultImage; } if ( idStr::Icmpn( _name, "fonts", 5 ) == 0 || idStr::Icmpn( _name, "newfonts", 8 ) == 0 ) { usage = TD_FONT; } if ( idStr::Icmpn( _name, "lights", 6 ) == 0 ) { usage = TD_LIGHT; } // strip any .tga file extensions from anywhere in the _name, including image program parameters idStrStatic< MAX_OSPATH > name = _name; name.Replace( ".tga", "" ); name.BackSlashesToSlashes(); int hash = name.FileNameHash(); for ( int i = imageHash.First( hash ); i != -1; i = imageHash.Next( i ) ) { idImage * image = images[i]; if ( name.Icmp( image->GetName() ) == 0 ) { // the built in's, like _white and _flat always match the other options if ( name[0] == '_' ) { return image; } if ( image->cubeFiles != cubeMap ) { common->Error( "Image '%s' has been referenced with conflicting cube map states", _name ); } if ( image->filter != filter || image->repeat != repeat ) { // we might want to have the system reset these parameters on every bind and // share the image data continue; } if ( image->usage != usage ) { // If an image is used differently then we need 2 copies of it because usage affects the way it's compressed and swizzled continue; } return image; } } return NULL; } /* =============== ImageFromFile Finds or loads the given image, always returning a valid image pointer. Loading of the image may be deferred for dynamic loading. ============== */ idImage *idImageManager::ImageFromFile( const char *_name, textureFilter_t filter, textureRepeat_t repeat, textureUsage_t usage, cubeFiles_t cubeMap ) { if ( !_name || !_name[0] || idStr::Icmp( _name, "default" ) == 0 || idStr::Icmp( _name, "_default" ) == 0 ) { declManager->MediaPrint( "DEFAULTED\n" ); return globalImages->defaultImage; } if ( idStr::Icmpn( _name, "fonts", 5 ) == 0 || idStr::Icmpn( _name, "newfonts", 8 ) == 0 ) { usage = TD_FONT; } if ( idStr::Icmpn( _name, "lights", 6 ) == 0 ) { usage = TD_LIGHT; } // strip any .tga file extensions from anywhere in the _name, including image program parameters idStrStatic< MAX_OSPATH > name = _name; name.Replace( ".tga", "" ); name.BackSlashesToSlashes(); // // see if the image is already loaded, unless we // are in a reloadImages call // int hash = name.FileNameHash(); for ( int i = imageHash.First( hash ); i != -1; i = imageHash.Next( i ) ) { idImage * image = images[i]; if ( name.Icmp( image->GetName() ) == 0 ) { // the built in's, like _white and _flat always match the other options if ( name[0] == '_' ) { return image; } if ( image->cubeFiles != cubeMap ) { common->Error( "Image '%s' has been referenced with conflicting cube map states", _name ); } if ( image->filter != filter || image->repeat != repeat ) { // we might want to have the system reset these parameters on every bind and // share the image data continue; } if ( image->usage != usage ) { // If an image is used differently then we need 2 copies of it because usage affects the way it's compressed and swizzled continue; } image->usage = usage; image->levelLoadReferenced = true; if ( ( !insideLevelLoad || preloadingMapImages ) && !image->IsLoaded() ) { image->referencedOutsideLevelLoad = ( !insideLevelLoad && !preloadingMapImages ); image->ActuallyLoadImage( false ); // load is from front end declManager->MediaPrint( "%ix%i %s (reload for mixed referneces)\n", image->GetUploadWidth(), image->GetUploadHeight(), image->GetName() ); } return image; } } // // create a new image // idImage * image = AllocImage( name ); image->cubeFiles = cubeMap; image->usage = usage; image->filter = filter; image->repeat = repeat; image->levelLoadReferenced = true; // load it if we aren't in a level preload if ( !insideLevelLoad || preloadingMapImages ) { image->referencedOutsideLevelLoad = ( !insideLevelLoad && !preloadingMapImages ); image->ActuallyLoadImage( false ); // load is from front end declManager->MediaPrint( "%ix%i %s\n", image->GetUploadWidth(), image->GetUploadHeight(), image->GetName() ); } else { declManager->MediaPrint( "%s\n", image->GetName() ); } return image; } /* ======================== idImageManager::ScratchImage ======================== */ idImage * idImageManager::ScratchImage( const char *_name, idImageOpts *imgOpts, textureFilter_t filter, textureRepeat_t repeat, textureUsage_t usage ) { if ( !_name || !_name[0] ) { idLib::FatalError( "idImageManager::ScratchImage called with empty name" ); } if ( imgOpts == NULL ) { idLib::FatalError( "idImageManager::ScratchImage called with NULL imgOpts" ); } idStr name = _name; // // see if the image is already loaded, unless we // are in a reloadImages call // int hash = name.FileNameHash(); for ( int i = imageHash.First( hash ); i != -1; i = imageHash.Next( i ) ) { idImage * image = images[i]; if ( name.Icmp( image->GetName() ) == 0 ) { // the built in's, like _white and _flat always match the other options if ( name[0] == '_' ) { return image; } if ( image->filter != filter || image->repeat != repeat ) { // we might want to have the system reset these parameters on every bind and // share the image data continue; } if ( image->usage != usage ) { // If an image is used differently then we need 2 copies of it because usage affects the way it's compressed and swizzled continue; } image->usage = usage; image->levelLoadReferenced = true; image->referencedOutsideLevelLoad = true; return image; } } // clamp is the only repeat mode that makes sense for cube maps, but // some platforms let them stay in repeat mode and get border seam issues if ( imgOpts->textureType == TT_CUBIC && repeat != TR_CLAMP ) { repeat = TR_CLAMP; } // // create a new image // idImage* newImage = AllocImage( name ); if ( newImage != NULL ) { newImage->AllocImage( *imgOpts, filter, repeat ); } return newImage; } /* =============== idImageManager::GetImage =============== */ idImage *idImageManager::GetImage( const char *_name ) const { if ( !_name || !_name[0] || idStr::Icmp( _name, "default" ) == 0 || idStr::Icmp( _name, "_default" ) == 0 ) { declManager->MediaPrint( "DEFAULTED\n" ); return globalImages->defaultImage; } // strip any .tga file extensions from anywhere in the _name, including image program parameters idStr name = _name; name.Replace( ".tga", "" ); name.BackSlashesToSlashes(); // // look in loaded images // int hash = name.FileNameHash(); for ( int i = imageHash.First( hash ); i != -1; i = imageHash.Next( i ) ) { idImage * image = images[i]; if ( name.Icmp( image->GetName() ) == 0 ) { return image; } } return NULL; } /* =============== PurgeAllImages =============== */ void idImageManager::PurgeAllImages() { int i; idImage *image; for ( i = 0; i < images.Num() ; i++ ) { image = images[i]; image->PurgeImage(); } } /* =============== ReloadImages =============== */ void idImageManager::ReloadImages( bool all ) { for ( int i = 0 ; i < globalImages->images.Num() ; i++ ) { globalImages->images[ i ]->Reload( all ); } } /* =============== R_CombineCubeImages_f Used to combine animations of six separate tga files into a serials of 6x taller tga files, for preparation to roq compress =============== */ void R_CombineCubeImages_f( const idCmdArgs &args ) { if ( args.Argc() != 2 ) { common->Printf( "usage: combineCubeImages \n" ); common->Printf( " combines basename[1-6][0001-9999].tga to basenameCM[0001-9999].tga\n" ); common->Printf( " 1: forward 2:right 3:back 4:left 5:up 6:down\n" ); return; } idStr baseName = args.Argv( 1 ); common->SetRefreshOnPrint( true ); for ( int frameNum = 1 ; frameNum < 10000 ; frameNum++ ) { char filename[MAX_IMAGE_NAME]; byte *pics[6]; int width = 0, height = 0; int side; int orderRemap[6] = { 1,3,4,2,5,6 }; for ( side = 0 ; side < 6 ; side++ ) { sprintf( filename, "%s%i%04i.tga", baseName.c_str(), orderRemap[side], frameNum ); common->Printf( "reading %s\n", filename ); R_LoadImage( filename, &pics[side], &width, &height, NULL, true ); if ( !pics[side] ) { common->Printf( "not found.\n" ); break; } // convert from "camera" images to native cube map images switch( side ) { case 0: // forward R_RotatePic( pics[side], width); break; case 1: // back R_RotatePic( pics[side], width); R_HorizontalFlip( pics[side], width, height ); R_VerticalFlip( pics[side], width, height ); break; case 2: // left R_VerticalFlip( pics[side], width, height ); break; case 3: // right R_HorizontalFlip( pics[side], width, height ); break; case 4: // up R_RotatePic( pics[side], width); break; case 5: // down R_RotatePic( pics[side], width); break; } } if ( side != 6 ) { for ( int i = 0 ; i < side ; side++ ) { Mem_Free( pics[side] ); } break; } idTempArray buf( width*height*6*4 ); byte *combined = (byte *)buf.Ptr(); for ( side = 0 ; side < 6 ; side++ ) { memcpy( combined+width*height*4*side, pics[side], width*height*4 ); Mem_Free( pics[side] ); } sprintf( filename, "%sCM%04i.tga", baseName.c_str(), frameNum ); common->Printf( "writing %s\n", filename ); R_WriteTGA( filename, combined, width, height*6 ); } common->SetRefreshOnPrint( false ); } /* =============== UnbindAll =============== */ void idImageManager::UnbindAll() { int oldTMU = backEnd.glState.currenttmu; for ( int i = 0; i < MAX_PROG_TEXTURE_PARMS; ++i ) { backEnd.glState.currenttmu = i; BindNull(); } backEnd.glState.currenttmu = oldTMU; } /* =============== BindNull =============== */ void idImageManager::BindNull() { RENDERLOG_PRINTF( "BindNull()\n" ); } /* =============== Init =============== */ void idImageManager::Init() { images.Resize( 1024, 1024 ); imageHash.ResizeIndex( 1024 ); CreateIntrinsicImages(); cmdSystem->AddCommand( "reloadImages", R_ReloadImages_f, CMD_FL_RENDERER, "reloads images" ); cmdSystem->AddCommand( "listImages", R_ListImages_f, CMD_FL_RENDERER, "lists images" ); cmdSystem->AddCommand( "combineCubeImages", R_CombineCubeImages_f, CMD_FL_RENDERER, "combines six images for roq compression" ); // should forceLoadImages be here? } /* =============== Shutdown =============== */ void idImageManager::Shutdown() { images.DeleteContents( true ); imageHash.Clear(); } /* ==================== idImageManager::BeginLevelLoad Frees all images used by the previous level ==================== */ void idImageManager::BeginLevelLoad() { insideLevelLoad = true; for ( int i = 0 ; i < images.Num() ; i++ ) { idImage *image = images[ i ]; // generator function images are always kept around if ( image->generatorFunction ) { continue; } if ( !image->referencedOutsideLevelLoad && image->IsLoaded() ) { image->PurgeImage(); //idLib::Printf( "purging %s\n", image->GetName() ); } else { //idLib::Printf( "not purging %s\n", image->GetName() ); } image->levelLoadReferenced = false; } } /* ==================== idImageManager::ExcludePreloadImage ==================== */ bool idImageManager::ExcludePreloadImage( const char *name ) { idStrStatic< MAX_OSPATH > imgName = name; imgName.ToLower(); if ( imgName.Find( "newfonts/", false ) >= 0 ) { return true; } if ( imgName.Find( "generated/swf/", false ) >= 0 ) { return true; } if ( imgName.Find( "/loadscreens/", false ) >= 0 ) { return true; } return false; } /* ==================== idImageManager::Preload ==================== */ void idImageManager::Preload( const idPreloadManifest &manifest, const bool & mapPreload ) { if ( preLoad_Images.GetBool() && manifest.NumResources() > 0 ) { // preload this levels images common->Printf( "Preloading images...\n" ); preloadingMapImages = mapPreload; int start = Sys_Milliseconds(); int numLoaded = 0; //fileSystem->StartPreload( preloadImageFiles ); for ( int i = 0; i < manifest.NumResources(); i++ ) { const preloadEntry_s & p = manifest.GetPreloadByIndex( i ); if ( p.resType == PRELOAD_IMAGE && !ExcludePreloadImage( p.resourceName ) ) { globalImages->ImageFromFile( p.resourceName, ( textureFilter_t )p.imgData.filter, ( textureRepeat_t )p.imgData.repeat, ( textureUsage_t )p.imgData.usage, ( cubeFiles_t )p.imgData.cubeMap ); numLoaded++; } } //fileSystem->StopPreload(); int end = Sys_Milliseconds(); common->Printf( "%05d images preloaded ( or were already loaded ) in %5.1f seconds\n", numLoaded, ( end - start ) * 0.001 ); common->Printf( "----------------------------------------\n" ); preloadingMapImages = false; } } /* =============== idImageManager::LoadLevelImages =============== */ int idImageManager::LoadLevelImages( bool pacifier ) { int loadCount = 0; for ( int i = 0 ; i < images.Num() ; i++ ) { if ( pacifier ) { common->UpdateLevelLoadPacifier(); } idImage *image = images[ i ]; if ( image->generatorFunction ) { continue; } if ( image->levelLoadReferenced && !image->IsLoaded() ) { loadCount++; image->ActuallyLoadImage( false ); } } return loadCount; } /* =============== idImageManager::EndLevelLoad =============== */ void idImageManager::EndLevelLoad() { insideLevelLoad = false; common->Printf( "----- idImageManager::EndLevelLoad -----\n" ); int start = Sys_Milliseconds(); int loadCount = LoadLevelImages( true ); int end = Sys_Milliseconds(); common->Printf( "%5i images loaded in %5.1f seconds\n", loadCount, (end-start) * 0.001 ); common->Printf( "----------------------------------------\n" ); //R_ListImages_f( idCmdArgs( "sorted sorted", false ) ); } /* =============== idImageManager::StartBuild =============== */ void idImageManager::StartBuild() { } /* =============== idImageManager::FinishBuild =============== */ void idImageManager::FinishBuild( bool removeDups ) { } /* =============== idImageManager::PrintMemInfo =============== */ void idImageManager::PrintMemInfo( MemInfo_t *mi ) { int i, j, total = 0; int *sortIndex; idFile *f; f = fileSystem->OpenFileWrite( mi->filebase + "_images.txt" ); if ( !f ) { return; } // sort first sortIndex = new (TAG_IMAGE) int[images.Num()]; for ( i = 0; i < images.Num(); i++ ) { sortIndex[i] = i; } for ( i = 0; i < images.Num() - 1; i++ ) { for ( j = i + 1; j < images.Num(); j++ ) { if ( images[sortIndex[i]]->StorageSize() < images[sortIndex[j]]->StorageSize() ) { int temp = sortIndex[i]; sortIndex[i] = sortIndex[j]; sortIndex[j] = temp; } } } // print next for ( i = 0; i < images.Num(); i++ ) { idImage *im = images[sortIndex[i]]; int size; size = im->StorageSize(); total += size; f->Printf( "%s %3i %s\n", idStr::FormatNumber( size ).c_str(), im->refCount, im->GetName() ); } delete [] sortIndex; mi->imageAssetsTotal = total; f->Printf( "\nTotal image bytes allocated: %s\n", idStr::FormatNumber( total ).c_str() ); fileSystem->CloseFile( f ); }