Visualization Library 2.0.0

A lightweight C++ OpenGL middleware for 2D/3D graphics

VL     Star     Watch     Fork     Issue

[Download] [Tutorials] [All Classes] [Grouped Classes]
Public Member Functions | List of all members
vlWX::WXGLCanvas Class Reference

The WXGLCanvas class implements a vl::OpenGLContext using the wxWidgets library. More...

#include <WXGLCanvas.hpp>

+ Inheritance diagram for vlWX::WXGLCanvas:

Public Member Functions

 WXGLCanvas (wxWindow *parent, const wxGLContext *shared, wxWindowID id=wxID_ANY, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=0, int *attribList=0, const wxString &name=wxT("WXGLCanvas"), const wxPalette &palette=wxNullPalette)
 
 ~WXGLCanvas ()
 
void OnPaint (wxPaintEvent &ev)
 
void OnSize (wxSizeEvent &ev)
 
void OnEraseBackground (wxEraseEvent &ev)
 
void OnKeyDown (wxKeyEvent &ev)
 
void OnKeyUp (wxKeyEvent &ev)
 
void OnMouseMotion (wxMouseEvent &ev)
 
void OnMouseDown (wxMouseEvent &ev)
 
void OnMouseUp (wxMouseEvent &ev)
 
void OnMouseWheel (wxMouseEvent &ev)
 
void OnMouseEnter (wxMouseEvent &ev)
 
void OnIdle (wxIdleEvent &ev)
 
void OnDropFiles (wxDropFilesEvent &ev)
 
bool setFullscreen (bool fullscreen)
 If the OpenGL context is a widget this function requests a maximization to fullscreen. More...
 
void quitApplication ()
 Asks to the windowing system that is managing the OpenGLContext to quit the application. More...
 
void makeCurrent ()
 Sets the OpenGL context as current for the calling thread. More...
 
void swapBuffers ()
 Swaps the back and front buffers to present the last rendering. More...
 
void getFocus ()
 If the OpenGL context is a widget this function requests the mouse focus on it. 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 setWindowTitle (const vl::String &text)
 If the OpenGL context is a top window this function sets its title. More...
 
void show ()
 If the OpenGL context is a widget this function makes it visible to the user. More...
 
void hide ()
 If the OpenGL context is a widget this function makes it invisible to the user. More...
 
void setPosition (int x, int y)
 If the OpenGL context is a widget this function sets its position. More...
 
void setSize (int w, int h)
 If the OpenGL context is a widget this function sets its size. More...
 
vl::ivec2 position () const
 If the OpenGL context is a widget this function returns its position. 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...
 
- 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...
 
FramebufferleftFramebuffer ()
 The render target representing the default left framebuffer. More...
 
const FramebufferleftFramebuffer () const
 The render target representing the default left framebuffer. More...
 
FramebufferrightFramebuffer ()
 The render target representing the default right framebuffer (if a stereo OpenGL context is present). More...
 
const FramebufferrightFramebuffer () const
 The render target representing the default right framebuffer (if a stereo OpenGL context is present). More...
 
Framebufferframebuffer ()
 The default render target (always returns leftFramebuffer()). More...
 
const Framebufferframebuffer () const
 The default render target (always returns leftFramebuffer()). More...
 
ref< FramebufferObjectcreateFramebufferObject ()
 Equivalent to "createFramebufferObject(0,0);". More...
 
ref< FramebufferObjectcreateFramebufferObject (int width, int height, EReadDrawBuffer draw_buffer=RDB_COLOR_ATTACHMENT0, EReadDrawBuffer read_buffer=RDB_COLOR_ATTACHMENT0)
 Creates a new FramebufferObject (framebuffer object Framebuffer). 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 fullscreen () const
 If the OpenGL context is a widget this function returns whether it has been maximized to fullscreen. 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...
 
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 UIEventListenereventListener (int i) const
 Returns the i-th UIEventListener registered to an OpenGLContext. More...
 
UIEventListenereventListener (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 OpenGLContextFormatopenglContextInfo () 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 RenderStateSlotdefaultRenderState (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 GLSLProgramglslProgram () const
 
GLSLProgramglslProgram ()
 
bool isCleanState (bool verbose)
 Checks whether the OpenGL state is clean or not. More...
 
const fvec3normal () const
 
const fvec4color () const
 
const fvec3secondaryColor () const
 
const fvec4vertexAttribValue (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...
 
Objectoperator= (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...
 
IMutexrefCountMutex ()
 The mutex used to protect the reference counting of an Object across multiple threads. More...
 
const IMutexrefCountMutex () 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...
 

Additional Inherited Members

- 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...
 
- Protected Member Functions inherited from vl::Object
virtual ~Object ()
 
- Protected Attributes inherited from vl::OpenGLContext
ref< FramebuffermLeftFramebuffer
 
ref< FramebuffermRightFramebuffer
 
std::vector< ref< FramebufferObject > > mFramebufferObject
 
std::vector< ref< UIEventListener > > mEventListeners
 
std::set< EKeymKeyboard
 
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< GLSLProgrammGLSLProgram
 
bool mGLSLUpdated
 
const IVertexAttribSetmCurVAS
 
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
 
IMutexmRefCountMutex
 
int mReferenceCount
 
bool mAutomaticDelete
 

Detailed Description

The WXGLCanvas class implements a vl::OpenGLContext using the wxWidgets library.

Definition at line 52 of file WXGLCanvas.hpp.

Constructor & Destructor Documentation

◆ WXGLCanvas()

WXGLCanvas::WXGLCanvas ( wxWindow *  parent,
const wxGLContext *  shared,
wxWindowID  id = wxID_ANY,
const wxPoint &  pos = wxDefaultPosition,
const wxSize &  size = wxDefaultSize,
long  style = 0,
int *  attribList = 0,
const wxString &  name = wxT("WXGLCanvas"),
const wxPalette &  palette = wxNullPalette 
)

Definition at line 66 of file WXGLCanvas.cpp.

References vl::Object::setAutomaticDelete().

◆ ~WXGLCanvas()

WXGLCanvas::~WXGLCanvas ( )

Definition at line 61 of file WXGLCanvas.cpp.

Member Function Documentation

◆ getFocus()

void WXGLCanvas::getFocus ( )
virtual

If the OpenGL context is a widget this function requests the mouse focus on it.

Reimplemented from vl::OpenGLContext.

Definition at line 385 of file WXGLCanvas.cpp.

◆ hide()

void WXGLCanvas::hide ( )
virtual

If the OpenGL context is a widget this function makes it invisible to the user.

Reimplemented from vl::OpenGLContext.

Definition at line 417 of file WXGLCanvas.cpp.

◆ makeCurrent()

void WXGLCanvas::makeCurrent ( )
virtual

Sets the OpenGL context as current for the calling thread.

Implements vl::OpenGLContext.

Definition at line 367 of file WXGLCanvas.cpp.

Referenced by OnPaint().

◆ OnDropFiles()

void WXGLCanvas::OnDropFiles ( wxDropFilesEvent &  ev)

Definition at line 84 of file WXGLCanvas.cpp.

References vl::OpenGLContext::dispatchFileDroppedEvent().

◆ OnEraseBackground()

void WXGLCanvas::OnEraseBackground ( wxEraseEvent &  ev)

Definition at line 337 of file WXGLCanvas.cpp.

◆ OnIdle()

void WXGLCanvas::OnIdle ( wxIdleEvent &  ev)

Definition at line 96 of file WXGLCanvas.cpp.

References vl::OpenGLContext::continuousUpdate().

◆ OnKeyDown()

void WXGLCanvas::OnKeyDown ( wxKeyEvent &  ev)

◆ OnKeyUp()

void WXGLCanvas::OnKeyUp ( wxKeyEvent &  ev)

◆ OnMouseDown()

void WXGLCanvas::OnMouseDown ( wxMouseEvent &  ev)

◆ OnMouseEnter()

void WXGLCanvas::OnMouseEnter ( wxMouseEvent &  ev)

Definition at line 104 of file WXGLCanvas.cpp.

◆ OnMouseMotion()

void WXGLCanvas::OnMouseMotion ( wxMouseEvent &  ev)

Definition at line 109 of file WXGLCanvas.cpp.

References vl::OpenGLContext::dispatchMouseMoveEvent().

◆ OnMouseUp()

void WXGLCanvas::OnMouseUp ( wxMouseEvent &  ev)

◆ OnMouseWheel()

void WXGLCanvas::OnMouseWheel ( wxMouseEvent &  ev)

Definition at line 114 of file WXGLCanvas.cpp.

References vl::OpenGLContext::dispatchMouseWheelEvent().

◆ OnPaint()

void WXGLCanvas::OnPaint ( wxPaintEvent &  ev)

◆ OnSize()

void WXGLCanvas::OnSize ( wxSizeEvent &  ev)

Definition at line 158 of file WXGLCanvas.cpp.

References vl::OpenGLContext::dispatchResizeEvent().

◆ position()

ivec2 WXGLCanvas::position ( ) const
virtual

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

Reimplemented from vl::OpenGLContext.

Definition at line 432 of file WXGLCanvas.cpp.

◆ quitApplication()

void WXGLCanvas::quitApplication ( )
virtual

Asks to the windowing system that is managing the OpenGLContext to quit the application.

Reimplemented from vl::OpenGLContext.

Definition at line 359 of file WXGLCanvas.cpp.

References vl::OpenGLContext::eraseAllEventListeners().

◆ setFullscreen()

bool WXGLCanvas::setFullscreen ( bool  )
virtual

If the OpenGL context is a widget this function requests a maximization to fullscreen.

Reimplemented from vl::OpenGLContext.

Definition at line 342 of file WXGLCanvas.cpp.

References vl::OpenGLContext::fullscreen(), and vl::OpenGLContext::mFullscreen.

◆ setMousePosition()

void WXGLCanvas::setMousePosition ( int  ,
int   
)
virtual

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

Reimplemented from vl::OpenGLContext.

Definition at line 390 of file WXGLCanvas.cpp.

◆ setMouseVisible()

void WXGLCanvas::setMouseVisible ( bool  )
virtual

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 438 of file WXGLCanvas.cpp.

References vl::OpenGLContext::mMouseVisible, and vl::OpenGLContext::mouseVisible().

◆ setPosition()

void WXGLCanvas::setPosition ( int  ,
int   
)
virtual

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

Reimplemented from vl::OpenGLContext.

Definition at line 422 of file WXGLCanvas.cpp.

◆ setSize()

void WXGLCanvas::setSize ( int  ,
int   
)
virtual

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

Reimplemented from vl::OpenGLContext.

Definition at line 427 of file WXGLCanvas.cpp.

◆ setWindowTitle()

void WXGLCanvas::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 400 of file WXGLCanvas.cpp.

References vl::String::toStdString(), and vl::String::toStdWString().

◆ show()

void WXGLCanvas::show ( )
virtual

If the OpenGL context is a widget this function makes it visible to the user.

Reimplemented from vl::OpenGLContext.

Definition at line 412 of file WXGLCanvas.cpp.

◆ swapBuffers()

void WXGLCanvas::swapBuffers ( )
virtual

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

Implements vl::OpenGLContext.

Definition at line 376 of file WXGLCanvas.cpp.

Referenced by OnPaint().

◆ update()

void WXGLCanvas::update ( )
virtual

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

Implements vl::OpenGLContext.

Definition at line 395 of file WXGLCanvas.cpp.


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