public class Texture2D extends Texture
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.
Canvas3D.queryProperties()| Modifier and Type | Field and Description |
|---|---|
static int |
ALLOW_DETAIL_TEXTURE_READ
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
Specifies that this Texture object allows reading its detail
texture information (e.g., detail texture image, detail texture mode,
detail texture function, detail texture function points count,
detail texture level)
|
static int |
DETAIL_ADD
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
Adds the detail texture image to the level 0 image of this texture
object
|
static int |
DETAIL_MODULATE
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
Modulates the detail texture image with the level 0 image of this
texture object
|
static int |
LINEAR_DETAIL
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
Performs linear sampling in both the base level
texture image and the detail texture image, and combines the two
texture values according to the detail texture mode.
|
static int |
LINEAR_DETAIL_ALPHA
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
Performs linear detail for the alpha
component only. The rgb components are computed using
BASE_LEVEL_LINEAR filter.
|
static int |
LINEAR_DETAIL_RGB
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
Performs linear detail for the rgb
components only. The alpha component is computed using
BASE_LEVEL_LINEAR filter.
|
ALLOW_ANISOTROPIC_FILTER_READ, ALLOW_BOUNDARY_COLOR_READ, ALLOW_BOUNDARY_MODE_READ, ALLOW_ENABLE_READ, ALLOW_ENABLE_WRITE, ALLOW_FILTER_READ, ALLOW_FILTER4_READ, ALLOW_FORMAT_READ, ALLOW_IMAGE_READ, ALLOW_IMAGE_WRITE, ALLOW_LOD_RANGE_READ, ALLOW_LOD_RANGE_WRITE, ALLOW_MIPMAP_MODE_READ, ALLOW_SHARPEN_TEXTURE_READ, ALLOW_SIZE_READ, ALPHA, ANISOTROPIC_NONE, ANISOTROPIC_SINGLE_VALUE, BASE_LEVEL, BASE_LEVEL_LINEAR, BASE_LEVEL_POINT, CLAMP, CLAMP_TO_BOUNDARY, CLAMP_TO_EDGE, FASTEST, FILTER4, INTENSITY, LINEAR_SHARPEN, LINEAR_SHARPEN_ALPHA, LINEAR_SHARPEN_RGB, LUMINANCE, LUMINANCE_ALPHA, MULTI_LEVEL_LINEAR, MULTI_LEVEL_MIPMAP, MULTI_LEVEL_POINT, NICEST, RGB, RGBA, WRAP| Constructor and Description |
|---|
Texture2D()
Constructs a texture object using default values.
|
Texture2D(int mipMapMode,
int format,
int width,
int height)
Constructs an empty Texture2D object with specified mipmapMode
format, width and height.
|
Texture2D(int mipMapMode,
int format,
int width,
int height,
int boundaryWidth)
Constructs an empty Texture2D object with specified mipMapMode,
format, width, height, and boundaryWidth.
|
| Modifier and Type | Method and Description |
|---|---|
NodeComponent |
cloneNodeComponent()
Deprecated.
replaced with cloneNodeComponent(boolean forceDuplicate)
|
void |
duplicateNodeComponent(NodeComponent originalNodeComponent)
Deprecated.
replaced with duplicateNodeComponent(
NodeComponent originalNodeComponent, boolean forceDuplicate)
|
ImageComponent2D |
getDetailImage()
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
getDetailTextureFunc(float[] lod,
float[] pts)
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
getDetailTextureFunc(Point2f[] pts)
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
int |
getDetailTextureFuncPointsCount()
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
int |
getDetailTextureLevel()
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
int |
getDetailTextureMode()
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
setDetailImage(ImageComponent2D detailTexture)
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
setDetailTextureFunc(float[] lod,
float[] pts)
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
setDetailTextureFunc(Point2f[] pts)
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
setDetailTextureLevel(int level)
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
setDetailTextureMode(int mode)
Deprecated.
As of Java 3D 1.5 the optional detail texture feature is no
longer supported.
|
void |
setMagFilter(int magFilter)
Sets the magnification filter function.
|
getAnisotropicFilterDegree, getAnisotropicFilterMode, getBaseLevel, getBoundaryColor, getBoundaryModeS, getBoundaryModeT, getBoundaryWidth, getEnable, getFilter4Func, getFilter4FuncPointsCount, getFormat, getHeight, getImage, getImages, getLodOffset, getMagFilter, getMaximumLevel, getMaximumLOD, getMinFilter, getMinimumLOD, getMipMapMode, getSharpenTextureFunc, getSharpenTextureFunc, getSharpenTextureFuncPointsCount, getWidth, numMipMapLevels, setAnisotropicFilterDegree, setAnisotropicFilterMode, setBaseLevel, setBoundaryColor, setBoundaryColor, setBoundaryModeS, setBoundaryModeT, setEnable, setFilter4Func, setImage, setImages, setLodOffset, setLodOffset, setMaximumLevel, setMaximumLOD, setMinFilter, setMinimumLOD, setMipMapMode, setSharpenTextureFunc, setSharpenTextureFunccloneNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTreeclearCapability, clearCapabilityIsFrequent, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferencespublic static final int ALLOW_DETAIL_TEXTURE_READ
public static final int LINEAR_DETAIL
setMagFilter(int),
Constant Field Valuespublic static final int LINEAR_DETAIL_RGB
setMagFilter(int),
Constant Field Valuespublic static final int LINEAR_DETAIL_ALPHA
setMagFilter(int),
Constant Field Valuespublic static final int DETAIL_ADD
setDetailTextureMode(int),
Constant Field Valuespublic static final int DETAIL_MODULATE
setDetailTextureMode(int),
Constant Field Valuespublic Texture2D()
Note that the default constructor creates a texture object with a width and height of 0 and is, therefore, not useful.
public Texture2D(int mipMapMode,
int format,
int width,
int height)
mipMapMode - type of mipmap for this Texture: One of
BASE_LEVEL, MULTI_LEVEL_MIPMAP.format - data format of Textures saved in this object.
One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBA.width - width of image at level 0.height - height of image at level 0.IllegalArgumentException - if width or height are NOT
greater than 0 OR invalid format/mipmapMode is specified.public Texture2D(int mipMapMode,
int format,
int width,
int height,
int boundaryWidth)
mipMapMode is set to
BASE_LEVEL, then the image at level 0 must be set
by the application (using either the setImage or
setImages method). If mipMapMode is
set to MULTI_LEVEL_MIPMAP, then images for levels
Base Level through Maximum Level must be set.
Note that a texture with a non-power-of-two width or height will
only be rendered on a graphics device that supports non-power-of-two
textures.mipMapMode - type of mipmap for this Texture: one of
BASE_LEVEL, MULTI_LEVEL_MIPMAPformat - data format of Textures saved in this object.
One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBAwidth - width of image at level 0. This
does not include the width of the boundary.height - height of image at level 0. This
does not include the width of the boundary.boundaryWidth - width of the boundary, which must be 0 or 1.IllegalArgumentException - if width or height are not greater
than 0, if an invalid format or mipMapMode is specified, or
if the boundaryWidth is < 0 or > 1public void setMagFilter(int magFilter)
setMagFilter in class TexturemagFilter - the magnification filter, one of:
FASTEST, NICEST, BASE_LEVEL_POINT, BASE_LEVEL_LINEAR,
LINEAR_DETAIL, LINEAR_DETAIL_RGB, LINEAR_DETAIL_ALPHA,
LINEAR_SHARPEN, LINEAR_SHARPEN_RGB, LINEAR_SHARPEN_ALPHA, or FILTER4.RestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException - if minFilter
is a value other than FASTEST, NICEST,
BASE_LEVEL_POINT, BASE_LEVEL_LINEAR,
LINEAR_DETAIL, LINEAR_DETAIL_RGB,
LINEAR_DETAIL_ALPHA,
LINEAR_SHARPEN, LINEAR_SHARPEN_RGB,
LINEAR_SHARPEN_ALPHA, or
FILTER4.Canvas3D.queryProperties()public void setDetailImage(ImageComponent2D detailTexture)
detailTexture - ImageComponent2D object containing the
detail texture image.RestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()public ImageComponent2D getDetailImage()
CapabilityNotSetException - if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setDetailTextureMode(int mode)
mode - detail texture mode. One of: DETAIL_ADD or DETAIL_MODULATEIllegalArgumentException - if
mode is a value other than
DETAIL_ADD, or DETAIL_MODULATERestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()public int getDetailTextureMode()
CapabilityNotSetException - if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setDetailTextureLevel(int level)
level - the detail texture level.IllegalArgumentException - if level < 0RestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()public int getDetailTextureLevel()
CapabilityNotSetException - if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setDetailTextureFunc(float[] lod,
float[] pts)
lod - array containing the level-of-detail values.pts - array containing the function values for the corresponding
level-of-detail values.IllegalStateException - if the length of lod
does not match the length of ptsRestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()public void setDetailTextureFunc(Point2f[] pts)
pts - array of Point2f containing the lod as well as the
corresponding function value.RestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()public int getDetailTextureFuncPointsCount()
CapabilityNotSetException - if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void getDetailTextureFunc(float[] lod,
float[] pts)
lod - the array to receive the level-of-detail values.pts - the array to receive the function values for the
corresponding level-of-detail values.CapabilityNotSetException - if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void getDetailTextureFunc(Point2f[] pts)
pts - the array to receive the detail texture LOD function pointsCapabilityNotSetException - if appropriate capability is
not set and this object is part of live or compiled scene graphpublic NodeComponent cloneNodeComponent()
cloneNodeComponent in class NodeComponentpublic void duplicateNodeComponent(NodeComponent originalNodeComponent)
duplicateNodeComponent in class NodeComponentCopyright © 2016–2022 SciJava. All rights reserved.