#include <OgreEGLSupport.h>

Inheritance diagram for Ogre::EGLSupport:

Collaboration diagram for Ogre::EGLSupport:

Public Member Functions
	EGLSupport ()

	EGLSupport ()

virtual	~EGLSupport ()

virtual	~EGLSupport ()

void	addConfig (void)
	Add any special config values to the system. More...

void	addConfig (void)
	Add any special config values to the system. More...

virtual bool	checkExtension (const String &ext) const
	Check if an extension is available. More...

virtual bool	checkExtension (const String &ext) const
	Check if an extension is available. More...

EGLConfig *	chooseGLConfig (const EGLint attribList, EGLint nElements)

EGLConfig *	chooseGLConfig (const EGLint attribList, EGLint nElements)

::EGLContext	createNewContext (EGLDisplay eglDisplay,::EGLConfig glconfig,::EGLContext shareList) const

::EGLContext	createNewContext (EGLDisplay eglDisplay,::EGLConfig glconfig,::EGLContext shareList) const

virtual GLESPBuffer *	createPBuffer (PixelComponentType format, size_t width, size_t height)=0

RenderWindow *	createWindow (bool autoCreateWindow, GLESRenderSystem *renderSystem, const String &windowTitle)

RenderWindow *	createWindow (bool autoCreateWindow, GLES2RenderSystem *renderSystem, const String &windowTitle)

virtual ConfigOptionMap &	getConfigOptions (void)

virtual ConfigOptionMap &	getConfigOptions (void)

EGLConfig *	getConfigs (EGLint *nElements)

virtual unsigned int	getDisplayMonitorCount () const

virtual unsigned int	getDisplayMonitorCount () const
	Gets the number of display monitors. More...

virtual String	getDisplayName (void)

virtual String	getDisplayName (void)

EGLBoolean	getGLConfigAttrib (EGLConfig fbConfig, EGLint attribute, EGLint *value)

EGLBoolean	getGLConfigAttrib (EGLConfig fbConfig, EGLint attribute, EGLint *value)

::EGLConfig	getGLConfigFromContext (::EGLContext context)

::EGLConfig	getGLConfigFromContext (::EGLContext context)

::EGLConfig	getGLConfigFromDrawable (::EGLSurface drawable, unsigned int w, unsigned int h)

::EGLConfig	getGLConfigFromDrawable (::EGLSurface drawable, unsigned int w, unsigned int h)

EGLDisplay	getGLDisplay (void)

EGLDisplay	getGLDisplay (void)

const String &	getGLVendor (void) const
	Get vendor information. More...

const String &	getGLVendor (void) const
	Get vendor information. More...

const String &	getGLVersion (void) const
	Get version information. More...

const String &	getGLVersion (void) const
	Get version information. More...

void *	getProcAddress (const Ogre::String &name)
	Get the address of a function. More...

void *	getProcAddress (const Ogre::String &name)
	Get the address of a function. More...

const String &	getShaderCachePath (void) const
	Get shader cache path. More...

const String &	getShaderLibraryPath (void) const
	Get shader library path. More...

GLESStateCacheManager *	getStateCacheManager () const
	Get the state cache manager. More...

GLES2StateCacheManager *	getStateCacheManager () const
	Get the state cache manager. More...

virtual void	initialiseExtensions ()
	Initialises GL extensions, must be done AFTER the GL context has been established. More...

virtual void	initialiseExtensions ()
	Initialises GL extensions, must be done AFTER the GL context has been established. More...

virtual RenderWindow *	newWindow (const String &name, unsigned int width, unsigned int height, bool fullScreen, const NameValuePairList *miscParams=0)=0
	Creates a new rendering window. More...

virtual RenderWindow *	newWindow (const String &name, unsigned int width, unsigned int height, bool fullScreen, const NameValuePairList *miscParams=0)=0
	Creates a new rendering window. More...

::EGLConfig	selectGLConfig (const EGLint minAttribs, const EGLint maxAttribs)

::EGLConfig	selectGLConfig (const EGLint minAttribs, const EGLint maxAttribs)

void	setConfigOption (const String &name, const String &value)

void	setConfigOption (const String &name, const String &value)

void	setGLDisplay (EGLDisplay val)

void	setGLDisplay (EGLDisplay val)

void	setShaderCachePath (String path)
	Set shader cache path. More...

void	setShaderLibraryPath (String path)
	Set shader library path. More...

void	setStateCacheManager (GLESStateCacheManager *stateCacheMgr)
	Set a valid state cache manager. More...

void	setStateCacheManager (GLES2StateCacheManager *stateCacheMgr)
	Set a valid state cache manager. More...

void	start (void)
	Start anything special. More...

void	start (void)
	Start anything special. More...

void	stop (void)
	Stop anything special. More...

void	stop (void)
	Stop anything special. More...

void	switchMode (void)

void	switchMode (void)

virtual void	switchMode (uint &width, uint &height, short &frequency)=0

virtual void	switchMode (uint &width, uint &height, short &frequency)=0

String	validateConfig (void)
	Make sure all the extra options are valid. More...

String	validateConfig (void)
	Make sure all the extra options are valid. More...

Protected Types
typedef short	Rate

typedef short	Rate

typedef std::pair< uint, uint >	ScreenSize

typedef std::pair< uint, uint >	ScreenSize

typedef std::pair< ScreenSize, Rate >	VideoMode

typedef std::pair< ScreenSize, Rate >	VideoMode

typedef std::vector< VideoMode >	VideoModes

typedef std::vector< VideoMode >	VideoModes

Protected Member Functions
void	refreshConfig (void)

void	refreshConfig (void)

Protected Attributes
std::set< String >	extensionList

set< String >::type	extensionList

VideoMode	mCurrentMode

EGLDisplay	mGLDisplay

bool	mIsExternalDisplay

NativeDisplayType	mNativeDisplay

ConfigOptionMap	mOptions

ConfigOptionMap	mOptions

VideoMode	mOriginalMode

bool	mRandr

StringVector	mSampleLevels

GLESStateCacheManager *	mStateCacheMgr

GLES2StateCacheManager *	mStateCacheMgr

VideoModes	mVideoModes

Detailed Description

Definition at line 47 of file include/EGL/OgreEGLSupport.h.

Member Typedef Documentation

typedef short Ogre::EGLSupport::Rate

protected

Definition at line 58 of file include/EGL/OgreEGLSupport.h.

typedef short Ogre::EGLSupport::Rate

protected

Definition at line 58 of file /include/EGL/OgreEGLSupport.h.

typedef std::pair<uint, uint> Ogre::EGLSupport::ScreenSize

protected

Definition at line 57 of file include/EGL/OgreEGLSupport.h.

typedef std::pair<uint, uint> Ogre::EGLSupport::ScreenSize

protected

Definition at line 57 of file /include/EGL/OgreEGLSupport.h.

typedef std::pair<ScreenSize, Rate> Ogre::EGLSupport::VideoMode

protected

Definition at line 59 of file /include/EGL/OgreEGLSupport.h.

typedef std::pair<ScreenSize, Rate> Ogre::EGLSupport::VideoMode

protected

Definition at line 59 of file include/EGL/OgreEGLSupport.h.

typedef std::vector<VideoMode> Ogre::EGLSupport::VideoModes

protected

Definition at line 60 of file include/EGL/OgreEGLSupport.h.

typedef std::vector<VideoMode> Ogre::EGLSupport::VideoModes

protected

Definition at line 60 of file /include/EGL/OgreEGLSupport.h.

Constructor & Destructor Documentation

Ogre::EGLSupport::EGLSupport ( )

virtual Ogre::EGLSupport::~EGLSupport ( )

virtual

Ogre::EGLSupport::EGLSupport ( )

virtual Ogre::EGLSupport::~EGLSupport ( )

virtual

Member Function Documentation

void Ogre::EGLSupport::addConfig ( void )

virtual

Add any special config values to the system.

Must have a "Full Screen" value that is a bool and a "Video Mode" value that is a string in the form of wxh

Implements Ogre::GLESSupport.

void Ogre::EGLSupport::addConfig ( void )

virtual

Add any special config values to the system.

Must have a "Full Screen" value that is a bool and a "Video Mode" value that is a string in the form of wxh

Implements Ogre::GLESSupport.

virtual bool Ogre::GLESSupport::checkExtension ( const String & ext ) const

virtualinherited

Check if an extension is available.

virtual bool Ogre::GLES2Support::checkExtension ( const String & ext ) const

virtualinherited

Check if an extension is available.

EGLConfig* Ogre::EGLSupport::chooseGLConfig	(	const EGLint *	attribList,
		EGLint *	nElements
	)

EGLConfig* Ogre::EGLSupport::chooseGLConfig	(	const EGLint *	attribList,
		EGLint *	nElements
	)

::EGLContext Ogre::EGLSupport::createNewContext	(	EGLDisplay	eglDisplay,
		::EGLConfig	glconfig,
		::EGLContext	shareList
	)		const

::EGLContext Ogre::EGLSupport::createNewContext	(	EGLDisplay	eglDisplay,
		::EGLConfig	glconfig,
		::EGLContext	shareList
	)		const

virtual GLESPBuffer* Ogre::EGLSupport::createPBuffer	(	PixelComponentType	format,
		size_t	width,
		size_t	height
	)

pure virtual

Implements Ogre::GLESSupport.

Implemented in Ogre::X11EGLSupport, Ogre::Win32EGLSupport, and Ogre::AndroidEGLSupport.

RenderWindow* Ogre::EGLSupport::createWindow	(	bool	autoCreateWindow,
		GLESRenderSystem *	renderSystem,
		const String &	windowTitle
	)

virtual

Implements Ogre::GLESSupport.

RenderWindow* Ogre::EGLSupport::createWindow	(	bool	autoCreateWindow,
		GLES2RenderSystem *	renderSystem,
		const String &	windowTitle
	)

virtual

Implements Ogre::GLES2Support.

virtual ConfigOptionMap& Ogre::GLES2Support::getConfigOptions ( void )

virtualinherited

virtual ConfigOptionMap& Ogre::GLESSupport::getConfigOptions ( void )

virtualinherited

EGLConfig* Ogre::EGLSupport::getConfigs ( EGLint * nElements )

virtual unsigned int Ogre::GLESSupport::getDisplayMonitorCount ( ) const

inlinevirtualinherited

Definition at line 104 of file OgreGLESSupport.h.

virtual unsigned int Ogre::GLES2Support::getDisplayMonitorCount ( ) const

inlinevirtualinherited

Gets the number of display monitors.

See also: Root::getDisplayMonitorCount

Definition at line 135 of file OgreGLES2Support.h.

virtual String Ogre::EGLSupport::getDisplayName ( void )

virtual

Reimplemented in Ogre::X11EGLSupport, and Ogre::X11EGLSupport.

virtual String Ogre::EGLSupport::getDisplayName ( void )

virtual

Reimplemented in Ogre::X11EGLSupport, and Ogre::X11EGLSupport.

EGLBoolean Ogre::EGLSupport::getGLConfigAttrib	(	EGLConfig	fbConfig,
		EGLint	attribute,
		EGLint *	value
	)

EGLBoolean Ogre::EGLSupport::getGLConfigAttrib	(	EGLConfig	fbConfig,
		EGLint	attribute,
		EGLint *	value
	)

::EGLConfig Ogre::EGLSupport::getGLConfigFromContext ( ::EGLContext context )

::EGLConfig Ogre::EGLSupport::getGLConfigFromDrawable	(	::EGLSurface	drawable,
		unsigned int *	w,
		unsigned int *	h
	)

::EGLConfig Ogre::EGLSupport::getGLConfigFromDrawable	(	::EGLSurface	drawable,
		unsigned int *	w,
		unsigned int *	h
	)

EGLDisplay Ogre::EGLSupport::getGLDisplay ( void )

const String& Ogre::GLES2Support::getGLVendor ( void ) const

inlineinherited

Get vendor information.

Definition at line 74 of file OgreGLES2Support.h.

const String& Ogre::GLESSupport::getGLVendor ( void ) const

inlineinherited

Get vendor information.

Definition at line 76 of file OgreGLESSupport.h.

const String& Ogre::GLES2Support::getGLVersion ( void ) const

inlineinherited

Get version information.

Definition at line 82 of file OgreGLES2Support.h.

const String& Ogre::GLESSupport::getGLVersion ( void ) const

inlineinherited

Get version information.

Definition at line 84 of file OgreGLESSupport.h.

void* Ogre::EGLSupport::getProcAddress ( const Ogre::String & procname )

virtual

Get the address of a function.

Implements Ogre::GLESSupport.

void* Ogre::EGLSupport::getProcAddress ( const Ogre::String & procname )

virtual

Get the address of a function.

Implements Ogre::GLESSupport.

const String& Ogre::GLES2Support::getShaderCachePath ( void ) const

inlineinherited

Get shader cache path.

Definition at line 90 of file OgreGLES2Support.h.

const String& Ogre::GLES2Support::getShaderLibraryPath ( void ) const

inlineinherited

Get shader library path.

Definition at line 98 of file OgreGLES2Support.h.

GLESStateCacheManager* Ogre::GLESSupport::getStateCacheManager ( ) const

inlineinherited

Get the state cache manager.

Definition at line 112 of file OgreGLESSupport.h.

GLES2StateCacheManager* Ogre::GLES2Support::getStateCacheManager ( ) const

inlineinherited

Get the state cache manager.

Definition at line 143 of file OgreGLES2Support.h.

virtual void Ogre::GLESSupport::initialiseExtensions ( )

virtualinherited

Initialises GL extensions, must be done AFTER the GL context has been established.

virtual void Ogre::GLES2Support::initialiseExtensions ( )

virtualinherited

Initialises GL extensions, must be done AFTER the GL context has been established.

virtual RenderWindow* Ogre::GLES2Support::newWindow	(	const String &	name,
		unsigned int	width,
		unsigned int	height,
		bool	fullScreen,
		const NameValuePairList *	miscParams = `0`
	)

pure virtualinherited

Creates a new rendering window.

Remarks: This method creates a new rendering window as specified by the paramteters. The rendering system could be responible for only a single window (e.g. in the case of a game), or could be in charge of multiple ones (in the case of a level editor). The option to create the window as a child of another is therefore given. This method will create an appropriate subclass of RenderWindow depending on the API and platform implementation.

: After creation, this window can be retrieved using getRenderTarget().

Parameters

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	Notes
title	Any string	RenderTarget name	The title of the window that will appear in the title bar
colourDepth	16, 32	Desktop depth	Colour depth of the resulting rendering window; only applies if fullScreen	Win32 Specific
left	Positive integers	Centred	Screen x coordinate from left
top	Positive integers	Centred	Screen y coordinate from left
depthBuffer	true, false	true	Use depth buffer	DirectX9 specific
externalWindowHandle	Win32: HWND as integer GLX: poslong:posint:poslong (display:screen:windowHandle) or poslong:posint:poslong:poslong (display:screen:windowHandle:XVisualInfo*) OS X: WindowRef for Carbon or NSWindow for Cocoa address as an integer iOS: UIWindow address as an integer	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 specific
externalGLContext	Context as Unsigned Long	0 (create own context)	Use an externally created GL context	OpenGL Specific
parentWindowHandle	Win32: HWND as integer GLX: poslong:posint:poslong (display:screen:windowHandle) or poslong:posint:poslong:poslong (display:screen:windowHandle:XVisualInfo*)	0 (none)	Parent window handle, for embedding the OGRE in a child of an external window
macAPI	String: "cocoa" or "carbon"	"carbon"	Specifies the type of rendering window on the Mac Platform.	Mac OS X Specific
macAPICocoaUseNSView	bool "true" or "false"	"false"	On the Mac platform the most diffused method to embed OGRE in a custom application is to use Interface Builder and add to the interface an instance of OgreView. The pointer to this instance is then used as "externalWindowHandle". However, there are cases where you are NOT using Interface Builder and you get the Cocoa NSView* of an existing interface. For example, this is happens when you want to render into a Java/AWT interface. In short, by setting this flag to "true" the Ogre::Root::createRenderWindow interprets the "externalWindowHandle" as a NSView* instead of an OgreView*. See OgreOSXCocoaView.h/mm.	Mac OS X Specific
contentScalingFactor	Positive Float greater than 1.0	The default content scaling factor of the screen	Specifies the CAEAGLLayer content scaling factor. Only supported on iOS 4 or greater. 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.	iOS Specific
externalViewHandle	UIView pointer as an integer	0	External view handle, for rendering OGRE render in an existing view	iOS Specific
externalViewControllerHandle	UIViewController pointer as an integer	0	External view controller handle, for embedding OGRE in an existing view controller	iOS Specific
externalSharegroup	EAGLSharegroup pointer as an integer	0	External sharegroup, used to shared GL resources between contexts	iOS Specific
Full Screen	true, false	false	Specify whether to create the window in full screen mode	OS X Specific
FSAA	Positive integer (usually 0, 2, 4, 8, 16)	0	Full screen antialiasing factor
FSAAHint	Depends on RenderSystem and hardware. Currently supports: "Quality": on systems that have an option to prefer higher AA quality over speed, use it	Blank	Full screen antialiasing hint
displayFrequency	Refresh rate in Hertz (e.g. 60, 75, 100)	Desktop vsync rate	Display frequency rate, for fullscreen mode
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.
border	none, fixed, resize	resize	The type of window border (in windowed mode)
outerDimensions	true, false	false	Whether the width/height is expressed as the size of the outer window, rather than the content area
useNVPerfHUD	true, false	false	Enable the use of nVidia NVPerfHUD
gamma	true, false	false	Enable hardware conversion from linear colour space to gamma colour space on rendering to the window.
enableDoubleClick	true, false	false	Enable the window to keep track and transmit double click messages.	Win32 Specific

Implemented in Ogre::X11EGLSupport, Ogre::X11EGLSupport, Ogre::EAGL2Support, Ogre::Win32EGLSupport, Ogre::Win32EGLSupport, Ogre::NaClGLSupport, Ogre::AndroidEGLSupport, and Ogre::AndroidEGLSupport.

virtual RenderWindow* Ogre::GLESSupport::newWindow	(	const String &	name,
		unsigned int	width,
		unsigned int	height,
		bool	fullScreen,
		const NameValuePairList *	miscParams = `0`
	)

pure virtualinherited

Creates a new rendering window.

Remarks: This method creates a new rendering window as specified by the paramteters. The rendering system could be responible for only a single window (e.g. in the case of a game), or could be in charge of multiple ones (in the case of a level editor). The option to create the window as a child of another is therefore given. This method will create an appropriate subclass of RenderWindow depending on the API and platform implementation.

: After creation, this window can be retrieved using getRenderTarget().

Parameters

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	Notes
title	Any string	RenderTarget name	The title of the window that will appear in the title bar
colourDepth	16, 32	Desktop depth	Colour depth of the resulting rendering window; only applies if fullScreen	Win32 Specific
left	Positive integers	Centred	Screen x coordinate from left
top	Positive integers	Centred	Screen y coordinate from left
depthBuffer	true, false	true	Use depth buffer	DirectX9 specific
externalWindowHandle	Win32: HWND as integer GLX: poslong:posint:poslong (display:screen:windowHandle) or poslong:posint:poslong:poslong (display:screen:windowHandle:XVisualInfo*) OS X: WindowRef for Carbon or NSWindow for Cocoa address as an integer iOS: UIWindow address as an integer	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 specific
externalGLContext	Context as Unsigned Long	0 (create own context)	Use an externally created GL context	OpenGL Specific
parentWindowHandle	Win32: HWND as integer GLX: poslong:posint:poslong (display:screen:windowHandle) or poslong:posint:poslong:poslong (display:screen:windowHandle:XVisualInfo*)	0 (none)	Parent window handle, for embedding the OGRE in a child of an external window
macAPI	String: "cocoa" or "carbon"	"carbon"	Specifies the type of rendering window on the Mac Platform.	Mac OS X Specific
macAPICocoaUseNSView	bool "true" or "false"	"false"	On the Mac platform the most diffused method to embed OGRE in a custom application is to use Interface Builder and add to the interface an instance of OgreView. The pointer to this instance is then used as "externalWindowHandle". However, there are cases where you are NOT using Interface Builder and you get the Cocoa NSView* of an existing interface. For example, this is happens when you want to render into a Java/AWT interface. In short, by setting this flag to "true" the Ogre::Root::createRenderWindow interprets the "externalWindowHandle" as a NSView* instead of an OgreView*. See OgreOSXCocoaView.h/mm.	Mac OS X Specific
contentScalingFactor	Positive Float greater than 1.0	The default content scaling factor of the screen	Specifies the CAEAGLLayer content scaling factor. Only supported on iOS 4 or greater. 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.	iOS Specific
externalViewHandle	UIView pointer as an integer	0	External view handle, for rendering OGRE render in an existing view	iOS Specific
externalViewControllerHandle	UIViewController pointer as an integer	0	External view controller handle, for embedding OGRE in an existing view controller	iOS Specific
externalSharegroup	EAGLSharegroup pointer as an integer	0	External sharegroup, used to shared GL resources between contexts	iOS Specific
Full Screen	true, false	false	Specify whether to create the window in full screen mode	OS X Specific
FSAA	Positive integer (usually 0, 2, 4, 8, 16)	0	Full screen antialiasing factor
FSAAHint	Depends on RenderSystem and hardware. Currently supports: "Quality": on systems that have an option to prefer higher AA quality over speed, use it	Blank	Full screen antialiasing hint
displayFrequency	Refresh rate in Hertz (e.g. 60, 75, 100)	Desktop vsync rate	Display frequency rate, for fullscreen mode
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.
border	none, fixed, resize	resize	The type of window border (in windowed mode)
outerDimensions	true, false	false	Whether the width/height is expressed as the size of the outer window, rather than the content area
useNVPerfHUD	true, false	false	Enable the use of nVidia NVPerfHUD
gamma	true, false	false	Enable hardware conversion from linear colour space to gamma colour space on rendering to the window.
enableDoubleClick	true, false	false	Enable the window to keep track and transmit double click messages.	Win32 Specific