The SDLWindow class implements an OpenGLContext using the SDL API. More...

#include <SDLWindow.hpp>

Inheritance diagram for vlSDL::SDLWindow:

Public Member Functions
	SDLWindow ()

	SDLWindow (const vl::String &title, const vl::OpenGLContextFormat &info, int x=0, int y=0, int width=640, int height=480)

bool	initSDLWindow (const vl::String &title, const vl::OpenGLContextFormat &info, int x=0, int y=0, int width=640, int height=480)

	~SDLWindow ()

void	setPosition (int x, int y)
	If the OpenGL context is a widget this function sets its position. More...

virtual void	swapBuffers ()
	Swaps the back and front buffers to present the last rendering. More...

void	translateEvent (SDL_Event *ev)

void	quitApplication ()
	Quits the event loop. More...

void	setWindowTitle (const vl::String &)
	If the OpenGL context is a top window this function sets its title. More...

void	setMouseVisible (bool visible)
	If the OpenGL context is a widget this function sets whether the mouse is visible over it or not. More...

void	setMousePosition (int x, int y)
	If the OpenGL context is a widget this function sets the mouse position. More...

void	update ()
	If the OpenGLContext is a widget this function requests a redraw and generates an updateEvent(). More...

void	makeCurrent ()
	Sets the OpenGL context as current for the calling thread. More...

Public Member Functions inherited from vl::OpenGLContext
	OpenGLContext (int w=0, int h=0)
	Constructor. More...

	~OpenGLContext ()
	Destructor. More...

bool	initGLContext (bool log=true)
	Initializes the supported OpenGL extensions. More...

void	logOpenGLInfo ()
	Logs some information about the OpenGL context. More...

const std::string &	extensions () const
	Returns the list of OpenGL extensions supported separated by '\|' characters. More...

bool	isExtensionSupported (const char *ext_name)
	Returns true if the given extension is supported. More...

void *	getProcAddress (const char *function_name)
	Returns the address of an OpenGL extension function. More...

FramebufferObject *	leftFramebuffer ()
	The render target representing the default left framebuffer. More...

const FramebufferObject *	leftFramebuffer () const
	The render target representing the default left framebuffer. More...

FramebufferObject *	rightFramebuffer ()
	The render target representing the default right framebuffer (if a stereo OpenGL context is present). More...

const FramebufferObject *	rightFramebuffer () const
	The render target representing the default right framebuffer (if a stereo OpenGL context is present). More...

FramebufferObject *	framebuffer ()
	The default render target (always returns leftFramebuffer()). More...

const FramebufferObject *	framebuffer () const
	The default render target (always returns leftFramebuffer()). More...

FramebufferObject *	createFramebufferObject ()
	Equivalent to `"createFramebufferObject(0,0);"`. More...

FramebufferObject *	createFramebufferObject (int width, int height, EReadDrawBuffer draw_buffer=RDB_COLOR_ATTACHMENT0, EReadDrawBuffer read_buffer=RDB_COLOR_ATTACHMENT0)
	Creates a new FramebufferObject (framebuffer object FramebufferObject). More...

void	destroyFramebufferObject (FramebufferObject *fbort)
	Destroys the specified FramebufferObject. More...

void	destroyAllFramebufferObjects ()
	Removes all FramebufferObjects belonging to an OpenGLContext. More...

void	destroyAllOpenGLResources ()
	Removes all OpenGL resources handled by the OpenGLContext. More...

virtual bool	setFullscreen (bool)
	If the OpenGL context is a widget this function requests a maximization to fullscreen. More...

virtual bool	fullscreen () const
	If the OpenGL context is a widget this function returns whether it has been maximized to fullscreen. More...

virtual void	show ()
	If the OpenGL context is a widget this function makes it visible to the user. More...

virtual void	hide ()
	If the OpenGL context is a widget this function makes it invisible to the user. More...

virtual ivec2	position () const
	If the OpenGL context is a widget this function returns its position. More...

virtual void	setSize (int, int)
	If the OpenGL context is a widget this function sets its size. More...

int	width () const
	Returns the width in pixels of an OpenGLContext. More...

int	height () const
	Returns the height in pixels of an OpenGLContext. More...

virtual bool	mouseVisible () const
	If the OpenGL context is a widget this function returns whether the mouse is visible over it or not. More...

virtual void	getFocus ()
	If the OpenGL context is a widget this function requests the mouse focus on it. More...

void	setVSyncEnabled (bool enable)
	If the OpenGL context is a widget this function enabled/disables double buffer swapping to the monitor's vertical synch. More...

bool	vsyncEnabled () const
	If the OpenGL context is a widget this function returns whether vsync is enabled or not. More...

virtual void	setContinuousUpdate (bool continuous)
	If the OpenGL context is a widget this function sets whether its area is continuously updated at each frame. More...

bool	continuousUpdate () const
	If the OpenGL context is a widget this function returns whether its area is continuously updated at each frame. More...

void	addEventListener (UIEventListener *el)
	Adds an UIEventListener to be notified of OpenGLContext related events. More...

void	removeEventListener (UIEventListener *el)
	Removes an UIEventListener. More...

void	eraseAllEventListeners ()
	Removes all UIEventListener previously registered. More...

const std::vector< ref< UIEventListener > > &	eventListeners () const
	The currently UIEventListener registered to be notified of OpenGLContext related events. More...

const UIEventListener *	eventListener (int i) const
	Returns the `i-th` UIEventListener registered to an OpenGLContext. More...

UIEventListener *	eventListener (int i)
	Returns the `i-th` UIEventListener registered to an OpenGLContext. More...

int	eventListenerCount () const
	Returns the number of UIEventListener registered to an OpenGLContext. More...

const OpenGLContextFormat &	openglContextInfo () const
	Returns an OpenGLContextFormat structure describing an OpenGLContext. More...

void	setOpenGLContextInfo (const OpenGLContextFormat &info)
	Sets the OpenGLContextFormat associated to an OpenGLContext. More...

void	ignoreNextMouseMoveEvent ()
	Requests not to dispatch the next mouse move event. More...

void	dispatchResizeEvent (int w, int h)
	Dispatches the UIEventListener::resizeEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchMouseMoveEvent (int x, int y)
	Dispatches the UIEventListener::mouseMoveEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchMouseUpEvent (EMouseButton button, int x, int y)
	Dispatches the UIEventListener::mouseUpEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchMouseDownEvent (EMouseButton button, int x, int y)
	Dispatches the UIEventListener::mouseDownEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchMouseWheelEvent (int n)
	Dispatches the UIEventListener::mouseWheelEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchKeyPressEvent (unsigned short unicode_ch, EKey key)
	Dispatches the UIEventListener::keyPressEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchKeyReleaseEvent (unsigned short unicode_ch, EKey key)
	Dispatches the UIEventListener::keyReleaseEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchDestroyEvent ()
	Dispatches the UIEventListener::destroyEvent() notification to the subscribed UIEventListener(s), calls destroyAllOpenGLResources() and eraseAllEventListeners() This event must be issued just before the actual GL context is destroyed. More...

void	dispatchUpdateEvent ()
	Dispatches the UIEventListener::updateEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchVisibilityEvent (bool visible)
	Dispatches the UIEventListener::visibilityEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchInitEvent ()
	Dispatches the UIEventListener::initEvent() notification to the subscribed UIEventListener objects. More...

void	dispatchFileDroppedEvent (const std::vector< String > &files)
	Dispatches the UIEventListener::fileDroppedEvent() notification to the subscribed UIEventListener objects. More...

const std::set< EKey > &	keyboard () const
	Returns the std::set containing the currently pressed keys. More...

bool	isKeyPressed (EKey key) const
	Returns true if the given key is pressed. More...

void	keyPress (EKey key)
	Inserts the specified key in the set of currently active keys - For internal use only. More...

void	keyRelease (EKey key)
	Removes the specified key from the set of currently active keys - For internal use only. More...

bool	isInitialized () const
	Returns true if the OpenGLContext is in an initialized state. More...

int	vertexAttribCount () const
	The number (clamped to VA_MaxAttribCount) of generic vertex attributes as returned by glGet(GL_MAX_VERTEX_ATTRIBS) More...

int	textureImageUnitCount () const
	The number (clamped to VL_MAX_TEXTURE_IMAGE_UNITS) of texture image units supported by the current hardware. More...

int	textureCoordCount () const
	The number (clamped to VL_MAX_LEGACY_TEXTURE_UNITS) of fixed function pipeline texture units supported by the current hardware. More...

bool	hasDoubleBuffer () const
	Returns `true` if an OpenGLContext supports double buffering. More...

void	useGLSLProgram (const GLSLProgram *glsl)
	Activates the given GLSLProgram or unbinds the current one if `glsl` is NULL. More...

void	bindVAS (const IVertexAttribSet *vas, bool use_vbo, bool force)
	Activates the specified vertex attribute set - For internal use only. More...

void	bindVAS_Attribs (const IVertexAttribSet *vas, bool use_vbo)

void	bindVAS_Fixed (const IVertexAttribSet *vas, bool use_vbo)

void	bindVAS_Reset ()

void	applyEnables (const EnableSet *cur)
	Applies an EnableSet to an OpenGLContext - Typically for internal use only. More...

void	applyRenderStates (const RenderStateSet cur, const Camera camera)
	Applies a RenderStateSet to an OpenGLContext - Typically for internal use only. More...

void	resetEnables ()
	Resets all the interanal enable-tables - For internal use only. More...

void	resetRenderStates ()
	Resets all the interanal render-states-tables - For internal use only. More...

void	setDefaultRenderState (const RenderStateSlot &rs_slot)
	Defines the default render state slot to be used by the opengl context. More...

const RenderStateSlot &	defaultRenderState (ERenderState rs)
	Returns the default render state slot used by VL when a specific render state type is left undefined. More...

void	resetContextStates (EResetContextStates start_or_finish)
	Resets the OpenGL states necessary to begin and finish a rendering. - For internal use only. More...

void	setTexUnitBinding (int unit_i, ETextureDimension target)
	Declares that texture unit `unit_i` is currently bound to the specified texture target. - For internal use only. More...

ETextureDimension	texUnitBinding (int unit_i) const
	Returnes the texture target currently active for the specified texture unit. - For internal use only. More...

const GLSLProgram *	glslProgram () const

GLSLProgram *	glslProgram ()

bool	isCleanState (bool verbose)
	Checks whether the OpenGL state is clean or not. More...

const fvec3 &	normal () const

const fvec4 &	color () const

const fvec3 &	secondaryColor () const

const fvec4 &	vertexAttribValue (int i) const

Public Member Functions inherited from vl::Object
	Object ()
	Constructor. More...

	Object (const Object &other)
	Copy constructor: copies the name, ref count mutex and user data. More...

Object &	operator= (const Object &other)
	Copy operator: copies the object's name, ref count mutex and user data. More...

const std::string &	objectName () const
	The name of the object, by default set to the object's class name. More...

void	setObjectName (const char *name)
	The name of the object, by default set to the object's class name in debug builds. More...

void	setObjectName (const std::string &name)
	The name of the object, by default set to the object's class name in debug builds. More...

void	setRefCountMutex (IMutex *mutex)
	The mutex used to protect the reference counting of an Object across multiple threads. More...

IMutex *	refCountMutex ()
	The mutex used to protect the reference counting of an Object across multiple threads. More...

const IMutex *	refCountMutex () const
	The mutex used to protect the reference counting of an Object across multiple threads. More...

int	referenceCount () const
	Returns the number of references of an object. More...

void	incReference () const
	Increments the reference count of an object. More...

void	decReference ()
	Decrements the reference count of an object and deletes it if both automaticDelete() is `true` the count reaches 0. More...

void	setAutomaticDelete (bool autodel_on)
	If set to true the Object is deleted when its reference count reaches 0. More...

bool	automaticDelete () const
	If set to true the Object is deleted when its reference count reaches 0. More...

template<class T >
T *	as ()
	Casts an Object to the specified class. More...

template<class T >
const T *	as () const
	Casts an Object to the specified class. More...

Static Public Member Functions
static SDL_Surface *	sdlSurface ()

Static Public Member Functions inherited from vl::OpenGLContext
static bool	areUniformsColliding (const UniformSet u1, const UniformSet u2)
	Returns `true` if the two UniformSet contain at least one Uniform variable with the same name. More...

Static Protected Attributes
static SDL_Surface *	mScreen = NULL

Additional Inherited Members
Protected Member Functions inherited from vl::Object
virtual	~Object ()

Protected Attributes inherited from vl::OpenGLContext
ref< FramebufferObject >	mLeftFramebuffer

ref< FramebufferObject >	mRightFramebuffer

std::vector< ref< FramebufferObject > >	mFramebufferObject

std::vector< ref< UIEventListener > >	mEventListeners

std::set< EKey >	mKeyboard

OpenGLContextFormat	mGLContextInfo

int	mVertexAttribCount

int	mTextureImageUnitCount

int	mTextureCoordCount

bool	mMouseVisible

bool	mContinuousUpdate

bool	mIgnoreNextMouseMoveEvent

bool	mFullscreen

bool	mHasDoubleBuffer

bool	mIsInitialized

std::string	mExtensions

RenderStateSlot	mDefaultRenderStates [RS_RenderStateCount]

ref< NaryQuickMap< EEnable, EEnable, EN_EnableCount > >	mCurrentEnableSet

ref< NaryQuickMap< EEnable, EEnable, EN_EnableCount > >	mNewEnableSet

ref< NaryQuickMap< ERenderState, RenderStateSlot, RS_RenderStateCount > >	mCurrentRenderStateSet

ref< NaryQuickMap< ERenderState, RenderStateSlot, RS_RenderStateCount > >	mNewRenderStateSet

ETextureDimension	mTexUnitBinding [VL_MAX_TEXTURE_IMAGE_UNITS]

ref< GLSLProgram >	mGLSLProgram

bool	mGLSLUpdated

const IVertexAttribSet *	mCurVAS

VertexArrayInfo	mVertexArray

VertexArrayInfo	mNormalArray

VertexArrayInfo	mColorArray

VertexArrayInfo	mSecondaryColorArray

VertexArrayInfo	mFogArray

VertexArrayInfo	mTexCoordArray [VA_MaxTexCoordCount]

VertexArrayInfo	mVertexAttrib [VA_MaxAttribCount]

fvec3	mNormal

fvec4	mColor

fvec3	mSecondaryColor

fvec4	mVertexAttribValue [VA_MaxAttribCount]

GLuint	mDefaultVAO

Protected Attributes inherited from vl::Object
std::string	mObjectName

IMutex *	mRefCountMutex

int	mReferenceCount

bool	mAutomaticDelete

Detailed Description

The SDLWindow class implements an OpenGLContext using the SDL API.

Note: SDL notifies Unicode codes only on key-press events not on release events.

Definition at line 58 of file SDLWindow.hpp.

Constructor & Destructor Documentation

◆ SDLWindow() [1/2]

SDLWindow::SDLWindow ( )

Definition at line 169 of file SDLWindow.cpp.

◆ SDLWindow() [2/2]

SDLWindow::SDLWindow	(	const vl::String &	title,
		const vl::OpenGLContextFormat &	info,
		int	x = `0`,
		int	y = `0`,
		int	width = `640`,
		int	height = `480`
	)

Definition at line 177 of file SDLWindow.cpp.

◆ ~SDLWindow()

SDLWindow::~SDLWindow ( )

Definition at line 173 of file SDLWindow.cpp.

Member Function Documentation

◆ initSDLWindow()

bool SDLWindow::initSDLWindow	(	const vl::String &	title,
		const vl::OpenGLContextFormat &	info,
		int	x = `0`,
		int	y = `0`,
		int	width = `640`,
		int	height = `480`
	)

◆ makeCurrent()

void vlSDL::SDLWindow::makeCurrent ( )

inlinevirtual

Sets the OpenGL context as current for the calling thread.

Implements vl::OpenGLContext.

Definition at line 91 of file SDLWindow.hpp.

◆ quitApplication()

void SDLWindow::quitApplication ( )

virtual

Quits the event loop.

Reimplemented from vl::OpenGLContext.

Definition at line 470 of file SDLWindow.cpp.

References NULL.

◆ sdlSurface()

static SDL_Surface* vlSDL::SDLWindow::sdlSurface ( )

inlinestatic

Definition at line 93 of file SDLWindow.hpp.

◆ setMousePosition()

void vlSDL::SDLWindow::setMousePosition	(	int	,
		int
	)

inlinevirtual

If the OpenGL context is a widget this function sets the mouse position.

Reimplemented from vl::OpenGLContext.

Definition at line 84 of file SDLWindow.hpp.

◆ setMouseVisible()

void vlSDL::SDLWindow::setMouseVisible ( bool )

inlinevirtual

If the OpenGL context is a widget this function sets whether the mouse is visible over it or not.

Reimplemented from vl::OpenGLContext.

Definition at line 78 of file SDLWindow.hpp.

◆ setPosition()

void SDLWindow::setPosition	(	int	,
		int
	)

virtual

If the OpenGL context is a widget this function sets its position.

Reimplemented from vl::OpenGLContext.

Definition at line 491 of file SDLWindow.cpp.

◆ setWindowTitle()

void SDLWindow::setWindowTitle ( const vl::String & )

virtual

If the OpenGL context is a top window this function sets its title.

Reimplemented from vl::OpenGLContext.

Definition at line 481 of file SDLWindow.cpp.

References vl::String::toStdString().

◆ swapBuffers()

void SDLWindow::swapBuffers ( )

virtual

Swaps the back and front buffers to present the last rendering.

Implements vl::OpenGLContext.

Definition at line 486 of file SDLWindow.cpp.

◆ translateEvent()

void SDLWindow::translateEvent ( SDL_Event * ev )

Definition at line 300 of file SDLWindow.cpp.

References vl::Key_Alt, vl::Key_Ctrl, vl::Key_LeftAlt, vl::Key_LeftCtrl, vl::Key_LeftShift, vl::Key_None, vl::Key_RightAlt, vl::Key_RightCtrl, vl::Key_RightShift, vl::Key_Shift, vl::Key_Unknown, vl::LeftButton, vl::MiddleButton, and vl::RightButton.

◆ update()

void SDLWindow::update ( )

virtual

If the OpenGLContext is a widget this function requests a redraw and generates an updateEvent().

Implements vl::OpenGLContext.

Definition at line 476 of file SDLWindow.cpp.

Member Data Documentation

◆ mScreen

SDL_Surface * SDLWindow::mScreen = NULL

staticprotected

Definition at line 96 of file SDLWindow.hpp.

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

C:/git/VL/src/gui/vlSDL/SDLWindow.hpp
C:/git/VL/src/gui/vlSDL/SDLWindow.cpp

Public Member Functions

Static Public Member Functions

Static Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SDLWindow() [1/2]

◆ SDLWindow() [2/2]

◆ ~SDLWindow()

Member Function Documentation

◆ initSDLWindow()

◆ makeCurrent()

◆ quitApplication()

◆ sdlSurface()

◆ setMousePosition()

◆ setMouseVisible()

◆ setPosition()

◆ setWindowTitle()

◆ swapBuffers()

◆ translateEvent()

◆ update()

Member Data Documentation

◆ mScreen