|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.media.j3d.SceneGraphObject
javax.media.j3d.NodeComponent
javax.media.j3d.Texture
javax.media.j3d.Texture3D
public class Texture3D
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.
Note that as of Java 3D 1.5, 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()
Field Summary |
---|
Fields inherited from class javax.media.j3d.NodeComponent |
---|
forceDuplicate |
Fields inherited from class javax.media.j3d.SceneGraphObject |
---|
nodeHashtable, retained |
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. |
|
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. |
Method Summary | |
---|---|
NodeComponent |
cloneNodeComponent()
Deprecated. replaced with cloneNodeComponent(boolean forceDuplicate) |
(package private) void |
createRetained()
Creates a retained mode Texture3DRetained object that this Texture3D component object will point to. |
(package private) void |
duplicateAttributes(NodeComponent originalNodeComponent,
boolean forceDuplicate)
Copies all node information from originalNodeComponent into
the current node. |
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.NodeComponent |
---|
checkDuplicateNodeComponent, cloneNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTree, validateImageIllegalSharing |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
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 > 1Method Detail |
---|
public void setBoundaryModeR(int boundaryModeR)
boundaryModeR
- the boundary mode for the R coordinate,
one of: CLAMP, WRAP, CLAMP_TO_EDGE, or CLAMP_TO_BOUNDARY
RestrictedAccessException
- 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 graphvoid createRetained()
createRetained
in class NodeComponent
public NodeComponent cloneNodeComponent()
cloneNodeComponent
in class NodeComponent
public void duplicateNodeComponent(NodeComponent originalNodeComponent)
duplicateNodeComponent
in class NodeComponent
void duplicateAttributes(NodeComponent originalNodeComponent, boolean forceDuplicate)
originalNodeComponent
into
the current node. This method is called from the
duplicateNode
method. This routine does
the actual duplication of all "local data" (any data defined in
this object).
duplicateAttributes
in class Texture
originalNodeComponent
- the original node to duplicate.forceDuplicate
- when set to true
, causes the
duplicateOnCloneTree
flag to be ignored. When
false
, the value of each node's
duplicateOnCloneTree
variable determines whether
NodeComponent data is duplicated or copied.Node.cloneTree()
,
NodeComponent.setDuplicateOnCloneTree(boolean)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |