com.jme3.texture

Enum Texture.MinFilter

java.lang.Object

java.lang.Enum<Texture.MinFilter>

com.jme3.texture.Texture.MinFilter

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Texture.MinFilter>

Enclosing class:

Texture

public static enum Texture.MinFilter
extends java.lang.Enum<Texture.MinFilter>

Enum Constant Summary

Enum Constants

Enum Constant and Description
BilinearNearestMipMap Same as BilinearNoMipMaps except that instead of using samples from texture level 0, the closest mipmap level is chosen based on distance.
BilinearNoMipMaps In this method the four nearest texels to the pixel center are sampled (at texture level 0), and their colors are combined by weighted averages.
NearestLinearMipMap Similar to NearestNeighborNoMipMaps except that instead of using samples from texture level 0, a sample is chosen from each of the closest (by distance) two mipmap levels.
NearestNearestMipMap Same as NearestNeighborNoMipMaps except that instead of using samples from texture level 0, the closest mipmap level is chosen based on distance.
NearestNoMipMaps Nearest neighbor interpolation is the fastest and crudest filtering method - it simply uses the color of the texel closest to the pixel center for the pixel color.
Trilinear Trilinear filtering is a remedy to a common artifact seen in mipmapped bilinearly filtered images: an abrupt and very noticeable change in quality at boundaries where the renderer switches from one mipmap level to the next.

Method Summary

Modifier and Type	Method and Description
boolean	usesMipMapLevels()
static Texture.MinFilter	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static Texture.MinFilter[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

NearestNoMipMaps

public static final Texture.MinFilter NearestNoMipMaps

Nearest neighbor interpolation is the fastest and crudest filtering method - it simply uses the color of the texel closest to the pixel center for the pixel color. While fast, this results in aliasing and shimmering during minification. (GL equivalent: GL_NEAREST)

BilinearNoMipMaps

public static final Texture.MinFilter BilinearNoMipMaps

In this method the four nearest texels to the pixel center are sampled (at texture level 0), and their colors are combined by weighted averages. Though smoother, without mipmaps it suffers the same aliasing and shimmering problems as nearest NearestNeighborNoMipMaps. (GL equivalent: GL_LINEAR)

NearestNearestMipMap

public static final Texture.MinFilter NearestNearestMipMap

Same as NearestNeighborNoMipMaps except that instead of using samples from texture level 0, the closest mipmap level is chosen based on distance. This reduces the aliasing and shimmering significantly, but does not help with blockiness. (GL equivalent: GL_NEAREST_MIPMAP_NEAREST)

BilinearNearestMipMap

public static final Texture.MinFilter BilinearNearestMipMap

Same as BilinearNoMipMaps except that instead of using samples from texture level 0, the closest mipmap level is chosen based on distance. By using mipmapping we avoid the aliasing and shimmering problems of BilinearNoMipMaps. (GL equivalent: GL_LINEAR_MIPMAP_NEAREST)

NearestLinearMipMap

public static final Texture.MinFilter NearestLinearMipMap

Similar to NearestNeighborNoMipMaps except that instead of using samples from texture level 0, a sample is chosen from each of the closest (by distance) two mipmap levels. A weighted average of these two samples is returned. (GL equivalent: GL_NEAREST_MIPMAP_LINEAR)

Trilinear

public static final Texture.MinFilter Trilinear

Trilinear filtering is a remedy to a common artifact seen in mipmapped bilinearly filtered images: an abrupt and very noticeable change in quality at boundaries where the renderer switches from one mipmap level to the next. Trilinear filtering solves this by doing a texture lookup and bilinear filtering on the two closest mipmap levels (one higher and one lower quality), and then linearly interpolating the results. This results in a smooth degradation of texture quality as distance from the viewer increases, rather than a series of sudden drops. Of course, closer than Level 0 there is only one mipmap level available, and the algorithm reverts to bilinear filtering (GL equivalent: GL_LINEAR_MIPMAP_LINEAR)

Method Detail

values

public static Texture.MinFilter[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Texture.MinFilter c : Texture.MinFilter.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Texture.MinFilter valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

usesMipMapLevels

public boolean usesMipMapLevels()