# Ogre::PageProvider Class Reference
[Paging]

Abstract class that can be implemented by the user application to provide a way to retrieve or generate page data from a source of their choosing. More...

`#include <OgrePageManager.h>`

List of all members.

## Public Member Functions

| PageProvider ()
virtual | ~PageProvider ()
virtual bool | prepareProceduralPage (Page *page, PagedWorldSection *section)
| Give a provider the opportunity to prepare page content procedurally.
virtual bool | loadProceduralPage (Page *page, PagedWorldSection *section)
| Give a provider the opportunity to load page content procedurally.
virtual bool | unloadProceduralPage (Page *page, PagedWorldSection *section)
| Give a provider the opportunity to unload page content procedurally.
virtual bool | unprepareProceduralPage (Page *page, PagedWorldSection *section)
| Give a provider the opportunity to unprepare page content procedurally.
virtual StreamSerialiser * | readWorldStream (const String &filename)
| Get a serialiser set up to read PagedWorld data for the given world filename.
virtual StreamSerialiser * | writeWorldStream (const String &filename)
| Get a serialiser set up to write PagedWorld data for the given world filename.
virtual StreamSerialiser * | readPageStream (PageID pageID, PagedWorldSection *section)
| Get a serialiser set up to read Page data for the given PageID, or null if this provider cannot supply one.
virtual StreamSerialiser * | writePageStream (PageID pageID, PagedWorldSection *section)
| Get a serialiser set up to write Page data for the given PageID, or null if this provider cannot supply one.

## Detailed Description

Abstract class that can be implemented by the user application to provide a way to retrieve or generate page data from a source of their choosing.

Note:
  All of the methods in this class can be called in a background, non-render thread.

Definition at line 58 of file OgrePageManager.h.

## Constructor & Destructor Documentation

Ogre::PageProvider::PageProvider | ( |  | ) |

Definition at line 61 of file OgrePageManager.h.

virtual Ogre::PageProvider::~PageProvider | ( |  | ) | `[virtual]`

Definition at line 62 of file OgrePageManager.h.

## Member Function Documentation

virtual bool Ogre::PageProvider::loadProceduralPage | ( | Page * | page,
|  | PagedWorldSection * | section |
| ) |  |  | `[virtual]`

Give a provider the opportunity to load page content procedurally.

Remarks:
  This call will happen in the main render thread so it can access GPU resources. Use prepareProceduralPage for background preparation.

Returns:
  true if the page was populated, false otherwise

Definition at line 77 of file OgrePageManager.h.

virtual bool Ogre::PageProvider::prepareProceduralPage | ( | Page * | page,
|  | PagedWorldSection * | section |
| ) |  |  | `[virtual]`

Give a provider the opportunity to prepare page content procedurally.

Remarks:
  This call may well happen in a separate thread so it should not access GPU resources, use loadProceduralPage for that

Returns:
  true if the page was populated, false otherwise

Definition at line 70 of file OgrePageManager.h.

virtual StreamSerialiser* Ogre::PageProvider::readPageStream | ( | PageID | pageID,
|  | PagedWorldSection * | section |
| ) |  |  | `[virtual]`

Get a serialiser set up to read Page data for the given PageID, or null if this provider cannot supply one.

Remarks:
  The StreamSerialiser returned is the responsibility of the caller to delete.

Parameters:

  | pageID | The ID of the page being requested
  | section | The parent section to which this page will belong

Definition at line 115 of file OgrePageManager.h.

virtual StreamSerialiser* Ogre::PageProvider::readWorldStream | ( | const String & | filename | ) | `[virtual]`

Get a serialiser set up to read PagedWorld data for the given world filename.

Remarks:
  The StreamSerialiser returned is the responsibility of the caller to delete.

Definition at line 100 of file OgrePageManager.h.

virtual bool Ogre::PageProvider::unloadProceduralPage | ( | Page * | page,
|  | PagedWorldSection * | section |
| ) |  |  | `[virtual]`

Give a provider the opportunity to unload page content procedurally.

Remarks:
  You should not call this method directly. This call will happen in the main render thread so it can access GPU resources. Use _unprepareProceduralPage for background preparation.

Returns:
  true if the page was populated, false otherwise

Definition at line 85 of file OgrePageManager.h.

virtual bool Ogre::PageProvider::unprepareProceduralPage | ( | Page * | page,
|  | PagedWorldSection * | section |
| ) |  |  | `[virtual]`

Give a provider the opportunity to unprepare page content procedurally.

Remarks:
  You should not call this method directly. This call may well happen in a separate thread so it should not access GPU resources, use _unloadProceduralPage for that

Returns:
  true if the page was unpopulated, false otherwise

Definition at line 93 of file OgrePageManager.h.

virtual StreamSerialiser* Ogre::PageProvider::writePageStream | ( | PageID | pageID,
|  | PagedWorldSection * | section |
| ) |  |  | `[virtual]`

Get a serialiser set up to write Page data for the given PageID, or null if this provider cannot supply one.

Remarks:
  The StreamSerialiser returned is the responsibility of the caller to delete.

Parameters:

  | pageID | The ID of the page being requested
  | section | The parent section to which this page will belong

Definition at line 125 of file OgrePageManager.h.

virtual StreamSerialiser* Ogre::PageProvider::writeWorldStream | ( | const String & | filename | ) | `[virtual]`

Get a serialiser set up to write PagedWorld data for the given world filename.

Remarks:
  The StreamSerialiser returned is the responsibility of the caller to delete.

Definition at line 106 of file OgrePageManager.h.

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

- OgrePageManager.h

Copyright © 2008 Torus Knot Software Ltd
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
Last modified Wed Nov 3 2010 19:25:04