Specifies the OpenGL profile. More...

#include <GLContext.hpp>

Inheritance diagram for gamp::render::gl::GLProfile:

Collaboration diagram for gamp::render::gl::GLProfile:

Public Member Functions
constexpr	GLProfile () noexcept

constexpr	GLProfile (const jau::util::VersionNumber &version, GLProfileMask profileMask) noexcept
	Create a new instance.

constexpr	GLProfile (std::string_view tag) noexcept
	Create a new instance, merely deriving from given tag.

std::string	getGLSLVersionString () const
	Returns the GLSL version string as to be used in a shader program, including a terminating newline ' ', i.e.

constexpr const jau::util::VersionNumber &	glslVersion () const noexcept

constexpr bool	hasGLSL () const noexcept
	Indicates whether this profile supports GLSL, i.e.

constexpr bool	isGL2 () const noexcept
	Indicates whether this profile is capable of GL2 .

constexpr bool	isGL2ES1 () const noexcept
	Indicates whether this profile is capable of GL2ES1.

constexpr bool	isGL2ES2 () const noexcept
	Indicates whether this profile is capable of GL2ES2.

constexpr bool	isGL2ES3 () const noexcept
	Indicates whether this profile is capable of GL2ES3.

constexpr bool	isGL2GL3 () const noexcept
	Indicates whether this profile is capable of GL2GL3.

constexpr bool	isGL3 () const noexcept
	Indicates whether this profile is capable of GL3.

constexpr bool	isGL3bc () const noexcept
	Indicates whether this profile is capable of GL3bc.

constexpr bool	isGL3ES3 () const noexcept
	Indicates whether this profile is capable of GL3ES3.

constexpr bool	isGL4 () const noexcept
	Indicates whether this profile is capable of GL4.

constexpr bool	isGL4bc () const noexcept
	Indicates whether this profile is capable of GL4bc.

constexpr bool	isGL4ES3 () const noexcept
	Indicates whether this profile is capable of GL4ES3.

constexpr bool	isGLES () const noexcept
	Indicates whether this profile is capable of GLES.

constexpr bool	isGLES1 () const noexcept
	Indicates whether this profile is capable of GLES1.

constexpr bool	isGLES2 () const noexcept
	Indicates whether this profile is capable of GLES2.

constexpr bool	isGLES3 () const noexcept
	Indicates whether this profile is capable of GLES3.

bool	isValidArrayDataType (GLenum index, GLsizei comps, GLenum type, bool isVertexAttribPointer, bool throwException) const
	General validation if index, comps and type are valid for the current profile.

constexpr bool	isValidDataType (GLenum type) const noexcept
	General validation if type is a valid GL data type for the current profile.

constexpr bool	nativeGLCompat () const noexcept
	Indicates whether either of the native OpenGL compatibility profiles are in use.

constexpr bool	nativeGLCore () const noexcept
	Indicates whether either of the native OpenGL core profiles are in use.

constexpr bool	nativeGLES () const noexcept
	Indicates whether either of the native OpenGL ES profiles are in use.

constexpr bool	nativeGLES1 () const noexcept
	Indicates whether the native OpenGL ES1 profile is in use.

constexpr bool	nativeGLES2 () const noexcept
	Indicates whether the native OpenGL ES3 or ES2 profile is in use.

constexpr bool	nativeGLES3 () const noexcept
	Indicates whether the native OpenGL ES2 profile is in use.

constexpr GLProfileMask	profileMask () const noexcept

const jau::type_info &	signature () const noexcept override

std::string	toString () const override

Public Member Functions inherited from gamp::render::RenderProfile
constexpr	RenderProfile () noexcept
	Create an undefined instance.

constexpr	RenderProfile (const std::string_view profile, const jau::util::VersionNumber &version) noexcept
	Create an instance w/ unique name.

virtual	~RenderProfile () noexcept=default

constexpr const std::string_view &	name () const noexcept

constexpr bool	operator== (const RenderProfile &rhs) const noexcept

constexpr const jau::util::VersionNumber &	version () const noexcept

Static Public Member Functions
static const GLProfile &	downcast (const RenderProfile &rp)
	Downcast dereferenced given `const RenderProfile&` to `const GLProfile&`, throws exception if signature doesn't match GLSignature()

static const jau::type_info &	GLSignature () noexcept

Static Public Attributes
static constexpr std::string_view	GL2 = "GL2"
	The desktop OpenGL profile 1.x up to 3.0.

static constexpr std::string_view	GL3 = "GL3"
	The desktop OpenGL core profile 3.x, with x >= 1.

static constexpr std::string_view	GL3bc = "GL3bc"
	The desktop OpenGL compatibility profile 3.x, with x >= 1, ie GL2 plus GL3.

static constexpr std::string_view	GL4 = "GL4"
	The desktop OpenGL core profile 4.x, with x >= 0.

static constexpr std::string_view	GL4bc = "GL4bc"
	The desktop OpenGL compatibility profile 4.x, with x >= 0, ie GL2 plus GL4.

static constexpr std::string_view	GL_UNDEF = "undef"
	The default profile, used for the device default profile map.

static constexpr std::string_view	GLES1 = "GLES1"
	The embedded OpenGL profile ES 1.x, with x >= 0.

static constexpr std::string_view	GLES2 = "GLES2"
	The embedded OpenGL profile ES 2.x, with x >= 0.

static constexpr std::string_view	GLES3 = "GLES3"
	The embedded OpenGL profile ES 3.x, with x >= 0.

Static Public Attributes inherited from gamp::render::RenderProfile
static constexpr std::string_view	RP_UNDEF = "undef"
	The default profile, used for the device default profile map.

Protected Member Functions
void	clear () noexcept override

Additional Inherited Members
Static Protected Member Functions inherited from gamp::render::RenderProfile
static const RenderProfile &	getUndef () noexcept

Protected Attributes inherited from gamp::render::RenderProfile
friend	RenderContext

Detailed Description

Specifies the OpenGL profile.

Examples: GraphShapes01.cpp, and Primitives02.cpp.

Definition at line 41 of file GLContext.hpp.

Constructor & Destructor Documentation

◆ GLProfile() [1/3]

gamp::render::gl::GLProfile::GLProfile ( )

inlineconstexprnoexcept

Definition at line 149 of file GLContext.hpp.

Here is the caller graph for this function:

◆ GLProfile() [2/3]

gamp::render::gl::GLProfile::GLProfile	(	const jau::util::VersionNumber &	version,
		GLProfileMask	profileMask )

inlineconstexprnoexcept

Create a new instance.

Definition at line 152 of file GLContext.hpp.

◆ GLProfile() [3/3]

gamp::render::gl::GLProfile::GLProfile ( std::string_view tag )

inlineconstexprnoexcept

Create a new instance, merely deriving from given tag.

Definition at line 159 of file GLContext.hpp.

Member Function Documentation

◆ clear()

void gamp::render::gl::GLProfile::clear ( )

inlineoverrideprotectedvirtualnoexcept

Reimplemented from gamp::render::RenderProfile.

Definition at line 142 of file GLContext.hpp.

◆ GLSignature()

static const jau::type_info & gamp::render::gl::GLProfile::GLSignature ( )

inlinestaticnoexcept

Definition at line 165 of file GLContext.hpp.

Here is the caller graph for this function:

◆ signature()

const jau::type_info & gamp::render::gl::GLProfile::signature ( ) const

inlineoverridevirtualnoexcept

Reimplemented from gamp::render::RenderProfile.

Definition at line 166 of file GLContext.hpp.

◆ downcast()

static const GLProfile & gamp::render::gl::GLProfile::downcast ( const RenderProfile & rp )

inlinestatic

Downcast dereferenced given const RenderProfile& to const GLProfile&, throws exception if signature doesn't match GLSignature()

Definition at line 169 of file GLContext.hpp.

Here is the caller graph for this function:

◆ glslVersion()

const jau::util::VersionNumber & gamp::render::gl::GLProfile::glslVersion ( ) const

inlineconstexprnoexcept

Definition at line 176 of file GLContext.hpp.

◆ profileMask()

GLProfileMask gamp::render::gl::GLProfile::profileMask ( ) const

inlineconstexprnoexcept

Definition at line 177 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL4bc()

bool gamp::render::gl::GLProfile::isGL4bc ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL4bc.

Includes [ GL4bc ].

Definition at line 180 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL4()

bool gamp::render::gl::GLProfile::isGL4 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL4.

Includes [ GL4bc, GL4 ].

Definition at line 185 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL3bc()

bool gamp::render::gl::GLProfile::isGL3bc ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL3bc.

Includes [ GL4bc, GL3bc ].

Definition at line 190 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL3()

bool gamp::render::gl::GLProfile::isGL3 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL3.

Includes [ GL4bc, GL4, GL3bc, GL3 ].

Definition at line 195 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL2()

bool gamp::render::gl::GLProfile::isGL2 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL2 .

Includes [ GL4bc, GL3bc, GL2 ].

Definition at line 200 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGLES1()

bool gamp::render::gl::GLProfile::isGLES1 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GLES1.

Includes [ GLES1 ].

Definition at line 205 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGLES2()

bool gamp::render::gl::GLProfile::isGLES2 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GLES2.

Includes [ GLES2, GLES3 ].

Definition at line 210 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGLES3()

bool gamp::render::gl::GLProfile::isGLES3 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GLES3.

Includes [ GLES3 ].

Definition at line 215 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGLES()

bool gamp::render::gl::GLProfile::isGLES ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GLES.

Includes [ GLES1, GLES2, GLES3 ].

Definition at line 220 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL2ES1()

bool gamp::render::gl::GLProfile::isGL2ES1 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL2ES1.

Includes [ GL4bc, GL3bc, GL2, GLES1, GL2ES1 ].

GL2ES1 is the intersection of the desktop GL2 and embedded ES1 profile.

Definition at line 231 of file GLContext.hpp.

◆ isGL2GL3()

bool gamp::render::gl::GLProfile::isGL2GL3 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL2GL3.

Includes [ GL4bc, GL4, GL3bc, GL3, GL2, GL2GL3 ].

GL2GL3 is the intersection of the desktop GL2 and GL3 profile.

Definition at line 242 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL2ES2()

bool gamp::render::gl::GLProfile::isGL2ES2 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL2ES2.

Includes [ GL4bc, GL4, GL3bc, GL3, GLES3, GL2, GL2GL3, GL2ES2, GLES2 ].

GL2ES2 is the intersection of the desktop GL2 and embedded ES2 profile.

Definition at line 253 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL2ES3()

bool gamp::render::gl::GLProfile::isGL2ES3 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL2ES3.

Includes [ GL4bc, GL4, GL3bc, GL3, GLES3, GL3ES3, GL2, GL2GL3 ].

GL2ES3 is the intersection of the desktop GL2 and embedded ES3 profile.

See also: isGL3ES3(); isGL2GL3()

Definition at line 266 of file GLContext.hpp.

◆ isGL3ES3()

bool gamp::render::gl::GLProfile::isGL3ES3 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL3ES3.

Includes [ GL4bc, GL4, GL3bc, GL3, GLES3 ].

GL3ES3 is the intersection of the desktop GL3 and embedded ES3 profile.

Definition at line 277 of file GLContext.hpp.

Here is the caller graph for this function:

◆ isGL4ES3()

bool gamp::render::gl::GLProfile::isGL4ES3 ( ) const

inlineconstexprnoexcept

Indicates whether this profile is capable of GL4ES3.

Includes [ GL4bc, GL4, GLES3 ].

Definition at line 282 of file GLContext.hpp.

Here is the caller graph for this function:

◆ hasGLSL()

bool gamp::render::gl::GLProfile::hasGLSL ( ) const

inlineconstexprnoexcept

Indicates whether this profile supports GLSL, i.e.

nativeGLES2() || ( !nativeGLES() && m_version.major()>1 ).

Definition at line 287 of file GLContext.hpp.

◆ nativeGLES1()

bool gamp::render::gl::GLProfile::nativeGLES1 ( ) const

inlineconstexprnoexcept

Indicates whether the native OpenGL ES1 profile is in use.

This requires an EGL interface.

Definition at line 296 of file GLContext.hpp.

◆ nativeGLES2()

bool gamp::render::gl::GLProfile::nativeGLES2 ( ) const

inlineconstexprnoexcept

Indicates whether the native OpenGL ES3 or ES2 profile is in use.

This requires an EGL, ES3 or ES2 compatible interface.

Definition at line 304 of file GLContext.hpp.

Here is the caller graph for this function:

◆ nativeGLES3()

bool gamp::render::gl::GLProfile::nativeGLES3 ( ) const

inlineconstexprnoexcept

Indicates whether the native OpenGL ES2 profile is in use.

This requires an EGL, ES3 compatible interface.

Definition at line 312 of file GLContext.hpp.

◆ nativeGLES()

bool gamp::render::gl::GLProfile::nativeGLES ( ) const

inlineconstexprnoexcept

Indicates whether either of the native OpenGL ES profiles are in use.

Definition at line 317 of file GLContext.hpp.

Here is the caller graph for this function:

◆ nativeGLCore()

bool gamp::render::gl::GLProfile::nativeGLCore ( ) const

inlineconstexprnoexcept

Indicates whether either of the native OpenGL core profiles are in use.

Definition at line 322 of file GLContext.hpp.

◆ nativeGLCompat()

bool gamp::render::gl::GLProfile::nativeGLCompat ( ) const

inlineconstexprnoexcept

Indicates whether either of the native OpenGL compatibility profiles are in use.

Definition at line 327 of file GLContext.hpp.

◆ isValidDataType()

bool gamp::render::gl::GLProfile::isValidDataType ( GLenum type ) const

inlineconstexprnoexcept

General validation if type is a valid GL data type for the current profile.

Disclaimer: The validation might not satisfy updated OpenGL specifications.

Definition at line 337 of file GLContext.hpp.

◆ isValidArrayDataType()

bool GLProfile::isValidArrayDataType	(	GLenum	index,
		GLsizei	comps,
		GLenum	type,
		bool	isVertexAttribPointer,
		bool	throwException ) const

General validation if index, comps and type are valid for the current profile.

Disclaimer: The validation might not satisfy updated OpenGL specifications.

Definition at line 25 of file gamp_gl.cpp.

◆ getGLSLVersionString()

std::string gamp::render::gl::GLProfile::getGLSLVersionString ( ) const

inline

Returns the GLSL version string as to be used in a shader program, including a terminating newline '
', i.e.

for desktop

   version 110
   ..
   version 150 core
   version 330 compatibility
   ...

And for ES:

   version 100
   version 300 es
   ..

If context has not been made current yet, a string of zero length is returned.

See also: getGLSLVersionNumber()

Definition at line 396 of file GLContext.hpp.

◆ toString()

std::string gamp::render::gl::GLProfile::toString ( ) const

inlineoverridevirtual

Reimplemented from gamp::render::RenderProfile.

Definition at line 415 of file GLContext.hpp.

Here is the caller graph for this function:

Member Data Documentation

◆ GL4bc

std::string_view gamp::render::gl::GLProfile::GL4bc = "GL4bc"

staticconstexpr

The desktop OpenGL compatibility profile 4.x, with x >= 0, ie GL2 plus GL4.

bc stands for backward compatibility.

Definition at line 45 of file GLContext.hpp.

◆ GL4

std::string_view gamp::render::gl::GLProfile::GL4 = "GL4"

staticconstexpr

The desktop OpenGL core profile 4.x, with x >= 0.

Definition at line 48 of file GLContext.hpp.

◆ GL3bc

std::string_view gamp::render::gl::GLProfile::GL3bc = "GL3bc"

staticconstexpr

The desktop OpenGL compatibility profile 3.x, with x >= 1, ie GL2 plus GL3.

bc stands for backward compatibility.

Definition at line 52 of file GLContext.hpp.

◆ GL3

std::string_view gamp::render::gl::GLProfile::GL3 = "GL3"

staticconstexpr

The desktop OpenGL core profile 3.x, with x >= 1.

Definition at line 55 of file GLContext.hpp.

◆ GL2

std::string_view gamp::render::gl::GLProfile::GL2 = "GL2"

staticconstexpr

The desktop OpenGL profile 1.x up to 3.0.

Definition at line 58 of file GLContext.hpp.

◆ GLES1

std::string_view gamp::render::gl::GLProfile::GLES1 = "GLES1"

staticconstexpr

The embedded OpenGL profile ES 1.x, with x >= 0.

Definition at line 61 of file GLContext.hpp.

◆ GLES2

std::string_view gamp::render::gl::GLProfile::GLES2 = "GLES2"

staticconstexpr

The embedded OpenGL profile ES 2.x, with x >= 0.

Definition at line 64 of file GLContext.hpp.

◆ GLES3

std::string_view gamp::render::gl::GLProfile::GLES3 = "GLES3"

staticconstexpr

The embedded OpenGL profile ES 3.x, with x >= 0.

Definition at line 67 of file GLContext.hpp.

◆ GL_UNDEF

std::string_view gamp::render::gl::GLProfile::GL_UNDEF = "undef"

staticconstexpr

The default profile, used for the device default profile map.

Definition at line 70 of file GLContext.hpp.

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

include/gamp/render/gl/GLContext.hpp
src/gamp_gl.cpp

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ GLProfile() [1/3]

◆ GLProfile() [2/3]

◆ GLProfile() [3/3]

Member Function Documentation

◆ clear()

◆ GLSignature()

◆ signature()

◆ downcast()

◆ glslVersion()

◆ profileMask()

◆ isGL4bc()

◆ isGL4()

◆ isGL3bc()

◆ isGL3()

◆ isGL2()

◆ isGLES1()

◆ isGLES2()

◆ isGLES3()

◆ isGLES()

◆ isGL2ES1()

◆ isGL2GL3()

◆ isGL2ES2()

◆ isGL2ES3()

◆ isGL3ES3()

◆ isGL4ES3()

◆ hasGLSL()

◆ nativeGLES1()

◆ nativeGLES2()

◆ nativeGLES3()

◆ nativeGLES()

◆ nativeGLCore()

◆ nativeGLCompat()

◆ isValidDataType()

◆ isValidArrayDataType()

◆ getGLSLVersionString()

◆ toString()

Member Data Documentation

◆ GL4bc

◆ GL4

◆ GL3bc

◆ GL3

◆ GL2

◆ GLES1

◆ GLES2

◆ GLES3

◆ GL_UNDEF