#include <wx/glcanvas.h>

Inheritance diagram for wxGLAttributes:

Detailed Description

This class is used for setting display attributes when drawing through OpenGL ("Pixel format" in MSW and OSX parlance, "Configs" in X11).

While framebuffer depth and samplers are still common, attributes like layers overlay or not using true colour are rarely used nowadays.

Attributes can be chained. For example:

wxGLAttributes dispAttrs;

dispAttrs.PlatformDefaults().MinRGBA(8, 8, 8, 8).DoubleBuffer().Depth(32).EndList();

Notice that EndList() must be used as the last attribute. Not adding it will likely result in nothing displayed at all.

Note: Not all of platform-dependant available attributes are implemented in wxWidgets. You can set other attributes by using AddAttribute() and AddAttribBits() functions inherited from the base wxGLAttribsBase class.

Since: 3.1.0

Library: wxGL

Category: OpenGL

See also: wxGLCanvas, wxGLContext, wxGLAttribsBase, wxGLContextAttrs

Public Member Functions
wxGLAttributes &	RGBA ()
	Use true color (8 bits for each color plus 8 bits for alpha channel). More...

wxGLAttributes &	BufferSize (int val)
	Specifies the number of bits for buffer when it isn't a RGBA buffer. More...

wxGLAttributes &	Level (int val)
	Specifies the framebuffer level. More...

wxGLAttributes &	DoubleBuffer ()
	Requests using double buffering if present. More...

wxGLAttributes &	Stereo ()
	Use stereoscopic display if present. More...

wxGLAttributes &	AuxBuffers (int val)
	Specifies the number of auxiliary buffers. More...

wxGLAttributes &	MinRGBA (int mRed, int mGreen, int mBlue, int mAlpha)
	Specifies the minimal number of bits for colour buffers. More...

wxGLAttributes &	Depth (int val)
	Specifies number of bits for Z-buffer. More...

wxGLAttributes &	Stencil (int val)
	Specifies number of bits for stencil buffer. More...

wxGLAttributes &	MinAcumRGBA (int mRed, int mGreen, int mBlue, int mAlpha)
	Specifies the minimal number of bits for the accumulation buffer. More...

wxGLAttributes &	SampleBuffers (int val)
	Use multi-sampling support (antialiasing). More...

wxGLAttributes &	Samplers (int val)
	Specifies the number of samplers per pixel. More...

wxGLAttributes &	FrameBuffersRGB ()
	Used to request a frame buffer sRGB capable. More...

wxGLAttributes &	PlatformDefaults ()
	Set some typically needed attributes. More...

wxGLAttributes &	Defaults ()
	wxWidgets defaults: RGBA, Z-depth 16 bits, double buffering, 1 sample buffer, 4 samplers. More...

void	EndList ()
	The set of attributes must end with this one; otherwise, the GPU may display nothing at all. More...

Public Member Functions inherited from wxGLAttribsBase
	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...

Member Function Documentation

wxGLAttributes& wxGLAttributes::AuxBuffers ( int val )

Specifies the number of auxiliary buffers.

Parameters

val	The number of auxiliary buffers.

wxGLAttributes& wxGLAttributes::BufferSize ( int val )

Specifies the number of bits for buffer when it isn't a RGBA buffer.

It makes no effect for OS X.

Parameters

val	The number of bits.

wxGLAttributes& wxGLAttributes::Defaults ( )

wxWidgets defaults: RGBA, Z-depth 16 bits, double buffering, 1 sample buffer, 4 samplers.

See also: PlatformDefaults()

wxGLAttributes& wxGLAttributes::Depth ( int val )

Specifies number of bits for Z-buffer.

Parameters

val	Number of bits for Z-buffer (typically 0, 16 or 32).

wxGLAttributes& wxGLAttributes::DoubleBuffer ( )

Requests using double buffering if present.

void wxGLAttributes::EndList ( )

The set of attributes must end with this one; otherwise, the GPU may display nothing at all.

wxGLAttributes& wxGLAttributes::FrameBuffersRGB ( )

Used to request a frame buffer sRGB capable.

It makes no effect for OS X.

wxGLAttributes& wxGLAttributes::Level ( int val )

Specifies the framebuffer level.

It makes no effect for OS X.

Parameters

val	0 for main buffer, >0 for overlay, <0 for underlay.

wxGLAttributes& wxGLAttributes::MinAcumRGBA	(	int	mRed,
		int	mGreen,
		int	mBlue,
		int	mAlpha
	)

Specifies the minimal number of bits for the accumulation buffer.

Parameters

mRed	The minimal number of bits for red accumulator.
mGreen	The minimal number of bits for green accumulator.
mBlue	The minimal number of bits for blue accumulator.
mAlpha	The minimal number of bits for alpha accumulator.

wxGLAttributes& wxGLAttributes::MinRGBA	(	int	mRed,
		int	mGreen,
		int	mBlue,
		int	mAlpha
	)

Specifies the minimal number of bits for colour buffers.

Parameters

mRed	The minimal number of bits for colour red.
mGreen	The minimal number of bits for colour green.
mBlue	The minimal number of bits for colour blue.
mAlpha	The minimal number of bits for alpha channel.

wxGLAttributes& wxGLAttributes::PlatformDefaults ( )

Set some typically needed attributes.

E.g. full-acceleration on MSW.

See also: Defaults()

wxGLAttributes& wxGLAttributes::RGBA ( )

Use true color (8 bits for each color plus 8 bits for alpha channel).

wxGLAttributes& wxGLAttributes::SampleBuffers ( int val )

Use multi-sampling support (antialiasing).

Parameters

val	Number of sample buffers, usually 1.

wxGLAttributes& wxGLAttributes::Samplers ( int val )

Specifies the number of samplers per pixel.

Parameters

val	Number of samplers, e.g. 4 for 2x2 antialiasing.

wxGLAttributes& wxGLAttributes::Stencil ( int val )

Specifies number of bits for stencil buffer.

Parameters

val	Number of bits.

wxGLAttributes& wxGLAttributes::Stereo ( )

Use stereoscopic display if present.

Detailed Description

Public Member Functions

Member Function Documentation