The Irrlicht device. You can create it with createDevice() or createDeviceEx(). More...

#include <IrrlichtDevice.h>

Inheritance diagram for irr::IrrlichtDevice:

Public Member Functions
virtual bool	run ()=0
	Runs the device. More...

virtual void	yield ()=0
	Cause the device to temporarily pause execution and let other processes run. More...

virtual void	sleep (u32 timeMs, bool pauseTimer=false)=0
	Pause execution and let other processes to run for a specified amount of time. More...

virtual video::IVideoDriver *	getVideoDriver ()=0
	Provides access to the video driver for drawing 3d and 2d geometry. More...

virtual io::IFileSystem *	getFileSystem ()=0
	Provides access to the virtual file system. More...

virtual gui::IGUIEnvironment *	getGUIEnvironment ()=0
	Provides access to the 2d user interface environment. More...

virtual scene::ISceneManager *	getSceneManager ()=0
	Provides access to the scene manager. More...

virtual gui::ICursorControl *	getCursorControl ()=0
	Provides access to the cursor control. More...

virtual ILogger *	getLogger ()=0
	Provides access to the message logger. More...

virtual video::IVideoModeList *	getVideoModeList ()=0
	Gets a list with all video modes available. More...

virtual video::IContextManager *	getContextManager ()=0
	Get context manager. More...

virtual IOSOperator *	getOSOperator ()=0
	Provides access to the operation system operator object. More...

virtual ITimer *	getTimer ()=0
	Provides access to the engine's timer. More...

virtual IRandomizer *	getRandomizer () const =0
	Provides access to the engine's currently set randomizer. More...

virtual void	setRandomizer (IRandomizer *r)=0
	Sets a new randomizer. More...

virtual IRandomizer *	createDefaultRandomizer () const =0
	Creates a new default randomizer. More...

virtual void	setWindowCaption (const wchar_t *text)=0
	Sets the caption of the window. More...

virtual bool	isWindowActive () const =0
	Returns if the window is active. More...

virtual bool	isWindowFocused () const =0
	Checks if the Irrlicht window has the input focus. More...

virtual bool	isWindowMinimized () const =0
	Checks if the Irrlicht window is minimized. More...

virtual bool	isFullscreen () const =0
	Checks if the Irrlicht window is running in fullscreen mode. More...

virtual video::ECOLOR_FORMAT	getColorFormat () const =0
	Get the current color format of the window. More...

virtual void	closeDevice ()=0
	Notifies the device that it should close itself. More...

virtual const c8 *	getVersion () const =0
	Get the version of the engine. More...

virtual void	setEventReceiver (IEventReceiver *receiver)=0
	Sets a new user event receiver which will receive events from the engine. More...

virtual IEventReceiver *	getEventReceiver ()=0
	Provides access to the current event receiver. More...

virtual bool	postEventFromUser (const SEvent &event)=0
	Sends a user created event to the engine. More...

virtual void	setInputReceivingSceneManager (scene::ISceneManager *sceneManager)=0
	Sets the input receiving scene manager. More...

virtual void	setResizable (bool resize=false)=0
	Sets if the window should be resizable in windowed mode. More...

virtual void	setWindowSize (const irr::core::dimension2d< u32 > &size)=0
	Resize the render window. More...

virtual void	minimizeWindow ()=0
	Minimizes the window if possible. More...

virtual void	maximizeWindow ()=0
	Maximizes the window if possible. More...

virtual void	restoreWindow ()=0
	Restore the window to normal size if possible. More...

virtual core::position2di	getWindowPosition ()=0
	Get the position of the frame on-screen. More...

virtual bool	activateJoysticks (core::array< SJoystickInfo > &joystickInfo)=0
	Activate any joysticks, and generate events for them. More...

virtual bool	activateAccelerometer (float updateInterval=0.016666f)=0
	Activate accelerometer. More...

virtual bool	deactivateAccelerometer ()=0
	Deactivate accelerometer. More...

virtual bool	isAccelerometerActive ()=0
	Is accelerometer active. More...

virtual bool	isAccelerometerAvailable ()=0
	Is accelerometer available. More...

virtual bool	activateGyroscope (float updateInterval=0.016666f)=0
	Activate gyroscope. More...

virtual bool	deactivateGyroscope ()=0
	Deactivate gyroscope. More...

virtual bool	isGyroscopeActive ()=0
	Is gyroscope active. More...

virtual bool	isGyroscopeAvailable ()=0
	Is gyroscope available. More...

virtual bool	activateDeviceMotion (float updateInterval=0.016666f)=0
	Activate device motion. More...

virtual bool	deactivateDeviceMotion ()=0
	Deactivate device motion. More...

virtual bool	isDeviceMotionActive ()=0
	Is device motion active. More...

virtual bool	isDeviceMotionAvailable ()=0
	Is device motion available. More...

virtual bool	setGammaRamp (f32 red, f32 green, f32 blue, f32 relativebrightness, f32 relativecontrast)=0
	Set the current Gamma Value for the Display. More...

virtual bool	getGammaRamp (f32 &red, f32 &green, f32 &blue, f32 &brightness, f32 &contrast)=0
	Get the current Gamma Value for the Display. More...

virtual void	setDoubleClickTime (u32 timeMs)=0
	Set the maximal elapsed time between 2 clicks to generate doubleclicks for the mouse. It also affects tripleclick behavior. More...

virtual u32	getDoubleClickTime () const =0
	Get the maximal elapsed time between 2 clicks to generate double- and tripleclicks for the mouse. More...

virtual void	clearSystemMessages ()=0
	Remove messages pending in the system message loop. More...

virtual E_DEVICE_TYPE	getType () const =0
	Get the type of the device. More...

Public Member Functions inherited from irr::IReferenceCounted
	IReferenceCounted ()
	Constructor. More...

virtual	~IReferenceCounted ()
	Destructor. More...

void	grab () const
	Grabs the object. Increments the reference counter by one. More...

bool	drop () const
	Drops the object. Decrements the reference counter by one. More...

s32	getReferenceCount () const
	Get the reference count. More...

const c8 *	getDebugName () const
	Returns the debug name of the object. More...

Static Public Member Functions
static bool	isDriverSupported (video::E_DRIVER_TYPE driver)
	Check if a driver type is supported by the engine. More...

Additional Inherited Members
Protected Member Functions inherited from irr::IReferenceCounted
void	setDebugName (const c8 *newName)
	Sets the debug name of the object. More...

Detailed Description

The Irrlicht device. You can create it with createDevice() or createDeviceEx().

This is the most important class of the Irrlicht Engine. You can access everything in the engine if you have a pointer to an instance of this class. There should be only one instance of this class at any time.

Definition at line 47 of file IrrlichtDevice.h.

Member Function Documentation

◆ activateAccelerometer()

virtual bool irr::IrrlichtDevice::activateAccelerometer ( float updateInterval = 0.016666f )

pure virtual

Activate accelerometer.

◆ activateDeviceMotion()

virtual bool irr::IrrlichtDevice::activateDeviceMotion ( float updateInterval = 0.016666f )

pure virtual

Activate device motion.

◆ activateGyroscope()

virtual bool irr::IrrlichtDevice::activateGyroscope ( float updateInterval = 0.016666f )

pure virtual

Activate gyroscope.

◆ activateJoysticks()

virtual bool irr::IrrlichtDevice::activateJoysticks ( core::array< SJoystickInfo > & joystickInfo )

pure virtual

Activate any joysticks, and generate events for them.

Irrlicht contains support for joysticks, but does not generate joystick events by default, as this would consume joystick info that 3rd party libraries might rely on. Call this method to activate joystick support in Irrlicht and to receive irr::SJoystickEvent events.

Parameters

joystickInfo On return, this will contain an array of each joystick that was found and activated.

Returns: true if joysticks are supported on this device and IRR_COMPILE_WITH_JOYSTICK_EVENTS is defined, false if joysticks are not supported or support is compiled out.

◆ clearSystemMessages()

virtual void irr::IrrlichtDevice::clearSystemMessages ( )

pure virtual

Remove messages pending in the system message loop.

This function is usually used after messages have been buffered for a longer time, for example when loading a large scene. Clearing the message loop prevents that mouse- or buttonclicks which users have pressed in the meantime will now trigger unexpected actions in the gui.
So far the following messages are cleared:
Win32: All keyboard and mouse messages
Linux: All keyboard and mouse messages
All other devices are not yet supported here.
The function is still somewhat experimental, as the kind of messages we clear is based on just a few use-cases. If you think further messages should be cleared, or some messages should not be cleared here, then please tell us.

◆ closeDevice()

virtual void irr::IrrlichtDevice::closeDevice ( )

pure virtual

Notifies the device that it should close itself.

IrrlichtDevice::run() will always return false after closeDevice() was called.

◆ createDefaultRandomizer()

virtual IRandomizer* irr::IrrlichtDevice::createDefaultRandomizer ( ) const

pure virtual

Creates a new default randomizer.

The default randomizer provides the random sequence known from previous Irrlicht versions and is the initial randomizer set on device creation.

Returns: Pointer to the default IRandomizer object.

◆ deactivateAccelerometer()

virtual bool irr::IrrlichtDevice::deactivateAccelerometer ( )

pure virtual

Deactivate accelerometer.

◆ deactivateDeviceMotion()

virtual bool irr::IrrlichtDevice::deactivateDeviceMotion ( )

pure virtual

Deactivate device motion.

◆ deactivateGyroscope()

virtual bool irr::IrrlichtDevice::deactivateGyroscope ( )

pure virtual

Deactivate gyroscope.

◆ getColorFormat()

virtual video::ECOLOR_FORMAT irr::IrrlichtDevice::getColorFormat ( ) const

pure virtual

Get the current color format of the window.

Returns: Color format of the window.

◆ getContextManager()

virtual video::IContextManager* irr::IrrlichtDevice::getContextManager ( )

pure virtual

Get context manager.

◆ getCursorControl()

virtual gui::ICursorControl* irr::IrrlichtDevice::getCursorControl ( )

pure virtual

Provides access to the cursor control.

Returns: Pointer to the mouse cursor control interface.

◆ getDoubleClickTime()

virtual u32 irr::IrrlichtDevice::getDoubleClickTime ( ) const

pure virtual

Get the maximal elapsed time between 2 clicks to generate double- and tripleclicks for the mouse.

When return value is 0 no double- and tripleclicks will be generated.

Returns: maximal time in milliseconds for two consecutive clicks to be recognized as double click

◆ getEventReceiver()

virtual IEventReceiver* irr::IrrlichtDevice::getEventReceiver ( )

pure virtual

Provides access to the current event receiver.

Returns: Pointer to the current event receiver. Returns 0 if there is none.

◆ getFileSystem()

virtual io::IFileSystem* irr::IrrlichtDevice::getFileSystem ( )

pure virtual

Provides access to the virtual file system.

Returns: Pointer to the file system.

◆ getGammaRamp()

virtual bool irr::IrrlichtDevice::getGammaRamp	(	f32 &	red,
		f32 &	green,
		f32 &	blue,
		f32 &	brightness,
		f32 &	contrast
	)

pure virtual

Get the current Gamma Value for the Display.

◆ getGUIEnvironment()

virtual gui::IGUIEnvironment* irr::IrrlichtDevice::getGUIEnvironment ( )

pure virtual

Provides access to the 2d user interface environment.

Returns: Pointer to the gui environment.

◆ getLogger()

virtual ILogger* irr::IrrlichtDevice::getLogger ( )

pure virtual

Provides access to the message logger.

Returns: Pointer to the logger.

◆ getOSOperator()

virtual IOSOperator* irr::IrrlichtDevice::getOSOperator ( )

pure virtual

Provides access to the operation system operator object.

The OS operator provides methods for getting system specific information and doing system specific operations, such as exchanging data with the clipboard or reading the operation system version.

Returns: Pointer to the OS operator.

◆ getRandomizer()

virtual IRandomizer* irr::IrrlichtDevice::getRandomizer ( ) const

pure virtual

Provides access to the engine's currently set randomizer.

Returns: Pointer to the IRandomizer object.

◆ getSceneManager()

virtual scene::ISceneManager* irr::IrrlichtDevice::getSceneManager ( )

pure virtual

Provides access to the scene manager.

Returns: Pointer to the scene manager.

◆ getTimer()

virtual ITimer* irr::IrrlichtDevice::getTimer ( )

pure virtual

Provides access to the engine's timer.

The system time can be retrieved by it as well as the virtual time, which also can be manipulated.

Returns: Pointer to the ITimer object.

◆ getType()

virtual E_DEVICE_TYPE irr::IrrlichtDevice::getType ( ) const

pure virtual

Get the type of the device.

This allows the user to check which windowing system is currently being used.

◆ getVersion()

virtual const c8* irr::IrrlichtDevice::getVersion ( ) const

pure virtual

Get the version of the engine.

The returned string will look like this: "1.2.3" or this: "1.2".

Returns: String which contains the version.

◆ getVideoDriver()

virtual video::IVideoDriver* irr::IrrlichtDevice::getVideoDriver ( )

pure virtual

Provides access to the video driver for drawing 3d and 2d geometry.

Returns: Pointer the video driver.

◆ getVideoModeList()

virtual video::IVideoModeList* irr::IrrlichtDevice::getVideoModeList ( )

pure virtual

Gets a list with all video modes available.

You only need a null driver (ED_NULL) to access those video modes. So you can get the available modes before starting any other video driver.

Returns: Pointer to a list with all video modes supported by the gfx adapter.

◆ getWindowPosition()

virtual core::position2di irr::IrrlichtDevice::getWindowPosition ( )

pure virtual

Get the position of the frame on-screen.

◆ isAccelerometerActive()

virtual bool irr::IrrlichtDevice::isAccelerometerActive ( )

pure virtual

Is accelerometer active.

◆ isAccelerometerAvailable()

virtual bool irr::IrrlichtDevice::isAccelerometerAvailable ( )

pure virtual

Is accelerometer available.

◆ isDeviceMotionActive()

virtual bool irr::IrrlichtDevice::isDeviceMotionActive ( )

pure virtual

Is device motion active.

◆ isDeviceMotionAvailable()

virtual bool irr::IrrlichtDevice::isDeviceMotionAvailable ( )

pure virtual

Is device motion available.

◆ isDriverSupported()

static bool irr::IrrlichtDevice::isDriverSupported ( video::E_DRIVER_TYPE driver )

inlinestatic

Check if a driver type is supported by the engine.

Even if true is returned the driver may not be available for a configuration requested when creating the device.

Definition at line 339 of file IrrlichtDevice.h.

                 {
                         switch (driver)
                         {
                                 case video::EDT_NULL:
                                         return true;
                                 case video::EDT_SOFTWARE:
 #ifdef _IRR_COMPILE_WITH_SOFTWARE_
                                         return true;
 #else
                                         return false;
 #endif
                                 case video::EDT_BURNINGSVIDEO:
 #ifdef _IRR_COMPILE_WITH_BURNINGSVIDEO_
                                         return true;
 #else
                                         return false;
 #endif
                                 case video::EDT_DIRECT3D9:
 #ifdef _IRR_COMPILE_WITH_DIRECT3D_9_
                                         return true;
 #else
                                         return false;
 #endif
                                 case video::EDT_OPENGL:
 #ifdef _IRR_COMPILE_WITH_OPENGL_
                                         return true;
 #else
                                         return false;
 #endif
                                 case video::EDT_OGLES1:
 #ifdef _IRR_COMPILE_WITH_OGLES1_
                                         return true;
 #else
                                         return false;
 #endif
                                 case video::EDT_OGLES2:
 #ifdef _IRR_COMPILE_WITH_OGLES2_
                                         return true;
 #else
                                         return false;
 #endif
                                 case video::EDT_WEBGL1:
 #ifdef _IRR_COMPILE_WITH_WEBGL1_
                                         return true;
 #else
                                         return false;
 #endif
                                 default:
                                         return false;
                         }
                 }

◆ isFullscreen()

virtual bool irr::IrrlichtDevice::isFullscreen ( ) const

pure virtual

Checks if the Irrlicht window is running in fullscreen mode.

Returns: True if window is fullscreen.

◆ isGyroscopeActive()

virtual bool irr::IrrlichtDevice::isGyroscopeActive ( )

pure virtual

Is gyroscope active.

◆ isGyroscopeAvailable()

virtual bool irr::IrrlichtDevice::isGyroscopeAvailable ( )

pure virtual

Is gyroscope available.

◆ isWindowActive()

virtual bool irr::IrrlichtDevice::isWindowActive ( ) const

pure virtual

Returns if the window is active.

If the window is inactive, nothing needs to be drawn. So if you don't want to draw anything when the window is inactive, create your drawing loop this way:

while(device->run())
{
        if (device->isWindowActive())
        {
                // draw everything here
        }
        else
                device->yield();
}

Returns: True if window is active.

◆ isWindowFocused()

virtual bool irr::IrrlichtDevice::isWindowFocused ( ) const

pure virtual

Checks if the Irrlicht window has the input focus.

Returns: True if window has focus.

◆ isWindowMinimized()

virtual bool irr::IrrlichtDevice::isWindowMinimized ( ) const

pure virtual

Checks if the Irrlicht window is minimized.

Returns: True if window is minimized.

◆ maximizeWindow()

virtual void irr::IrrlichtDevice::maximizeWindow ( )

pure virtual

Maximizes the window if possible.

◆ minimizeWindow()

virtual void irr::IrrlichtDevice::minimizeWindow ( )

pure virtual

Minimizes the window if possible.

◆ postEventFromUser()

virtual bool irr::IrrlichtDevice::postEventFromUser ( const SEvent & event )

pure virtual

Sends a user created event to the engine.

Is is usually not necessary to use this. However, if you are using an own input library for example for doing joystick input, you can use this to post key or mouse input events to the engine. Internally, this method only delegates the events further to the scene manager and the GUI environment.

◆ restoreWindow()

virtual void irr::IrrlichtDevice::restoreWindow ( )

pure virtual

Restore the window to normal size if possible.

◆ run()

virtual bool irr::IrrlichtDevice::run ( )

pure virtual

Runs the device.

Also increments the virtual timer by calling ITimer::tick();. You can prevent this by calling ITimer::stop(); before and ITimer::start() after calling IrrlichtDevice::run(). Returns false if device wants to be deleted. Use it in this way:

while(device->run())
{
        // draw everything here
}

If you want the device to do nothing if the window is inactive (recommended), use the slightly enhanced code shown at isWindowActive().

Note if you are running Irrlicht inside an external, custom created window: Calling Device->run() will cause Irrlicht to dispatch windows messages internally. If you are running Irrlicht in your own custom window, you can also simply use your own message loop using GetMessage, DispatchMessage and whatever and simply don't use this method. But note that Irrlicht will not be able to fetch user input then. See irr::SIrrlichtCreationParameters::WindowId for more information and example code.

◆ setDoubleClickTime()

virtual void irr::IrrlichtDevice::setDoubleClickTime ( u32 timeMs )

pure virtual

Set the maximal elapsed time between 2 clicks to generate doubleclicks for the mouse. It also affects tripleclick behavior.

When set to 0 no double- and tripleclicks will be generated.

Parameters

timeMs maximal time in milliseconds for two consecutive clicks to be recognized as double click

◆ setEventReceiver()

virtual void irr::IrrlichtDevice::setEventReceiver ( IEventReceiver * receiver )

pure virtual

Sets a new user event receiver which will receive events from the engine.

Return true in IEventReceiver::OnEvent to prevent the event from continuing along the chain of event receivers. The path that an event takes through the system depends on its type. See irr::EEVENT_TYPE for details.

Parameters

receiver New receiver to be used.

◆ setGammaRamp()

virtual bool irr::IrrlichtDevice::setGammaRamp	(	f32	red,
		f32	green,
		f32	blue,
		f32	relativebrightness,
		f32	relativecontrast
	)

pure virtual

Set the current Gamma Value for the Display.

◆ setInputReceivingSceneManager()

virtual void irr::IrrlichtDevice::setInputReceivingSceneManager ( scene::ISceneManager * sceneManager )

pure virtual

Sets the input receiving scene manager.

If set to null, the main scene manager (returned by GetSceneManager()) will receive the input

Parameters

sceneManager New scene manager to be used.

◆ setRandomizer()

virtual void irr::IrrlichtDevice::setRandomizer ( IRandomizer * r )

pure virtual

Sets a new randomizer.

Parameters

r	Pointer to the new IRandomizer object. This object is grab()'ed by the engine and will be released upon the next setRandomizer call or upon device destruction.

◆ setResizable()

virtual void irr::IrrlichtDevice::setResizable ( bool resize = false )

pure virtual

Sets if the window should be resizable in windowed mode.

The default is false. This method only works in windowed mode.

Parameters

resize Flag whether the window should be resizable.

◆ setWindowCaption()

virtual void irr::IrrlichtDevice::setWindowCaption ( const wchar_t * text )

pure virtual

Sets the caption of the window.

Parameters

text	New text of the window caption.

◆ setWindowSize()

virtual void irr::IrrlichtDevice::setWindowSize ( const irr::core::dimension2d< u32 > & size )

pure virtual

Resize the render window.

This will only work in windowed mode and is not yet supported on all systems. It does set the drawing/clientDC size of the window, the window decorations are added to that. You get the current window size with IVideoDriver::getScreenSize() (might be unified in future)

◆ sleep()

virtual void irr::IrrlichtDevice::sleep	(	u32	timeMs,
		bool	pauseTimer = `false`
	)

pure virtual

Pause execution and let other processes to run for a specified amount of time.

It may not wait the full given time, as sleep may be interrupted

Parameters

timeMs	Time to sleep for in milliseconds.
pauseTimer	If true, pauses the device timer while sleeping

◆ yield()

virtual void irr::IrrlichtDevice::yield ( )

pure virtual

Cause the device to temporarily pause execution and let other processes run.

This should bring down processor usage without major performance loss for Irrlicht

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

include/irrlicht/IrrlichtDevice.h

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ activateAccelerometer()

◆ activateDeviceMotion()

◆ activateGyroscope()

◆ activateJoysticks()

◆ clearSystemMessages()

◆ closeDevice()

◆ createDefaultRandomizer()

◆ deactivateAccelerometer()

◆ deactivateDeviceMotion()

◆ deactivateGyroscope()

◆ getColorFormat()

◆ getContextManager()

◆ getCursorControl()

◆ getDoubleClickTime()

◆ getEventReceiver()

◆ getFileSystem()

◆ getGammaRamp()

◆ getGUIEnvironment()

◆ getLogger()

◆ getOSOperator()

◆ getRandomizer()

◆ getSceneManager()

◆ getTimer()

◆ getType()

◆ getVersion()

◆ getVideoDriver()

◆ getVideoModeList()

◆ getWindowPosition()

◆ isAccelerometerActive()

◆ isAccelerometerAvailable()

◆ isDeviceMotionActive()

◆ isDeviceMotionAvailable()

◆ isDriverSupported()

◆ isFullscreen()

◆ isGyroscopeActive()

◆ isGyroscopeAvailable()

◆ isWindowActive()

◆ isWindowFocused()

◆ isWindowMinimized()

◆ maximizeWindow()

◆ minimizeWindow()

◆ postEventFromUser()

◆ restoreWindow()

◆ run()

◆ setDoubleClickTime()

◆ setEventReceiver()

◆ setGammaRamp()

◆ setInputReceivingSceneManager()

◆ setRandomizer()

◆ setResizable()

◆ setWindowCaption()

◆ setWindowSize()

◆ sleep()

◆ yield()