com.luciad.view.lightspeed.util.opengl.texture

LuciadLightspeedClass ALspTextureObject

java.lang.Object

com.luciad.view.lightspeed.services.glcache.ALspGLResource

com.luciad.view.lightspeed.util.opengl.texture.ALspTextureObject

Direct Known Subclasses:

ALsp2DTextureObject

public abstract class ALspTextureObject
extends ALspGLResource

Manages an OpenGL texture object. This abstract class provides the base functionality to create, bind and destroy the texture object. Definition of the texture image and other texture parameters is left up to implementing classes.

Since:

2012.0

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ALspTextureObject() Constructs a new ALspTextureObject.
protected	ALspTextureObject(String aSourceString) Constructs a new ALspTextureObject.

Method Summary

Modifier and Type	Method and Description
void	bind(ILcdGLDrawable aGLDrawable) Binds the texture object to its appropriate target.
void	destroy(ILcdGLDrawable aGLDrawable) Deletes the texture object owned by this ALspTextureObject.
abstract long	getBytes() Returns the number of estimated bytes this texture object occupies.
abstract int	getTarget() Returns the OpenGL enumerant for the texture target to which this texture can be bound.
int	getTextureObject() Returns the OpenGL texture object id.
protected void	init(ILcdGLDrawable aGLDrawable) Creates a new OpenGL texture object.
protected boolean	isDestroyed() Returns true if this texture object has been destroyed.
void	unbind(ILcdGLDrawable aGLDrawable) Unbinds the texture object from its target (by binding texture object 0).

Methods inherited from class com.luciad.view.lightspeed.services.glcache.ALspGLResource

getSourceString, isBound, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ALspTextureObject

protected ALspTextureObject()

Constructs a new ALspTextureObject. No OpenGL texture object is created until the first attempt to bind the texture.

ALspTextureObject

protected ALspTextureObject(String aSourceString)

Constructs a new ALspTextureObject. No OpenGL texture object is created until the first attempt to bind the texture.

Method Detail

init

protected void init(ILcdGLDrawable aGLDrawable)

Creates a new OpenGL texture object. This method is called the first time this texture is bound. It may be extended to include initialization of the texture image (e.g. by calling glTexImage2D()).

Parameters:

aGLDrawable - the drawable

destroy

public void destroy(ILcdGLDrawable aGLDrawable)

Deletes the texture object owned by this ALspTextureObject.

Overrides:

destroy in class ALspGLResource

Parameters:

aGLDrawable - the drawable

bind

public void bind(ILcdGLDrawable aGLDrawable)

Binds the texture object to its appropriate target. Note that this method does not enable texture mapping on this target. This method invokes init(ILcdGLDrawable) the first time it is called.

Overrides:

bind in class ALspGLResource

Parameters:

aGLDrawable - the drawable

See Also:

getTarget()

unbind

public void unbind(ILcdGLDrawable aGLDrawable)

Unbinds the texture object from its target (by binding texture object 0). Note that this method does not disable texture mapping on this target.

Overrides:

unbind in class ALspGLResource

Parameters:

aGLDrawable - the drawable

See Also:

getTarget()

getTarget

public abstract int getTarget()

Returns the OpenGL enumerant for the texture target to which this texture can be bound. Allowed values include GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_CUBE_MAP...

Returns:

the OpenGL enumerant for the texture target to which this texture can be bound

getBytes

public abstract long getBytes()

Returns the number of estimated bytes this texture object occupies.

Specified by:

getBytes in class ALspGLResource

Returns:

the number of estimated bytes this texture object occupies

isDestroyed

protected boolean isDestroyed()

Returns true if this texture object has been destroyed. No attempts to use the texture should be made at this point.

Returns:

whether or not this texture has already been destroyed

See Also:

destroy(com.luciad.view.opengl.binding.ILcdGLDrawable)

getTextureObject

public int getTextureObject()

Returns the OpenGL texture object id. Will be -1 if the texture is not valid.

Returns:

the OpenGL texture object id