ResourceCache.cpp 32 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012
  1. //
  2. // Copyright (c) 2008-2014 the Urho3D project.
  3. //
  4. // Permission is hereby granted, free of charge, to any person obtaining a copy
  5. // of this software and associated documentation files (the "Software"), to deal
  6. // in the Software without restriction, including without limitation the rights
  7. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  8. // copies of the Software, and to permit persons to whom the Software is
  9. // furnished to do so, subject to the following conditions:
  10. //
  11. // The above copyright notice and this permission notice shall be included in
  12. // all copies or substantial portions of the Software.
  13. //
  14. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20. // THE SOFTWARE.
  21. //
  22. #include "Precompiled.h"
  23. #include "BackgroundLoader.h"
  24. #include "Context.h"
  25. #include "CoreEvents.h"
  26. #include "FileSystem.h"
  27. #include "FileWatcher.h"
  28. #include "Image.h"
  29. #include "JSONFile.h"
  30. #include "Log.h"
  31. #include "PackageFile.h"
  32. #include "PListFile.h"
  33. #include "Profiler.h"
  34. #include "ResourceCache.h"
  35. #include "ResourceEvents.h"
  36. #include "WorkQueue.h"
  37. #include "XMLFile.h"
  38. #include "DebugNew.h"
  39. namespace Urho3D
  40. {
  41. static const char* checkDirs[] = {
  42. "Fonts",
  43. "Materials",
  44. "Models",
  45. "Music",
  46. "Objects",
  47. "Particle",
  48. "PostProcess",
  49. "RenderPaths",
  50. "Scenes",
  51. "Scripts",
  52. "Sounds",
  53. "Shaders",
  54. "Techniques",
  55. "Textures",
  56. "UI",
  57. 0
  58. };
  59. static const SharedPtr<Resource> noResource;
  60. ResourceCache::ResourceCache(Context* context) :
  61. Object(context),
  62. autoReloadResources_(false),
  63. returnFailedResources_(false),
  64. searchPackagesFirst_(true),
  65. finishBackgroundResourcesMs_(5)
  66. {
  67. // Register Resource library object factories
  68. RegisterResourceLibrary(context_);
  69. // Create resource background loader. Its thread will start on the first background request
  70. backgroundLoader_ = new BackgroundLoader(this);
  71. // Subscribe BeginFrame for handling directory watchers and background loaded resource finalization
  72. SubscribeToEvent(E_BEGINFRAME, HANDLER(ResourceCache, HandleBeginFrame));
  73. }
  74. ResourceCache::~ResourceCache()
  75. {
  76. // Shut down the background loader first
  77. backgroundLoader_.Reset();
  78. }
  79. bool ResourceCache::AddResourceDir(const String& pathName, unsigned priority)
  80. {
  81. MutexLock lock(resourceMutex_);
  82. FileSystem* fileSystem = GetSubsystem<FileSystem>();
  83. if (!fileSystem || !fileSystem->DirExists(pathName))
  84. {
  85. LOGERROR("Could not open directory " + pathName);
  86. return false;
  87. }
  88. // Convert path to absolute
  89. String fixedPath = SanitateResourceDirName(pathName);
  90. // Check that the same path does not already exist
  91. for (unsigned i = 0; i < resourceDirs_.Size(); ++i)
  92. {
  93. if (!resourceDirs_[i].Compare(fixedPath, false))
  94. return true;
  95. }
  96. if (priority < resourceDirs_.Size())
  97. resourceDirs_.Insert(priority, fixedPath);
  98. else
  99. resourceDirs_.Push(fixedPath);
  100. // If resource auto-reloading active, create a file watcher for the directory
  101. if (autoReloadResources_)
  102. {
  103. SharedPtr<FileWatcher> watcher(new FileWatcher(context_));
  104. watcher->StartWatching(fixedPath, true);
  105. fileWatchers_.Push(watcher);
  106. }
  107. LOGINFO("Added resource path " + fixedPath);
  108. return true;
  109. }
  110. bool ResourceCache::AddPackageFile(PackageFile* package, unsigned priority)
  111. {
  112. MutexLock lock(resourceMutex_);
  113. // Do not add packages that failed to load
  114. if (!package || !package->GetNumFiles())
  115. return false;
  116. if (priority < packages_.Size())
  117. packages_.Insert(priority, SharedPtr<PackageFile>(package));
  118. else
  119. packages_.Push(SharedPtr<PackageFile>(package));
  120. LOGINFO("Added resource package " + package->GetName());
  121. return true;
  122. }
  123. bool ResourceCache::AddPackageFile(const String& fileName, unsigned priority)
  124. {
  125. SharedPtr<PackageFile> package(new PackageFile(context_));
  126. return package->Open(fileName) && AddPackageFile(fileName);
  127. }
  128. bool ResourceCache::AddManualResource(Resource* resource)
  129. {
  130. if (!resource)
  131. {
  132. LOGERROR("Null manual resource");
  133. return false;
  134. }
  135. const String& name = resource->GetName();
  136. if (name.Empty())
  137. {
  138. LOGERROR("Manual resource with empty name, can not add");
  139. return false;
  140. }
  141. resource->ResetUseTimer();
  142. resourceGroups_[resource->GetType()].resources_[resource->GetNameHash()] = resource;
  143. UpdateResourceGroup(resource->GetType());
  144. return true;
  145. }
  146. void ResourceCache::RemoveResourceDir(const String& pathName)
  147. {
  148. MutexLock lock(resourceMutex_);
  149. String fixedPath = SanitateResourceDirName(pathName);
  150. for (unsigned i = 0; i < resourceDirs_.Size(); ++i)
  151. {
  152. if (!resourceDirs_[i].Compare(fixedPath, false))
  153. {
  154. resourceDirs_.Erase(i);
  155. // Remove the filewatcher with the matching path
  156. for (unsigned j = 0; j < fileWatchers_.Size(); ++j)
  157. {
  158. if (!fileWatchers_[j]->GetPath().Compare(fixedPath, false))
  159. {
  160. fileWatchers_.Erase(j);
  161. break;
  162. }
  163. }
  164. LOGINFO("Removed resource path " + fixedPath);
  165. return;
  166. }
  167. }
  168. }
  169. void ResourceCache::RemovePackageFile(PackageFile* package, bool releaseResources, bool forceRelease)
  170. {
  171. MutexLock lock(resourceMutex_);
  172. for (Vector<SharedPtr<PackageFile> >::Iterator i = packages_.Begin(); i != packages_.End(); ++i)
  173. {
  174. if (*i == package)
  175. {
  176. if (releaseResources)
  177. ReleasePackageResources(*i, forceRelease);
  178. LOGINFO("Removed resource package " + (*i)->GetName());
  179. packages_.Erase(i);
  180. return;
  181. }
  182. }
  183. }
  184. void ResourceCache::RemovePackageFile(const String& fileName, bool releaseResources, bool forceRelease)
  185. {
  186. MutexLock lock(resourceMutex_);
  187. // Compare the name and extension only, not the path
  188. String fileNameNoPath = GetFileNameAndExtension(fileName);
  189. for (Vector<SharedPtr<PackageFile> >::Iterator i = packages_.Begin(); i != packages_.End(); ++i)
  190. {
  191. if (!GetFileNameAndExtension((*i)->GetName()).Compare(fileNameNoPath, false))
  192. {
  193. if (releaseResources)
  194. ReleasePackageResources(*i, forceRelease);
  195. LOGINFO("Removed resource package " + (*i)->GetName());
  196. packages_.Erase(i);
  197. return;
  198. }
  199. }
  200. }
  201. void ResourceCache::ReleaseResource(StringHash type, const String& name, bool force)
  202. {
  203. StringHash nameHash(name);
  204. const SharedPtr<Resource>& existingRes = FindResource(type, nameHash);
  205. if (!existingRes)
  206. return;
  207. // If other references exist, do not release, unless forced
  208. if ((existingRes.Refs() == 1 && existingRes.WeakRefs() == 0) || force)
  209. {
  210. resourceGroups_[type].resources_.Erase(nameHash);
  211. UpdateResourceGroup(type);
  212. }
  213. }
  214. void ResourceCache::ReleaseResources(StringHash type, bool force)
  215. {
  216. bool released = false;
  217. HashMap<StringHash, ResourceGroup>::Iterator i = resourceGroups_.Find(type);
  218. if (i != resourceGroups_.End())
  219. {
  220. for (HashMap<StringHash, SharedPtr<Resource> >::Iterator j = i->second_.resources_.Begin();
  221. j != i->second_.resources_.End();)
  222. {
  223. HashMap<StringHash, SharedPtr<Resource> >::Iterator current = j++;
  224. // If other references exist, do not release, unless forced
  225. if ((current->second_.Refs() == 1 && current->second_.WeakRefs() == 0) || force)
  226. {
  227. i->second_.resources_.Erase(current);
  228. released = true;
  229. }
  230. }
  231. }
  232. if (released)
  233. UpdateResourceGroup(type);
  234. }
  235. void ResourceCache::ReleaseResources(StringHash type, const String& partialName, bool force)
  236. {
  237. bool released = false;
  238. HashMap<StringHash, ResourceGroup>::Iterator i = resourceGroups_.Find(type);
  239. if (i != resourceGroups_.End())
  240. {
  241. for (HashMap<StringHash, SharedPtr<Resource> >::Iterator j = i->second_.resources_.Begin();
  242. j != i->second_.resources_.End();)
  243. {
  244. HashMap<StringHash, SharedPtr<Resource> >::Iterator current = j++;
  245. if (current->second_->GetName().Contains(partialName))
  246. {
  247. // If other references exist, do not release, unless forced
  248. if ((current->second_.Refs() == 1 && current->second_.WeakRefs() == 0) || force)
  249. {
  250. i->second_.resources_.Erase(current);
  251. released = true;
  252. }
  253. }
  254. }
  255. }
  256. if (released)
  257. UpdateResourceGroup(type);
  258. }
  259. void ResourceCache::ReleaseResources(const String& partialName, bool force)
  260. {
  261. // Some resources refer to others, like materials to textures. Release twice to ensure these get released.
  262. // This is not necessary if forcing release
  263. unsigned repeat = force ? 1 : 2;
  264. while (repeat--)
  265. {
  266. for (HashMap<StringHash, ResourceGroup>::Iterator i = resourceGroups_.Begin(); i != resourceGroups_.End(); ++i)
  267. {
  268. bool released = false;
  269. for (HashMap<StringHash, SharedPtr<Resource> >::Iterator j = i->second_.resources_.Begin();
  270. j != i->second_.resources_.End();)
  271. {
  272. HashMap<StringHash, SharedPtr<Resource> >::Iterator current = j++;
  273. if (current->second_->GetName().Contains(partialName))
  274. {
  275. // If other references exist, do not release, unless forced
  276. if ((current->second_.Refs() == 1 && current->second_.WeakRefs() == 0) || force)
  277. {
  278. i->second_.resources_.Erase(current);
  279. released = true;
  280. }
  281. }
  282. }
  283. if (released)
  284. UpdateResourceGroup(i->first_);
  285. }
  286. }
  287. }
  288. void ResourceCache::ReleaseAllResources(bool force)
  289. {
  290. unsigned repeat = force ? 1 : 2;
  291. while (repeat--)
  292. {
  293. for (HashMap<StringHash, ResourceGroup>::Iterator i = resourceGroups_.Begin();
  294. i != resourceGroups_.End(); ++i)
  295. {
  296. bool released = false;
  297. for (HashMap<StringHash, SharedPtr<Resource> >::Iterator j = i->second_.resources_.Begin();
  298. j != i->second_.resources_.End();)
  299. {
  300. HashMap<StringHash, SharedPtr<Resource> >::Iterator current = j++;
  301. // If other references exist, do not release, unless forced
  302. if ((current->second_.Refs() == 1 && current->second_.WeakRefs() == 0) || force)
  303. {
  304. i->second_.resources_.Erase(current);
  305. released = true;
  306. }
  307. }
  308. if (released)
  309. UpdateResourceGroup(i->first_);
  310. }
  311. }
  312. }
  313. bool ResourceCache::ReloadResource(Resource* resource)
  314. {
  315. if (!resource)
  316. return false;
  317. resource->SendEvent(E_RELOADSTARTED);
  318. bool success = false;
  319. SharedPtr<File> file = GetFile(resource->GetName());
  320. if (file)
  321. success = resource->Load(*(file.Get()));
  322. if (success)
  323. {
  324. resource->ResetUseTimer();
  325. UpdateResourceGroup(resource->GetType());
  326. resource->SendEvent(E_RELOADFINISHED);
  327. return true;
  328. }
  329. // If reloading failed, do not remove the resource from cache, to allow for a new live edit to
  330. // attempt loading again
  331. resource->SendEvent(E_RELOADFAILED);
  332. return false;
  333. }
  334. void ResourceCache::ReloadResourceWithDependencies(const String& fileName)
  335. {
  336. StringHash fileNameHash(fileName);
  337. // If the filename is a resource we keep track of, reload it
  338. const SharedPtr<Resource>& resource = FindResource(fileNameHash);
  339. if (resource)
  340. {
  341. LOGDEBUG("Reloading changed resource " + fileName);
  342. ReloadResource(resource);
  343. }
  344. // Always perform dependency resource check for resource loaded from XML file as it could be used in inheritance
  345. if (!resource || GetExtension(resource->GetName()) == ".xml")
  346. {
  347. // Check if this is a dependency resource, reload dependents
  348. HashMap<StringHash, HashSet<StringHash> >::ConstIterator j = dependentResources_.Find(fileNameHash);
  349. if (j != dependentResources_.End())
  350. {
  351. // Reloading a resource may modify the dependency tracking structure. Therefore collect the
  352. // resources we need to reload first
  353. Vector<SharedPtr<Resource> > dependents;
  354. dependents.Reserve(j->second_.Size());
  355. for (HashSet<StringHash>::ConstIterator k = j->second_.Begin(); k != j->second_.End(); ++k)
  356. {
  357. const SharedPtr<Resource>& dependent = FindResource(*k);
  358. if (dependent)
  359. dependents.Push(dependent);
  360. }
  361. for (unsigned k = 0; k < dependents.Size(); ++k)
  362. {
  363. LOGDEBUG("Reloading resource " + dependents[k]->GetName() + " depending on " + fileName);
  364. ReloadResource(dependents[k]);
  365. }
  366. }
  367. }
  368. }
  369. void ResourceCache::SetMemoryBudget(StringHash type, unsigned budget)
  370. {
  371. resourceGroups_[type].memoryBudget_ = budget;
  372. }
  373. void ResourceCache::SetAutoReloadResources(bool enable)
  374. {
  375. if (enable != autoReloadResources_)
  376. {
  377. if (enable)
  378. {
  379. for (unsigned i = 0; i < resourceDirs_.Size(); ++i)
  380. {
  381. SharedPtr<FileWatcher> watcher(new FileWatcher(context_));
  382. watcher->StartWatching(resourceDirs_[i], true);
  383. fileWatchers_.Push(watcher);
  384. }
  385. }
  386. else
  387. fileWatchers_.Clear();
  388. autoReloadResources_ = enable;
  389. }
  390. }
  391. void ResourceCache::SetReturnFailedResources(bool enable)
  392. {
  393. returnFailedResources_ = enable;
  394. }
  395. SharedPtr<File> ResourceCache::GetFile(const String& nameIn, bool sendEventOnFailure)
  396. {
  397. MutexLock lock(resourceMutex_);
  398. String name = SanitateResourceName(nameIn);
  399. if (resourceRouter_)
  400. resourceRouter_->Route(name, RESOURCE_GETFILE);
  401. if (name.Length())
  402. {
  403. File* file = 0;
  404. if (searchPackagesFirst_)
  405. {
  406. file = SearchPackages(name);
  407. if (!file)
  408. file = SearchResourceDirs(name);
  409. }
  410. else
  411. {
  412. file = SearchResourceDirs(name);
  413. if (!file)
  414. file = SearchPackages(name);
  415. }
  416. if (file)
  417. return SharedPtr<File>(file);
  418. }
  419. if (sendEventOnFailure)
  420. {
  421. if (resourceRouter_ && name.Empty() && !nameIn.Empty())
  422. LOGERROR("Resource request " + nameIn + " was blocked");
  423. else
  424. LOGERROR("Could not find resource " + name);
  425. if (Thread::IsMainThread())
  426. {
  427. using namespace ResourceNotFound;
  428. VariantMap& eventData = GetEventDataMap();
  429. eventData[P_RESOURCENAME] = name.Length() ? name : nameIn;
  430. SendEvent(E_RESOURCENOTFOUND, eventData);
  431. }
  432. }
  433. return SharedPtr<File>();
  434. }
  435. Resource* ResourceCache::GetResource(StringHash type, const String& nameIn, bool sendEventOnFailure)
  436. {
  437. String name = SanitateResourceName(nameIn);
  438. if (!Thread::IsMainThread())
  439. {
  440. LOGERROR("Attempted to get resource " + name + " from outside the main thread");
  441. return 0;
  442. }
  443. // If empty name, return null pointer immediately
  444. if (name.Empty())
  445. return 0;
  446. StringHash nameHash(name);
  447. // Check if the resource is being background loaded but is now needed immediately
  448. backgroundLoader_->WaitForResource(type, nameHash);
  449. const SharedPtr<Resource>& existing = FindResource(type, nameHash);
  450. if (existing)
  451. return existing;
  452. SharedPtr<Resource> resource;
  453. // Make sure the pointer is non-null and is a Resource subclass
  454. resource = DynamicCast<Resource>(context_->CreateObject(type));
  455. if (!resource)
  456. {
  457. LOGERROR("Could not load unknown resource type " + String(type));
  458. if (sendEventOnFailure)
  459. {
  460. using namespace UnknownResourceType;
  461. VariantMap& eventData = GetEventDataMap();
  462. eventData[P_RESOURCETYPE] = type;
  463. SendEvent(E_UNKNOWNRESOURCETYPE, eventData);
  464. }
  465. return 0;
  466. }
  467. // Attempt to load the resource
  468. SharedPtr<File> file = GetFile(name, sendEventOnFailure);
  469. if (!file)
  470. return 0; // Error is already logged
  471. LOGDEBUG("Loading resource " + name);
  472. resource->SetName(name);
  473. if (!resource->Load(*(file.Get())))
  474. {
  475. // Error should already been logged by corresponding resource descendant class
  476. if (sendEventOnFailure)
  477. {
  478. using namespace LoadFailed;
  479. VariantMap& eventData = GetEventDataMap();
  480. eventData[P_RESOURCENAME] = name;
  481. SendEvent(E_LOADFAILED, eventData);
  482. }
  483. if (!returnFailedResources_)
  484. return 0;
  485. }
  486. // Store to cache
  487. resource->ResetUseTimer();
  488. resourceGroups_[type].resources_[nameHash] = resource;
  489. UpdateResourceGroup(type);
  490. return resource;
  491. }
  492. bool ResourceCache::BackgroundLoadResource(StringHash type, const String& nameIn, bool sendEventOnFailure, Resource* caller)
  493. {
  494. // If empty name, fail immediately
  495. String name = SanitateResourceName(nameIn);
  496. if (name.Empty())
  497. return false;
  498. // First check if already exists as a loaded resource
  499. StringHash nameHash(name);
  500. if (FindResource(type, nameHash) != noResource)
  501. return false;
  502. return backgroundLoader_->QueueResource(type, name, sendEventOnFailure, caller);
  503. }
  504. SharedPtr<Resource> ResourceCache::GetTempResource(StringHash type, const String& nameIn, bool sendEventOnFailure)
  505. {
  506. String name = SanitateResourceName(nameIn);
  507. // If empty name, return null pointer immediately
  508. if (name.Empty())
  509. return SharedPtr<Resource>();
  510. SharedPtr<Resource> resource;
  511. // Make sure the pointer is non-null and is a Resource subclass
  512. resource = DynamicCast<Resource>(context_->CreateObject(type));
  513. if (!resource)
  514. {
  515. LOGERROR("Could not load unknown resource type " + String(type));
  516. if (sendEventOnFailure)
  517. {
  518. using namespace UnknownResourceType;
  519. VariantMap& eventData = GetEventDataMap();
  520. eventData[P_RESOURCETYPE] = type;
  521. SendEvent(E_UNKNOWNRESOURCETYPE, eventData);
  522. }
  523. return SharedPtr<Resource>();
  524. }
  525. // Attempt to load the resource
  526. SharedPtr<File> file = GetFile(name, sendEventOnFailure);
  527. if (!file)
  528. return SharedPtr<Resource>(); // Error is already logged
  529. LOGDEBUG("Loading temporary resource " + name);
  530. resource->SetName(file->GetName());
  531. if (!resource->Load(*(file.Get())))
  532. {
  533. // Error should already been logged by corresponding resource descendant class
  534. if (sendEventOnFailure)
  535. {
  536. using namespace LoadFailed;
  537. VariantMap& eventData = GetEventDataMap();
  538. eventData[P_RESOURCENAME] = name;
  539. SendEvent(E_LOADFAILED, eventData);
  540. }
  541. return SharedPtr<Resource>();
  542. }
  543. return resource;
  544. }
  545. unsigned ResourceCache::GetNumBackgroundLoadResources() const
  546. {
  547. return backgroundLoader_->GetNumQueuedResources();
  548. }
  549. void ResourceCache::GetResources(PODVector<Resource*>& result, StringHash type) const
  550. {
  551. result.Clear();
  552. HashMap<StringHash, ResourceGroup>::ConstIterator i = resourceGroups_.Find(type);
  553. if (i != resourceGroups_.End())
  554. {
  555. for (HashMap<StringHash, SharedPtr<Resource> >::ConstIterator j = i->second_.resources_.Begin();
  556. j != i->second_.resources_.End(); ++j)
  557. result.Push(j->second_);
  558. }
  559. }
  560. bool ResourceCache::Exists(const String& nameIn) const
  561. {
  562. MutexLock lock(resourceMutex_);
  563. String name = SanitateResourceName(nameIn);
  564. if (resourceRouter_)
  565. resourceRouter_->Route(name, RESOURCE_CHECKEXISTS);
  566. if (name.Empty())
  567. return false;
  568. for (unsigned i = 0; i < packages_.Size(); ++i)
  569. {
  570. if (packages_[i]->Exists(name))
  571. return true;
  572. }
  573. FileSystem* fileSystem = GetSubsystem<FileSystem>();
  574. for (unsigned i = 0; i < resourceDirs_.Size(); ++i)
  575. {
  576. if (fileSystem->FileExists(resourceDirs_[i] + name))
  577. return true;
  578. }
  579. // Fallback using absolute path
  580. if (fileSystem->FileExists(name))
  581. return true;
  582. return false;
  583. }
  584. unsigned ResourceCache::GetMemoryBudget(StringHash type) const
  585. {
  586. HashMap<StringHash, ResourceGroup>::ConstIterator i = resourceGroups_.Find(type);
  587. if (i != resourceGroups_.End())
  588. return i->second_.memoryBudget_;
  589. else
  590. return 0;
  591. }
  592. unsigned ResourceCache::GetMemoryUse(StringHash type) const
  593. {
  594. HashMap<StringHash, ResourceGroup>::ConstIterator i = resourceGroups_.Find(type);
  595. if (i != resourceGroups_.End())
  596. return i->second_.memoryUse_;
  597. else
  598. return 0;
  599. }
  600. unsigned ResourceCache::GetTotalMemoryUse() const
  601. {
  602. unsigned total = 0;
  603. for (HashMap<StringHash, ResourceGroup>::ConstIterator i = resourceGroups_.Begin(); i != resourceGroups_.End(); ++i)
  604. total += i->second_.memoryUse_;
  605. return total;
  606. }
  607. String ResourceCache::GetResourceFileName(const String& name) const
  608. {
  609. MutexLock lock(resourceMutex_);
  610. FileSystem* fileSystem = GetSubsystem<FileSystem>();
  611. for (unsigned i = 0; i < resourceDirs_.Size(); ++i)
  612. {
  613. if (fileSystem->FileExists(resourceDirs_[i] + name))
  614. return resourceDirs_[i] + name;
  615. }
  616. return String();
  617. }
  618. String ResourceCache::GetPreferredResourceDir(const String& path) const
  619. {
  620. String fixedPath = AddTrailingSlash(path);
  621. bool pathHasKnownDirs = false;
  622. bool parentHasKnownDirs = false;
  623. FileSystem* fileSystem = GetSubsystem<FileSystem>();
  624. for (unsigned i = 0; checkDirs[i] != 0; ++i)
  625. {
  626. if (fileSystem->DirExists(fixedPath + checkDirs[i]))
  627. {
  628. pathHasKnownDirs = true;
  629. break;
  630. }
  631. }
  632. if (!pathHasKnownDirs)
  633. {
  634. String parentPath = GetParentPath(fixedPath);
  635. for (unsigned i = 0; checkDirs[i] != 0; ++i)
  636. {
  637. if (fileSystem->DirExists(parentPath + checkDirs[i]))
  638. {
  639. parentHasKnownDirs = true;
  640. break;
  641. }
  642. }
  643. // If path does not have known subdirectories, but the parent path has, use the parent instead
  644. if (parentHasKnownDirs)
  645. fixedPath = parentPath;
  646. }
  647. return fixedPath;
  648. }
  649. String ResourceCache::SanitateResourceName(const String& nameIn) const
  650. {
  651. // Sanitate unsupported constructs from the resource name
  652. String name = GetInternalPath(nameIn);
  653. name.Replace("../", "");
  654. name.Replace("./", "");
  655. // If the path refers to one of the resource directories, normalize the resource name
  656. FileSystem* fileSystem = GetSubsystem<FileSystem>();
  657. if (resourceDirs_.Size())
  658. {
  659. String namePath = GetPath(name);
  660. String exePath = fileSystem->GetProgramDir();
  661. for (unsigned i = 0; i < resourceDirs_.Size(); ++i)
  662. {
  663. String relativeResourcePath = resourceDirs_[i];
  664. if (relativeResourcePath.StartsWith(exePath))
  665. relativeResourcePath = relativeResourcePath.Substring(exePath.Length());
  666. if (namePath.StartsWith(resourceDirs_[i], false))
  667. namePath = namePath.Substring(resourceDirs_[i].Length());
  668. else if (namePath.StartsWith(relativeResourcePath, false))
  669. namePath = namePath.Substring(relativeResourcePath.Length());
  670. }
  671. name = namePath + GetFileNameAndExtension(name);
  672. }
  673. return name.Trimmed();
  674. }
  675. String ResourceCache::SanitateResourceDirName(const String& nameIn) const
  676. {
  677. String fixedPath = AddTrailingSlash(nameIn);
  678. if (!IsAbsolutePath(fixedPath))
  679. fixedPath = GetSubsystem<FileSystem>()->GetCurrentDir() + fixedPath;
  680. // Sanitate away /./ construct
  681. fixedPath.Replace("/./", "/");
  682. return fixedPath.Trimmed();
  683. }
  684. void ResourceCache::StoreResourceDependency(Resource* resource, const String& dependency)
  685. {
  686. // If resource reloading is not on, do not create the dependency data structure (saves memory)
  687. if (!resource || !autoReloadResources_)
  688. return;
  689. MutexLock lock(resourceMutex_);
  690. StringHash nameHash(resource->GetName());
  691. HashSet<StringHash>& dependents = dependentResources_[dependency];
  692. dependents.Insert(nameHash);
  693. }
  694. void ResourceCache::ResetDependencies(Resource* resource)
  695. {
  696. if (!resource || !autoReloadResources_)
  697. return;
  698. MutexLock lock(resourceMutex_);
  699. StringHash nameHash(resource->GetName());
  700. for (HashMap<StringHash, HashSet<StringHash> >::Iterator i = dependentResources_.Begin(); i !=
  701. dependentResources_.End();)
  702. {
  703. HashSet<StringHash>& dependents = i->second_;
  704. dependents.Erase(nameHash);
  705. if (dependents.Empty())
  706. i = dependentResources_.Erase(i);
  707. else
  708. ++i;
  709. }
  710. }
  711. const SharedPtr<Resource>& ResourceCache::FindResource(StringHash type, StringHash nameHash)
  712. {
  713. MutexLock lock(resourceMutex_);
  714. HashMap<StringHash, ResourceGroup>::Iterator i = resourceGroups_.Find(type);
  715. if (i == resourceGroups_.End())
  716. return noResource;
  717. HashMap<StringHash, SharedPtr<Resource> >::Iterator j = i->second_.resources_.Find(nameHash);
  718. if (j == i->second_.resources_.End())
  719. return noResource;
  720. return j->second_;
  721. }
  722. const SharedPtr<Resource>& ResourceCache::FindResource(StringHash nameHash)
  723. {
  724. MutexLock lock(resourceMutex_);
  725. for (HashMap<StringHash, ResourceGroup>::Iterator i = resourceGroups_.Begin(); i != resourceGroups_.End(); ++i)
  726. {
  727. HashMap<StringHash, SharedPtr<Resource> >::Iterator j = i->second_.resources_.Find(nameHash);
  728. if (j != i->second_.resources_.End())
  729. return j->second_;
  730. }
  731. return noResource;
  732. }
  733. void ResourceCache::ReleasePackageResources(PackageFile* package, bool force)
  734. {
  735. HashSet<StringHash> affectedGroups;
  736. const HashMap<String, PackageEntry>& entries = package->GetEntries();
  737. for (HashMap<String, PackageEntry>::ConstIterator i = entries.Begin(); i != entries.End(); ++i)
  738. {
  739. StringHash nameHash(i->first_);
  740. // We do not know the actual resource type, so search all type containers
  741. for (HashMap<StringHash, ResourceGroup>::Iterator j = resourceGroups_.Begin();
  742. j != resourceGroups_.End(); ++j)
  743. {
  744. HashMap<StringHash, SharedPtr<Resource> >::Iterator k = j->second_.resources_.Find(nameHash);
  745. if (k != j->second_.resources_.End())
  746. {
  747. // If other references exist, do not release, unless forced
  748. if ((k->second_.Refs() == 1 && k->second_.WeakRefs() == 0) || force)
  749. {
  750. j->second_.resources_.Erase(k);
  751. affectedGroups.Insert(j->first_);
  752. }
  753. break;
  754. }
  755. }
  756. }
  757. for (HashSet<StringHash>::Iterator i = affectedGroups.Begin(); i != affectedGroups.End(); ++i)
  758. UpdateResourceGroup(*i);
  759. }
  760. void ResourceCache::UpdateResourceGroup(StringHash type)
  761. {
  762. HashMap<StringHash, ResourceGroup>::Iterator i = resourceGroups_.Find(type);
  763. if (i == resourceGroups_.End())
  764. return;
  765. for (;;)
  766. {
  767. unsigned totalSize = 0;
  768. unsigned oldestTimer = 0;
  769. HashMap<StringHash, SharedPtr<Resource> >::Iterator oldestResource = i->second_.resources_.End();
  770. for (HashMap<StringHash, SharedPtr<Resource> >::Iterator j = i->second_.resources_.Begin();
  771. j != i->second_.resources_.End(); ++j)
  772. {
  773. totalSize += j->second_->GetMemoryUse();
  774. unsigned useTimer = j->second_->GetUseTimer();
  775. if (useTimer > oldestTimer)
  776. {
  777. oldestTimer = useTimer;
  778. oldestResource = j;
  779. }
  780. }
  781. i->second_.memoryUse_ = totalSize;
  782. // If memory budget defined and is exceeded, remove the oldest resource and loop again
  783. // (resources in use always return a zero timer and can not be removed)
  784. if (i->second_.memoryBudget_ && i->second_.memoryUse_ > i->second_.memoryBudget_ &&
  785. oldestResource != i->second_.resources_.End())
  786. {
  787. LOGDEBUG("Resource group " + oldestResource->second_->GetTypeName() + " over memory budget, releasing resource " +
  788. oldestResource->second_->GetName());
  789. i->second_.resources_.Erase(oldestResource);
  790. }
  791. else
  792. break;
  793. }
  794. }
  795. void ResourceCache::HandleBeginFrame(StringHash eventType, VariantMap& eventData)
  796. {
  797. for (unsigned i = 0; i < fileWatchers_.Size(); ++i)
  798. {
  799. String fileName;
  800. while (fileWatchers_[i]->GetNextChange(fileName))
  801. {
  802. ReloadResourceWithDependencies(fileName);
  803. // Finally send a general file changed event even if the file was not a tracked resource
  804. using namespace FileChanged;
  805. VariantMap& eventData = GetEventDataMap();
  806. eventData[P_FILENAME] = fileWatchers_[i]->GetPath() + fileName;
  807. eventData[P_RESOURCENAME] = fileName;
  808. SendEvent(E_FILECHANGED, eventData);
  809. }
  810. }
  811. // Check for background loaded resources that can be finished
  812. {
  813. PROFILE(FinishBackgroundResources);
  814. backgroundLoader_->FinishResources(finishBackgroundResourcesMs_);
  815. }
  816. }
  817. File* ResourceCache::SearchResourceDirs(const String& nameIn)
  818. {
  819. FileSystem* fileSystem = GetSubsystem<FileSystem>();
  820. for (unsigned i = 0; i < resourceDirs_.Size(); ++i)
  821. {
  822. if (fileSystem->FileExists(resourceDirs_[i] + nameIn))
  823. {
  824. // Construct the file first with full path, then rename it to not contain the resource path,
  825. // so that the file's name can be used in further GetFile() calls (for example over the network)
  826. File* file(new File(context_, resourceDirs_[i] + nameIn));
  827. file->SetName(nameIn);
  828. return file;
  829. }
  830. }
  831. // Fallback using absolute path
  832. if (fileSystem->FileExists(nameIn))
  833. return new File(context_, nameIn);
  834. return 0;
  835. }
  836. File* ResourceCache::SearchPackages(const String& nameIn)
  837. {
  838. for (unsigned i = 0; i < packages_.Size(); ++i)
  839. {
  840. if (packages_[i]->Exists(nameIn))
  841. return new File(context_, packages_[i], nameIn);
  842. }
  843. return 0;
  844. }
  845. void RegisterResourceLibrary(Context* context)
  846. {
  847. Image::RegisterObject(context);
  848. JSONFile::RegisterObject(context);
  849. PListFile::RegisterObject(context);
  850. XMLFile::RegisterObject(context);
  851. }
  852. }