Irrlicht 3D Engine
irr Namespace Reference

Everything in the Irrlicht Engine can be found in this namespace. More...

Namespaces

Classes

Typedefs

Enumerations

Functions


Detailed Description

Everything in the Irrlicht Engine can be found in this namespace.

As of Irrlicht 1.6, position2d is a synonym for vector2d.

You should consider position2d to be deprecated, and use vector2d by preference.


Typedef Documentation

typedef char irr::c8

8 bit character variable.

This is a typedef for char, it ensures portability of the engine.

Definition at line 31 of file irrTypes.h.

typedef float irr::f32

32 bit floating point variable.

This is a typedef for float, it ensures portability of the engine.

Definition at line 104 of file irrTypes.h.

typedef double irr::f64

64 bit floating point variable.

This is a typedef for double, it ensures portability of the engine.

Definition at line 108 of file irrTypes.h.

typedef char irr::fschar_t

Type name for character type used by the file system.

Should the wide character version of the FileSystem be used it is a 16 bit character variable. Used for unicode Filesystem and unicode strings. Else it is a 8 bit character variable. Used for ansi Filesystem and non-unicode strings

Definition at line 158 of file irrTypes.h.

typedef IrrlichtDevice* IRRCALLCONV* irr::funcptr_createDevice(video::E_DRIVER_TYPE deviceType, const core::dimension2d< u32 > &windowSize, u32 bits, bool fullscreen, bool stencilbuffer, bool vsync, IEventReceiver *receiver)

typedef for Function Pointer

Definition at line 335 of file irrlicht.h.

typedef for Function Pointer

Definition at line 357 of file irrlicht.h.

typedef signed short irr::s16

16 bit signed variable.

This is a typedef for signed short, it ensures portability of the engine.

Definition at line 48 of file irrTypes.h.

typedef signed int irr::s32

32 bit signed variable.

This is a typedef for signed int, it ensures portability of the engine.

Definition at line 66 of file irrTypes.h.

typedef long long irr::s64

64 bit signed variable.

This is a typedef for 64bit int, it ensures portability of the engine.

Definition at line 96 of file irrTypes.h.

typedef signed char irr::s8

8 bit signed variable.

This is a typedef for signed char, it ensures portability of the engine.

Definition at line 26 of file irrTypes.h.

typedef unsigned short irr::u16

16 bit unsigned variable.

This is a typedef for unsigned short, it ensures portability of the engine.

Definition at line 40 of file irrTypes.h.

typedef unsigned int irr::u32

32 bit unsigned variable.

This is a typedef for unsigned int, it ensures portability of the engine.

Definition at line 58 of file irrTypes.h.

typedef unsigned long long irr::u64

64 bit unsigned variable.

This is a typedef for 64bit uint, it ensures portability of the engine.

Definition at line 82 of file irrTypes.h.

typedef unsigned char irr::u8

8 bit unsigned variable.

This is a typedef for unsigned char, it ensures portability of the engine.

Definition at line 18 of file irrTypes.h.


Enumeration Type Documentation

An enum for the different device types supported by the Irrlicht Engine.

Enumerator:
EIDT_WIN32 

A device native to Microsoft Windows.

This device uses the Win32 API and works in all versions of Windows.

EIDT_WINCE 

A device native to Windows CE devices.

This device works on Windows Mobile, Pocket PC and Microsoft SmartPhone devices

EIDT_X11 

A device native to Unix style operating systems.

This device uses the X11 windowing system and works in Linux, Solaris, FreeBSD, OSX and other operating systems which support X11.

EIDT_OSX 

A device native to Mac OSX.

This device uses Apple's Cocoa API and works in Mac OSX 10.2 and above.

EIDT_SDL 

A device which uses Simple DirectMedia Layer.

The SDL device works under all platforms supported by SDL but first must be compiled in by defining the IRR_USE_SDL_DEVICE macro in IrrCompileConfig.h

EIDT_FRAMEBUFFER 

A device for raw framebuffer access.

Best used with embedded devices and mobile systems. Does not need X11 or other graphical subsystems. May support hw-acceleration via OpenGL-ES for FBDirect

EIDT_CONSOLE 

A simple text only device supported by all platforms.

This device allows applications to run from the command line without opening a window. It can render the output of the software drivers to the console as ASCII. It only supports mouse and keyboard in Windows operating systems.

EIDT_BEST 

This selection allows Irrlicht to choose the best device from the ones available.

If this selection is chosen then Irrlicht will try to use the IrrlichtDevice native to your operating system. If this is unavailable then the X11, SDL and then console device will be tried. This ensures that Irrlicht will run even if your platform is unsupported, although it may not be able to render anything.

Definition at line 12 of file EDeviceTypes.h.

Masks for mouse button states.

Enumerator:
EMBSM_LEFT 
EMBSM_RIGHT 
EMBSM_MIDDLE 
EMBSM_EXTRA1 

currently only on windows

EMBSM_EXTRA2 

currently only on windows

EMBSM_FORCE_32_BIT 

Definition at line 130 of file IEventReceiver.h.

Enumeration for all event types there are.

Enumerator:
EET_GUI_EVENT 

An event of the graphical user interface.

GUI events are created by the GUI environment or the GUI elements in response to mouse or keyboard events. When a GUI element receives an event it will either process it and return true, or pass the event to its parent. If an event is not absorbed before it reaches the root element then it will then be passed to the user receiver.

EET_MOUSE_INPUT_EVENT 

A mouse input event.

Mouse events are created by the device and passed to IrrlichtDevice::postEventFromUser in response to mouse input received from the operating system. Mouse events are first passed to the user receiver, then to the GUI environment and its elements, then finally the input receiving scene manager where it is passed to the active camera.

EET_KEY_INPUT_EVENT 

A key input event.

Like mouse events, keyboard events are created by the device and passed to IrrlichtDevice::postEventFromUser. They take the same path as mouse events.

EET_JOYSTICK_INPUT_EVENT 

A joystick (joypad, gamepad) input event.

Joystick events are created by polling all connected joysticks once per device run() and then passing the events to IrrlichtDevice::postEventFromUser. They take the same path as mouse events. Windows, SDL: Implemented. Linux: Implemented, with POV hat issues. MacOS / Other: Not yet implemented.

EET_LOG_TEXT_EVENT 

A log event.

Log events are only passed to the user receiver if there is one. If they are absorbed by the user receiver then no text will be sent to the console.

EET_USER_EVENT 

A user event with user data.

This is not used by Irrlicht and can be used to send user specific data though the system. The Irrlicht 'window handle' can be obtained from IrrlichtDevice::getExposedVideoData() The usage and behavior depends on the operating system: Windows: send a WM_USER message to the Irrlicht Window; the wParam and lParam will be used to populate the UserData1 and UserData2 members of the SUserEvent. Linux: send a ClientMessage via XSendEvent to the Irrlicht Window; the data.l[0] and data.l[1] members will be casted to s32 and used as UserData1 and UserData2. MacOS: Not yet implemented

EGUIET_FORCE_32_BIT 

This enum is never used, it only forces the compiler to compile these enumeration values to 32 bit.

Definition at line 15 of file IEventReceiver.h.

enumeration for key actions. Used for example in the FPS Camera.

Enumerator:
EKA_MOVE_FORWARD 
EKA_MOVE_BACKWARD 
EKA_STRAFE_LEFT 
EKA_STRAFE_RIGHT 
EKA_JUMP_UP 
EKA_CROUCH 
EKA_COUNT 
EKA_FORCE_32BIT 

This value is not used. It only forces this enumeration to compile in 32 bit.

Definition at line 14 of file SKeyMap.h.

Enumerator:
KEY_LBUTTON 
KEY_RBUTTON 
KEY_CANCEL 
KEY_MBUTTON 
KEY_XBUTTON1 
KEY_XBUTTON2 
KEY_BACK 
KEY_TAB 
KEY_CLEAR 
KEY_RETURN 
KEY_SHIFT 
KEY_CONTROL 
KEY_MENU 
KEY_PAUSE 
KEY_CAPITAL 
KEY_KANA 
KEY_HANGUEL 
KEY_HANGUL 
KEY_JUNJA 
KEY_FINAL 
KEY_HANJA 
KEY_KANJI 
KEY_ESCAPE 
KEY_CONVERT 
KEY_NONCONVERT 
KEY_ACCEPT 
KEY_MODECHANGE 
KEY_SPACE 
KEY_PRIOR 
KEY_NEXT 
KEY_END 
KEY_HOME 
KEY_LEFT 
KEY_UP 
KEY_RIGHT 
KEY_DOWN 
KEY_SELECT 
KEY_PRINT 
KEY_EXECUT 
KEY_SNAPSHOT 
KEY_INSERT 
KEY_DELETE 
KEY_HELP 
KEY_KEY_0 
KEY_KEY_1 
KEY_KEY_2 
KEY_KEY_3 
KEY_KEY_4 
KEY_KEY_5 
KEY_KEY_6 
KEY_KEY_7 
KEY_KEY_8 
KEY_KEY_9 
KEY_KEY_A 
KEY_KEY_B 
KEY_KEY_C 
KEY_KEY_D 
KEY_KEY_E 
KEY_KEY_F 
KEY_KEY_G 
KEY_KEY_H 
KEY_KEY_I 
KEY_KEY_J 
KEY_KEY_K 
KEY_KEY_L 
KEY_KEY_M 
KEY_KEY_N 
KEY_KEY_O 
KEY_KEY_P 
KEY_KEY_Q 
KEY_KEY_R 
KEY_KEY_S 
KEY_KEY_T 
KEY_KEY_U 
KEY_KEY_V 
KEY_KEY_W 
KEY_KEY_X 
KEY_KEY_Y 
KEY_KEY_Z 
KEY_LWIN 
KEY_RWIN 
KEY_APPS 
KEY_SLEEP 
KEY_NUMPAD0 
KEY_NUMPAD1 
KEY_NUMPAD2 
KEY_NUMPAD3 
KEY_NUMPAD4 
KEY_NUMPAD5 
KEY_NUMPAD6 
KEY_NUMPAD7 
KEY_NUMPAD8 
KEY_NUMPAD9 
KEY_MULTIPLY 
KEY_ADD 
KEY_SEPARATOR 
KEY_SUBTRACT 
KEY_DECIMAL 
KEY_DIVIDE 
KEY_F1 
KEY_F2 
KEY_F3 
KEY_F4 
KEY_F5 
KEY_F6 
KEY_F7 
KEY_F8 
KEY_F9 
KEY_F10 
KEY_F11 
KEY_F12 
KEY_F13 
KEY_F14 
KEY_F15 
KEY_F16 
KEY_F17 
KEY_F18 
KEY_F19 
KEY_F20 
KEY_F21 
KEY_F22 
KEY_F23 
KEY_F24 
KEY_NUMLOCK 
KEY_SCROLL 
KEY_LSHIFT 
KEY_RSHIFT 
KEY_LCONTROL 
KEY_RCONTROL 
KEY_LMENU 
KEY_RMENU 
KEY_OEM_1 
KEY_PLUS 
KEY_COMMA 
KEY_MINUS 
KEY_PERIOD 
KEY_OEM_2 
KEY_OEM_3 
KEY_OEM_4 
KEY_OEM_5 
KEY_OEM_6 
KEY_OEM_7 
KEY_OEM_8 
KEY_OEM_AX 
KEY_OEM_102 
KEY_ATTN 
KEY_CRSEL 
KEY_EXSEL 
KEY_EREOF 
KEY_PLAY 
KEY_ZOOM 
KEY_PA1 
KEY_OEM_CLEAR 
KEY_KEY_CODES_COUNT 

Definition at line 11 of file Keycodes.h.

Possible log levels. When used has filter ELL_DEBUG means => log everything and ELL_NONE means => log (nearly) nothing. When used to print logging information ELL_DEBUG will have lowest priority while ELL_NONE messages are never filtered and always printed.

Enumerator:
ELL_DEBUG 

Used for printing information helpful in debugging.

ELL_INFORMATION 

Useful information to print. For example hardware infos or something started/stopped.

ELL_WARNING 

Warnings that something isn't as expected and can cause oddities.

ELL_ERROR 

Something did go wrong.

ELL_NONE 

Logs with ELL_NONE will never be filtered. And used as filter it will remove all logging except ELL_NONE messages.

Definition at line 17 of file ILogger.h.

Enumeration for all mouse input events.

Enumerator:
EMIE_LMOUSE_PRESSED_DOWN 

Left mouse button was pressed down.

EMIE_RMOUSE_PRESSED_DOWN 

Right mouse button was pressed down.

EMIE_MMOUSE_PRESSED_DOWN 

Middle mouse button was pressed down.

EMIE_LMOUSE_LEFT_UP 

Left mouse button was left up.

EMIE_RMOUSE_LEFT_UP 

Right mouse button was left up.

EMIE_MMOUSE_LEFT_UP 

Middle mouse button was left up.

EMIE_MOUSE_MOVED 

The mouse cursor changed its position.

EMIE_MOUSE_WHEEL 

The mouse wheel was moved. Use Wheel value in event data to find out in what direction and how fast.

EMIE_LMOUSE_DOUBLE_CLICK 

Left mouse button double click. This event is generated after the second EMIE_LMOUSE_PRESSED_DOWN event.

EMIE_RMOUSE_DOUBLE_CLICK 

Right mouse button double click. This event is generated after the second EMIE_RMOUSE_PRESSED_DOWN event.

EMIE_MMOUSE_DOUBLE_CLICK 

Middle mouse button double click. This event is generated after the second EMIE_MMOUSE_PRESSED_DOWN event.

EMIE_LMOUSE_TRIPLE_CLICK 

Left mouse button triple click. This event is generated after the third EMIE_LMOUSE_PRESSED_DOWN event.

EMIE_RMOUSE_TRIPLE_CLICK 

Right mouse button triple click. This event is generated after the third EMIE_RMOUSE_PRESSED_DOWN event.

EMIE_MMOUSE_TRIPLE_CLICK 

Middle mouse button triple click. This event is generated after the third EMIE_MMOUSE_PRESSED_DOWN event.

EMIE_COUNT 

No real event. Just for convenience to get number of events.

Definition at line 74 of file IEventReceiver.h.


Function Documentation

IRRLICHT_API IrrlichtDevice* IRRCALLCONV irr::createDevice ( video::E_DRIVER_TYPE  deviceType = video::EDT_SOFTWARE,
const core::dimension2d< u32 > &  windowSize = (core::dimension2d< u32 >(640, 480)),
u32  bits = 16,
bool  fullscreen = false,
bool  stencilbuffer = false,
bool  vsync = false,
IEventReceiver *  receiver = 0 
)

Creates an Irrlicht device. The Irrlicht device is the root object for using the engine.

If you need more parameters to be passed to the creation of the Irrlicht Engine device, use the createDeviceEx() function.

Parameters:
deviceType,:Type of the device. This can currently be video::EDT_NULL, video::EDT_SOFTWARE, video::EDT_BURNINGSVIDEO, video::EDT_DIRECT3D8, video::EDT_DIRECT3D9 and video::EDT_OPENGL.
windowSize,:Size of the window or the video mode in fullscreen mode.
bits,:Bits per pixel in fullscreen mode. Ignored if windowed mode.
fullscreen,:Should be set to true if the device should run in fullscreen. Otherwise the device runs in windowed mode.
stencilbuffer,:Specifies if the stencil buffer should be enabled. Set this to true, if you want the engine be able to draw stencil buffer shadows. Note that not all devices are able to use the stencil buffer. If they don't no shadows will be drawn.
vsync,:Specifies vertical syncronisation: If set to true, the driver will wait for the vertical retrace period, otherwise not.
receiver,:A user created event receiver.
Returns:
Returns pointer to the created IrrlichtDevice or null if the device could not be created.
IRRLICHT_API IrrlichtDevice* IRRCALLCONV irr::createDeviceEx ( const SIrrlichtCreationParameters &  parameters)

Creates an Irrlicht device with the option to specify advanced parameters.

Usually you should used createDevice() for creating an Irrlicht Engine device. Use this function only if you wish to specify advanced parameters like a window handle in which the device should be created.

Parameters:
parameters,:Structure containing advanced parameters for the creation of the device. See irr::SIrrlichtCreationParameters for details.
Returns:
Returns pointer to the created IrrlichtDevice or null if the device could not be created.