filesys.h

Go to the documentation of this file.

 
/*
All original material Copyright (C) 2002-2025 UFO: Alien Invasion.
 
Copyright (C) 1997-2001 Id Software, Inc.
 
This program 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 2
of the License, or (at your option) any later version.
 
This program 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 this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
*/
 
#pragma once
 
#include <stdio.h>
#include <string.h>
#include "../shared/ufotypes.h"
#include "../shared/cxx.h"
#define BASEDIRNAME "base"
 
/* Maximum maps constant */
#define MAX_MAPS 400
 
/* max length of the ufo virtual filesystem */
#define MAX_QPATH           64
 
/* max length of a filesystem pathname
 * windows + linux 256, macosx 32 */
#define MAX_OSPATH          256
 
/* max files in a directory */
#define MAX_FILES           512
 
/*
==============================================================
FILESYSTEM
==============================================================
*/
typedef struct qFILE_s {
    void* z; 
    FILE* f; 
    char name[MAX_OSPATH];
    unsigned long filepos;
    unsigned long size;
 
    inline FILE* getFile () const
    {
        return f;
    }
} qFILE;
 
typedef enum {
    FS_READ,
    FS_WRITE,
    FS_APPEND,
    FS_APPEND_SYNC
} fsMode_t;
 
typedef enum {
    FS_SEEK_CUR,
    FS_SEEK_END,
    FS_SEEK_SET
} fsOrigin_t;

typedef struct filelink_s {
    struct filelink_s* next;
    char* from;
    int fromlength;
    char* to;
} filelink_t;
 
typedef struct {
    char name[MAX_QPATH];
    unsigned long filepos;
    unsigned long filelen;
} packfile_t;
 
typedef struct pack_s {
    char filename[MAX_OSPATH];
    qFILE handle;
    int numfiles;
    packfile_t* files;
} pack_t;
 
typedef struct searchpath_s {
    char filename[MAX_OSPATH];
    pack_t* pack;               
    bool write;                 
    struct searchpath_s* next;
} searchpath_t;

typedef enum {
    FILE_READ, FILE_WRITE, FILE_APPEND
} filemode_t;
 
/*
==============================================================
FILESYSTEM
==============================================================
*/
extern char* fs_maps[MAX_MAPS];
extern int fs_numInstalledMaps;
 
/* directory searching */
#define SFF_ARCH    0x01
#define SFF_HIDDEN  0x02
#define SFF_RDONLY  0x04
#define SFF_SUBDIR  0x08
#define SFF_SYSTEM  0x10
 
int FS_FileLength(qFILE* f);
int FS_Seek(qFILE* f, long offset, int origin);
int FS_WriteFile(const void* buffer, size_t len, const char* filename);
int FS_Write(const void* buffer, int len, qFILE* f);
int FS_Printf(qFILE* f, const char* msg, ...) __attribute__((format(__printf__, 2, 3)));
void FS_InitFilesystem(bool writeToHomeDir);
void FS_AddGameDirectory(const char* dir, bool write);
void FS_AddHomeAsGameDirectory(const char* dir, bool write);
void FS_RestartFilesystem(const char* gamedir);
const char* FS_Gamedir(void);
void FS_CreateOpenPipeFile(const char* filename, qFILE* f);
const char* FS_NextPath(const char* prevpath);
void FS_ExecAutoexec(void);
int FS_GetModList(struct linkedList_t** mods);
const char* FS_GetCwd(void);
void FS_NormPath(char* path);
bool FS_FileExists(const char* filename, ...) __attribute__((format(__printf__, 1, 2)));
 
void FS_GetMaps(bool reset);
 
int FS_OpenFile(const char* filename, qFILE* file, filemode_t mode);
void FS_CloseFile(qFILE* f);
 
bool FS_RenameFile(const char* from, const char* to, bool relative);
void FS_RemoveFile(const char* osPath);
void FS_CopyFile(const char* fromOSPath, const char* toOSPath);
 
/* note: this can't be called from another DLL, due to MS libc issues */
 
int FS_LoadFile(const char* path, byte** buffer);
 
/* a null buffer will just return the file length without loading */
/* a -1 length is not present */
 
int FS_Read2(void* buffer, int len, qFILE* f, bool failOnEmptyRead);
int FS_Read(void* buffer, int len, qFILE* f);
/* properly handles partial reads */
 
void FS_FreeFile(void* buffer);
 
int FS_CheckFile(const char* fmt, ...) __attribute__((format(__printf__, 1, 2)));
 
int FS_BuildFileList(const char* files);
const char* FS_NextFileFromFileList(const char* files);
char* FS_NextScriptHeader(const char* files, const char** name, const char** text);
void FS_CreatePath(const char* path);
 
/* Make sure we have this available */
char** FS_ListFiles(const char* findname, int* numfiles, unsigned musthave, unsigned canthave);
 
const char* FS_GetFileData(const char* files);

void FS_Shutdown(void);
 
class ScopedFile {
private:
    qFILE _file;
public:
    ScopedFile ()
    {
        memset(&_file, 0, sizeof(_file));
    }
    ~ScopedFile ()
    {
        FS_CloseFile(&_file);
    }
    inline qFILE* operator& ()
    {
        return &_file;
    }
    inline operator bool () const
    {
        return file() || zip();
    }
    inline bool file () const
    {
        return _file.f;
    }
    inline bool zip () const
    {
        return _file.z;
    }
    inline FILE* getFile () const
    {
        return _file.getFile();
    }
};