OGRE
1.12.13
Object-Oriented Graphics Rendering Engine
|
The root class of the Ogre system. More...
#include <OgreRoot.h>
Public Types | |
typedef ConstMapIterator< MovableObjectFactoryMap > | MovableObjectFactoryIterator |
typedef std::map< String, MovableObjectFactory * > | MovableObjectFactoryMap |
typedef std::vector< Plugin * > | PluginInstanceList |
typedef std::vector< DynLib * > | PluginLibList |
Public Member Functions | |
Root (const String &pluginFileName="plugins.cfg", const String &configFileName="ogre.cfg", const String &logFileName="Ogre.log") | |
Constructor. More... | |
~Root () | |
uint32 | _allocateNextMovableObjectTypeFlag (void) |
Allocate the next MovableObject type flag. More... | |
bool | _fireFrameEnded () |
Method for raising frame ended events. More... | |
bool | _fireFrameEnded (FrameEvent &evt) |
Method for raising frame ended events. More... | |
bool | _fireFrameRenderingQueued () |
Method for raising frame rendering queued events. More... | |
bool | _fireFrameRenderingQueued (FrameEvent &evt) |
Method for raising frame rendering queued events. More... | |
bool | _fireFrameStarted () |
Method for raising frame started events. More... | |
bool | _fireFrameStarted (FrameEvent &evt) |
Method for raising frame started events. More... | |
SceneManager * | _getCurrentSceneManager (void) const |
Returns the scene manager currently being used to render a frame. More... | |
void | _popCurrentSceneManager (SceneManager *sm) |
void | _pushCurrentSceneManager (SceneManager *sm) |
void | _setCurrentSceneManager (SceneManager *sm) |
Sets the scene manager currently being used to render. More... | |
bool | _updateAllRenderTargets (FrameEvent &evt) |
Internal method used for updating all RenderTarget objects (windows, renderable textures etc) which are set to auto-update, with a custom time passed to the frameRenderingQueued events. More... | |
bool | _updateAllRenderTargets (void) |
Internal method used for updating all RenderTarget objects (windows, renderable textures etc) which are set to auto-update. More... | |
void | addFrameListener (FrameListener *newListener) |
Registers a FrameListener which will be called back every frame. More... | |
void | addMovableObjectFactory (MovableObjectFactory *fact, bool overrideExisting=false) |
Register a new MovableObjectFactory which will create new MovableObject instances of a particular type, as identified by the getType() method. More... | |
void | addRenderSystem (RenderSystem *newRend) |
Adds a new rendering subsystem to the list of available renderers. More... | |
void | addSceneManagerFactory (SceneManagerFactory *fact) |
Register a new SceneManagerFactory, a factory object for creating instances of specific SceneManagers. More... | |
void | clearEventTimes (void) |
Clears the history of all event times. More... | |
void | convertColourValue (const ColourValue &colour, uint32 *pDest) |
RenderQueueInvocationSequence * | createRenderQueueInvocationSequence (const String &name) |
Create a new RenderQueueInvocationSequence, useful for linking to Viewport instances to perform custom rendering. More... | |
RenderWindow * | createRenderWindow (const RenderWindowDescription &desc) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. More... | |
RenderWindow * | createRenderWindow (const String &name, unsigned int width, unsigned int height, bool fullScreen, const NameValuePairList *miscParams=0) |
Creates a new rendering window. More... | |
bool | createRenderWindows (const RenderWindowDescriptionList &renderWindowDescriptions, RenderWindowList &createdWindows) |
SceneManager * | createSceneManager () |
create a default scene manager More... | |
SceneManager * | createSceneManager (const String &typeName, const String &instanceName=BLANKSTRING) |
Create a SceneManager instance of a given type. More... | |
SceneManager * | createSceneManager (SceneTypeMask typeMask, const String &instanceName=BLANKSTRING) |
void | destroyAllRenderQueueInvocationSequences (void) |
Destroy all RenderQueueInvocationSequences. More... | |
void | destroyRenderQueueInvocationSequence (const String &name) |
Destroy a RenderQueueInvocationSequence. More... | |
void | destroyRenderTarget (const String &name) |
Destroys the given named RenderTarget. More... | |
void | destroyRenderTarget (RenderTarget *target) |
Destroys the given RenderTarget. More... | |
void | destroySceneManager (SceneManager *sm) |
Destroy an instance of a SceneManager. More... | |
RenderTarget * | detachRenderTarget (const String &name) |
Detaches a named RenderTarget from the active render system and returns a pointer to it. More... | |
RenderTarget * | detachRenderTarget (RenderTarget *pWin) |
Detaches a RenderTarget from the active render system and returns a pointer to it. More... | |
bool | endRenderingQueued (void) |
Check for planned end of rendering. More... | |
RenderWindow * | getAutoCreatedWindow (void) |
Retrieves a pointer to the window that was created automatically. More... | |
const RenderSystemList & | getAvailableRenderers (void) |
Retrieve a list of the available render systems. More... | |
Real | getDefaultMinPixelSize () |
Get the default minimum pixel size for object to be rendered by. More... | |
unsigned int | getDisplayMonitorCount () const |
Real | getFrameSmoothingPeriod (void) const |
Gets the period over which OGRE smooths out fluctuations in frame times. More... | |
const PluginInstanceList & | getInstalledPlugins () const |
Gets a read-only list of the currently installed plugins. More... | |
MeshManager * | getMeshManager (void) |
Retrieves a reference to the current MeshManager. More... | |
const MovableObjectFactoryMap & | getMovableObjectFactories () const |
Return an iterator over all the MovableObjectFactory instances currently registered. More... | |
MovableObjectFactory * | getMovableObjectFactory (const String &typeName) |
Get a MovableObjectFactory for the given type. More... | |
MovableObjectFactoryIterator | getMovableObjectFactoryIterator (void) const |
unsigned long | getNextFrameNumber (void) const |
Gets the number of the next frame to be rendered. More... | |
bool | getRemoveRenderQueueStructuresOnClear () const |
Get whether the entire render queue structure should be emptied on clearing, or whether just the objects themselves should be cleared. More... | |
RenderQueueInvocationSequence * | getRenderQueueInvocationSequence (const String &name) |
Get a RenderQueueInvocationSequence. More... | |
RenderSystem * | getRenderSystem (void) |
Retrieve a pointer to the currently selected render system. More... | |
RenderSystem * | getRenderSystemByName (const String &name) |
Retrieve a pointer to the render system by the given name. More... | |
RenderTarget * | getRenderTarget (const String &name) |
Retrieves a pointer to a named render target. More... | |
SceneManager * | getSceneManager (const String &instanceName) const |
Get an existing SceneManager instance that has already been created, identified by the instance name. More... | |
SceneManagerEnumerator::SceneManagerIterator | getSceneManagerIterator (void) |
Get an iterator over all the existing SceneManager instances. More... | |
const SceneManagerEnumerator::MetaDataList & | getSceneManagerMetaData () const |
get all types of SceneManager available for construction More... | |
const SceneManagerMetaData * | getSceneManagerMetaData (const String &typeName) const |
Get more information about a given type of SceneManager. More... | |
SceneManagerEnumerator::MetaDataIterator | getSceneManagerMetaDataIterator (void) const |
Iterate over all types of SceneManager available for construction, providing some information about each one. More... | |
const SceneManagerEnumerator::Instances & | getSceneManagers (void) const |
Get all the existing SceneManager instances. More... | |
TextureManager * | getTextureManager (void) |
Retrieves a reference to the current TextureManager. More... | |
Timer * | getTimer (void) |
Gets a pointer to the central timer used for all OGRE timings. More... | |
WorkQueue * | getWorkQueue () const |
Get the WorkQueue for processing background tasks. More... | |
bool | hasMovableObjectFactory (const String &typeName) const |
Checks whether a factory is registered for a given MovableObject type. More... | |
bool | hasSceneManager (const String &instanceName) const |
Identify if a SceneManager instance already exists. More... | |
RenderWindow * | initialise (bool autoCreateWindow, const String &windowTitle="OGRE Render Window", const String &customCapabilitiesConfig=BLANKSTRING) |
Initialises the renderer. More... | |
void | installPlugin (Plugin *plugin) |
Install a new plugin. More... | |
bool | isBlendIndicesGpuRedundant () const |
Returns whether blend indices information needs to be passed to the GPU see setBlendIndicesGpuRedundant() for more information. More... | |
bool | isBlendWeightsGpuRedundant () const |
Returns whether blend weights information needs to be passed to the GPU see setBlendWeightsGpuRedundant() for more information. More... | |
bool | isInitialised (void) const |
Returns whether the system is initialised or not. More... | |
void | loadPlugin (const String &pluginName) |
Manually load a Plugin contained in a DLL / DSO. More... | |
void | queueEndRendering (bool state=true) |
Queues the end of rendering. More... | |
void | removeFrameListener (FrameListener *oldListener) |
Removes a FrameListener from the list of listening classes. More... | |
void | removeMovableObjectFactory (MovableObjectFactory *fact) |
Removes a previously registered MovableObjectFactory. More... | |
void | removeSceneManagerFactory (SceneManagerFactory *fact) |
Register a new SceneManagerFactory. More... | |
bool | renderOneFrame (Real timeSinceLastFrame) |
Updates all the render targets with custom frame time information. More... | |
bool | renderOneFrame (void) |
Updates all the render targets automatically. More... | |
bool | restoreConfig (void) |
Checks for saved video/sound/etc settings. More... | |
void | saveConfig (void) |
Saves the details of the current configuration. More... | |
void | setBlendIndicesGpuRedundant (bool redundant) |
Sets whether blend indices information needs to be passed to the GPU. More... | |
void | setBlendWeightsGpuRedundant (bool redundant) |
Sets whether blend weights information needs to be passed to the GPU. More... | |
void | setDefaultMinPixelSize (Real pixelSize) |
Set the default minimum pixel size for object to be rendered by. More... | |
void | setFrameSmoothingPeriod (Real period) |
Sets the period over which OGRE smooths out fluctuations in frame times. More... | |
void | setRemoveRenderQueueStructuresOnClear (bool r) |
Set whether the entire render queue structure should be emptied on clearing, or whether just the objects themselves should be cleared. More... | |
void | setRenderSystem (RenderSystem *system) |
Sets the rendering subsystem to be used. More... | |
void | setWorkQueue (WorkQueue *queue) |
Replace the current work queue with an alternative. More... | |
bool | showConfigDialog (ConfigDialog *dialog) |
Displays a dialog asking the user to choose system settings. More... | |
void | shutdown (void) |
Shuts down the system manually. More... | |
void | startRendering (void) |
Starts / restarts the automatic rendering cycle. More... | |
void | uninstallPlugin (Plugin *plugin) |
Uninstall an existing plugin. More... | |
void | unloadPlugin (const String &pluginName) |
Manually unloads a Plugin contained in a DLL / DSO. More... | |
void | useCustomRenderSystemCapabilities (RenderSystemCapabilities *capabilities) |
Requests active RenderSystem to use custom RenderSystemCapabilities. More... | |
Public Member Functions inherited from Ogre::Singleton< Root > | |
Singleton (void) | |
~Singleton (void) | |
Static Public Member Functions | |
static DataStreamPtr | createFileStream (const String &filename, const String &groupName=ResourceGroupManager::DEFAULT_RESOURCE_GROUP_NAME, bool overwrite=false, const String &locationPattern=BLANKSTRING) |
Helper method to assist you in creating writeable file streams. More... | |
static Root & | getSingleton (void) |
Get the singleton instance. More... | |
static Root * | getSingletonPtr (void) |
Get the singleton instance. More... | |
static DataStreamPtr | openFileStream (const String &filename, const String &groupName=ResourceGroupManager::DEFAULT_RESOURCE_GROUP_NAME) |
Helper method to assist you in accessing readable file streams. More... | |
Static Public Member Functions inherited from Ogre::Singleton< Root > | |
static Root & | getSingleton (void) |
Get the singleton instance. More... | |
static Root * | getSingletonPtr (void) |
Get the singleton instance. More... | |
The root class of the Ogre system.
typedef std::map<String, MovableObjectFactory*> Ogre::Root::MovableObjectFactoryMap |
typedef std::vector<DynLib*> Ogre::Root::PluginLibList |
typedef std::vector<Plugin*> Ogre::Root::PluginInstanceList |
Ogre::Root::Root | ( | const String & | pluginFileName = "plugins.cfg" , |
const String & | configFileName = "ogre.cfg" , |
||
const String & | logFileName = "Ogre.log" |
||
) |
Constructor.
pluginFileName | The file that contains plugins information. May be left blank to ignore. |
configFileName | The file that contains the configuration to be loaded. Defaults to "ogre.cfg", may be left blank to load nothing. |
logFileName | The logfile to create, defaults to Ogre.log, may be left blank if you've already set up LogManager & Log yourself |
Ogre::Root::~Root | ( | ) |
void Ogre::Root::saveConfig | ( | void | ) |
Saves the details of the current configuration.
bool Ogre::Root::restoreConfig | ( | void | ) |
Checks for saved video/sound/etc settings.
bool Ogre::Root::showConfigDialog | ( | ConfigDialog * | dialog | ) |
Displays a dialog asking the user to choose system settings.
dialog | ConfigDialog implementation to use. If NULL, the first available render system with the default options will be selected. |
void Ogre::Root::addRenderSystem | ( | RenderSystem * | newRend | ) |
Adds a new rendering subsystem to the list of available renderers.
const RenderSystemList& Ogre::Root::getAvailableRenderers | ( | void | ) |
Retrieve a list of the available render systems.
RenderSystem* Ogre::Root::getRenderSystemByName | ( | const String & | name | ) |
Retrieve a pointer to the render system by the given name.
name | Name of the render system intend to retrieve. |
void Ogre::Root::setRenderSystem | ( | RenderSystem * | system | ) |
Sets the rendering subsystem to be used.
system | Pointer to the render system to use. |
RenderSystem* Ogre::Root::getRenderSystem | ( | void | ) |
Retrieve a pointer to the currently selected render system.
RenderWindow* Ogre::Root::initialise | ( | bool | autoCreateWindow, |
const String & | windowTitle = "OGRE Render Window" , |
||
const String & | customCapabilitiesConfig = BLANKSTRING |
||
) |
Initialises the renderer.
autoCreateWindow | If true, a rendering window will automatically be created (saving a call to Root::createRenderWindow). The window will be created based on the options currently set on the render system. |
windowTitle | |
customCapabilitiesConfig | see useCustomRenderSystemCapabilities |
|
inline |
Returns whether the system is initialised or not.
void Ogre::Root::useCustomRenderSystemCapabilities | ( | RenderSystemCapabilities * | capabilities | ) |
Requests active RenderSystem to use custom RenderSystemCapabilities.
|
inline |
Get whether the entire render queue structure should be emptied on clearing, or whether just the objects themselves should be cleared.
|
inline |
Set whether the entire render queue structure should be emptied on clearing, or whether just the objects themselves should be cleared.
void Ogre::Root::addSceneManagerFactory | ( | SceneManagerFactory * | fact | ) |
Register a new SceneManagerFactory, a factory object for creating instances of specific SceneManagers.
void Ogre::Root::removeSceneManagerFactory | ( | SceneManagerFactory * | fact | ) |
Register a new SceneManagerFactory.
const SceneManagerMetaData* Ogre::Root::getSceneManagerMetaData | ( | const String & | typeName | ) | const |
Get more information about a given type of SceneManager.
typeName | The type name of the SceneManager you want to enquire on. If you don't know the typeName already, you can iterate over the metadata for all types using getMetaDataIterator. |
const SceneManagerEnumerator::MetaDataList& Ogre::Root::getSceneManagerMetaData | ( | ) | const |
get all types of SceneManager available for construction
providing some information about each one.
SceneManagerEnumerator::MetaDataIterator Ogre::Root::getSceneManagerMetaDataIterator | ( | void | ) | const |
Iterate over all types of SceneManager available for construction, providing some information about each one.
|
inline |
create a default scene manager
References Ogre::DefaultSceneManagerFactory::FACTORY_TYPE_NAME.
SceneManager* Ogre::Root::createSceneManager | ( | const String & | typeName, |
const String & | instanceName = BLANKSTRING |
||
) |
Create a SceneManager instance of a given type.
typeName | String identifying a unique SceneManager type |
instanceName | Optional name to given the new instance that is created. If you leave this blank, an auto name will be assigned. |
|
inline |
References Ogre::DefaultSceneManagerFactory::FACTORY_TYPE_NAME.
void Ogre::Root::destroySceneManager | ( | SceneManager * | sm | ) |
Destroy an instance of a SceneManager.
SceneManager* Ogre::Root::getSceneManager | ( | const String & | instanceName | ) | const |
Get an existing SceneManager instance that has already been created, identified by the instance name.
instanceName | The name of the instance to retrieve. |
bool Ogre::Root::hasSceneManager | ( | const String & | instanceName | ) | const |
Identify if a SceneManager instance already exists.
instanceName | The name of the instance to retrieve. |
SceneManagerEnumerator::SceneManagerIterator Ogre::Root::getSceneManagerIterator | ( | void | ) |
Get an iterator over all the existing SceneManager instances.
const SceneManagerEnumerator::Instances& Ogre::Root::getSceneManagers | ( | void | ) | const |
Get all the existing SceneManager instances.
TextureManager* Ogre::Root::getTextureManager | ( | void | ) |
Retrieves a reference to the current TextureManager.
MeshManager* Ogre::Root::getMeshManager | ( | void | ) |
Retrieves a reference to the current MeshManager.
void Ogre::Root::addFrameListener | ( | FrameListener * | newListener | ) |
Registers a FrameListener which will be called back every frame.
void Ogre::Root::removeFrameListener | ( | FrameListener * | oldListener | ) |
Removes a FrameListener from the list of listening classes.
void Ogre::Root::queueEndRendering | ( | bool | state = true | ) |
Queues the end of rendering.
bool Ogre::Root::endRenderingQueued | ( | void | ) |
Check for planned end of rendering.
void Ogre::Root::startRendering | ( | void | ) |
Starts / restarts the automatic rendering cycle.
bool Ogre::Root::renderOneFrame | ( | void | ) |
Updates all the render targets automatically.
Raises frame events before and after.
Overview of the render cycle
bool Ogre::Root::renderOneFrame | ( | Real | timeSinceLastFrame | ) |
Updates all the render targets with custom frame time information.
void Ogre::Root::shutdown | ( | void | ) |
|
static |
Helper method to assist you in creating writeable file streams.
filename | The name of the file to create. If it includes path separators, the filesystem will be accessed direct. If no path separators are present the resource system is used, falling back on the raw filesystem after. |
groupName | The name of the group in which to create the file, if the resource system is used |
overwrite | If true, an existing file will be overwritten, if false an error will occur if the file already exists |
locationPattern | If the resource group contains multiple locations, then usually the file will be created in the first writable location. If you want to be more specific, you can include a location pattern here and only locations which match that pattern (as determined by StringUtil::match) will be considered candidates for creation. |
|
static |
Helper method to assist you in accessing readable file streams.
filename | The name of the file to open. |
groupName | The name of the group in which to create the file, if the resource system is used |
void Ogre::Root::convertColourValue | ( | const ColourValue & | colour, |
uint32 * | pDest | ||
) |
RenderWindow* Ogre::Root::getAutoCreatedWindow | ( | void | ) |
RenderWindow* Ogre::Root::createRenderWindow | ( | const String & | name, |
unsigned int | width, | ||
unsigned int | height, | ||
bool | fullScreen, | ||
const NameValuePairList * | miscParams = 0 |
||
) |
Creates a new rendering window.
name | The name of the window. Used in other methods later like setRenderTarget and getRenderTarget. |
width | The width of the new window. |
height | The height of the new window. |
fullScreen | Specify true to make the window full screen without borders, title bar or menu bar. |
miscParams | A NameValuePairList describing the other parameters for the new rendering window. Options are case sensitive. Unrecognised parameters will be ignored silently. These values might be platform dependent, but these are present for all platforms unless indicated otherwise: |
Key | Type / Values | Default | Description | Platform |
---|---|---|---|---|
title | String | RenderTarget name | The title of the window that will appear in the title bar | |
left | Positive integers | Centred | Screen x coordinate from left | |
top | Positive integers | Centred | Screen y coordinate from left | |
border | none, fixed, resize | resize | The type of window border (in windowed mode) | |
hidden | true, false | false | hide the created window | |
FSAA | Positive integer (usually 0, 2, 4, 8, 16) | 0 | Full screen antialiasing factor | |
gamma | true, false | false | Enable hardware conversion from linear colour space to gamma colour space on rendering to the window. | |
vsync | true, false | false | Synchronize buffer swaps to monitor vsync, eliminating tearing at the expense of a fixed frame rate | |
vsyncInterval | 1, 2, 3, 4 | 1 | If vsync is enabled, the minimum number of vertical blanks that should occur between renders. For example if vsync is enabled, the refresh rate is 60 and this is set to 2, then the frame rate will be locked at 30. | |
Full Screen | true, false | false | Specify whether to create the window in full screen mode | |
displayFrequency | Refresh rate in Hertz (e.g. 60, 75, 100) | Desktop vsync rate | Display frequency rate, for fullscreen mode | |
parentWindowHandle |
| 0 (none) | Parent window handle, for embedding the OGRE in a child of an external window | |
externalWindowHandle |
| 0 (none) | External window handle, for embedding the OGRE render in an existing window | |
externalGLControl | true, false | false | Let the external window control OpenGL i.e. don't select a pixel format for the window, do not change v-sync and do not swap buffer. When set to true, the calling application is responsible of OpenGL initialization and buffer swapping. It should also create an OpenGL context for its own rendering, Ogre will create one for its use. Then the calling application must also enable Ogre OpenGL context before calling any Ogre function and restore its OpenGL context after these calls. | OpenGL |
currentGLContext | true, false | false | Use an externally created GL context. (Must be current) | OpenGL |
minColourBufferSize | Positive integer (usually 16, 32) | 16 | Min total colour buffer size. See EGL_BUFFER_SIZE | OpenGL |
windowProc | WNDPROC | DefWindowProc | function that processes window messages | Win 32 |
colourDepth | 16, 32 | Desktop depth | Colour depth of the resulting rendering window; only applies if fullScreen | Win32 |
FSAAHint | RenderSystem specific. Currently enables EQAA/ CSAA mode on D3D: if you want 4f8x (8x CSAA), set FSAA=4 and this to "f8" | Blank | FSAA mode hint | D3D |
outerDimensions | true, false | false | Whether the width/height is expressed as the size of the outer window, rather than the content area | Win32 |
monitorIndex | -1 | Win 32 | ||
monitorHandle | 0 (none) | Win 32 (OpenGL) | ||
enableDoubleClick | true, false | false | Enable the window to keep track and transmit double click messages. | Win32 |
useNVPerfHUD | true, false | false | Enable the use of nVidia NVPerfHUD | D3D |
depthBuffer | true, false | true | Use depth buffer | D3D |
NSOpenGLCPSurfaceOrder | -1 or 1 | 1 | NSOpenGLCPSurfaceOrder | OSX |
contentScalingFactor | Positive Float | The default content scaling factor of the screen | On IOS specifies the CAEAGLLayer content scaling factor. This can be useful to limit the resolution of the OpenGL ES backing store. For example, the iPhone 4's native resolution is 960 x 640. Windows are always 320 x 480, if you would like to limit the display to 720 x 480, specify 1.5 as the scaling factor. | OSX, iOS, Android |
externalViewHandle | UIView pointer as an integer | 0 | External view handle, for rendering OGRE render in an existing view | iOS |
externalViewControllerHandle | UIViewController pointer as an integer | 0 | External view controller handle, for embedding OGRE in an existing view controller | iOS |
externalSharegroup | EAGLSharegroup pointer as an integer | 0 | External sharegroup, used to shared GL resources between contexts | iOS |
CSAA | Positive integer (usually 0, 2, 4, 8, 16) | 0 | Coverage sampling factor | Android |
maxColourBufferSize | Positive integer (usually 16, 32) | 32 | Max EGL_BUFFER_SIZE | Android |
maxStencilBufferSize | Positive integer (usually 0, 8) | 0 | EGL_STENCIL_SIZE | Android |
maxDepthBufferSize | Positive integer (usually 0, 16, 24) | 16 | EGL_DEPTH_SIZE | Android |
|
inline |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
References Ogre::RenderWindowDescription::height, Ogre::RenderWindowDescription::miscParams, Ogre::RenderWindowDescription::name, Ogre::RenderWindowDescription::useFullScreen, and Ogre::RenderWindowDescription::width.
bool Ogre::Root::createRenderWindows | ( | const RenderWindowDescriptionList & | renderWindowDescriptions, |
RenderWindowList & | createdWindows | ||
) |
RenderTarget* Ogre::Root::detachRenderTarget | ( | RenderTarget * | pWin | ) |
Detaches a RenderTarget from the active render system and returns a pointer to it.
RenderTarget* Ogre::Root::detachRenderTarget | ( | const String & | name | ) |
Detaches a named RenderTarget from the active render system and returns a pointer to it.
void Ogre::Root::destroyRenderTarget | ( | RenderTarget * | target | ) |
Destroys the given RenderTarget.
void Ogre::Root::destroyRenderTarget | ( | const String & | name | ) |
Destroys the given named RenderTarget.
RenderTarget* Ogre::Root::getRenderTarget | ( | const String & | name | ) |
Retrieves a pointer to a named render target.
void Ogre::Root::loadPlugin | ( | const String & | pluginName | ) |
Manually load a Plugin contained in a DLL / DSO.
pluginName | Name of the plugin library to load |
void Ogre::Root::unloadPlugin | ( | const String & | pluginName | ) |
Manually unloads a Plugin contained in a DLL / DSO.
pluginName | Name of the plugin library to unload |
void Ogre::Root::installPlugin | ( | Plugin * | plugin | ) |
Install a new plugin.
void Ogre::Root::uninstallPlugin | ( | Plugin * | plugin | ) |
Uninstall an existing plugin.
|
inline |
Gets a read-only list of the currently installed plugins.
Timer* Ogre::Root::getTimer | ( | void | ) |
Gets a pointer to the central timer used for all OGRE timings.
bool Ogre::Root::_fireFrameStarted | ( | FrameEvent & | evt | ) |
Method for raising frame started events.
evt | Event object which includes all the timing information which you have calculated for yourself |
bool Ogre::Root::_fireFrameRenderingQueued | ( | FrameEvent & | evt | ) |
Method for raising frame rendering queued events.
bool Ogre::Root::_fireFrameEnded | ( | FrameEvent & | evt | ) |
Method for raising frame ended events.
evt | Event object which includes all the timing information which you have calculated for yourself |
bool Ogre::Root::_fireFrameStarted | ( | ) |
Method for raising frame started events.
bool Ogre::Root::_fireFrameRenderingQueued | ( | ) |
Method for raising frame rendering queued events.
bool Ogre::Root::_fireFrameEnded | ( | ) |
Method for raising frame ended events.
|
inline |
Gets the number of the next frame to be rendered.
|
inline |
Returns the scene manager currently being used to render a frame.
|
inline |
Sets the scene manager currently being used to render.
|
inline |
|
inline |
bool Ogre::Root::_updateAllRenderTargets | ( | void | ) |
Internal method used for updating all RenderTarget objects (windows, renderable textures etc) which are set to auto-update.
bool Ogre::Root::_updateAllRenderTargets | ( | FrameEvent & | evt | ) |
Internal method used for updating all RenderTarget objects (windows, renderable textures etc) which are set to auto-update, with a custom time passed to the frameRenderingQueued events.
RenderQueueInvocationSequence* Ogre::Root::createRenderQueueInvocationSequence | ( | const String & | name | ) |
Create a new RenderQueueInvocationSequence, useful for linking to Viewport instances to perform custom rendering.
name | The name to give the new sequence |
RenderQueueInvocationSequence* Ogre::Root::getRenderQueueInvocationSequence | ( | const String & | name | ) |
Get a RenderQueueInvocationSequence.
name | The name to identify the sequence |
void Ogre::Root::destroyRenderQueueInvocationSequence | ( | const String & | name | ) |
Destroy a RenderQueueInvocationSequence.
name | The name to identify the sequence |
void Ogre::Root::destroyAllRenderQueueInvocationSequences | ( | void | ) |
Destroy all RenderQueueInvocationSequences.
|
static |
Get the singleton instance.
|
static |
Get the singleton instance.
void Ogre::Root::clearEventTimes | ( | void | ) |
Clears the history of all event times.
|
inline |
Sets the period over which OGRE smooths out fluctuations in frame times.
|
inline |
Gets the period over which OGRE smooths out fluctuations in frame times.
void Ogre::Root::addMovableObjectFactory | ( | MovableObjectFactory * | fact, |
bool | overrideExisting = false |
||
) |
Register a new MovableObjectFactory which will create new MovableObject instances of a particular type, as identified by the getType() method.
fact | Pointer to the factory instance |
overrideExisting | Set this to true to override any existing factories which are registered for the same type. You should only change this if you are very sure you know what you're doing. |
void Ogre::Root::removeMovableObjectFactory | ( | MovableObjectFactory * | fact | ) |
Removes a previously registered MovableObjectFactory.
bool Ogre::Root::hasMovableObjectFactory | ( | const String & | typeName | ) | const |
Checks whether a factory is registered for a given MovableObject type.
MovableObjectFactory* Ogre::Root::getMovableObjectFactory | ( | const String & | typeName | ) |
Get a MovableObjectFactory for the given type.
uint32 Ogre::Root::_allocateNextMovableObjectTypeFlag | ( | void | ) |
Allocate the next MovableObject type flag.
|
inline |
Return an iterator over all the MovableObjectFactory instances currently registered.
MovableObjectFactoryIterator Ogre::Root::getMovableObjectFactoryIterator | ( | void | ) | const |
unsigned int Ogre::Root::getDisplayMonitorCount | ( | ) | const |
|
inline |
Get the WorkQueue for processing background tasks.
You are free to add new requests and handlers to this queue to process your custom background tasks using the shared thread pool. However, you must remember to assign yourself a new channel through which to process your tasks.
void Ogre::Root::setWorkQueue | ( | WorkQueue * | queue | ) |
Replace the current work queue with an alternative.
You can use this method to replace the internal implementation of WorkQueue with your own, e.g. to externalise the processing of background events. Doing so will delete the existing queue and replace it with this one.
|
inline |
Sets whether blend indices information needs to be passed to the GPU.
When entities use software animation they remove blend information such as indices and weights from the vertex buffers sent to the graphic card. This function can be used to limit which information is removed.
redundant | Set to true to remove blend indices information. |
|
inline |
Returns whether blend indices information needs to be passed to the GPU see setBlendIndicesGpuRedundant() for more information.
|
inline |
Sets whether blend weights information needs to be passed to the GPU.
When entities use software animation they remove blend information such as indices and weights from the vertex buffers sent to the graphic card. This function can be used to limit which information is removed.
redundant | Set to true to remove blend weights information. |
|
inline |
Returns whether blend weights information needs to be passed to the GPU see setBlendWeightsGpuRedundant() for more information.
|
inline |
Set the default minimum pixel size for object to be rendered by.
|
inline |
Get the default minimum pixel size for object to be rendered by.