| java.lang.Object
 javax.media.j3d.SceneGraphObject
javax.media.j3d.NodeComponent
javax.media.j3d.Texture
javax.media.j3d.Texture3D
| Texture3D | | public class Texture3D extends Texture (Code) | | 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.
See Also: Canvas3D.queryProperties |
| Constructor Summary | |
| public | Texture3D()
Constructs a Texture3D object with default parameters. | | 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. | | public | 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. |
| Texture3D | | public Texture3D()(Code) | | 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)(Code) | | Constructs an empty Texture3D object with specified mipmapMode
format, width, height, and depth. Image at base level must be set by
the application using 'setImage' method. If mipmapMode is
set to MULTI_LEVEL_MIPMAP, images for base level through
maximum level must be set.
Note that a texture with a non-power-of-two width, height, or depth will
only be rendered on a graphics device that supports non-power-of-two
textures.
Parameters:
mipmapMode - type of mipmap for this Texture: One ofBASE_LEVEL, MULTI_LEVEL_MIPMAP.
Parameters:
format - data format of Textures saved in this object.One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBA.
Parameters:
width - width of image at level 0.
Parameters:
height - height of image at level 0.
Parameters:
depth - depth of image at level 0.
exception:
IllegalArgumentException - if width, height, or depth are notgreater than 0 OR invalid format/mipmapMode is specified. |
| Texture3D | | public Texture3D(int mipmapMode, int format, int width, int height, int depth, int boundaryWidth)(Code) | | Constructs an empty Texture3D object with specified mipmapMode
format, width, height, depth, and boundaryWidth.
Image at base level must be set by
the application using 'setImage' method. If mipmapMode is
set to MULTI_LEVEL_MIPMAP, images for base level through
maximum level must be set.
Note that a texture with a non-power-of-two width, height, or depth will
only be rendered on a graphics device that supports non-power-of-two
textures.
Parameters:
mipmapMode - type of mipmap for this Texture: One ofBASE_LEVEL, MULTI_LEVEL_MIPMAP.
Parameters:
format - data format of Textures saved in this object.One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBA.
Parameters:
width - width of image at level 0. Thisdoes not include the width of the boundary.
Parameters:
height - height of image at level 0. Thisdoes not include the width of the boundary.
Parameters:
depth - depth of image at level 0. Thisdoes not include the width of the boundary.
Parameters:
boundaryWidth - width of the boundary, which must be 0 or 1.
exception:
IllegalArgumentException - if width, height, or depth are notgreater than 0 OR invalid format/mipmapMode is specified, orif the boundaryWidth is < 0 or > 1
since:
Java 3D 1.3 |
| createRetained | | void createRetained()(Code) | | Creates a retained mode Texture3DRetained object that this
Texture3D component object will point to.
|
| duplicateAttributes | | void duplicateAttributes(NodeComponent originalNodeComponent, boolean forceDuplicate)(Code) | | Copies all node information from 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).
Parameters:
originalNodeComponent - the original node to duplicate.
Parameters:
forceDuplicate - when set to true, causes theduplicateOnCloneTree flag to be ignored. Whenfalse, the value of each node'sduplicateOnCloneTree variable determines whetherNodeComponent data is duplicated or copied.
See Also: Node.cloneTree
See Also: NodeComponent.setDuplicateOnCloneTree |
| duplicateNodeComponent | | public void duplicateNodeComponent(NodeComponent originalNodeComponent)(Code) | | NOTE: Applications should not call this method directly.
It should only be called by the cloneNode method.
|
| getBoundaryModeR | | public int getBoundaryModeR()(Code) | | Retrieves the boundary mode for the R coordinate.
the current boundary mode for the R coordinate.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| getDepth | | public int getDepth()(Code) | | Retrieves the depth of this Texture3D object.
the depth of this Texture3D object.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
since:
Java 3D 1.2 |
| setBoundaryModeR | | public void setBoundaryModeR(int boundaryModeR)(Code) | | Sets the boundary mode for the R coordinate in this texture object.
Parameters:
boundaryModeR - the boundary mode for the R coordinate,one of: CLAMP, WRAP, CLAMP_TO_EDGE, or CLAMP_TO_BOUNDARY
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph.
exception:
IllegalArgumentException - if boundaryModeRis a value other than CLAMP, WRAP,CLAMP_TO_EDGE, or CLAMP_TO_BOUNDARY. |
| Fields inherited from javax.media.j3d.NodeComponent | boolean forceDuplicate(Code)(Java Doc)
|
|
|