/* * The ManaPlus Client * Copyright (C) 2004-2009 The Mana World Development Team * Copyright (C) 2009-2010 The Mana Developers * Copyright (C) 2011 The ManaPlus Developers * * This file is part of The ManaPlus Client. * * 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 * 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, see <http://www.gnu.org/licenses/>. */ #ifndef RESOURCE_MANAGER_H #define RESOURCE_MANAGER_H #include "main.h" #include <ctime> #include <map> #include <string> #include <vector> #include <set> class Image; class ImageSet; class Music; class Resource; class SoundEffect; class SpriteDef; struct SDL_Surface; /** * A class for loading and managing resources. */ class ResourceManager { friend class Resource; public: typedef Resource *(*loader)(void *, unsigned); typedef Resource *(*generator)(void *); ResourceManager(); /** * Destructor. Cleans up remaining resources, warning about resources * that were still referenced. */ ~ResourceManager(); /** * Sets the write directory. * * @param path The path of the directory to be added. * @return <code>true</code> on success, <code>false</code> otherwise. */ bool setWriteDir(const std::string &path); /** * Adds a directory or archive to the search path. If append is true * then the directory is added to the end of the search path, otherwise * it is added at the front. * * @return <code>true</code> on success, <code>false</code> otherwise. */ bool addToSearchPath(const std::string &path, bool append); /** * Remove a directory or archive from the search path. * * @return <code>true</code> on success, <code>false</code> otherwise. */ bool removeFromSearchPath(const std::string &path); /** * Searches for zip files and adds them to the search path. */ void searchAndAddArchives(const std::string &path, const std::string &ext, bool append); /** * Searches for zip files and remove them from the search path. */ void searchAndRemoveArchives(const std::string &path, const std::string &ext); /** * Creates a directory in the write path */ bool mkdir(const std::string &path); /** * Checks whether the given file or directory exists in the search path */ bool exists(const std::string &path); /** * Checks whether the given path is a directory. */ bool isDirectory(const std::string &path); /** * Returns the real path to a file. Note that this method will always * return a path, it does not check whether the file exists. * * @param file The file to get the real path to. * @return The real path. */ std::string getPath(const std::string &file); /** * Creates a resource and adds it to the resource map. * * @param idPath The resource identifier path. * @param fun A function for generating the resource. * @param data Extra parameters for the generator. * @return A valid resource or <code>NULL</code> if the resource could * not be generated. */ Resource *get(const std::string &idPath, generator fun, void *data); /** * Loads a resource from a file and adds it to the resource map. * * @param path The file name. * @param fun A function for parsing the file. * @return A valid resource or <code>NULL</code> if the resource could * not be loaded. */ Resource *load(const std::string &path, loader fun); /** * Adds a preformatted resource to the resource map. * * @param path The file name. * @param Resource The Resource to add. * @return true if successfull, false otherwise. */ bool addResource(const std::string &idPath, Resource* resource); /** * Copies a file from one place to another (useful for extracting * raw files from a zip archive, for example) * * @param src Source file name * @param dst Destination file name * @return true on success, false on failure. An error message should be * in the log file. */ bool copyFile(const std::string &src, const std::string &dst); /** * Convenience wrapper around ResourceManager::get for loading * images. */ Image *getImage(const std::string &idPath); /** * Convenience wrapper around ResourceManager::get for loading * songs. */ Music *getMusic(const std::string &idPath); /** * Convenience wrapper around ResourceManager::get for loading * samples. */ SoundEffect *getSoundEffect(const std::string &idPath); /** * Creates a image set based on the image referenced by the given * path and the supplied sprite sizes */ ImageSet *getImageSet(const std::string &imagePath, int w, int h); /** * Creates a sprite definition based on a given path and the supplied * variant. */ SpriteDef *getSprite(const std::string &path, int variant = 0); /** * Releases a resource, placing it in the set of orphaned resources. */ void release(Resource *); /** * Allocates data into a buffer pointer for raw data loading. The * returned data is expected to be freed using <code>free()</code>. * * @param fileName The name of the file to be loaded. * @param fileSize The size of the file that was loaded. * * @return An allocated byte array containing the data that was loaded, * or <code>NULL</code> on fail. */ void *loadFile(const std::string &fileName, int &fileSize); /** * Retrieves the contents of a text file. */ std::vector<std::string> loadTextFile(const std::string &fileName); /** * Loads the given filename as an SDL surface. The returned surface is * expected to be freed by the caller using SDL_FreeSurface. */ SDL_Surface *loadSDLSurface(const std::string &filename); void scheduleDelete(SDL_Surface* surface); void clearScheduled(); /** * Returns an instance of the class, creating one if it does not * already exist. */ static ResourceManager *getInstance(); /** * Deletes the class instance if it exists. */ static void deleteInstance(); int size() { return mResources.size(); } typedef std::map<std::string, Resource*> Resources; typedef Resources::iterator ResourceIterator; #ifdef DEBUG_DUMP_LEAKS Resources* getResources() { return &mResources; } Resources* getOrphanedResources() { return &mOrphanedResources; } #endif void cleanOrphans(bool always = false); private: /** * Deletes the resource after logging a cleanup message. */ static void cleanUp(Resource *resource); static ResourceManager *instance; std::set<SDL_Surface*> deletedSurfaces; Resources mResources; Resources mOrphanedResources; time_t mOldestOrphan; std::string mSelectedSkin; std::string mSkinName; bool mDestruction; }; #endif