// Copyright (C) 2002-2012 Nikolaus Gebhardt // This file is part of the "Irrlicht Engine". // For conditions of distribution and use, see copyright notice in irrlicht.h #ifndef __C_FILE_SYSTEM_H_INCLUDED__ #define __C_FILE_SYSTEM_H_INCLUDED__ #include "IFileSystem.h" #include "irrArray.h" namespace irr { namespace io { class CZipReader; class CPakReader; class CMountPointReader; /*! FileSystem which uses normal files and one zipfile */ class CFileSystem : public IFileSystem { public: //! constructor CFileSystem(); //! destructor virtual ~CFileSystem(); //! opens a file for read access virtual IReadFile* createAndOpenFile(const io::path& filename); //! Creates an IReadFile interface for accessing memory like a file. virtual IReadFile* createMemoryReadFile(void* memory, s32 len, const io::path& fileName, bool deleteMemoryWhenDropped = false); //! Creates an IReadFile interface for accessing files inside files virtual IReadFile* createLimitReadFile(const io::path& fileName, IReadFile* alreadyOpenedFile, long pos, long areaSize); //! Creates an IWriteFile interface for accessing memory like a file. virtual IWriteFile* createMemoryWriteFile(void* memory, s32 len, const io::path& fileName, bool deleteMemoryWhenDropped=false); //! Opens a file for write access. virtual IWriteFile* createAndWriteFile(const io::path& filename, bool append=false); //! Adds an archive to the file system. virtual bool addFileArchive(const io::path& filename, bool ignoreCase = true, bool ignorePaths = true, E_FILE_ARCHIVE_TYPE archiveType = EFAT_UNKNOWN, const core::stringc& password="", IFileArchive** retArchive = 0); //! Adds an archive to the file system. virtual bool addFileArchive(IReadFile* file, bool ignoreCase=true, bool ignorePaths=true, E_FILE_ARCHIVE_TYPE archiveType=EFAT_UNKNOWN, const core::stringc& password="", IFileArchive** retArchive = 0); //! Adds an archive to the file system. virtual bool addFileArchive(IFileArchive* archive); //! move the hirarchy of the filesystem. moves sourceIndex relative up or down virtual bool moveFileArchive(u32 sourceIndex, s32 relative); //! Adds an external archive loader to the engine. virtual void addArchiveLoader(IArchiveLoader* loader); //! Returns the total number of archive loaders added. virtual u32 getArchiveLoaderCount() const; //! Gets the archive loader by index. virtual IArchiveLoader* getArchiveLoader(u32 index) const; //! gets the file archive count virtual u32 getFileArchiveCount() const; //! gets an archive virtual IFileArchive* getFileArchive(u32 index); virtual void removeAllFileArchives(); //! removes an archive from the file system. virtual bool removeFileArchive(u32 index); //! removes an archive from the file system. virtual bool removeFileArchive(const io::path& filename); //! Removes an archive from the file system. virtual bool removeFileArchive(const IFileArchive* archive); //! Returns the string of the current working directory virtual const io::path& getWorkingDirectory(); //! Changes the current Working Directory to the string given. //! The string is operating system dependent. Under Windows it will look //! like this: "drive:\directory\sudirectory\" virtual bool changeWorkingDirectoryTo(const io::path& newDirectory); //! Converts a relative path to an absolute (unique) path, resolving symbolic links virtual io::path getAbsolutePath(const io::path& filename) const; //! Returns the directory a file is located in. /** \param filename: The file to get the directory from */ virtual io::path getFileDir(const io::path& filename) const; //! Returns the base part of a filename, i.e. the name without the directory //! part. If no directory is prefixed, the full name is returned. /** \param filename: The file to get the basename from */ virtual io::path getFileBasename(const io::path& filename, bool keepExtension=true) const; //! flatten a path and file name for example: "/you/me/../." becomes "/you" virtual io::path& flattenFilename( io::path& directory, const io::path& root = "/" ) const; //! Get the relative filename, relative to the given directory virtual path getRelativeFilename(const path& filename, const path& directory) const; virtual EFileSystemType setFileListSystem(EFileSystemType listType); //! Creates a list of files and directories in the current working directory //! and returns it. virtual IFileList* createFileList(); //! Creates a list of files and directories in specified directory //! and returns it. virtual IFileList* createFileList(const io::path& directory); //! Creates an empty filelist virtual IFileList* createEmptyFileList(const io::path& path, bool ignoreCase, bool ignorePaths); //! determines if a file exists and would be able to be opened. virtual bool existFile(const io::path& filename) const; //! Creates a XML Reader from a file. virtual IXMLReader* createXMLReader(const io::path& filename); //! Creates a XML Reader from a file. virtual IXMLReader* createXMLReader(IReadFile* file); //! Creates a XML Reader from a file. virtual IXMLReaderUTF8* createXMLReaderUTF8(const io::path& filename); //! Creates a XML Reader from a file. virtual IXMLReaderUTF8* createXMLReaderUTF8(IReadFile* file); //! Creates a XML Writer from a file. virtual IXMLWriter* createXMLWriter(const io::path& filename); //! Creates a XML Writer from a file. virtual IXMLWriter* createXMLWriter(IWriteFile* file); //! Creates a new empty collection of attributes, usable for serialization and more. virtual IAttributes* createEmptyAttributes(video::IVideoDriver* driver); private: // don't expose, needs refactoring bool changeArchivePassword(const path& filename, const core::stringc& password, IFileArchive** archive = 0); //! Currently used FileSystemType EFileSystemType FileSystemType; //! WorkingDirectory for Native and Virtual filesystems io::path WorkingDirectory [2]; //! currently attached ArchiveLoaders core::array ArchiveLoader; //! currently attached Archives core::array FileArchives; }; } // end namespace irr } // end namespace io #endif