ResourceManager Class Reference

#include <ResourceManager.h>

List of all members.

Public Member Functions
	ResourceManager ()
	~ResourceManager ()
IResource *	Acquire (std::string key)
IResource *	AcquireRandom (std::string type)
void	Release (IResource *resource)
void	LoadXMLFile (std::string filename, std::auto_ptr< IResourceFactory > factory)
void	LogDebugInfo ()
Static Public Member Functions
static void	Initialize ()
static void	Shutdown ()
Static Public Attributes
static ResourceManager *	s_resourceManager = NULL
Private Member Functions
IResource *	DoAcquireResource (ResourceEntry *entry)
Private Attributes
ResourceMap	m_resources
ResourceTypeMap	m_typeVectors

---

Detailed Description

Definition at line 20 of file ResourceManager.h.

---

Constructor & Destructor Documentation

ResourceManager::ResourceManager

(

)

Definition at line 24 of file ResourceManager.cpp.

References Log::Message(), and Log::s_log.

Referenced by Initialize().

                                 {
  // Does anything need to happen here?
  Log::s_log->Message("Resource manager initialized");
}

ResourceManager::~ResourceManager

(

)

Definition at line 29 of file ResourceManager.cpp.

References m_resources, m_typeVectors, Log::Message(), ResourceEntry::resource, and Log::s_log.

                                  {
  ResourceEntry *entry;
  string key;

  m_typeVectors.clear();

  // Loop through all the resources, free them and the ResourceEntry the map was using
  while (!m_resources.empty()) {
    entry = m_resources.begin()->second;
    key = m_resources.begin()->first;
    delete entry->resource;
    m_resources.erase(key);
    delete entry;
  }

  if (!m_resources.empty()) {
    Log::s_log->Message("Warning: Could not empty resource map");
  }

  Log::s_log->Message("Resource manager shut down");
}

---

Member Function Documentation

IResource * ResourceManager::Acquire

(

std::string

key

)

Definition at line 51 of file ResourceManager.cpp.

References DoAcquireResource(), and m_resources.

                                              {
  ResourceEntry *entry;

  entry = m_resources[key];
  if (entry == NULL) {
    throw string("Key not found in resource map (" + key + ")");
  }

  return DoAcquireResource(entry);
}

IResource * ResourceManager::AcquireRandom

(

std::string

type

)

Definition at line 62 of file ResourceManager.cpp.

References DoAcquireResource(), IResource::GetKey(), m_typeVectors, Log::Message(), randInt(), ResourceEntry::resource, and Log::s_log.

                                                     {
  ResourceEntryVector resources;
  unsigned int index;
  ResourceEntry *entry;

  resources = m_typeVectors[type];
  if (resources.empty()) {
    throw string("Zero resources of type " + type + " found");
  }

  index = (unsigned int) randInt(resources.size() - 1);
  entry = resources[index];
  Log::s_log->Message("Got random resource: %s", entry->resource->GetKey().c_str());

  return DoAcquireResource(entry);
}

IResource * ResourceManager::DoAcquireResource

(

ResourceEntry *

entry

)

[private]

Definition at line 79 of file ResourceManager.cpp.

References IResource::Load(), ResourceEntry::refCount, and ResourceEntry::resource.

Referenced by Acquire(), and AcquireRandom().

                                                                  {
  // Check to see if this is the first use of this resource, load it if it is
  if (entry->refCount == 0) {
    entry->resource->Load();
  }
  // Increment the reference count
  ++entry->refCount;

  return entry->resource;
}

void ResourceManager::Initialize

(

)

[static]

Definition at line 141 of file ResourceManager.cpp.

References Log::Message(), ResourceManager(), Log::s_log, and s_resourceManager.

Referenced by main().

                                 {
  if (s_resourceManager != NULL) {
    Log::s_log->Message("Warning: Attempt to re-initialize resource manager");
    return;
  }

  s_resourceManager = new ResourceManager();
}

void ResourceManager::LoadXMLFile	(	std::string	filename,
		std::auto_ptr< IResourceFactory >	factory
	)

Definition at line 106 of file ResourceManager.cpp.

References m_resources, m_typeVectors, Log::Message(), and Log::s_log.

Referenced by init().

                                                                                        {
  TiXmlElement *elem;
  TiXmlDocument doc( filename.c_str() );

  doc.LoadFile();
  if (doc.Error()) {
    // Should throw an exception
    Log::s_log->Message("Warning: Could not load %s. %s (line %d, column %d)", filename.c_str(), doc.ErrorDesc(), doc.ErrorRow(), doc.ErrorCol());
    return;
  }

  for (elem = doc.FirstChildElement("Resources")->FirstChildElement("Resource"); elem; elem = elem->NextSiblingElement("Resource")) {
    ResourceEntry *entry = new ResourceEntry;
    entry->refCount = 0;
    try {
      entry->resource = factory->NewResource(elem);
      if (entry->resource == NULL) {
        throw string("Factory returned null pointer");
      }
      m_resources[entry->resource->GetKey()] = entry;

      m_typeVectors[entry->resource->GetType()].push_back(entry);
    } catch (string e) {
      delete entry;
      throw e;
    }
  }

  Log::s_log->Message("Resource file %s loaded", filename.c_str());
}

void ResourceManager::LogDebugInfo

(

)

Definition at line 137 of file ResourceManager.cpp.

References m_resources, Log::Message(), and Log::s_log.

                                   {
  Log::s_log->Message("%d total resources", m_resources.size());
}

void ResourceManager::Release

(

IResource *

resource

)

Definition at line 90 of file ResourceManager.cpp.

References IResource::GetKey(), m_resources, ResourceEntry::refCount, ResourceEntry::resource, and IResource::Unload().

Referenced by Ship::ReleaseResource(), CCFont::~CCFont(), SoundEffect::~SoundEffect(), and Texture::~Texture().

                                                 {
  ResourceEntry *entry;

  entry = m_resources[resource->GetKey()];
  if (entry == NULL) {
    throw string("Key not found in resource map (" + resource->GetKey() + ")");
  }

  // Decrement the reference count
  --entry->refCount;
  // Check to see if we are releasing the last reference to this resource, and unload it if we are
  if (entry->refCount == 0) {
    entry->resource->Unload();
  }
}

void ResourceManager::Shutdown

(

)

[static]

Definition at line 150 of file ResourceManager.cpp.

References Log::Message(), Log::s_log, and s_resourceManager.

Referenced by prepExit().

                               {
  if (s_resourceManager == NULL) {
    Log::s_log->Message("Warning: Attempt to re-shutdown resource manager");
    return;
  }
  delete s_resourceManager;
  s_resourceManager = NULL;
}

---

Member Data Documentation

ResourceMap ResourceManager::m_resources [private]

Definition at line 42 of file ResourceManager.h.

Referenced by Acquire(), LoadXMLFile(), LogDebugInfo(), Release(), and ~ResourceManager().

ResourceTypeMap ResourceManager::m_typeVectors [private]

Definition at line 43 of file ResourceManager.h.

Referenced by AcquireRandom(), LoadXMLFile(), and ~ResourceManager().

ResourceManager * ResourceManager::s_resourceManager = NULL [static]

Definition at line 37 of file ResourceManager.h.

Referenced by Ship::AcquireResource(), CCFont::CCFont(), init(), Initialize(), Ship::ReleaseResource(), Ship::Ship(), Shutdown(), SoundEffect::SoundEffect(), Texture::Texture(), CCFont::~CCFont(), SoundEffect::~SoundEffect(), and Texture::~Texture().

---

The documentation for this class was generated from the following files:

• src/ResourceManager/ResourceManager.h
• src/ResourceManager/ResourceManager.cpp

---