OSDL::Video::OpenGL Namespace Reference

---

Detailed Description

All OpenGL-specific operations and conventions are encapsulated here, be they related to 2D or 3D.

The OpenGL viewport is set so that it covers all of the setMode-created surface.

See also:

'http://osdl.sourceforge.net', then 'Documentation', 'Rendering', 'OpenGL + SDL' for further implementation details.

Classes
class	OpenGLException
	Exception to be raised when OpenGL operations fail. More...
class	OpenGLContext
	An OpenGL context corresponds to the state of a running OpenGL screen. More...
class	GLTextureException
	Exception to be raised when OpenGL texture operations fail. More...
class	GLTexture
	Encapsulates an OpenGL texture, constructed directly or not from a surface. More...
Namespaces
namespace	GLU
	Gathers appropriate GLU (OpenGL Utility Library) encapsulations for better integration into OSDL.
Typedefs
typedef GLfloat	GLLength
	Length, OpenGL unit of measure.
typedef GLfloat	GLCoordinate
	Coordinate, OpenGL unit of measure.
typedef GLU::Int	GLTextureIdentifier
	Texture identifier.
Enumerations
enum	Flavour { None, OpenGLFor2D, OpenGLFor3D, Reload }
	Various flavours (presets) are available for OpenGL. More...
Variables
OSDL_DLL Pixels::ColorMask	RedMask
	Mask used for OpenGL RGBA color specification for red, depending on the endianness of the local machine.
OSDL_DLL Pixels::ColorMask	GreenMask
	Mask used for OpenGL RGBA color specification for green, depending on the endianness of the local machine.
OSDL_DLL Pixels::ColorMask	BlueMask
	Mask used for OpenGL RGBA color specification for blue, depending on the endianness of the local machine.
OSDL_DLL Pixels::ColorMask	AlphaMask
	Mask used for OpenGL RGBA color specification for alpha, depending on the endianness of the local machine.

---

Typedef Documentation

typedef GLfloat OSDL::Video::OpenGL::GLCoordinate

Coordinate, OpenGL unit of measure.

GL prefix is kept to avoid namespace misuse.

Definition at line 105 of file OSDLOpenGL.h.

typedef GLfloat OSDL::Video::OpenGL::GLLength

Length, OpenGL unit of measure.

GL prefix is kept to avoid namespace misuse.

Definition at line 97 of file OSDLOpenGL.h.

typedef GLU::Int OSDL::Video::OpenGL::GLTextureIdentifier

Texture identifier.

Note:

Made so that it can be converted (i.e. has at least the same value range) into OpenGL texture identifier, Gluint (which is 'unsigned int' in general).

No 'typedef GLUint GLTextureIdentifier' could be kept, as it would have made this header file depend on OSDLConfig, which should not be installed.

Definition at line 42 of file OSDLGLTexture.h.

---

Enumeration Type Documentation

enum OSDL::Video::OpenGL::Flavour

Various flavours (presets) are available for OpenGL.

The flavour must be selected before or during the call to setMode, and will not take effect until that call.

Following flavours are available :

• None : no further action taken after basic OpenGL initialization
• OpenGLFor2D : dedicated for accelerated 2D with OpenGL
• OpenGLFor3D : classical full-blown 3D
• Reload : designates the same settings as the ones that were lastly used, just set them back in the state machine. This is useful for example when a resize occurs : the actual OpenGL context of the state machine is lost on some platforms, so the OSDL OpenGLContext object must set them again during the setMode call.

Note:

It results in loading the appropriate OpenGL settings for the selected mode, including projection, model view matrix, etc.

Enumerator:

None
OpenGLFor2D
OpenGLFor3D
Reload

Definition at line 132 of file OSDLOpenGL.h.

---

Variable Documentation

OSDL::Video::Pixels::ColorMask OSDL::Video::OpenGL::AlphaMask

Mask used for OpenGL RGBA color specification for alpha, depending on the endianness of the local machine.

Definition at line 49 of file OSDLOpenGL.cc.

Referenced by OSDL::Video::Pixels::getRecommendedColorMasks(), and OSDL::Video::OpenGL::GLTexture::upload().

OSDL::Video::Pixels::ColorMask OSDL::Video::OpenGL::BlueMask

Mask used for OpenGL RGBA color specification for blue, depending on the endianness of the local machine.

Definition at line 48 of file OSDLOpenGL.cc.

Referenced by OSDL::Video::Pixels::getRecommendedColorMasks(), and OSDL::Video::OpenGL::GLTexture::upload().

OSDL::Video::Pixels::ColorMask OSDL::Video::OpenGL::GreenMask

Mask used for OpenGL RGBA color specification for green, depending on the endianness of the local machine.

Definition at line 47 of file OSDLOpenGL.cc.

Referenced by OSDL::Video::Pixels::getRecommendedColorMasks(), and OSDL::Video::OpenGL::GLTexture::upload().

OSDL::Video::Pixels::ColorMask OSDL::Video::OpenGL::RedMask

Mask used for OpenGL RGBA color specification for red, depending on the endianness of the local machine.

Definition at line 46 of file OSDLOpenGL.cc.

Referenced by OSDL::Video::Pixels::getRecommendedColorMasks(), and OSDL::Video::OpenGL::GLTexture::upload().

---