Skip to content
Snippets Groups Projects
Select Git revision
  • master default
  • mingw_gcc44
  • release_ABP1_012
  • release_ABP1_008
  • release_ABP1_006
  • release_ABP1_007
  • release_ABP1_005
  • release_ABP1_004
  • release_ABP1_003
  • pre_release_0.15
  • release_ABP1_001
  • release_ABP1_002
  • pre_release_0.13
  • pre_release_0.14
  • pre_release_0.11
  • pre_release_0.12
  • pre_release_0.10
  • pre_release_0.09
  • pre_release_0.08
19 results

ResourceFactory.h

Blame
  • Forked from einsteinathome / graphicsframework
    238 commits behind the upstream repository.
    ResourceFactory.h 2.71 KiB
    #ifndef RESOURCEFACTORY_H_
    #define RESOURCEFACTORY_H_
    
    #include <string>
    #include <map>
    #include <iostream>
    
    #include "Resource.h"
    
    /**
     * \brief This factory instantiates %Resource objects using a given identifier
     * 
     * During contruction of the factory object itself it loads all available resources into
     * an internal cache. The user can subsequently request a copy of this resource by specifying
     * it using the resource's identifier.
     *
     * The resource data is expected to be stored in these three externally linked arrays:
     * - \ref c_ResourceIdentifiers
     * - \ref c_ResourceIndex 
     * - \ref c_ResourceStorage
     *
     * These arrays are compiled using the Open %Resource Compiler (ORC) which can be found
     * in the \c orc subdirectory.
     * 
     * \see Resource
     * \see ResourceCompiler
     *  
     * \author Oliver Bock\n
     * Max-Planck-Institute for Gravitational Physics\n
     * Hannover, Germany
     */
    class ResourceFactory
    {
    public:
    	/// Default constructor
    	ResourceFactory();
    	
    	/// Destructor
    	virtual ~ResourceFactory();
    	
    	/**
    	 * \brief Creates an instance of the requested resource
    	 * 
    	 * The identifier has to be the same as the one specified in the \c *.orc file
    	 * used to compile the resources
    	 * 
    	 * \param identifier The identifer of the resource to be instantiated
    	 * 
    	 * \return A constant pointer to the newly instantiated resource
    	 * or NULL if the specified resource could not be found
    	 * 
    	 * \see ResourceCompiler
    	 */
    	const Resource* createInstance(const string identifier);
    	
    private:
    	/// Hashtable mapping identifiers to resource data
    	map<string, vector<unsigned char> > m_ResourceMap;
    };
    
    /**
     * \brief Declaration of the external list of resource identifiers
     * 
     * \todo Does this need to be global?
     * Maybe we should wrap a class around the generated resources?
     */
    extern "C++" const string c_ResourceIdentifiers[];
    
    /**
     * \brief Declaration of the external list of resource indices
     * 
     * This two-dimensional array contains the necessary indices for
     * every resource in the storage container. Using these indices you
     * can easily extract a requested resource:
     * -# Offset to the resource
     * -# Length of the resource
     * 
     * \todo Does this need to be global?
     * Maybe we should wrap a class around the generated resources?
     */
    extern "C++" const unsigned int c_ResourceIndex[][2];
    
    /**
     * \brief Declaration of the external resource storage container
     * 
     * The container comprises all resources in a continuous byte sequence
     * expressed as hex values. Use the resource index to locate/retrieve
     * a specific resource from the container.
     * 
     * \todo Does this need to be global?
     * Maybe we should wrap a class around the generated resources?
     */
    extern "C++" const unsigned char c_ResourceStorage[];
    
    #endif /*RESOURCEFACTORY_H_*/