Detailed Description

This is the base class for wxGLAttributes and wxGLContextAttrs.

It stores internally the list required by OS and OpenGL driver for setting display and rendering context attributes.

Normally this class is not used directly. But there's a case where it its member functions are useful: setting attributes not handled by wxWidgets. Suppose the OpenGL Board sets a new functionality of the context, by adding a new attribute (let's call it NEW_CTX_F) and also a new type of context by allowing a new bit value (let's call it NEW_BITS) for the CONTEXT_PROFILE_MASK_ARB value. These new values can be added to the list using code like this:

wxGLContextAttrs cxtAttrs;
// Some values
cxtAttrs.CoreProfile().OGLVersion(5, 0); // OGL 5.0, whenever available
cxtAttrs.PlatformDefaults();
// Values usually are platform-dependant named (even value assigned!)
#if defined(__WXMSW__)
    cxtAttrs.AddAttribute(WGL_NEW_CTX_F);
    cxtAttrs.AddAttribBits(WGL_CONTEXT_PROFILE_MASK_ARB, WGL_NEW_BITS);
#elif defined(__WXX11__)
    cxtAttrs.AddAttribute(GLX_NEW_CTX_F);
    cxtAttrs.AddAttribBits(GLX_CONTEXT_PROFILE_MASK_ARB, GLX_NEW_BITS);
#else
    // Other platforms
#endif
cxtAttrs.EndList(); // Don't forget this
cxtAttrs.SetNeedsARB(true); // Context attributes are set by an ARB-function

Since: 3.1.0

Library: wxGL

Category: OpenGL

See also: wxGLCanvas, wxGLContext, wxGLContextAttrs, wxGLAttributes

Public Member Functions
	wxGLAttribsBase ()
	Constructor. More...

void	AddAttribute (int attribute)
	Adds an integer value to the list of attributes. More...

void	AddAttribBits (int searchVal, int combineVal)
	Combine (bitwise OR) a given value with the existing one, if any. More...

void	SetNeedsARB (bool needsARB=true)
	Sets the necessity of using special ARB-functions (e.g. More...

void	Reset ()
	Delete contents and sets ARB-flag to false. More...

const int *	GetGLAttrs () const
	Returns a pointer to the internal list of attributes. More...

int	GetSize ()
	Returns the size of the internal list of attributes. More...

bool	NeedsARB () const
	Returns the current value of the ARB-flag. More...

Constructor & Destructor Documentation

wxGLAttribsBase::wxGLAttribsBase ( )

Constructor.

Member Function Documentation

void wxGLAttribsBase::AddAttribBits	(	int	searchVal,
		int	combineVal
	)

Combine (bitwise OR) a given value with the existing one, if any.

This function first searches for an identifier and then combines the given value with the value right after the identifier. If the identifier is not found, two new values (i.e. the identifier and the given value) are added to the list.

Parameters

searchVal	The identifier to search for.
combineVal	The value to combine with the existing one.

void wxGLAttribsBase::AddAttribute ( int attribute )

Adds an integer value to the list of attributes.

Parameters

attribute The value to add.

const int* wxGLAttribsBase::GetGLAttrs ( ) const

Returns a pointer to the internal list of attributes.

It's very unlikely you need this function. If the list is empty the returned value is NULL.

int wxGLAttribsBase::GetSize ( )

Returns the size of the internal list of attributes.

Remember that the last value in the list must be a '0' (zero). So, a minimal list is of size = 2, the first value is meaningful and the last is '0'.

bool wxGLAttribsBase::NeedsARB ( ) const

Returns the current value of the ARB-flag.

See also: SetNeedsARB

void wxGLAttribsBase::Reset ( )

Delete contents and sets ARB-flag to false.

void wxGLAttribsBase::SetNeedsARB ( bool needsARB = true )

Sets the necessity of using special ARB-functions (e.g.

wglCreateContextAttribsARB in MSW) for some of the attributes of the list. Multi-sampling and modern context require these ARB-functions.

Parameters

needsARB true if an ARB-function is needed for any of the attributes.

See also: NeedsARB

Detailed Description

Public Member Functions

Constructor & Destructor Documentation

Member Function Documentation