Class TextureBuilder.Abstract<GL extends OGLGraphics>

java.lang.Object

com.blackrook.gloop.opengl.util.TextureBuilder.Abstract<GL>

Type Parameters:

GL - the graphics implementation that this executes on.

All Implemented Interfaces:

TextureBuilder

Enclosing interface:

TextureBuilder

public abstract static class TextureBuilder.Abstract<GL extends OGLGraphics>
extends Object
implements TextureBuilder

Texture builder utility class.

Nested Class Summary

Nested classes/interfaces inherited from interface TextureBuilder

TextureBuilder.Abstract<GL>

Field Summary

Fields

Modifier and Type	Field	Description
protected float	anisotropy
protected boolean	autoGenerateMipMaps
protected int	border
protected boolean	compressed
protected GL	gl
protected List<BufferedImage[]>	imageLevels
protected TextureMagFilter	magFilter
protected TextureMinFilter	minFilter
protected TextureTargetType	targetType
protected TextureWrapType	wrapR
protected TextureWrapType	wrapS
protected TextureWrapType	wrapT

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Abstract(GL gl)	Creates a new Texture Builder with defaults set.

Method Summary

Modifier and Type	Method	Description
TextureBuilder	addTextureImage(BufferedImage... images)	Adds one or more textures to a mipmap level.
TextureBuilder	setAnisotropy(float anisotropy)	Sets texture anisotropy level.
TextureBuilder	setAutoGenerateMipMaps(boolean autoGenerateMipMaps)	Sets if this generator auto-generates mipmaps on or after data transfer.
TextureBuilder	setBorder(int texels)	Sets the border size on the texture in texels.
TextureBuilder	setCompressed(boolean enabled)	Sets if the texture is stored in a compressed format.
TextureBuilder	setFiltering(TextureMinFilter minFilter, TextureMagFilter magFilter)	Sets the minification and magnification filter on the texture.
TextureBuilder	setTargetType(TextureTargetType targetType)	Sets the texture target type.
TextureBuilder	setWrapping(TextureWrapType wrapS)	Sets the wrapping on the texture.
TextureBuilder	setWrapping(TextureWrapType wrapS, TextureWrapType wrapT)	Sets the wrapping on the texture.
TextureBuilder	setWrapping(TextureWrapType wrapS, TextureWrapType wrapT, TextureWrapType wrapR)	Sets the wrapping on the texture.
protected void	store1D(OGL11Graphics gl, Function<BufferedImage, ByteBuffer> dataFunc, ColorFormat colorFormat, TextureFormat textureFormat)
protected void	store1DArray(OGL11Graphics gl, Function<BufferedImage[], ByteBuffer> dataArrayFunc, ColorFormat colorFormat, TextureFormat textureFormat)
protected void	store2D(OGL11Graphics gl, Function<BufferedImage, ByteBuffer> dataFunc, ColorFormat colorFormat, TextureFormat textureFormat)
protected void	store2DArray(OGL12Graphics gl, Function<BufferedImage[], ByteBuffer> dataArrayFunc, ColorFormat colorFormat, TextureFormat textureFormat)
protected void	store3D(OGL12Graphics gl, Function<BufferedImage[], ByteBuffer> dataArrayFunc, ColorFormat colorFormat, TextureFormat textureFormat)
protected void	storeCube(OGL13Graphics gl, Function<BufferedImage, ByteBuffer> dataFunc, ColorFormat colorFormat, TextureFormat textureFormat)

Methods inherited from class Object

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

Methods inherited from interface TextureBuilder

create

Field Details

gl

protected GL extends OGLGraphics gl

targetType

protected TextureTargetType targetType

minFilter

protected TextureMinFilter minFilter

magFilter

protected TextureMagFilter magFilter

wrapS

protected TextureWrapType wrapS

wrapT

protected TextureWrapType wrapT

wrapR

protected TextureWrapType wrapR

border

protected int border

compressed

protected boolean compressed

autoGenerateMipMaps

protected boolean autoGenerateMipMaps

anisotropy

protected float anisotropy

imageLevels

protected List<BufferedImage[]> imageLevels

Constructor Details

Abstract

protected Abstract(GL gl)

Creates a new Texture Builder with defaults set.

Parameters:

gl - the graphics implementation that created this (and will execute this).

Method Details

setTargetType

public TextureBuilder setTargetType(TextureTargetType targetType)

Description copied from interface: TextureBuilder

Sets the texture target type. By default, this is TextureTargetType.TEXTURE_2D.

Specified by:

setTargetType in interface TextureBuilder

Parameters:

targetType - the target type to use.

Returns:

this builder.

setFiltering

public TextureBuilder setFiltering(TextureMinFilter minFilter,
 TextureMagFilter magFilter)

Description copied from interface: TextureBuilder

Sets the minification and magnification filter on the texture. By default, this is TextureMinFilter.NEAREST for both.

Specified by:

setFiltering in interface TextureBuilder

Parameters:

minFilter - the minification filter to use.

magFilter - the magnification filter to use.

Returns:

this builder.

setBorder

public TextureBuilder setBorder(int texels)

Description copied from interface: TextureBuilder

Sets the border size on the texture in texels. By default, this is 0.

Specified by:

setBorder in interface TextureBuilder

Parameters:

texels - the texel width.

Returns:

this builder.

setWrapping

public TextureBuilder setWrapping(TextureWrapType wrapS)

Description copied from interface: TextureBuilder

Sets the wrapping on the texture. By default, all wrapping is TextureWrapType.TILE.

Specified by:

setWrapping in interface TextureBuilder

Parameters:

wrapS - the S-coordinate wrap type.

Returns:

this builder.

setWrapping

public TextureBuilder setWrapping(TextureWrapType wrapS,
 TextureWrapType wrapT)

Description copied from interface: TextureBuilder

Sets the wrapping on the texture. By default, all wrapping is TextureWrapType.TILE.

Specified by:

setWrapping in interface TextureBuilder

Parameters:

wrapS - the S-coordinate wrap type.

wrapT - the T-coordinate wrap type.

Returns:

this builder.

setWrapping

public TextureBuilder setWrapping(TextureWrapType wrapS,
 TextureWrapType wrapT,
 TextureWrapType wrapR)

Description copied from interface: TextureBuilder

Sets the wrapping on the texture. By default, all wrapping is TextureWrapType.TILE.

Specified by:

setWrapping in interface TextureBuilder

Parameters:

wrapS - the S-coordinate wrap type.

wrapT - the T-coordinate wrap type.

wrapR - the R-coordinate wrap type.

Returns:

this builder.

setCompressed

public TextureBuilder setCompressed(boolean enabled)

Description copied from interface: TextureBuilder

Sets if the texture is stored in a compressed format. By default, this is false.

Specified by:

setCompressed in interface TextureBuilder

Parameters:

enabled - true to enable, false if disabled.

Returns:

this builder.

setAutoGenerateMipMaps

public TextureBuilder setAutoGenerateMipMaps(boolean autoGenerateMipMaps)

Description copied from interface: TextureBuilder

Sets if this generator auto-generates mipmaps on or after data transfer. By default, this is false.

Specified by:

setAutoGenerateMipMaps in interface TextureBuilder

Parameters:

autoGenerateMipMaps - true to auto-generate mipmaps for this texture.

Returns:

this builder.

setAnisotropy

public TextureBuilder setAnisotropy(float anisotropy)

Description copied from interface: TextureBuilder

Sets texture anisotropy level. By default, this is 1.0f.

Specified by:

setAnisotropy in interface TextureBuilder

Parameters:

anisotropy - the anisotropy level (1.0f or less = no anisotropy).

Returns:

this builder.

addTextureImage

public TextureBuilder addTextureImage(BufferedImage... images)

Description copied from interface: TextureBuilder

Adds one or more textures to a mipmap level.

Each image in the batch past the first is considered part of the depth dimension (an array of 4 images implies a depth of 4, height of 4 if 1D Array). If texture cube, then this expects 6 textures in the order: PX, NX, PY, NY, PZ, NZ.

The first call to this is the topmost level, and each subsequent call is the next lower mipmap level. Every texture past the first one is ignored if mipmap auto-generation is enabled.

Specified by:

addTextureImage in interface TextureBuilder

Parameters:

images - the image to add at this level.

Returns:

this builder.

store1D

protected void store1D(OGL11Graphics gl,
 Function<BufferedImage, ByteBuffer> dataFunc,
 ColorFormat colorFormat,
 TextureFormat textureFormat)

store2D

protected void store2D(OGL11Graphics gl,
 Function<BufferedImage, ByteBuffer> dataFunc,
 ColorFormat colorFormat,
 TextureFormat textureFormat)

store1DArray

protected void store1DArray(OGL11Graphics gl,
 Function<BufferedImage[], ByteBuffer> dataArrayFunc,
 ColorFormat colorFormat,
 TextureFormat textureFormat)

store2DArray

protected void store2DArray(OGL12Graphics gl,
 Function<BufferedImage[], ByteBuffer> dataArrayFunc,
 ColorFormat colorFormat,
 TextureFormat textureFormat)

storeCube

protected void storeCube(OGL13Graphics gl,
 Function<BufferedImage, ByteBuffer> dataFunc,
 ColorFormat colorFormat,
 TextureFormat textureFormat)

store3D

protected void store3D(OGL12Graphics gl,
 Function<BufferedImage[], ByteBuffer> dataArrayFunc,
 ColorFormat colorFormat,
 TextureFormat textureFormat)