1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
// -----------------------------------------------------------------------------
// This file is part of Broken Sword 2.5
// Copyright (c) Malte Thiesen, Daniel Queteschiner and Michael Elsd�rfer
//
// Broken Sword 2.5 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.
//
// Broken Sword 2.5 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 Broken Sword 2.5; if not, write to the Free Software
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
// -----------------------------------------------------------------------------
#ifndef SWORD25_RESOURCEMANAGER_H
#define SWORD25_RESOURCEMANAGER_H
// Includes
#include "sword25/kernel/memlog_off.h"
#include <vector>
#include <list>
#include "sword25/kernel/memlog_on.h"
#include "sword25/kernel/common.h"
// Klassendefinition
class BS_ResourceService;
class BS_Resource;
class BS_Kernel;
class BS_ResourceManager
{
friend class BS_Kernel;
public:
/**
@brief Fordert eine Resource an.
@param FileName Dateiname
@return Gibt die Resource zur�ck, falls erfolgreich, sonst NULL
*/
BS_Resource* RequestResource(const std::string& FileName);
/**
@brief L�dt eine Resource in den Cache.
@param FileName der Dateiname der zu cachenden Resource
@param ForceReload gibt an, ob die Datei auch neu geladen werden soll, wenn sie bereits geladen wurde.
Dies ist n�tzlich bei Dateien, die sich in der Zwischenzeit ver�ndert haben.
@return Gibt true zur�ck, wenn das Caching durchgef�hrt werden konnte, ansonsten false.
*/
bool PrecacheResource(const std::string& FileName, bool ForceReload = false);
/**
@brief Gibt die Anzahl der geladenen Resourcen zur�ck.
*/
int GetResourceCount() const { return static_cast<int>(m_Resources.size()); }
/**
@brief Gibt einen Pointer auf eine Resource anhand deren laufender Nummer zur�ck.
@param Ord laufende Nummer der Resource. Dieser Wert muss zwischen 0 und GetResourceCount() - 1 liegen.
@return Gibt einen Pointer auf die Resource zur�ck wenn erfolgreich, ansonsten NULL.
@remark Diese Methode ist nicht auf Geschwindigkeit optimiert und sollte nur f�r Debugzwecke eingesetzt werden.
*/
BS_Resource* GetResourceByOrdinal(int Ord) const;
/**
@brief RegisterResourceService Diese Methode wird vom Konstruktor von
BS_ResourceService aufgerufen und tr�gt somit alle
Resource-Services in einen Liste des
Resource-Managers ein.
@param pService welches Service
@return gibt true zur�ck, falls erfolgreich
*/
bool RegisterResourceService(BS_ResourceService* pService);
/**
* @brief gibt alle Resourcen frei, die nicht gelocked sind.
**/
void EmptyCache();
/**
@brief Gibt zur�ck wie viel Speicher die Engine maximal belegen soll.
*/
int GetMaxMemoryUsage() const { return m_MaxMemoryUsage; }
/**
@brief Legt fest wie viel Speicher die Engine maximal belegen soll.
Wenn dieser Wert �berschritten wird, werden Resourcen entladen um Platz zu schaffen. Dieser Wert ist als Richtgr��e zu verstehen und nicht als feste Grenze.
Es ist unter KEINEN Umst�nden garantiert, dass die Engine tats�chlich nur so viel Speicher benutzt.
*/
void SetMaxMemoryUsage(unsigned int MaxMemoryUsage);
/**
@brief Gibt an, ob eine Warnung ins Log geschrieben wird, wenn ein Cache-Miss auftritt.
Der Standardwert ist "false".
*/
bool IsLogCacheMiss() const { return m_LogCacheMiss; }
/**
@brief Legt fest, ob eine Warnung ins Log geschrieben wird, wenn in Cache-Miss auftritt.
@param Flag wenn "true" wird die Warnung in Zukunft ausgegeben, ansonsten nicht.
*/
void SetLogCacheMiss(bool Flag) { m_LogCacheMiss = Flag; }
/**
@brief Schreibt die Namen aller gelockten Resourcen in die Log-Datei.
*/
void DumpLockedResources();
private:
/**
@brief Erzeugt einen neuen Resource-Manager.
@param pKernel ein Pointer auf den Kernel.
@remark Nur der BS_Kernel darf Exemplare dieser Klasse erzeugen. Daher ist der Konstruktor private.
*/
BS_ResourceManager(BS_Kernel* pKernel) :
m_KernelPtr(pKernel),
m_MaxMemoryUsage(100000000),
m_LogCacheMiss(false)
{};
virtual ~BS_ResourceManager();
enum
{
HASH_TABLE_BUCKETS = 256
};
/**
@brief Verschiebt eine Resource an die Spitze der Resourcenliste.
@param pResource die Resource
*/
void MoveToFront(BS_Resource* pResource);
/**
@brief L�dt eine Resource und aktualisiert m_UsedMemory.
Die Resource darf nicht bereits geladen sein.
@param FileName der absolute und eindeutige Dateiname der zu ladenen Resource
@return Gibt einen Pointer auf die geladene Resource zur�ck wenn das Laden erfolgreich war, ansonsten NULL.
*/
BS_Resource* LoadResource(const std::string& FileName);
/**
@brief Gibt zu einer Datei ihren absoluten, eindeutigen Pfad zur�ck.
@param FileName der Dateiname
@return Der absolute, eindeutige Pfad zur Datei inklusive des Dateinamens.<br>
Gibt einen leeren std::string zur�ck, wenn der Pfad nicht erzeugt werden konnte.
*/
std::string GetUniqueFileName(const std::string& FileName) const;
/**
@brief L�scht eine Resource entfernt sie aus den Listen und aktualisiert m_UsedMemory.
@param pResource die zu l�schende Resource
@return Gibt einen Iterator zur�ck, der auf die n�chste Resource in der Resourcenliste zeigt.
*/
std::list<BS_Resource*>::iterator DeleteResource(BS_Resource* pResource);
/**
@brief Holt einen Pointer zu einer geladenen Resource.
@param UniqueFileName der absolute, eindeutige Pfad zur Datei inklusive des Dateinamens.
@return Gibt einen Pointer auf die angeforderte Resource zur�ck, oder NULL, wenn die Resourcen nicht geladen ist.
*/
BS_Resource* GetResource(const std::string& UniqueFileName) const;
/**
@brief L�scht solange Resourcen, bis der Prozess unter das angegebene Maximun an Speicherbelegung kommt.
*/
void DeleteResourcesIfNecessary();
BS_Kernel* m_KernelPtr;
unsigned int m_MaxMemoryUsage;
std::vector<BS_ResourceService*> m_ResourceServices;
std::list<BS_Resource*> m_Resources;
std::list<BS_Resource*> m_ResourceHashTable[HASH_TABLE_BUCKETS];
bool m_LogCacheMiss;
};
#endif
|