sf::Context Class Reference
Class holding a valid drawing context. More...
#include <Context.hpp>
Inheritance diagram for sf::Context:
Public Member Functions | |
| Context () | |
| Default constructor. More... | |
| ~Context () | |
| Destructor. More... | |
| bool | setActive (bool active) |
| Activate or deactivate explicitly the context. More... | |
| Context (const ContextSettings &settings, unsigned int width, unsigned int height) | |
| Construct a in-memory context. More... | |
Static Private Member Functions | |
| static void | ensureGlContext () |
| Make sure that a valid OpenGL context exists in the current thread. More... | |
Detailed Description
Class holding a valid drawing context.
If you need to make OpenGL calls without having an active window (like in a thread), you can use an instance of this class to get a valid context.
Having a valid context is necessary for every OpenGL call.
Note that a context is only active in its current thread, if you create a new thread it will have no valid context by default.
To use a sf::Context instance, just construct it and let it live as long as you need a valid context. No explicit activation is needed, all it has to do is to exist. Its destructor will take care of deactivating and freeing all the attached resources.
Usage example:
void threadFunction(void*)
{
sf::Context context;
// from now on, you have a valid context
// you can make OpenGL calls
glClear(GL_DEPTH_BUFFER_BIT);
}
// the context is automatically deactivated and destroyed
// by the sf::Context destructor
Definition at line 48 of file Context.hpp.
Constructor & Destructor Documentation
| sf::Context::Context | ( | ) |
Default constructor.
The constructor creates and activates the context
| sf::Context::~Context | ( | ) |
Destructor.
The destructor deactivates and destroys the context
| sf::Context::Context | ( | const ContextSettings & | settings, |
| unsigned int | width, | ||
| unsigned int | height | ||
| ) |
Construct a in-memory context.
This constructor is for internal use, you don't need to bother with it.
- Parameters
-
settings Creation parameters width Back buffer width height Back buffer height
Member Function Documentation
| bool sf::Context::setActive | ( | bool | active | ) |
Activate or deactivate explicitly the context.
- Parameters
-
active True to activate, false to deactivate
- Returns
- True on success, false on failure
The documentation for this class was generated from the following file: