com.luciad.view.lightspeed

LuciadFusionClass TLspOpenGLProfile

java.lang.Object

com.luciad.view.lightspeed.TLspOpenGLProfile

public class TLspOpenGLProfile
extends Object

Provides a mechanism to classify the level of OpenGL support on an end-user system. A profile can be tested for compatibility with a given ILcdGLDrawable using the isCompatible(com.luciad.view.opengl.binding.ILcdGLDrawable) isCompatible} method. The profile could check, for instance, for certain OpenGL versions or for the availability of certain OpenGL extensions. A few commonly used profiles are defined as constants in this class; other, more specific profiles can be created by extending this class. Each ILspPainter must advertise the profile it minimally requires via its getRequiredOpenGLProfile method.

Since:

2012.0

Field Summary

Fields

Modifier and Type	Field and Description
static TLspOpenGLProfile	FRAMEBUFFER_OBJECT Matches LIGHTSPEED_MINIMUM plus the GL_ARB_framebuffer_object extension.
static TLspOpenGLProfile	LIGHTSPEED_MINIMUM Matches OpenGL versions 2.0 and above

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TLspOpenGLProfile() Creates a new TLspOpenGLProfile.
protected	TLspOpenGLProfile(TLspOpenGLProfile aBaseLine) Creates a new TLspOpenGLProfile with the specified baseline.
	TLspOpenGLProfile(TLspOpenGLProfile aRequiredBaseLine, int aRequiredMajorVersion, int aRequiredMinorVersion, String[] aRequiredExtensions) Creates a new TLspOpenGLProfile with the specified baseline, minimum OpenGL version and list of required OpenGL extensions.

Method Summary

Modifier and Type	Method and Description
String[]	getExtensions() Returns the extensions of this OpenGL profile as a string array
int	getMajorVersion() Returns the major version number of this OpenGL profile
int	getMinorVersion() Returns the minor version number of this OpenGL profile
static TLspOpenGLProfile	getSuperSet(TLspOpenGLProfile... aProfiles) Creates a new OpenGL profile which matches a superset of the supplied profiles.
boolean	isCompatible(ILcdGLDrawable aGLDrawable) Determines whether or not the supplied ILcdGLDrawable meets all the requirements of this OpenGL profile.
static boolean	isExtensionAvailable(ILcdGLDrawable aGLDrawable, String aExtension) Determines whether the specified OpenGL extension is supported in the given ILcdGLDrawable.
void	setExtensions(String[] aExtensions) Sets the extensions of this OpenGL profile to the given extensions
void	setMajorVersion(int aMajorVersion) Sets the major version number of this OpenGL profile to the given version number
void	setMinorVersion(int aMinorVersion) Sets the minor version number of this OpenGL profile to the given version number
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

LIGHTSPEED_MINIMUM

public static final TLspOpenGLProfile LIGHTSPEED_MINIMUM

Matches OpenGL versions 2.0 and above

FRAMEBUFFER_OBJECT

public static final TLspOpenGLProfile FRAMEBUFFER_OBJECT

Matches LIGHTSPEED_MINIMUM plus the GL_ARB_framebuffer_object extension.

Constructor Detail

TLspOpenGLProfile

public TLspOpenGLProfile(TLspOpenGLProfile aRequiredBaseLine,
                         int aRequiredMajorVersion,
                         int aRequiredMinorVersion,
                         String[] aRequiredExtensions)

Creates a new TLspOpenGLProfile with the specified baseline, minimum OpenGL version and list of required OpenGL extensions.

Parameters:

aRequiredBaseLine - base line

aRequiredMajorVersion - major OpenGL version number

aRequiredMinorVersion - minor OpenGL version number

aRequiredExtensions - list of required extensions

TLspOpenGLProfile

protected TLspOpenGLProfile()

Creates a new TLspOpenGLProfile. No baseline profile is set.

See Also:

TLspOpenGLProfile(TLspOpenGLProfile)

TLspOpenGLProfile

protected TLspOpenGLProfile(TLspOpenGLProfile aBaseLine)

Creates a new TLspOpenGLProfile with the specified baseline. If the baseline profile is not null, isCompatible(com.luciad.view.opengl.binding.ILcdGLDrawable) will delegate to the baseline.

Parameters:

aBaseLine - the base line profile

Method Detail

getMajorVersion

public int getMajorVersion()

Returns the major version number of this OpenGL profile

Returns:

the major version number of this OpenGL profile

setMajorVersion

public void setMajorVersion(int aMajorVersion)

Sets the major version number of this OpenGL profile to the given version number

Parameters:

aMajorVersion - the new major version number for this OpenGL profile

getMinorVersion

public int getMinorVersion()

Returns the minor version number of this OpenGL profile

Returns:

the minor version number of this OpenGL profile

setMinorVersion

public void setMinorVersion(int aMinorVersion)

Sets the minor version number of this OpenGL profile to the given version number

Parameters:

aMinorVersion - the new minor version number for this OpenGL profile

getExtensions

public String[] getExtensions()

Returns the extensions of this OpenGL profile as a string array

Returns:

the extensions of this OpenGL profile as a string array or null

setExtensions

public void setExtensions(String[] aExtensions)

Sets the extensions of this OpenGL profile to the given extensions

Parameters:

aExtensions - the new set of extensions for this OpenGL profile

getSuperSet

public static TLspOpenGLProfile getSuperSet(TLspOpenGLProfile... aProfiles)

Creates a new OpenGL profile which matches a superset of the supplied profiles. In other words, the resulting profile is only compatible with views which are compatible with all elements of aProfiles.

Parameters:

aProfiles - array of profiles to group

Returns:

a profile that encompasses all the input profiles

isCompatible

public boolean isCompatible(ILcdGLDrawable aGLDrawable)

Determines whether or not the supplied ILcdGLDrawable meets all the requirements of this OpenGL profile. If this method returns false, a painter which requires this profile will not work with the given drawable. This method may check for specific OpenGL versions, for the availability of certain OpenGL extensions, or for any other implementation-specific variable that a painter might depend on (e.g. maximum texture resolution, matrix stack depths, ...).

Parameters:

aGLDrawable - the ILcdGLDrawable in which to check for compatibility

Returns:

true if this profile is supported by the given drawable

isExtensionAvailable

public static boolean isExtensionAvailable(ILcdGLDrawable aGLDrawable,
                                           String aExtension)

Determines whether the specified OpenGL extension is supported in the given ILcdGLDrawable.

Parameters:

aGLDrawable - the ILcdGLDrawable in which to check for availability of the extension

aExtension - the extension to check for

Returns:

true if the extension is available

toString

public String toString()

Overrides:

toString in class Object