Magnum::Platform::WindowlessWglContext class

Windowless WGL context.

Contents

GL context using pure WINAPI, used in WindowlessWglApplication. It is built if WITH_WINDOWLESSWGLAPPLICATION is enabled in CMake.

Meant to be used when there is a need to manage (multiple) GL contexts manually. See Manually managing windowless contexts for more information. If no other application header is included, this class is also aliased to Platform::WindowlessGLContext.

Public types

class Configuration
Configuration.

Constructors, destructors, conversion operators

WindowlessWglContext(const Configuration& configuration, GLContext* context = nullptr) explicit
Constructor.
WindowlessWglContext(NoCreateT) explicit
Construct without creating the context.
WindowlessWglContext(const WindowlessWglContext&) deleted
Copying is not allowed.
WindowlessWglContext(WindowlessWglContext&& other)
Move constructor.
~WindowlessWglContext()
Destructor.

Public functions

auto operator=(const WindowlessWglContext&) -> WindowlessWglContext& deleted
Copying is not allowed.
auto operator=(WindowlessWglContext&& other) -> WindowlessWglContext&
Move assignment.
auto isCreated() const -> bool
Whether the context is created.
auto makeCurrent() -> bool
Make the context current.

Function documentation

Magnum::Platform::WindowlessWglContext::WindowlessWglContext(const Configuration& configuration, GLContext* context = nullptr) explicit

Constructor.

Parameters
configuration Context configuration
context Optional Magnum context instance constructed using NoCreate to manage driver workarounds

On desktop GL, if version is not specified in configuration, the application first tries to create core context (OpenGL 3.1+) and if that fails, falls back to compatibility OpenGL 2.1 context. However, on binary AMD and NVidia drivers, creating core context does not use the largest available version. If the application detects such case (and given workaround is not disabled in optionally passed context instance), the core context is destroyed and compatibility OpenGL 2.1 context is created instead to make the driver use the latest available version.

Once the context is created, make it current using makeCurrent() and create Platform::GLContext instance to be able to use Magnum.

Magnum::Platform::WindowlessWglContext::WindowlessWglContext(NoCreateT) explicit

Construct without creating the context.

Move a instance with created context over to make it usable.

Magnum::Platform::WindowlessWglContext::~WindowlessWglContext()

Destructor.

Destroys the context, if any.

bool Magnum::Platform::WindowlessWglContext::makeCurrent()

Make the context current.

Prints error message and returns false on failure, otherwise returns true.