19fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream/* 29fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamCopyright (C) 1996-1997 Id Software, Inc. 39fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 49fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamThis program is free software; you can redistribute it and/or 59fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreammodify it under the terms of the GNU General Public License 69fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamas published by the Free Software Foundation; either version 2 79fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamof the License, or (at your option) any later version. 89fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 99fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamThis program is distributed in the hope that it will be useful, 109fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreambut WITHOUT ANY WARRANTY; without even the implied warranty of 119fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 129fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 139fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamSee the GNU General Public License for more details. 149fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 159fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamYou should have received a copy of the GNU General Public License 169fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamalong with this program; if not, write to the Free Software 179fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamFoundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 189fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 199fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream*/ 209fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream/* 219fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream memory allocation 229fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 239fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 249fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamH_??? The hunk manages the entire memory block given to quake. It must be 259fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamcontiguous. Memory can be allocated from either the low or high end in a 269fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamstack fashion. The only way memory is released is by resetting one of the 279fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreampointers. 289fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 299fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamHunk allocations should be given a name, so the Hunk_Print () function 309fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamcan display usage. 319fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 329fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamHunk allocations are guaranteed to be 16 byte aligned. 339fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 349fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamThe video buffers are allocated high to avoid leaving a hole underneath 359fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamserver allocations when changing to a higher video mode. 369fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 379fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 389fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamZ_??? Zone memory functions used for small, dynamic allocations like text 399fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamstrings from command input. There is only about 48K for it, allocated at 409fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamthe very bottom of the hunk. 419fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 429fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamCache_??? Cache memory is for objects that can be dynamically loaded and 439fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamcan usefully stay persistant between levels. The size of the cache 449fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamfluctuates from level to level. 459fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 469fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamTo allocate a cachable object 479fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 489fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 499fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamTemp_??? Temp memory is used for file loading and surface caching. The size 509fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamof the cache memory is adjusted so that there is a minimum of 512k remaining 519fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamfor temp memory. 529fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 539fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 549fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream------ Top of Memory ------- 559fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 569fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamhigh hunk allocations 579fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 589fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream<--- high hunk reset point held by vid 599fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 609fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvideo buffer 619fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 629fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamz buffer 639fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 649fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamsurface cache 659fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 669fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream<--- high hunk used 679fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 689fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamcachable memory 699fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 709fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream<--- low hunk used 719fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 729fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamclient and server low hunk allocations 739fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 749fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream<-- low hunk reset point held by host 759fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 769fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamstartup hunk allocations 779fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 789fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamZone block 799fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 809fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream----- Bottom of Memory ----- 819fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 829fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 839fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 849fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream*/ 859fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 869fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Memory_Init (void *buf, int size); 879fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 889fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Z_Free (void *ptr); 899fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Z_Malloc (int size); // returns 0 filled memory 909fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Z_TagMalloc (int size, int tag); 919fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 929fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Z_DumpHeap (void); 939fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Z_CheckHeap (void); 949fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamint Z_FreeMemory (void); 959fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 969fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Hunk_Alloc (int size); // returns 0 filled memory 979fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Hunk_AllocName (int size, char *name); 989fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 999fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Hunk_HighAllocName (int size, char *name); 1009fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1019fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamint Hunk_LowMark (void); 1029fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Hunk_FreeToLowMark (int mark); 1039fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1049fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamint Hunk_HighMark (void); 1059fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Hunk_FreeToHighMark (int mark); 1069fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1079fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Hunk_TempAlloc (int size); 1089fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1099fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Hunk_Check (void); 1109fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1119fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamtypedef struct cache_user_s 1129fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream{ 1139fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream void *data; 1149fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream} cache_user_t; 1159fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1169fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Cache_Flush (void); 1179fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1189fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Cache_Check (cache_user_t *c); 1199fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream// returns the cached data, and moves to the head of the LRU list 1209fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream// if present, otherwise returns NULL 1219fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1229fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Cache_Free (cache_user_t *c); 1239fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1249fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid *Cache_Alloc (cache_user_t *c, int size, char *name); 1259fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream// Returns NULL if all purgable data was tossed and there still 1269fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream// wasn't enough room. 1279fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1289fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstreamvoid Cache_Report (void); 1299fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1309fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 1319fd67c44777b350dc56f3e70c88963b0d966ffc7quake upstream 132