javax.media.j3d
Class Texture3D
java.lang.Object
|
+--javax.media.j3d.SceneGraphObject
|
+--javax.media.j3d.NodeComponent
|
+--javax.media.j3d.Texture
|
+--javax.media.j3d.Texture3D
- public class Texture3D
- extends Texture
Texture3D is a subclass of Texture class. It extends Texture
class by adding a third coordinate, constructor and a mutator
method for setting a 3D texture image.
If 3D texture mapping is not supported on a particular Canvas3D,
3D texture mapping is ignored for that canvas.
- See Also:
Canvas3D.queryProperties()
Fields inherited from class javax.media.j3d.Texture |
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_MIPMAP_MODE_READ,
ALLOW_SIZE_READ,
ALPHA,
BASE_LEVEL,
BASE_LEVEL_LINEAR,
BASE_LEVEL_POINT,
CLAMP,
FASTEST,
INTENSITY,
LUMINANCE,
LUMINANCE_ALPHA,
MULTI_LEVEL_LINEAR,
MULTI_LEVEL_MIPMAP,
MULTI_LEVEL_POINT,
NICEST,
RGB,
RGBA,
WRAP |
Constructor Summary |
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. |
Method Summary |
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. |
Methods inherited from class javax.media.j3d.Texture |
getBoundaryColor,
getBoundaryModeS,
getBoundaryModeT,
getEnable,
getFormat,
getHeight,
getImage,
getImages,
getMagFilter,
getMinFilter,
getMipMapMode,
getWidth,
numMipMapLevels,
setBoundaryColor,
setBoundaryColor,
setBoundaryModeS,
setBoundaryModeT,
setEnable,
setImage,
setImages,
setMagFilter,
setMinFilter,
setMipMapMode |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Texture3D
public Texture3D()
- Constructs a Texture3D object with default parameters.
The default values are as follows:
depth : 0
boundary mode R : WRAP
Note that the default constructor creates a texture object with
a width, height, and depth of 0 and is, therefore, not useful.
Texture3D
public Texture3D(int mipmapMode,
int format,
int width,
int height,
int depth)
- Constructs an empty Texture3D object with specified mipmapMode
format, width, height, and depth. Image at level 0 must be set by
the application using 'setImage' method. If mipmapMode is
set to MULTI_LEVEL_MIPMAP, images for ALL levels must be set.
- Parameters:
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. Must be power of 2.height
- height of image at level 0. Must be power of 2.depth
- depth of image at level 0. Must be power of 2.- Throws:
- java.lang.IllegalArgumentException - if width or height are NOT
power of 2 OR invalid format/mipmapMode is specified.
setBoundaryModeR
public void setBoundaryModeR(int boundaryModeR)
- Sets the boundary mode for the R coordinate in this texture object.
- Parameters:
boundaryModeR
- the boundary mode for the R coordinate,
one of: CLAMP or WRAP.- Throws:
- RestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.
getBoundaryModeR
public int getBoundaryModeR()
- Retrieves the boundary mode for the R coordinate.
- Returns:
- the current boundary mode for the R coordinate.
- Throws:
- RestrictedAccessException - if the method is called
when this object is part of live or compiled scene graph.
getDepth
public int getDepth()
- Retrieves the depth of this Texture3D object.
- Returns:
- the depth of this Texture3D object.
- Throws:
- CapabilityNotSetException - if appropriate capability is
not set and this object is part of live or compiled scene graph
- Since:
- Java 3D 1.2
cloneNodeComponent
public NodeComponent cloneNodeComponent()
- Deprecated. replaced with cloneNodeComponent(boolean forceDuplicate)
- Overrides:
- cloneNodeComponent in class NodeComponent
duplicateNodeComponent
public void duplicateNodeComponent(NodeComponent originalNodeComponent)
- Deprecated. replaced with duplicateNodeComponent(
NodeComponent originalNodeComponent, boolean forceDuplicate)
- NOTE: Applications should not call this method directly.
It should only be called by the cloneNode method.
- Overrides:
- duplicateNodeComponent in class NodeComponent