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 Texture#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 and Inner Type Summary

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

Field Summary

Modifier and Type	Field and Description
private static AssetManager	assetManager
pack-priv TextureData	data
pack-priv static final Map<Application, Array<Texture>>	managedTextures

Inherited from com.badlogic.gdx.graphics.GLTexture:: anisotropicFilterLevel glHandle glTarget magFilter minFilter uWrap vWrap

Constructor Summary

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

Method Summary

Modifier and Type	Method and Description
private static void	addManagedTexture(Application app, Texture texture)
public static void	clearAllTextures(Application app) Clears all managed textures.
public void	dispose() Overrides com.badlogic.gdx.graphics.GLTexture.dispose. Implements com.badlogic.gdx.utils.Disposable.dispose. Disposes all resources associated with the texture
public void	draw(Pixmap The Pixmap pixmap, int The x coordinate in pixels x, int The y coordinate in pixels y) Draws the given `Pixmap` to the texture at position x, y.
public int	getDepth() Implements abstract com.badlogic.gdx.graphics.GLTexture.getDepth.
public int	getHeight() Implements abstract com.badlogic.gdx.graphics.GLTexture.getHeight.
public static String	getManagedStatus()
public static int	getNumManagedTextures() Returns: the number of managed textures currently loaded
public TextureData	getTextureData()
public int	getWidth() Implements abstract com.badlogic.gdx.graphics.GLTexture.getWidth.
public static void	invalidateAllTextures(Application app) Invalidate all managed textures.
public boolean	isManaged() Implements abstract com.badlogic.gdx.graphics.GLTexture.isManaged. Returns: whether this texture is managed or not.
public void	load(TextureData data)
protected void	reload() Implements abstract com.badlogic.gdx.graphics.GLTexture.reload. Used internally to reload after context loss.
public static void	setAssetManager(AssetManager the asset manager. manager) Sets the `AssetManager`.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

assetManager	back to summary
private static AssetManager assetManager

data	back to summary
pack-priv TextureData data

managedTextures	back to summary
pack-priv static final Map<Application, Array<Texture>> managedTextures

Constructor Detail

Texture	back to summary
protected Texture()

Texture	back to summary
public Texture(String internalPath)

Texture	back to summary
public Texture(FileHandle file)

Texture	back to summary
public Texture(FileHandle file, boolean useMipMaps)

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

Texture	back to summary
public Texture(Pixmap pixmap)

Texture	back to summary
public Texture(Pixmap pixmap, boolean useMipMaps)

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

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

Texture	back to summary
public Texture(TextureData data)

Texture	back to summary
protected Texture(int glTarget, int glHandle, TextureData data)

Method Detail

addManagedTexture	back to summary
private static void addManagedTexture(Application app, Texture texture)

clearAllTextures	back to summary
public static void clearAllTextures(Application app) Clears all managed textures. This is an internal method. Do not use it!

dispose	back to summary
public void dispose() Overrides com.badlogic.gdx.graphics.GLTexture.dispose. Implements com.badlogic.gdx.utils.Disposable.dispose. Disposes all resources associated with the texture

dispose

back to summary

public void dispose()

Overrides com.badlogic.gdx.graphics.GLTexture.dispose.

Implements com.badlogic.gdx.utils.Disposable.dispose.

Disposes all resources associated with the texture

draw back to summary

draw	back to summary
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:Pixmap The Pixmap x:int The x coordinate in pixels y:int The y coordinate in pixels

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:Pixmap: The Pixmap
x:int: The x coordinate in pixels
y:int: The y coordinate in pixels

getDepth	back to summary
public int getDepth() Implements abstract com.badlogic.gdx.graphics.GLTexture.getDepth. Annotations @Override

getDepth

back to summary

public int getDepth()

Implements abstract com.badlogic.gdx.graphics.GLTexture.getDepth.

Annotations

@Override

getHeight	back to summary
public int getHeight() Implements abstract com.badlogic.gdx.graphics.GLTexture.getHeight. Annotations @Override

getHeight

back to summary

public int getHeight()

Implements abstract com.badlogic.gdx.graphics.GLTexture.getHeight.

Annotations

@Override

getManagedStatus	back to summary
public static String getManagedStatus()

getNumManagedTextures	back to summary
public static int getNumManagedTextures() Returns:int the number of managed textures currently loaded

getTextureData	back to summary
public TextureData getTextureData()

getWidth	back to summary
public int getWidth() Implements abstract com.badlogic.gdx.graphics.GLTexture.getWidth. Annotations @Override

getWidth

back to summary

public int getWidth()

Implements abstract com.badlogic.gdx.graphics.GLTexture.getWidth.

Annotations

@Override

invalidateAllTextures	back to summary
public static void invalidateAllTextures(Application app) Invalidate all managed textures. This is an internal method. Do not use it!

isManaged	back to summary
public boolean isManaged() Implements abstract com.badlogic.gdx.graphics.GLTexture.isManaged. Returns:boolean whether this texture is managed or not.

isManaged

back to summary

public boolean isManaged()

Implements abstract com.badlogic.gdx.graphics.GLTexture.isManaged.

Returns:boolean: whether this texture is managed or not.

load	back to summary
public void load(TextureData data)

reload back to summary

reload	back to summary
protected void reload() Implements abstract com.badlogic.gdx.graphics.GLTexture.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! Annotations @Override

protected void reload()

Implements abstract com.badlogic.gdx.graphics.GLTexture.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!

Annotations

@Override

setAssetManager back to summary

setAssetManager	back to summary
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:AssetManager the asset manager.

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:AssetManager: the asset manager.

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned.

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

com.badlogic.gdx.graphics back to summary

public final Enum Texture.TextureFilter

Class Inheritance

extends Enum<Texture.TextureFilter>

java.lang.Object
java.lang.Enum
com.badlogic.gdx.graphics.Texture.TextureFilter

Field Summary

Modifier and Type	Field and Description
pack-priv final int	glEnum
public static final Texture.TextureFilter	Linear Fetch four nearest texels that best maps to the pixel on screen.
public static final Texture.TextureFilter	MipMap
public static final Texture.TextureFilter	MipMapLinearLinear Fetch the two best fitting images from the mip map chain and then sample the four nearest texels from each of the two images, combining them to the final output pixel.
public static final Texture.TextureFilter	MipMapLinearNearest Fetch the best fitting image from the mip map chain based on the pixel/texel ratio and then sample the texels with a linear filter.
public static final Texture.TextureFilter	MipMapNearestLinear Fetch the two best fitting images from the mip map chain and then sample the nearest texel from each of the two images, combining them to the final output pixel.
public static final Texture.TextureFilter	MipMapNearestNearest Fetch the best fitting image from the mip map chain based on the pixel/texel ratio and then sample the texels with a nearest filter.
public static final Texture.TextureFilter	Nearest Fetch the nearest texel that best maps to the pixel on screen.

Constructor Summary

Access	Constructor and Description
private	TextureFilter(int glEnum)

Method Summary

Modifier and Type	Method and Description
public int	getGLEnum()
public boolean	isMipMap()
public static Texture.TextureFilter	valueOf(String name)
public static Texture.TextureFilter[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

glEnum	back to summary
pack-priv final int glEnum

Linear	back to summary
public static final Texture.TextureFilter Linear Fetch four nearest texels that best maps to the pixel on screen.

MipMap	back to summary
public static final Texture.TextureFilter MipMap See Also `TextureFilter#MipMapLinearLinear`

MipMapLinearLinear	back to summary
public static final Texture.TextureFilter MipMapLinearLinear Fetch the two best fitting images from the mip map chain and then sample the four nearest texels from each of the two images, combining them to the final output pixel.

MipMapLinearNearest	back to summary
public static final Texture.TextureFilter MipMapLinearNearest Fetch the best fitting image from the mip map chain based on the pixel/texel ratio and then sample the texels with a linear filter.

MipMapNearestLinear	back to summary
public static final Texture.TextureFilter MipMapNearestLinear Fetch the two best fitting images from the mip map chain and then sample the nearest texel from each of the two images, combining them to the final output pixel.

MipMapNearestNearest	back to summary
public static final Texture.TextureFilter MipMapNearestNearest Fetch the best fitting image from the mip map chain based on the pixel/texel ratio and then sample the texels with a nearest filter.

Nearest	back to summary
public static final Texture.TextureFilter Nearest Fetch the nearest texel that best maps to the pixel on screen.

Constructor Detail

TextureFilter	back to summary
private TextureFilter(int glEnum)

Method Detail

getGLEnum	back to summary
public int getGLEnum()

isMipMap	back to summary
public boolean isMipMap()

valueOf	back to summary
public static Texture.TextureFilter valueOf(String name)

values	back to summary
public static Texture.TextureFilter[] values()

com.badlogic.gdx.graphics back to summary

public final Enum Texture.TextureWrap

Class Inheritance

extends Enum<Texture.TextureWrap>

java.lang.Object
java.lang.Enum
com.badlogic.gdx.graphics.Texture.TextureWrap

Field Summary

Modifier and Type	Field and Description
public static final Texture.TextureWrap	ClampToEdge
pack-priv final int	glEnum
public static final Texture.TextureWrap	MirroredRepeat
public static final Texture.TextureWrap	Repeat

Constructor Summary

Access	Constructor and Description
private	TextureWrap(int glEnum)

Method Summary

Modifier and Type	Method and Description
public int	getGLEnum()
public static Texture.TextureWrap	valueOf(String name)
public static Texture.TextureWrap[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

ClampToEdge	back to summary
public static final Texture.TextureWrap ClampToEdge

glEnum	back to summary
pack-priv final int glEnum

MirroredRepeat	back to summary
public static final Texture.TextureWrap MirroredRepeat

Repeat	back to summary
public static final Texture.TextureWrap Repeat

Constructor Detail

TextureWrap	back to summary
private TextureWrap(int glEnum)

Method Detail

getGLEnum	back to summary
public int getGLEnum()

valueOf	back to summary
public static Texture.TextureWrap valueOf(String name)

values	back to summary
public static Texture.TextureWrap[] values()

public Class Texture

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum Texture.TextureFilter

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum Texture.TextureWrap

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail