public class Texture3D extends Texture
The texture width, height, and depth 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, height, or depth that are not an exact power of two are ignored for that canvas.
Canvas3D.queryProperties()
ALLOW_ANISOTROPIC_FILTER_READ, ALLOW_BOUNDARY_COLOR_READ, ALLOW_BOUNDARY_MODE_READ, ALLOW_ENABLE_READ, ALLOW_ENABLE_WRITE, ALLOW_FILTER_READ, ALLOW_FORMAT_READ, ALLOW_IMAGE_READ, ALLOW_IMAGE_WRITE, ALLOW_LOD_RANGE_READ, ALLOW_LOD_RANGE_WRITE, ALLOW_MIPMAP_MODE_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, INTENSITY, LUMINANCE, LUMINANCE_ALPHA, MULTI_LEVEL_LINEAR, MULTI_LEVEL_MIPMAP, MULTI_LEVEL_POINT, NICEST, RGB, RGBA, WRAP
Constructor and Description |
---|
Texture3D()
Constructs a Texture3D object with default parameters.
|
Texture3D(int mipmapMode,
int format,
int width,
int height,
int depth)
Constructs an empty Texture3D object with specified mipmapMode
format, width, height, and depth.
|
Texture3D(int mipmapMode,
int format,
int width,
int height,
int depth,
int boundaryWidth)
Constructs an empty Texture3D object with specified mipmapMode
format, width, height, depth, 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)
|
int |
getBoundaryModeR()
Retrieves the boundary mode for the R coordinate.
|
int |
getDepth()
Retrieves the depth of this Texture3D object.
|
void |
setBoundaryModeR(int boundaryModeR)
Sets the boundary mode for the R coordinate in this texture object.
|
getAnisotropicFilterDegree, getAnisotropicFilterMode, getBaseLevel, getBoundaryColor, getBoundaryModeS, getBoundaryModeT, getBoundaryWidth, getEnable, getFormat, getHeight, getImage, getImages, getLodOffset, getMagFilter, getMaximumLevel, getMaximumLOD, getMinFilter, getMinimumLOD, getMipMapMode, getWidth, numMipMapLevels, setAnisotropicFilterDegree, setAnisotropicFilterMode, setBaseLevel, setBoundaryColor, setBoundaryColor, setBoundaryModeS, setBoundaryModeT, setEnable, setImage, setImages, setLodOffset, setLodOffset, setMagFilter, setMaximumLevel, setMaximumLOD, setMinFilter, setMinimumLOD, setMipMapMode
cloneNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTree
clearCapability, clearCapabilityIsFrequent, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferences
public Texture3D()
Note that the default constructor creates a texture object with a width, height, and depth of 0 and is, therefore, not useful.
public Texture3D(int mipmapMode, int format, int width, int height, int depth)
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.depth
- depth of image at level 0.java.lang.IllegalArgumentException
- if width, height, or depth are not
greater than 0 OR invalid format/mipmapMode is specified.public Texture3D(int mipmapMode, int format, int width, int height, int depth, int boundaryWidth)
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. 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.depth
- depth 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.java.lang.IllegalArgumentException
- if width, height, or depth are not
greater than 0 OR invalid format/mipmapMode is specified, or
if the boundaryWidth is < 0 or > 1public void setBoundaryModeR(int boundaryModeR)
boundaryModeR
- the boundary mode for the R coordinate,
one of: CLAMP, WRAP, CLAMP_TO_EDGE, or CLAMP_TO_BOUNDARYRestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.java.lang.IllegalArgumentException
- if boundaryModeR
is a value other than CLAMP
, WRAP
,
CLAMP_TO_EDGE
, or CLAMP_TO_BOUNDARY
.public int getBoundaryModeR()
RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.public int getDepth()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic NodeComponent cloneNodeComponent()
cloneNodeComponent
in class NodeComponent
public void duplicateNodeComponent(NodeComponent originalNodeComponent)
duplicateNodeComponent
in class NodeComponent