[4744] | 1 | /* |
---|
[1853] | 2 | orxonox - the future of 3D-vertical-scrollers |
---|
| 3 | |
---|
| 4 | Copyright (C) 2004 orx |
---|
| 5 | |
---|
| 6 | This program is free software; you can redistribute it and/or modify |
---|
| 7 | it under the terms of the GNU General Public License as published by |
---|
| 8 | the Free Software Foundation; either version 2, or (at your option) |
---|
| 9 | any later version. |
---|
[1855] | 10 | |
---|
| 11 | ### File Specific: |
---|
[7195] | 12 | main-programmer: Benjamin Grauer |
---|
[1855] | 13 | co-programmer: ... |
---|
[1853] | 14 | */ |
---|
| 15 | |
---|
[9790] | 16 | #define DEBUG_SPECIAL_MODULE DEBUG_MODULE_LOAD |
---|
[1853] | 17 | |
---|
[7193] | 18 | #include "resource.h" |
---|
[9836] | 19 | #include "resource_manager.h" |
---|
[9791] | 20 | |
---|
[9790] | 21 | #include "debug.h" |
---|
[1853] | 22 | |
---|
[9785] | 23 | |
---|
[9800] | 24 | namespace Resources |
---|
[3365] | 25 | { |
---|
[9850] | 26 | //! Define an ObjectList for the Resources |
---|
[9847] | 27 | ObjectListDefinition(Resource); |
---|
[1853] | 28 | |
---|
[9783] | 29 | |
---|
[9800] | 30 | /** |
---|
[9850] | 31 | * @brief standard constructor |
---|
| 32 | * @param type the Type this resource belongs to. |
---|
| 33 | */ |
---|
[9847] | 34 | Resource::Resource (Type* type) |
---|
[9800] | 35 | : _pointer(NULL), _type(type) |
---|
| 36 | { |
---|
[9847] | 37 | this->registerObject(this, Resource::_objectList); |
---|
[9800] | 38 | } |
---|
[9783] | 39 | |
---|
[9800] | 40 | /** |
---|
[9850] | 41 | * @brief standard deconstructor |
---|
[9800] | 42 | */ |
---|
[9847] | 43 | Resource::~Resource () |
---|
[9800] | 44 | { |
---|
| 45 | // delete what has to be deleted here |
---|
| 46 | } |
---|
| 47 | |
---|
[9850] | 48 | /** |
---|
| 49 | * @brief Locates a File inside of the Resources Paths and returns the appended path. |
---|
| 50 | * |
---|
| 51 | * @param fileName the Name of the file to look for. |
---|
| 52 | * @returns the Name of the File prepended with the PAth it is in, if found, empty String ("") otherwise. |
---|
| 53 | * |
---|
| 54 | * This Function searches in (ordered): |
---|
| 55 | * 1. mainGlobalPath (from ResourceManger) |
---|
| 56 | * 2. all of the global Paths (from ResourceManger) |
---|
| 57 | * 3. all of the Resources Paths (from Resources::Type) |
---|
| 58 | * |
---|
| 59 | * in each of these directory, first "./" is searched, and afterwards all of the subDirs (from Resources::Type) are searched. |
---|
| 60 | * |
---|
| 61 | * @todo finish it!! |
---|
| 62 | */ |
---|
[9847] | 63 | std::string Resource::locateFile(const std::string& fileName) const |
---|
[9800] | 64 | { |
---|
[9836] | 65 | if ((ResourceManager::getInstance()->mainGlobalPath() + File(fileName)).exists() ) |
---|
| 66 | return (ResourceManager::getInstance()->mainGlobalPath() + File(fileName)).name(); |
---|
[9800] | 67 | |
---|
| 68 | std::string locatedFile; |
---|
[9836] | 69 | locatedFile = locateFileInSubDir(ResourceManager::getInstance()->mainGlobalPath(), fileName); |
---|
[9800] | 70 | if (!locatedFile.empty()) |
---|
| 71 | { |
---|
| 72 | return locatedFile; |
---|
| 73 | } |
---|
| 74 | |
---|
| 75 | if (File(fileName).exists()) |
---|
| 76 | return fileName; |
---|
| 77 | |
---|
[9836] | 78 | return (ResourceManager::getInstance()->mainGlobalPath() + File(fileName)).name(); |
---|
[9800] | 79 | } |
---|
[9783] | 80 | |
---|
[9800] | 81 | /** |
---|
| 82 | * @brief tests in all the SubDirectories defined in Resource under Directory if the fileName exists. |
---|
| 83 | * @param directory the directory to in what to search for all subdirectories for. |
---|
| 84 | * @param fileName the Name of the File to query for |
---|
| 85 | * @return true on success. |
---|
| 86 | */ |
---|
[9847] | 87 | std::string Resource::locateFileInSubDir(const Directory& directory, const std::string& fileName) const |
---|
[9793] | 88 | { |
---|
[9800] | 89 | std::vector<Directory>::const_iterator it; |
---|
| 90 | for (it = this->_type->resourceSubPaths().begin(); it != this->_type->resourceSubPaths().end(); ++it) |
---|
| 91 | { |
---|
| 92 | Directory dir = directory + (*it); |
---|
| 93 | File file = dir + File(fileName); |
---|
| 94 | if ((dir+ File(fileName)).exists()) |
---|
| 95 | return (dir+File(fileName)).name(); |
---|
| 96 | } |
---|
| 97 | return ""; |
---|
[9793] | 98 | } |
---|
[9795] | 99 | |
---|
[9799] | 100 | |
---|
[9850] | 101 | /** |
---|
| 102 | * @param loadString the Identifier of the Resource. |
---|
| 103 | * @returns a Store-Pointer to the Resource if found, NULL otherwise |
---|
| 104 | */ |
---|
[9847] | 105 | StorePointer* Resource::acquireResource(const std::string& loadString) |
---|
[9790] | 106 | { |
---|
[9800] | 107 | //const Type* const type = _resourceTypes[this->_type->id()]; |
---|
[9785] | 108 | |
---|
[9800] | 109 | for (unsigned int i = 0; i < _type->storedResources().size(); ++i) |
---|
| 110 | { |
---|
| 111 | if (_type->storedResources()[i]->loadString() == loadString) |
---|
| 112 | return _type->storedResources()[i]; |
---|
| 113 | } |
---|
[9785] | 114 | |
---|
[9800] | 115 | return NULL; |
---|
| 116 | } |
---|
[9790] | 117 | |
---|
[9850] | 118 | /** |
---|
| 119 | * @brief registers a StorePointer to a Resource's Type. |
---|
| 120 | * @param pointer the StorePointer to register. |
---|
| 121 | */ |
---|
[9847] | 122 | void Resource::addResource(StorePointer* pointer) |
---|
[9786] | 123 | { |
---|
[9850] | 124 | assert(pointer != NULL); |
---|
[9800] | 125 | this->_type->addResource(pointer); |
---|
[9786] | 126 | } |
---|
[9783] | 127 | |
---|
| 128 | |
---|
| 129 | |
---|
[9784] | 130 | |
---|
[9785] | 131 | |
---|
| 132 | |
---|
[9800] | 133 | /////////////////// |
---|
| 134 | //// KEEPLEVEL //// |
---|
| 135 | /////////////////// |
---|
[9850] | 136 | /** |
---|
| 137 | * @brief constructor of a KeepLevel. |
---|
| 138 | * @param keepLevelName the Name of the KeepLevel. Must be one Name of the defined Names in the ResourceManager. |
---|
| 139 | * |
---|
| 140 | * @note the Name is transformed into an Integer for fast interpretation. |
---|
| 141 | */ |
---|
[9800] | 142 | KeepLevel::KeepLevel(const std::string& keepLevelName) |
---|
| 143 | { |
---|
[9836] | 144 | this->_keepLevel = ResourceManager::getInstance()->getKeepLevelID(keepLevelName); |
---|
[9800] | 145 | } |
---|
[9785] | 146 | |
---|
[9850] | 147 | /** |
---|
| 148 | * @returns the name of the KeepLevel. |
---|
| 149 | */ |
---|
[9800] | 150 | const std::string& KeepLevel::name() const |
---|
| 151 | { |
---|
[9836] | 152 | return ResourceManager::getInstance()->getKeepLevelName(this->_keepLevel); |
---|
[9800] | 153 | } |
---|
[9785] | 154 | |
---|
| 155 | |
---|
[9790] | 156 | |
---|
[9800] | 157 | /////////////////////// |
---|
| 158 | //// STORE POINTER //// |
---|
| 159 | /////////////////////// |
---|
[9850] | 160 | /** |
---|
| 161 | * @brief allocates a StorePointer. |
---|
| 162 | * @param loadString An identifier String that is unique between all resources of this type. |
---|
| 163 | * @param keepLevel the KeepLevel at wich to keep this resource. |
---|
| 164 | */ |
---|
[9800] | 165 | StorePointer::StorePointer(const std::string& loadString, const KeepLevel& keeplevel) |
---|
| 166 | : _loadString(loadString), _keepLevel(keeplevel) |
---|
| 167 | {} |
---|
[9790] | 168 | |
---|
[9798] | 169 | |
---|
[9799] | 170 | |
---|
[9790] | 171 | |
---|
[9800] | 172 | ////////////// |
---|
| 173 | //// TYPE //// |
---|
| 174 | ////////////// |
---|
[9850] | 175 | /** |
---|
| 176 | * @brief allocates a Type. |
---|
| 177 | * @param typeName the Name of the Type to be stored in this Container. |
---|
| 178 | */ |
---|
[9800] | 179 | Type::Type(const std::string& typeName) |
---|
[9845] | 180 | : _typeName(typeName) |
---|
[9800] | 181 | { |
---|
[9836] | 182 | ResourceManager::getInstance()->registerType(this); |
---|
[9800] | 183 | PRINTF(4)("Created ResourceType '%s'\n", typeName.c_str()); |
---|
| 184 | } |
---|
[9790] | 185 | |
---|
[9850] | 186 | //! Destructs a Type. |
---|
[9800] | 187 | Type::~Type() |
---|
| 188 | { |
---|
[9836] | 189 | ResourceManager::getInstance()->unregisterType(this); |
---|
[9800] | 190 | } |
---|
[9790] | 191 | |
---|
[9850] | 192 | /** |
---|
| 193 | * @brief adds a Resource to this Resource's type. |
---|
| 194 | * @param resource the Resource to add. |
---|
| 195 | */ |
---|
[9800] | 196 | void Type::addResource(StorePointer* resource) |
---|
| 197 | { |
---|
| 198 | this->_storedResources.push_back(resource); |
---|
| 199 | } |
---|
[9785] | 200 | |
---|
[9850] | 201 | /** |
---|
| 202 | * @brief adds a Path to the Type's resource-paths. |
---|
| 203 | * @param path the path-name to add. |
---|
| 204 | */ |
---|
[9800] | 205 | bool Type::addResourcePath(const std::string& path) |
---|
| 206 | { |
---|
| 207 | std::vector<Directory>::const_iterator it; |
---|
| 208 | for (it = this->_resourcePaths.begin(); it != this->_resourcePaths.end(); ++it) |
---|
| 209 | if ((*it) == path) |
---|
| 210 | return false; |
---|
| 211 | this->_resourcePaths.push_back(path); |
---|
| 212 | return true; |
---|
[9799] | 213 | |
---|
[9800] | 214 | } |
---|
[9785] | 215 | |
---|
[9850] | 216 | /** |
---|
| 217 | * @brief Adds a SubPath to the Type's resource-subpaths. |
---|
| 218 | * @param subPath the subpath to add. |
---|
| 219 | */ |
---|
[9800] | 220 | bool Type::addResourceSubPath(const std::string& subPath) |
---|
| 221 | { |
---|
| 222 | std::vector<Directory>::const_iterator it; |
---|
| 223 | for (it = this->_resourceSubPaths.begin(); it != this->_resourceSubPaths.end(); ++it) |
---|
| 224 | if ((*it) == subPath) |
---|
| 225 | return false; |
---|
| 226 | this->_resourceSubPaths.push_back(subPath); |
---|
| 227 | return true; |
---|
| 228 | } |
---|
[9785] | 229 | |
---|
[9850] | 230 | /** |
---|
| 231 | * @brief Unloads all Resources below a certain Level. |
---|
| 232 | * @param keepLevel the KeepLevel at what to remove the Resources from. |
---|
| 233 | */ |
---|
[9845] | 234 | void Type::unloadAllBelowKeepLevel(const Resources::KeepLevel& keepLevel) |
---|
[9800] | 235 | { |
---|
[9845] | 236 | std::vector<Resources::StorePointer*>::iterator it; |
---|
| 237 | for (it = this->_storedResources.begin(); it != this->_storedResources.end(); ++it) |
---|
[9846] | 238 | if((*it)->keepLevel() < keepLevel && (*it)->last()) |
---|
[9850] | 239 | { |
---|
| 240 | delete (*it); |
---|
| 241 | this->_storedResources.erase(it); |
---|
| 242 | it = this->_storedResources.begin(); |
---|
| 243 | } |
---|
[9800] | 244 | } |
---|
[9790] | 245 | |
---|
[9850] | 246 | /** |
---|
| 247 | * @brief print out some nice Debug information in a beatifully designed style |
---|
| 248 | */ |
---|
[9800] | 249 | void Type::debug() const |
---|
| 250 | { |
---|
[9845] | 251 | PRINT(0)(" ResourceType '%s' stores %d Resources\n", this->_typeName.c_str(), this->_storedResources.size()); |
---|
[9800] | 252 | PRINT(0)(" Paths:\n"); |
---|
| 253 | for (unsigned int i = 0; i < this->_resourcePaths.size(); ++i) |
---|
| 254 | PRINT(0)(" %s\n", this->_resourcePaths[i].name().c_str()); |
---|
| 255 | PRINT(0)(" Sub-Paths:"); |
---|
| 256 | for (unsigned int i = 0; i < this->_resourceSubPaths.size(); ++i) |
---|
| 257 | PRINT(0)(" '%s'", this->_resourceSubPaths[i].name().c_str()); |
---|
| 258 | PRINT(0)("\n"); |
---|
[9790] | 259 | |
---|
[9843] | 260 | PRINT(0)(" Loaded Resources:\n"); |
---|
| 261 | std::vector<Resources::StorePointer*>::const_iterator it; |
---|
| 262 | for (it = this->_storedResources.begin(); it != this->_storedResources.end(); ++it) |
---|
| 263 | PRINT(0)(" '%s' : KeepLevel '%s'\n", (*it)->loadString().c_str(), (*it)->keepLevel().name().c_str()); |
---|
[9800] | 264 | } |
---|
[9785] | 265 | } |
---|