Java Doc for Texture.java in  » 6.0-JDK-Modules » java-3d » javax » media » j3d » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Each Texture object has the following properties:

• Boundary color - the texture boundary color. The texture boundary color is used when the boundaryModeS and boundaryModeT parameters are set to CLAMP or CLAMP_TO_BOUNDARY and if the texture boundary is not specified.
• Boundary Width - the texture boundary width, which must be 0 or 1. If the texture boundary width is 1, then all images for all mipmap levels will include a border. The actual texture image for level 0, for example, will be of dimension (width + 2*boundaryWidth) * (height + 2*boundaryWidth). The boundary texels will be used when linear filtering is to be applied.
• Boundary ModeS and Boundary ModeT - the boundary mode for the S and T coordinates, respectively. The boundary modes are as follows:
• CLAMP - clamps texture coordinates to be in the range [0,1]. Texture boundary texels or the constant boundary color if boundary width is 0 will be used for U,V values that fall outside this range.
• WRAP - repeats the texture by wrapping texture coordinates that are outside the range [0,1]. Only the fractional portion of the texture coordinates is used. The integer portion is discarded
• CLAMP_TO_EDGE - clamps texture coordinates such that filtering will not sample a texture boundary texel. Texels at the edge of the texture will be used instead.
• CLAMP_TO_BOUNDARY - clamps texture coordinates such that filtering will sample only texture boundary texels, that is, it will never get some samples from the boundary and some from the edge. This will ensure clean unfiltered boundaries. If the texture does not have a boundary, that is the boundary width is equal to 0, then the constant boundary color will be used.

• Image - an image or an array of images for all the mipmap levels. If only one image is provided, the MIPmap mode must be set to BASE_LEVEL.
• Magnification filter - the magnification filter function. Used when the pixel being rendered maps to an area less than or equal to one texel. The magnification filter functions are as follows:
• FASTEST - uses the fastest available method for processing geometry.
• NICEST - uses the nicest available method for processing geometry.
• BASE_LEVEL_POINT - selects the nearest texel in the base level texture image.
• BASE_LEVEL_LINEAR - performs a bilinear interpolation on the four nearest texels in the base level texture image. The texture value T' is computed as follows:
i₀ = trunc(u - 0.5)

j₀ = trunc(v - 0.5)

i₁ = i₀ + 1

j₁ = j₀ + 1

a = frac(u - 0.5)

b = frac(v - 0.5)

T' = (1-a)*(1-b)*T_i0j0 + a*(1-b)*T_i1j0 + (1-a)*b*T_i0j1 + a*b*T_i1j1

• LINEAR_SHARPEN - sharpens the resulting image by extrapolating from the base level plus one image to the base level image of this texture object.
• LINEAR_SHARPEN_RGB - performs linear sharpen filter for the rgb components only. The alpha component is computed using BASE_LEVEL_LINEAR filter.
• LINEAR_SHARPEN_ALPHA - performs linear sharpen filter for the alpha component only. The rgb components are computed using BASE_LEVEL_LINEAR filter.
• FILTER4 - applies an application-supplied weight function on the nearest 4x4 texels in the base level texture image. The texture value T' is computed as follows:

i1 = trunc(u - 0.5)	i2 = i1 + 1	i3 = i2 + 1	i0 = i1 - 1
j1 = trunc(v - 0.5)	j3 = j2 + 1	j2 = j1 + 1	j0 = j1 - 1
a = frac(u - 0.5)
b = frac(v - 0.5)

f(x) : filter4 function where 0<=x<=2

T' = f(1+a) * f(1+b) * T_i0j0 + f(a) * f(1+b) * T_i1j0 + f(1-a) * f(1+b) * T_i2j0 + f(2-a) * f(1+b) * T_i3j0 +
f(1+a) * f(b) * T_i0j1 + f(a) * f(b) * T_i1j1 + f(1-a) * f(b) * T_i2j1 + f(2-a) * f(b) * T_i3j1 +
f(1+a) * f(1-b) * T_i0j2 + f(a) * f(1-b) * T_i1j2 + f(1-a) * f(1-b) * T_i2j2 + f(2-a) * f(1-b) * T_i3j2 +
f(1+a) * f(2-b) * T_i0j3 + f(a) * f(2-b) * T_i1j3 + f(1-a) * f(2-b) * T_i2j3 + f(2-a) * f(2-b) * T_i3j3

• Minification filter - the minification filter function. Used when the pixel being rendered maps to an area greater than one texel. The minifaction filter functions are as follows:
• FASTEST - uses the fastest available method for processing geometry.
• NICEST - uses the nicest available method for processing geometry.
• BASE_LEVEL_POINT - selects the nearest level in the base level texture map.
• BASE_LEVEL_LINEAR - performs a bilinear interpolation on the four nearest texels in the base level texture map.
• MULTI_LEVEL_POINT - selects the nearest texel in the nearest mipmap.
• MULTI_LEVEL_LINEAR - performs trilinear interpolation of texels between four texels each from the two nearest mipmap levels.
• FILTER4 - applies an application-supplied weight function on the nearest 4x4 texels in the base level texture image.

• MIPmap mode - the mode used for texture mapping for this object. The mode is one of the following:
• BASE_LEVEL - indicates that this Texture object only has a base-level image. If multiple levels are needed, they will be implicitly computed.
• MULTI_LEVEL_MIPMAP - indicates that this Texture object has multiple images. If MIPmap mode is set to MULTI_LEVEL_MIPMAP, images for Base Level through Max Level must be set.

• Format - the data format. The format is one of the following:
• INTENSITY - the texture image contains only texture values.
• LUMINANCE - the texture image contains only luminance values.
• ALPHA - the texture image contains only alpha values.
• LUMINANCE_ALPHA - the texture image contains both luminance and alpha values.
• RGB - the texture image contains red, green, and blue values.
• RGBA - the texture image contains red, green, blue, and alpha values.

• Base Level - specifies the mipmap level to be used when filter specifies BASE_LEVEL_POINT or BASE_LEVEL_LINEAR.
• Maximum Level - specifies the maximum level of image that needs to be defined for this texture to be valid. Note, for this texture to be valid, images for Base Level through Maximum Level have to be defined.
• Minimum LOD - specifies the minimum of the LOD range. LOD smaller than this value will be clamped to this value.
• Maximum LOD - specifies the maximum of the LOD range. LOD larger than this value will be clamped to this value.
• LOD offset - specifies the offset to be used in the LOD calculation to compensate for under or over sampled texture images.
• Anisotropic Mode - defines how anisotropic filter is applied for this texture object. The anisotropic modes are as follows:
• ANISOTROPIC_NONE - no anisotropic filtering.
• ANISOTROPIC_SINGLE_VALUE - applies the degree of anisotropic filter in both the minification and magnification filters.

• Anisotropic Filter Degree - controls the degree of anisotropy. This property applies to both minification and magnification filtering. If it is equal to 1.0, then an isotropic filtering as specified in the minification or magnification filter will be used. If it is greater than 1.0, and the anisotropic mode is equal to ANISOTROPIC_SINGLE_VALUE, then the degree of anisotropy will also be applied in the filtering.
• Sharpen Texture Function - specifies the function of level-of-detail used in combining the texture value computed from the base level image and the texture value computed from the base level plus one image. The final texture value is computed as follows:
T' = ((1 + SharpenFunc(LOD)) * T_BaseLevel) - (SharpenFunc(LOD) * T_BaseLevel+1)

• Filter4 Function - specifies the function to be applied to the nearest 4x4 texels. This property includes samples of the filter function f(x), 0<=x<=2. The number of function values supplied has to be equal to 2^m + 1 for some integer value of m greater than or equal to 4.

Note that as of Java 3D 1.5, the texture width and height are no longer required to be an exact power of two. However, not all graphics devices supports non-power-of-two textures. If non-power-of-two texture mapping is unsupported on a particular Canvas3D, textures with a width or height that are not an exact power of two are ignored for that canvas.
See Also:   Canvas3D.queryProperties

enable flag : true
width : 0
height : 0
mipmap mode : BASE_LEVEL
format : RGB
boundary mode S : WRAP
boundary mode T : WRAP
min filter : BASE_LEVEL_POINT
mag filter : BASE_LEVEL_POINT
boundary color : black (0,0,0,0)
boundary width : 0
array of images : null
baseLevel : 0
maximumLevel : log2(max(width,height))
minimumLOD : -1000.0
maximumLOD : 1000.0
lod offset : (0, 0, 0)
anisotropic mode : ANISOTROPIC_NONE
anisotropic filter : 1.0
sharpen texture func: null
filter4 func: null

Note that the default constructor creates a texture object with a width and height of 0 and is, therefore, not useful.