Package com.badlogic.gdx.graphics

Class Texture

java.lang.Object

com.badlogic.gdx.graphics.GLTexture

com.badlogic.gdx.graphics.Texture

All Implemented Interfaces:

Disposable

public class Texture
extends GLTexture

A Texture wraps a standard OpenGL ES texture.

A Texture can be managed. If the OpenGL context is lost all managed textures get invalidated. This happens when a user switches to another application or receives an incoming call. Managed textures get reloaded automatically.

A Texture has to be bound via the GLTexture.bind() method in order for it to be applied to geometry. The texture will be bound to the currently active texture unit specified via GL20.glActiveTexture(int).

You can draw Pixmaps to a texture at any time. The changes will be automatically uploaded to texture memory. This is of course not extremely fast so use it with care. It also only works with unmanaged textures.

A Texture must be disposed when it is no longer used

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	Texture.TextureFilter
static enum	Texture.TextureWrap

Field Summary

Fields inherited from class com.badlogic.gdx.graphics.GLTexture

anisotropicFilterLevel, glHandle, glTarget, magFilter, minFilter, uWrap, vWrap

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Texture()
	Texture(int width, int height, Pixmap.Format format)
protected	Texture(int glTarget, int glHandle, TextureData data)
	Texture(FileHandle file)
	Texture(FileHandle file, boolean useMipMaps)
	Texture(FileHandle file, Pixmap.Format format, boolean useMipMaps)
	Texture(Pixmap pixmap)
	Texture(Pixmap pixmap, boolean useMipMaps)
	Texture(Pixmap pixmap, Pixmap.Format format, boolean useMipMaps)
	Texture(TextureData data)
	Texture(String internalPath)

Method Summary

Modifier and Type	Method	Description
static void	clearAllTextures(Application app)	Clears all managed textures.
void	dispose()	Disposes all resources associated with the texture
void	draw(Pixmap pixmap, int x, int y)	Draws the given Pixmap to the texture at position x, y.
int	getDepth()
int	getHeight()
static String	getManagedStatus()
static int	getNumManagedTextures()
TextureData	getTextureData()
int	getWidth()
static void	invalidateAllTextures(Application app)	Invalidate all managed textures.
boolean	isManaged()
void	load(TextureData data)
protected void	reload()	Used internally to reload after context loss.
static void	setAssetManager(AssetManager manager)	Sets the AssetManager.
String	toString()

Methods inherited from class com.badlogic.gdx.graphics.GLTexture

bind, bind, delete, getAnisotropicFilter, getMagFilter, getMaxAnisotropicFilterLevel, getMinFilter, getTextureObjectHandle, getUWrap, getVWrap, setAnisotropicFilter, setFilter, setWrap, unsafeSetAnisotropicFilter, unsafeSetAnisotropicFilter, unsafeSetFilter, unsafeSetFilter, unsafeSetWrap, unsafeSetWrap, uploadImageData, uploadImageData

Methods inherited from class java.lang.Object

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

Constructor Details

Texture

protected Texture()

Texture

public Texture(String internalPath)

Texture

public Texture(FileHandle file)

Texture

public Texture(FileHandle file,
 boolean useMipMaps)

Texture

public Texture(FileHandle file,
 Pixmap.Format format,
 boolean useMipMaps)

Texture

public Texture(Pixmap pixmap)

Texture

public Texture(Pixmap pixmap,
 boolean useMipMaps)

Texture

public Texture(Pixmap pixmap,
 Pixmap.Format format,
 boolean useMipMaps)

Texture

public Texture(int width,
 int height,
 Pixmap.Format format)

Texture

public Texture(TextureData data)

Texture

protected Texture(int glTarget,
 int glHandle,
 TextureData data)

Method Details

load

public void load(TextureData data)

reload

protected void reload()

Used internally to reload after context loss. Creates a new GL handle then calls load(TextureData). Use this only if you know what you do!

Specified by:

reload in class GLTexture

draw

public void draw(Pixmap pixmap,
 int x,
 int y)

Draws the given Pixmap to the texture at position x, y. No clipping is performed so you have to make sure that you draw only inside the texture region. Note that this will only draw to mipmap level 0!

Parameters:

pixmap - The Pixmap

x - The x coordinate in pixels

y - The y coordinate in pixels

getWidth

public int getWidth()

Specified by:

getWidth in class GLTexture

Returns:

the width of the texture in pixels

getHeight

public int getHeight()

Specified by:

getHeight in class GLTexture

Returns:

the height of the texture in pixels

getDepth

public int getDepth()

Specified by:

getDepth in class GLTexture

Returns:

the depth of the texture in pixels

getTextureData

public TextureData getTextureData()

isManaged

public boolean isManaged()

Specified by:

isManaged in class GLTexture

Returns:

whether this texture is managed or not.

dispose

public void dispose()

Disposes all resources associated with the texture

Specified by:

dispose in interface Disposable

Overrides:

dispose in class GLTexture

toString

public String toString()

Overrides:

toString in class Object

clearAllTextures

public static void clearAllTextures(Application app)

Clears all managed textures. This is an internal method. Do not use it!

invalidateAllTextures

public static void invalidateAllTextures(Application app)

Invalidate all managed textures. This is an internal method. Do not use it!

setAssetManager

public static void setAssetManager(AssetManager manager)

Sets the AssetManager. When the context is lost, textures managed by the asset manager are reloaded by the manager on a separate thread (provided that a suitable AssetLoader is registered with the manager). Textures not managed by the AssetManager are reloaded via the usual means on the rendering thread.

Parameters:

manager - the asset manager.

getManagedStatus

public static String getManagedStatus()

getNumManagedTextures

public static int getNumManagedTextures()

Returns:

the number of managed textures currently loaded