src/cfile/cfilearchive.cpp

   1 /*
   2  * Copyright (C) Volition, Inc. 1999.  All rights reserved.
   3  *
   4  * All source code herein is the property of Volition, Inc. You may not sell
   5  * or otherwise commercially exploit the source or things you created based on
   6  * the source.
   7  */
   8
   9 /*
  10  * $Logfile: /Freespace2/code/CFile/CfileArchive.cpp $
  11  * $Revision$
  12  * $Date$
  13  * $Author$
  14  *
  15  * Low-level code for reading data out of large archive files or normal files.  All
  16  * reads/seeks come through here.
  17  *
  18  * $Log$
  19  * Revision 1.2  2002/06/09 04:41:15  relnev
  20  * added copyright header
  21  *
  22  * Revision 1.1.1.1  2002/05/03 03:28:08  root
  23  * Initial import.
  24  *
  25  *
  26  * 4     2/22/99 10:31p Andsager
  27  * Get rid of unneeded includes.
  28  *
  29  * 3     1/06/99 2:24p Dave
  30  * Stubs and release build fixes.
  31  *
  32  * 2     10/07/98 10:52a Dave
  33  * Initial checkin.
  34  *
  35  * 1     10/07/98 10:48a Dave
  36  *
  37  * 12    5/14/98 8:10p Lawrance
  38  * Fix bug with trying to read past the end of a file (when from a
  39  * packfile).
  40  *
  41  * 11    5/11/98 11:48a John
  42  * fixed bug with memory mapped files
  43  *
  44  * 10    5/11/98 10:59a John
  45  * added in debug code
  46  *
  47  * 9     5/11/98 10:59a John
  48  * Moved the low-level file reading code into cfilearchive.cpp.
  49  *
  50  * 8     4/30/98 4:53p John
  51  * Restructured and cleaned up cfile code.  Added capability to read off
  52  * of CD-ROM drive and out of multiple pack files.
  53  *
  54  * 7     4/20/98 11:49a Hoffoss
  55  * Fixed bug with directory name getting.
  56  *
  57  * 6     4/10/98 12:18a Hoffoss
  58  * Make pilot image search in pack file possible.
  59  *
  60  * 5     1/19/98 9:37p Allender
  61  * Great Compiler Warning Purge of Jan, 1998.  Used pragma's in a couple
  62  * of places since I was unsure of what to do with code.
  63  *
  64  * 4     12/30/97 5:31p Lawrance
  65  * fixed problem for people that didn't have a VP file
  66  *
  67  * 3     12/30/97 4:31p Sandeep
  68  * Changed pakfile format
  69  *
  70  * 2     12/28/97 12:42p John
  71  * Put in support for reading archive files; Made missionload use the
  72  * cf_get_file_list function.   Moved demos directory out of data tree.
  73  *
  74  * 1     12/28/97 11:48a John
  75  *
  76  * $NoKeywords: $
  77  */
  78
  79 #define _CFILE_INTERNAL
  80
  81 #include <stdlib.h>
  82 #include <string.h>
  83 #include <stdio.h>
  84 #ifndef PLAT_UNIX
  85 #include <io.h>
  86 #include <direct.h>
  87 #include <windows.h>
  88 #include <winbase.h>            /* needed for memory mapping of file functions */
  89 #endif
  90
  91 #include "pstypes.h"
  92 #include "cfile.h"
  93 //#include "outwnd.h"
  94 //#include "vecmat.h"
  95 //#include "timer.h"
  96 #include "cfilearchive.h"
  97
  98 #define CHECK_POSITION
  99
 100 // Called once to setup the low-level reading code.
 101
 102 void cf_init_lowlevel_read_code( CFILE * cfile, int offset, int size )
 103 {
 104         SDL_assert(cfile != NULL);
 105
 106         Cfile_block *cb;
 107         SDL_assert(cfile->id >= 0 && cfile->id < MAX_CFILE_BLOCKS);
 108         cb = &Cfile_block_list[cfile->id];
 109
 110         cb->lib_offset = offset;
 111         cb->raw_position = 0;
 112         cb->size = size;
 113
 114         if ( cb->fp )   {
 115                 if ( cb->lib_offset )   {
 116                         fseek( cb->fp, cb->lib_offset, SEEK_SET );
 117                 }
 118
 119                 #if defined(CHECK_POSITION) && !defined(NDEBUG)
 120                         int raw_position = ftell(cb->fp) - cb->lib_offset;
 121                         SDL_assert(raw_position == cb->raw_position);
 122                 #endif
 123         }
 124 }
 125
 126
 127
 128 // cfeof() Tests for end-of-file on a stream
 129 //
 130 // returns a nonzero value after the first read operation that attempts to read
 131 // past the end of the file. It returns 0 if the current position is not end of file.
 132 // There is no error return.
 133
 134 int cfeof(CFILE *cfile)
 135 {
 136         SDL_assert(cfile != NULL);
 137
 138         Cfile_block *cb;
 139         SDL_assert(cfile->id >= 0 && cfile->id < MAX_CFILE_BLOCKS);
 140         cb = &Cfile_block_list[cfile->id];
 141
 142         int result = 0;
 143
 144         SDL_assert(cb->fp != NULL);
 145
 146         #if defined(CHECK_POSITION) && !defined(NDEBUG)
 147         int raw_position = ftell(cb->fp) - cb->lib_offset;
 148         SDL_assert(raw_position == cb->raw_position);
 149         #endif
 150
 151         if (cb->raw_position >= cb->size ) {
 152                 result = 1;
 153         } else {
 154                 result = 0;
 155         }
 156
 157         return result;
 158 }
 159
 160 // cftell() returns offset into file
 161 //
 162 // returns:  success ==> offset into the file
 163 //           error   ==> -1
 164 //
 165 int cftell( CFILE * cfile )
 166 {
 167         SDL_assert(cfile != NULL);
 168         Cfile_block *cb;
 169         SDL_assert(cfile->id >= 0 && cfile->id < MAX_CFILE_BLOCKS);
 170         cb = &Cfile_block_list[cfile->id];
 171
 172         SDL_assert(cb->fp != NULL);
 173
 174         #if defined(CHECK_POSITION) && !defined(NDEBUG)
 175         int raw_position = ftell(cb->fp) - cb->lib_offset;
 176         SDL_assert(raw_position == cb->raw_position);
 177         #endif
 178
 179         return cb->raw_position;
 180 }
 181
 182
 183 // cfseek() moves the file pointer
 184 //
 185 // returns:   success ==> 0
 186 //            error   ==> non-zero
 187 //
 188 int cfseek( CFILE *cfile, int offset, int where )
 189 {
 190
 191         SDL_assert(cfile != NULL);
 192         Cfile_block *cb;
 193         SDL_assert(cfile->id >= 0 && cfile->id < MAX_CFILE_BLOCKS);
 194         cb = &Cfile_block_list[cfile->id];
 195
 196         SDL_assert( cb->fp != NULL );
 197
 198         int goal_position;
 199
 200         switch( where ) {
 201         case CF_SEEK_SET:
 202                 goal_position = offset+cb->lib_offset;
 203                 break;
 204         case CF_SEEK_CUR:
 205                 {
 206                         goal_position = cb->raw_position+offset+cb->lib_offset;
 207                 }
 208                 break;
 209         case CF_SEEK_END:
 210                 goal_position = cb->size+offset+cb->lib_offset;
 211                 break;
 212         default:
 213                 Int3();
 214                 return 1;
 215         }
 216
 217         int result = fseek(cb->fp, goal_position, SEEK_SET );
 218         cb->raw_position = goal_position - cb->lib_offset;
 219
 220         #if defined(CHECK_POSITION) && !defined(NDEBUG)
 221                 int tmp_offset = ftell(cb->fp) - cb->lib_offset;
 222                 SDL_assert(tmp_offset==cb->raw_position);
 223         #endif
 224
 225         return result;
 226 }
 227
 228
 229 // cfread() reads from a file
 230 //
 231 // returns:   returns the number of full elements read
 232 //
 233 //
 234 int cfread(void *buf, int elsize, int nelem, CFILE *cfile)
 235 {
 236         SDL_assert(cfile != NULL);
 237         SDL_assert(buf != NULL);
 238         SDL_assert(cfile->id >= 0 && cfile->id < MAX_CFILE_BLOCKS);
 239
 240         Cfile_block *cb;
 241         cb = &Cfile_block_list[cfile->id];
 242
 243         SDL_assert(cb->fp != NULL);
 244
 245         int size = elsize*nelem;
 246
 247         SDL_assert(nelem > 0);
 248         SDL_assert(elsize > 0);
 249         SDL_assert(size > 0);
 250
 251         if ( (cb->raw_position+size) > cb->size ) {
 252                 size = cb->size - cb->raw_position;
 253                 if ( size < 1 ) {
 254                         return 0;
 255                 }
 256                 //mprintf(( "CFILE: EOF encountered in file\n" ));
 257         }
 258
 259         int bytes_read = fread( buf, 1, size, cb->fp );
 260         if ( bytes_read > 0 )   {
 261                 cb->raw_position += bytes_read;
 262         }
 263
 264         #if defined(CHECK_POSITION) && !defined(NDEBUG)
 265                 int tmp_offset = ftell(cb->fp) - cb->lib_offset;
 266                 SDL_assert(tmp_offset==cb->raw_position);
 267         #endif
 268
 269         return bytes_read / elsize;
 270
 271 }
 272