GlfContextCaps Class Reference

#include <contextCaps.h>

Static Public Member Functions
static GLF_API void	InitInstance ()
static GLF_API const GlfContextCaps &	GetInstance ()

Public Attributes
int	glVersion
bool	coreProfile
int	maxArrayTextureLayers

Friends
class	TfSingleton< GlfContextCaps >

Detailed Description

This class is intended to be a cache of the capabilites (resource limits and features) of the underlying GL context.

It serves two purposes. Firstly to reduce driver transition overhead of querying these values. Secondly to provide access to these values from other threads that don't have the context bound.

In the event of failure (InitInstance() wasn't called or an issue accessing the GL context), a reasonable set of defaults, based on GL minimums, is provided.

TO DO (bug #124971):

• LoadCaps() should be called whenever the context changes.
• Provide a mechanism where other Hd systems can subscribe to when the caps changes, so they can update and invalidate.

Definition at line 58 of file contextCaps.h.

Member Function Documentation

static GLF_API const GlfContextCaps& GlfContextCaps::GetInstance ( )

static

GetInstance() returns the filled capabilities structure. This function will not populate the caps and will issue a coding error if it hasn't been filled.

static GLF_API void GlfContextCaps::InitInstance ( )

static

InitInstance queries the GL context for its capabilities. It should be called by the application before using systems that depend on the caps, such as Hydra. A good example would be to pair the call to initialize after a call to initialize GL

Friends And Related Function Documentation

friend class TfSingleton< GlfContextCaps >

friend

Definition at line 93 of file contextCaps.h.

Member Data Documentation

bool GlfContextCaps::coreProfile

Definition at line 79 of file contextCaps.h.

int GlfContextCaps::glVersion

Definition at line 76 of file contextCaps.h.

int GlfContextCaps::maxArrayTextureLayers

Definition at line 82 of file contextCaps.h.

---

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

• pxr/imaging/glf/contextCaps.h