The PageManager is the entry point through which you load all PagedWorld instances, and the place where PageStrategy instances and factory classes are registered to customise the paging behaviour. More...
#include <OgrePageManager.h>
Classes | |
class | EventRouter |
Public Types | |
typedef vector< Camera * >::type | CameraList |
typedef map< String, PageContentCollectionFactory * > ::type | ContentCollectionFactoryMap |
typedef map< String, PageContentFactory * >::type | ContentFactoryMap |
typedef map< String, PageStrategy * >::type | StrategyMap |
typedef map< String, PagedWorld * >::type | WorldMap |
typedef map< String, PagedWorldSectionFactory * > ::type | WorldSectionFactoryMap |
Public Member Functions | |
PageManager () | |
virtual | ~PageManager () |
virtual bool | _loadProceduralPage (Page *page, PagedWorldSection *section) |
Give a provider the opportunity to prepare page content procedurally. More... | |
virtual bool | _prepareProceduralPage (Page *page, PagedWorldSection *section) |
Give a provider the opportunity to prepare page content procedurally. More... | |
StreamSerialiser * | _readPageStream (PageID pageID, PagedWorldSection *section) |
Get a serialiser set up to read Page data for the given PageID. More... | |
StreamSerialiser * | _readWorldStream (const String &filename) |
Get a serialiser set up to read PagedWorld data for the given world name. More... | |
virtual bool | _unloadProceduralPage (Page *page, PagedWorldSection *section) |
Give a manager the opportunity to unload page content procedurally. More... | |
virtual bool | _unprepareProceduralPage (Page *page, PagedWorldSection *section) |
Give a manager the opportunity to unprepare page content procedurally. More... | |
StreamSerialiser * | _writePageStream (PageID pageID, PagedWorldSection *section) |
Get a serialiser set up to write Page data for the given PageID. More... | |
StreamSerialiser * | _writeWorldStream (const String &filename) |
Get a serialiser set up to write PagedWorld data. More... | |
void | addCamera (Camera *c) |
Tells the paging system to start tracking a given camera. More... | |
void | addContentCollectionFactory (PageContentCollectionFactory *f) |
Add a new PageContentCollectionFactory implementation. More... | |
void | addContentFactory (PageContentFactory *f) |
Add a new PageContentFactory implementation. More... | |
void | addStrategy (PageStrategy *strategy) |
Add a new PageStrategy implementation. More... | |
void | addWorldSectionFactory (PagedWorldSectionFactory *f) |
Add a new PagedWorldSectionFactory implementation. More... | |
PageContent * | createContent (const String &typeName) |
Create a new instance of PageContent using the registered factories. More... | |
PageContentCollection * | createContentCollection (const String &typeName) |
Create a new instance of PageContentCollection using the registered factories. More... | |
PagedWorld * | createWorld (const String &name=StringUtil::BLANK) |
Create a new PagedWorld instance. More... | |
PagedWorldSection * | createWorldSection (const String &typeName, const String &name, PagedWorld *parent, SceneManager *sm) |
Create a new instance of PagedWorldSection using the registered factories. More... | |
void | destroyContent (PageContent *c) |
Destroy an instance of PageContent. More... | |
void | destroyContentCollection (PageContentCollection *coll) |
Destroy an instance of PageContentCollection. More... | |
void | destroyWorld (const String &name) |
Destroy a world. More... | |
void | destroyWorld (PagedWorld *world) |
Destroy a world. More... | |
void | destroyWorldSection (PagedWorldSection *s) |
Destroy an instance of PagedWorldSection. More... | |
const CameraList & | getCameraList () const |
Returns a list of cameras being tracked. More... | |
const ContentCollectionFactoryMap & | getContentCollectionFactories () const |
Get a reference to the registered strategies. More... | |
PageContentCollectionFactory * | getContentCollectionFactory (const String &name) |
Get a PageContentCollectionFactory. More... | |
const ContentFactoryMap & | getContentFactories () const |
Get a reference to the registered strategies. More... | |
PageContentFactory * | getContentFactory (const String &name) |
Get a PageContentFactory. More... | |
uint8 | getDebugDisplayLevel () const |
Get the debug display level. More... | |
PageProvider * | getPageProvider () const |
Get the PageProvider which can provide streams for any Page. More... | |
const String & | getPageResourceGroup () const |
Get the resource group that will be used to read/write files when the default load routines are used. More... | |
bool | getPagingOperationsEnabled () const |
Get whether paging operations are currently allowed to happen. More... | |
const StrategyMap & | getStrategies () const |
Get a reference to the registered strategies. More... | |
PageStrategy * | getStrategy (const String &name) |
Get a PageStrategy. More... | |
PagedWorld * | getWorld (const String &name) |
Get a named world. More... | |
const WorldMap & | getWorlds () const |
Get a reference to the worlds that are currently loaded. More... | |
const WorldSectionFactoryMap & | getWorldSectionFactories () const |
Get a reference to the registered strategies. More... | |
PagedWorldSectionFactory * | getWorldSectionFactory (const String &name) |
Get a PagedWorldSectionFactory. More... | |
bool | hasCamera (Camera *c) const |
Returns whether or not a given camera is being watched by the paging system. More... | |
PagedWorld * | loadWorld (const String &filename, const String &name=StringUtil::BLANK) |
Load a new PagedWorld from a file. More... | |
PagedWorld * | loadWorld (const DataStreamPtr &stream, const String &name=StringUtil::BLANK) |
Load a new PagedWorld from a stream. More... | |
void | operator delete (void *ptr) |
void | operator delete (void *ptr, void *) |
void | operator delete (void *ptr, const char *, int, const char *) |
void | operator delete[] (void *ptr) |
void | operator delete[] (void *ptr, const char *, int, const char *) |
void * | operator new (size_t sz, const char *file, int line, const char *func) |
operator new, with debug line info More... | |
void * | operator new (size_t sz) |
void * | operator new (size_t sz, void *ptr) |
placement operator new More... | |
void * | operator new[] (size_t sz, const char *file, int line, const char *func) |
array operator new, with debug line info More... | |
void * | operator new[] (size_t sz) |
void | removeCamera (Camera *c) |
Tells the paging system to stop tracking a given camera. More... | |
void | removeContentCollectionFactory (PageContentCollectionFactory *f) |
Remove a PageContentCollectionFactory implementation. More... | |
void | removeContentFactory (PageContentFactory *f) |
Remove a PageContentFactory implementation. More... | |
void | removeStrategy (PageStrategy *strategy) |
Remove a PageStrategy implementation. More... | |
void | removeWorldSectionFactory (PagedWorldSectionFactory *f) |
Remove a PagedWorldSectionFactory implementation. More... | |
void | saveWorld (PagedWorld *world, const String &filename) |
Save a PagedWorld instance to a file. More... | |
void | saveWorld (PagedWorld *world, const DataStreamPtr &stream) |
Save a PagedWorld instance to a file. More... | |
void | setDebugDisplayLevel (uint8 lvl) |
Set the debug display level. More... | |
void | setPageProvider (PageProvider *provider) |
Set the PageProvider which can provide streams for any Page. More... | |
void | setPageResourceGroup (const String &g) |
Set the resource group that will be used to read/write files when the default load routines are used. More... | |
void | setPagingOperationsEnabled (bool enabled) |
Pause or unpause all paging operations. More... | |
Protected Member Functions | |
void | createStandardContentFactories () |
void | createStandardStrategies () |
The PageManager is the entry point through which you load all PagedWorld instances, and the place where PageStrategy instances and factory classes are registered to customise the paging behaviour.
Definition at line 135 of file OgrePageManager.h.
typedef vector<Camera*>::type Ogre::PageManager::CameraList |
Definition at line 409 of file OgrePageManager.h.
typedef map<String, PageContentCollectionFactory*>::type Ogre::PageManager::ContentCollectionFactoryMap |
Definition at line 208 of file OgrePageManager.h.
typedef map<String, PageContentFactory*>::type Ogre::PageManager::ContentFactoryMap |
Definition at line 238 of file OgrePageManager.h.
typedef map<String, PageStrategy*>::type Ogre::PageManager::StrategyMap |
Definition at line 186 of file OgrePageManager.h.
typedef map<String, PagedWorld*>::type Ogre::PageManager::WorldMap |
Definition at line 181 of file OgrePageManager.h.
typedef map<String, PagedWorldSectionFactory*>::type Ogre::PageManager::WorldSectionFactoryMap |
Definition at line 269 of file OgrePageManager.h.
Ogre::PageManager::PageManager | ( | ) |
|
virtual |
|
virtual |
Give a provider the opportunity to prepare page content procedurally.
|
virtual |
Give a provider the opportunity to prepare page content procedurally.
StreamSerialiser* Ogre::PageManager::_readPageStream | ( | PageID | pageID, |
PagedWorldSection * | section | ||
) |
Get a serialiser set up to read Page data for the given PageID.
pageID | The ID of the page being requested |
section | The parent section to which this page will belong |
StreamSerialiser* Ogre::PageManager::_readWorldStream | ( | const String & | filename | ) |
Get a serialiser set up to read PagedWorld data for the given world name.
|
virtual |
Give a manager the opportunity to unload page content procedurally.
|
virtual |
Give a manager the opportunity to unprepare page content procedurally.
StreamSerialiser* Ogre::PageManager::_writePageStream | ( | PageID | pageID, |
PagedWorldSection * | section | ||
) |
Get a serialiser set up to write Page data for the given PageID.
pageID | The ID of the page being requested |
section | The parent section to which this page will belong |
StreamSerialiser* Ogre::PageManager::_writeWorldStream | ( | const String & | filename | ) |
Get a serialiser set up to write PagedWorld data.
void Ogre::PageManager::addCamera | ( | Camera * | c | ) |
Tells the paging system to start tracking a given camera.
void Ogre::PageManager::addContentCollectionFactory | ( | PageContentCollectionFactory * | f | ) |
Add a new PageContentCollectionFactory implementation.
void Ogre::PageManager::addContentFactory | ( | PageContentFactory * | f | ) |
Add a new PageContentFactory implementation.
void Ogre::PageManager::addStrategy | ( | PageStrategy * | strategy | ) |
Add a new PageStrategy implementation.
void Ogre::PageManager::addWorldSectionFactory | ( | PagedWorldSectionFactory * | f | ) |
Add a new PagedWorldSectionFactory implementation.
PageContent* Ogre::PageManager::createContent | ( | const String & | typeName | ) |
Create a new instance of PageContent using the registered factories.
typeName | The name of the type of content to create |
PageContentCollection* Ogre::PageManager::createContentCollection | ( | const String & | typeName | ) |
Create a new instance of PageContentCollection using the registered factories.
typeName | The name of the type of collection to create |
|
protected |
|
protected |
PagedWorld* Ogre::PageManager::createWorld | ( | const String & | name = StringUtil::BLANK | ) |
Create a new PagedWorld instance.
name | Optionally give a name to the world (if no name is given, one will be generated). |
PagedWorldSection* Ogre::PageManager::createWorldSection | ( | const String & | typeName, |
const String & | name, | ||
PagedWorld * | parent, | ||
SceneManager * | sm | ||
) |
Create a new instance of PagedWorldSection using the registered factories.
typeName | The name of the type of collection to create |
name | The instance name |
parent | The parent world |
sm | The SceneManager to use (can be null if this is to be loaded) |
void Ogre::PageManager::destroyContent | ( | PageContent * | c | ) |
Destroy an instance of PageContent.
void Ogre::PageManager::destroyContentCollection | ( | PageContentCollection * | coll | ) |
Destroy an instance of PageContentCollection.
void Ogre::PageManager::destroyWorld | ( | const String & | name | ) |
Destroy a world.
void Ogre::PageManager::destroyWorld | ( | PagedWorld * | world | ) |
Destroy a world.
void Ogre::PageManager::destroyWorldSection | ( | PagedWorldSection * | s | ) |
Destroy an instance of PagedWorldSection.
const CameraList& Ogre::PageManager::getCameraList | ( | ) | const |
Returns a list of cameras being tracked.
const ContentCollectionFactoryMap& Ogre::PageManager::getContentCollectionFactories | ( | ) | const |
Get a reference to the registered strategies.
PageContentCollectionFactory* Ogre::PageManager::getContentCollectionFactory | ( | const String & | name | ) |
Get a PageContentCollectionFactory.
name | The name of the factory to retrieve |
const ContentFactoryMap& Ogre::PageManager::getContentFactories | ( | ) | const |
Get a reference to the registered strategies.
PageContentFactory* Ogre::PageManager::getContentFactory | ( | const String & | name | ) |
Get a PageContentFactory.
name | The name of the factory to retrieve |
|
inline |
Get the debug display level.
Definition at line 424 of file OgrePageManager.h.
|
inline |
Get the PageProvider which can provide streams for any Page.
Definition at line 318 of file OgrePageManager.h.
|
inline |
Get the resource group that will be used to read/write files when the default load routines are used.
Definition at line 386 of file OgrePageManager.h.
|
inline |
Get whether paging operations are currently allowed to happen.
Definition at line 435 of file OgrePageManager.h.
const StrategyMap& Ogre::PageManager::getStrategies | ( | ) | const |
Get a reference to the registered strategies.
PageStrategy* Ogre::PageManager::getStrategy | ( | const String & | name | ) |
Get a PageStrategy.
name | The name of the strategy to retrieve |
PagedWorld* Ogre::PageManager::getWorld | ( | const String & | name | ) |
Get a named world.
name The name of the world (not a filename, the identifying name)
|
inline |
Get a reference to the worlds that are currently loaded.
Definition at line 183 of file OgrePageManager.h.
const WorldSectionFactoryMap& Ogre::PageManager::getWorldSectionFactories | ( | ) | const |
Get a reference to the registered strategies.
PagedWorldSectionFactory* Ogre::PageManager::getWorldSectionFactory | ( | const String & | name | ) |
Get a PagedWorldSectionFactory.
name | The name of the factory to retrieve |
bool Ogre::PageManager::hasCamera | ( | Camera * | c | ) | const |
Returns whether or not a given camera is being watched by the paging system.
PagedWorld* Ogre::PageManager::loadWorld | ( | const String & | filename, |
const String & | name = StringUtil::BLANK |
||
) |
Load a new PagedWorld from a file.
filename | The name of the file to load (standard is .world) |
name | Optionally give a name to the world (if no name is given, one will be generated). |
PagedWorld* Ogre::PageManager::loadWorld | ( | const DataStreamPtr & | stream, |
const String & | name = StringUtil::BLANK |
||
) |
Load a new PagedWorld from a stream.
stream | A stream from which to load the world data |
name | Optionally give a name to the world (if no name is given, one will be generated). |
|
inlineinherited |
Definition at line 95 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 101 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 107 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 112 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 118 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
operator new, with debug line info
Definition at line 67 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 72 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
placement operator new
Definition at line 78 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
array operator new, with debug line info
Definition at line 85 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 90 of file OgreMemoryAllocatedObject.h.
void Ogre::PageManager::removeCamera | ( | Camera * | c | ) |
Tells the paging system to stop tracking a given camera.
void Ogre::PageManager::removeContentCollectionFactory | ( | PageContentCollectionFactory * | f | ) |
Remove a PageContentCollectionFactory implementation.
void Ogre::PageManager::removeContentFactory | ( | PageContentFactory * | f | ) |
Remove a PageContentFactory implementation.
void Ogre::PageManager::removeStrategy | ( | PageStrategy * | strategy | ) |
Remove a PageStrategy implementation.
void Ogre::PageManager::removeWorldSectionFactory | ( | PagedWorldSectionFactory * | f | ) |
Remove a PagedWorldSectionFactory implementation.
void Ogre::PageManager::saveWorld | ( | PagedWorld * | world, |
const String & | filename | ||
) |
Save a PagedWorld instance to a file.
world | The world to be saved |
filename | The filename to save the data to |
arch | The Archive that filename is relative to (optional) |
void Ogre::PageManager::saveWorld | ( | PagedWorld * | world, |
const DataStreamPtr & | stream | ||
) |
Save a PagedWorld instance to a file.
world | The world to be saved |
stream | The stream to save the data to |
|
inline |
Set the debug display level.
Definition at line 422 of file OgrePageManager.h.
|
inline |
Set the PageProvider which can provide streams for any Page.
Definition at line 315 of file OgrePageManager.h.
|
inline |
Set the resource group that will be used to read/write files when the default load routines are used.
Definition at line 390 of file OgrePageManager.h.
|
inline |
Pause or unpause all paging operations.
enabled | True to proceed with normal paging operations, false to pause. |
Definition at line 432 of file OgrePageManager.h.
|
protected |
Definition at line 467 of file OgrePageManager.h.
|
protected |
Definition at line 461 of file OgrePageManager.h.
|
protected |
Definition at line 462 of file OgrePageManager.h.
|
protected |
Definition at line 469 of file OgrePageManager.h.
|
protected |
Definition at line 468 of file OgrePageManager.h.
|
protected |
Definition at line 472 of file OgrePageManager.h.
|
protected |
Definition at line 473 of file OgrePageManager.h.
|
protected |
Definition at line 465 of file OgrePageManager.h.
|
protected |
Definition at line 466 of file OgrePageManager.h.
|
protected |
Definition at line 470 of file OgrePageManager.h.
|
protected |
Definition at line 474 of file OgrePageManager.h.
|
protected |
Definition at line 460 of file OgrePageManager.h.
|
protected |
Definition at line 464 of file OgrePageManager.h.
|
protected |
Definition at line 459 of file OgrePageManager.h.
|
protected |
Definition at line 463 of file OgrePageManager.h.