| java.lang.Object
 javax.media.j3d.SceneGraphObject
javax.media.j3d.NodeComponent
javax.media.j3d.ImageComponent
javax.media.j3d.ImageComponent3D
| ImageComponent3D | | public class ImageComponent3D extends ImageComponent (Code) | | This class defines a 3D image component. This is used for texture
images.
Prior to Java 3D 1.2, only BufferedImage objects could be used as
the input to an ImageComponent3D object. As of Java 3D 1.2, an
ImageComponent3D accepts an array of arbitrary RenderedImage
objects (BufferedImage is an implementation of the RenderedImage
interface). The methods that set/get a BufferedImage object are
left in for compatibility. The new methods that set/get a
RenderedImage are a superset of the old methods. In particular,
the two set methods in the following example are equivalent:
BufferedImage bi;
RenderedImage ri = bi;
ImageComponent3D ic;
// Set image 0 to the specified BufferedImage
ic.set(0, bi);
// Set image 0 to the specified RenderedImage
ic.set(0, ri);
|
| Inner Class :public static interface Updater | |
| Constructor Summary | |
| | ImageComponent3D()
| | public | ImageComponent3D(int format, int width, int height, int depth)
Constructs a 3D image component object using the specified
format, width, height, and depth. | | public | ImageComponent3D(int format, BufferedImage[] images)
Constructs a 3D image component object using the specified format,
and the BufferedImage array.
The image class is set to ImageClass.BUFFERED_IMAGE.
Default values are used for all other parameters.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of BufferedImage objects. | | public | ImageComponent3D(int format, RenderedImage[] images)
Constructs a 3D image component object using the specified format,
and the RenderedImage array.
The image class is set to ImageClass.BUFFERED_IMAGE.
Default values are used for all other parameters.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of RenderedImage objects. | | public | ImageComponent3D(int format, int width, int height, int depth, boolean byReference, boolean yUp)
Constructs a 3D image component object using the specified
format, width, height, depth, byReference flag, and yUp flag.
Default values are used for all other parameters.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA, etc.
Parameters:
width - the number of columns of pixels in this image componentobject
Parameters:
height - the number of rows of pixels in this image componentobject
Parameters:
depth - the number of 2D slices in this image component object
Parameters:
byReference - a flag that indicates whether the data is copiedinto this image component object or is accessed by reference.
Parameters:
yUp - a flag that indicates the y-orientation of this imagecomponent. | | public | ImageComponent3D(int format, BufferedImage[] images, boolean byReference, boolean yUp)
Constructs a 3D image component object using the specified format,
BufferedImage array, byReference flag, and yUp flag.
The image class is set to ImageClass.BUFFERED_IMAGE.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of BufferedImage objects. | | public | ImageComponent3D(int format, RenderedImage[] images, boolean byReference, boolean yUp)
Constructs a 3D image component object using the specified format,
RenderedImage array, byReference flag, and yUp flag.
The image class is set to ImageClass.RENDERED_IMAGE if the byReference
flag is true and any of the specified RenderedImages is not an
instance of BufferedImage. | | public | ImageComponent3D(int format, NioImageBuffer[] images, boolean byReference, boolean yUp)
Constructs a 3D image component object using the specified format,
NioImageBuffer array, byReference flag, and yUp flag.
The image class is set to ImageClass.NIO_IMAGE_BUFFER.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of NioImageBuffer objects. |
| Method Summary | |
| public NodeComponent | cloneNodeComponent()
| | void | createRetained()
Creates a retained mode ImageComponent3DRetained object that this
ImageComponent3D component object will point to. | | void | duplicateAttributes(NodeComponent originalNodeComponent, boolean forceDuplicate)
Copies all node information from originalNodeComponent into
the current node. | | public int | getDepth()
Retrieves the depth of this 3D image component object. | | public BufferedImage[] | getImage()
Retrieves the images from this ImageComponent3D object. | | public BufferedImage | getImage(int index)
Retrieves one of the images from this ImageComponent3D object. | | public NioImageBuffer[] | getNioImage()
Retrieves the images from this ImageComponent3D object. | | public NioImageBuffer | getNioImage(int index)
Retrieves one of the images from this ImageComponent3D object. | | public RenderedImage[] | getRenderedImage()
Retrieves the images from this ImageComponent3D object. | | public RenderedImage | getRenderedImage(int index)
Retrieves one of the images from this ImageComponent3D object. | | public void | set(BufferedImage[] images)
Sets the array of images in this image component to the
specified array of BufferedImage objects. | | public void | set(RenderedImage[] images)
Sets the array of images in this image component to the
specified array of RenderedImage objects. | | public void | set(NioImageBuffer[] images)
Sets the array of images in this image component to the
specified array of NioImageBuffer objects. | | public void | set(int index, BufferedImage image)
Sets this image component at the specified index to the
specified BufferedImage object. | | public void | set(int index, RenderedImage image)
Sets this image component at the specified index to the
specified RenderedImage object. | | public void | set(int index, NioImageBuffer image)
Sets this image component at the specified index to the
specified NioImageBuffer object. | | public void | setSubImage(int index, RenderedImage image, int width, int height, int srcX, int srcY, int dstX, int dstY)
Modifies a contiguous subregion of a particular slice of
image of this ImageComponent3D object.
Block of data of dimension (width * height)
starting at the offset (srcX, srcY) of the specified
RenderedImage object will be copied into the particular slice of
image component
starting at the offset (dstX, dstY) of this ImageComponent3D object.
The specified RenderedImage object must be of the same format as
the current format of this object.
This method can only be used if the data access mode is
by-copy. | | public void | updateData(Updater updater, int index, int x, int y, int width, int height)
Updates a particular slice of image data that is accessed by reference.
This method calls the updateData method of the specified
ImageComponent3D.Updater object to synchronize updates to the
image data that is referenced by this ImageComponent3D object.
Applications that wish to modify such data must perform all
updates via this method.
The data to be modified has to be within the boundary of the
subregion
specified by the offset (x, y) and the dimension (width*height).
It is illegal to modify data outside this boundary. |
| ImageComponent3D | | ImageComponent3D()(Code) | | |
| ImageComponent3D | | public ImageComponent3D(int format, int width, int height, int depth)(Code) | | Constructs a 3D image component object using the specified
format, width, height, and depth. Default values are used for
all other parameters. The default values are as follows:
array of images : null
imageClass : ImageClass.BUFFERED_IMAGE
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA, etc.
Parameters:
width - the number of columns of pixels in this image componentobject
Parameters:
height - the number of rows of pixels in this image componentobject
Parameters:
depth - the number of 2D slices in this image component object
exception:
IllegalArgumentException - if format is invalid, or ifany of width, height, or depth are not positive. |
| ImageComponent3D | | public ImageComponent3D(int format, BufferedImage[] images)(Code) | | Constructs a 3D image component object using the specified format,
and the BufferedImage array.
The image class is set to ImageClass.BUFFERED_IMAGE.
Default values are used for all other parameters.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of BufferedImage objects. Thefirst image in the array determines the width and height of thisImageComponent3D.
exception:
IllegalArgumentException - if format is invalid, or ifthe width or height of the first image are not positive. |
| ImageComponent3D | | public ImageComponent3D(int format, RenderedImage[] images)(Code) | | Constructs a 3D image component object using the specified format,
and the RenderedImage array.
The image class is set to ImageClass.BUFFERED_IMAGE.
Default values are used for all other parameters.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of RenderedImage objects. Thefirst image in the array determines the width and height of thisImageComponent3D.
exception:
IllegalArgumentException - if format is invalid, or ifthe width or height of the first image are not positive.
since:
Java 3D 1.2 |
| ImageComponent3D | | public ImageComponent3D(int format, int width, int height, int depth, boolean byReference, boolean yUp)(Code) | | Constructs a 3D image component object using the specified
format, width, height, depth, byReference flag, and yUp flag.
Default values are used for all other parameters.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA, etc.
Parameters:
width - the number of columns of pixels in this image componentobject
Parameters:
height - the number of rows of pixels in this image componentobject
Parameters:
depth - the number of 2D slices in this image component object
Parameters:
byReference - a flag that indicates whether the data is copiedinto this image component object or is accessed by reference.
Parameters:
yUp - a flag that indicates the y-orientation of this imagecomponent. If yUp is set to true, the origin of the image isthe lower left; otherwise, the origin of the image is the upperleft.
exception:
IllegalArgumentException - if format is invalid, or ifany of width, height, or depth are not positive.
since:
Java 3D 1.2 |
| ImageComponent3D | | public ImageComponent3D(int format, BufferedImage[] images, boolean byReference, boolean yUp)(Code) | | Constructs a 3D image component object using the specified format,
BufferedImage array, byReference flag, and yUp flag.
The image class is set to ImageClass.BUFFERED_IMAGE.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of BufferedImage objects. Thefirst image in the array determines the width and height of thisImageComponent3D.
Parameters:
byReference - a flag that indicates whether the data is copiedinto this image component object or is accessed by reference.
Parameters:
yUp - a flag that indicates the y-orientation of this imagecomponent. If yUp is set to true, the origin of the image isthe lower left; otherwise, the origin of the image is the upperleft.
exception:
IllegalArgumentException - if format is invalid, or ifthe width or height of the first image are not positive.
since:
Java 3D 1.2 |
| ImageComponent3D | | public ImageComponent3D(int format, RenderedImage[] images, boolean byReference, boolean yUp)(Code) | | Constructs a 3D image component object using the specified format,
RenderedImage array, byReference flag, and yUp flag.
The image class is set to ImageClass.RENDERED_IMAGE if the byReference
flag is true and any of the specified RenderedImages is not an
instance of BufferedImage. In all other cases, the image class is set to
ImageClass.BUFFERED_IMAGE.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of RenderedImage objects. Thefirst image in the array determines the width and height of thisImageComponent3D.
Parameters:
byReference - a flag that indicates whether the data is copiedinto this image component object or is accessed by reference.
Parameters:
yUp - a flag that indicates the y-orientation of this imagecomponent. If yUp is set to true, the origin of the image isthe lower left; otherwise, the origin of the image is the upperleft.
exception:
IllegalArgumentException - if format is invalid, or ifthe width or height of the first image are not positive.
since:
Java 3D 1.2 |
| ImageComponent3D | | public ImageComponent3D(int format, NioImageBuffer[] images, boolean byReference, boolean yUp)(Code) | | Constructs a 3D image component object using the specified format,
NioImageBuffer array, byReference flag, and yUp flag.
The image class is set to ImageClass.NIO_IMAGE_BUFFER.
Parameters:
format - the image component format, one of: FORMAT_RGB,FORMAT_RGBA etc.
Parameters:
images - an array of NioImageBuffer objects. Thefirst image in the array determines the width and height of thisImageComponent3D.
Parameters:
byReference - a flag that indicates whether the data is copiedinto this image component object or is accessed by reference.
Parameters:
yUp - a flag that indicates the y-orientation of this imagecomponent. If yUp is set to true, the origin of the image isthe lower left; otherwise, the origin of the image is the upperleft.
exception:
IllegalArgumentException - if format is invalid, or ifthe width or height of the first image are not positive.
exception:
IllegalArgumentException - if the byReference flag is false.
exception:
IllegalArgumentException - if the yUp flag is false.
exception:
UnsupportedOperationException - this method is not supportedfor Java 3D 1.5.
since:
Java 3D 1.5 |
| createRetained | | void createRetained()(Code) | | Creates a retained mode ImageComponent3DRetained object that this
ImageComponent3D 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 |
| getDepth | | public int getDepth()(Code) | | Retrieves the depth of this 3D image component object.
the depth of this 3D image component object
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph |
| getImage | | public BufferedImage[] getImage()(Code) | | Retrieves the images from this ImageComponent3D object. If the
data access mode is not by-reference, then a copy of the images
is made. If the data access mode is by-reference, then the
references are returned.
either a new array of new BufferedImage objects created fromthe datain this image component, or a new array ofreferences to the BufferedImages that this image component refers to.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is notImageClass.BUFFERED_IMAGE. |
| getImage | | public BufferedImage getImage(int index)(Code) | | Retrieves one of the images from this ImageComponent3D object. If the
data access mode is not by-reference, then a copy of the image
is made. If the data access mode is by-reference, then the
reference is returned.
Parameters:
index - the index of the image to retrieve.The index must be less than the depth of this ImageComponent3D object. either a new BufferedImage object created from the datain this image component, or the BufferedImage object referencedby this image component.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is notImageClass.BUFFERED_IMAGE. |
| getNioImage | | public NioImageBuffer[] getNioImage()(Code) | | Retrieves the images from this ImageComponent3D object. If the
data access mode is not by-reference, then a copy of the images
is made. If the data access mode is by-reference, then the
references are returned.
either a new array of new RenderedImage objects created fromthe datain this image component, or a new array ofreferences to the RenderedImages that this image component refers to.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is notImageClass.NIO_IMAGE_BUFFER.
exception:
UnsupportedOperationException - this method is not supportedfor Java 3D 1.5.
since:
Java 3D 1.5 |
| getNioImage | | public NioImageBuffer getNioImage(int index)(Code) | | Retrieves one of the images from this ImageComponent3D object. If the
data access mode is not by-reference, then a copy of the image
is made. If the data access mode is by-reference, then the
reference is returned.
Parameters:
index - the index of the image to retrieve.The index must be less than the depth of this ImageComponent3D object. either a new NioImageBuffer object created from the datain this image component, or the NioImageBuffer object referencedby this image component.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is notImageClass.NIO_IMAGE_BUFFER.
exception:
UnsupportedOperationException - this method is not supportedfor Java 3D 1.5.
since:
Java 3D 1.5 |
| getRenderedImage | | public RenderedImage[] getRenderedImage()(Code) | | Retrieves the images from this ImageComponent3D object. If the
data access mode is not by-reference, then a copy of the images
is made. If the data access mode is by-reference, then the
references are returned.
either a new array of new RenderedImage objects created fromthe datain this image component, or a new array ofreferences to the RenderedImages that this image component refers to.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is not one of:ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.
since:
Java 3D 1.2 |
| getRenderedImage | | public RenderedImage getRenderedImage(int index)(Code) | | Retrieves one of the images from this ImageComponent3D object. If the
data access mode is not by-reference, then a copy of the image
is made. If the data access mode is by-reference, then the
reference is returned.
Parameters:
index - the index of the image to retrieve.The index must be less than the depth of this ImageComponent3D object. either a new RenderedImage object created from the datain this image component, or the RenderedImage object referencedby this image component.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is not one of:ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.
since:
Java 3D 1.2 |
| set | | public void set(BufferedImage[] images)(Code) | | Sets the array of images in this image component to the
specified array of BufferedImage objects. If the data access
mode is not by-reference, then the BufferedImage data is copied
into this object. If the data access mode is by-reference,
then a shallow copy of the array of references to the
BufferedImage objects is made, but the BufferedImage
data is not necessarily copied.
The image class is set to ImageClass.BUFFERED_IMAGE.
Parameters:
images - array of BufferedImage objects containing the image.The size (width and height) of each image must be the same as thesize of the image component, and the length of the images arraymust equal the depth of the image component.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalArgumentException - if the length of the images array isnot equal to the depth of this ImageComponent object.
exception:
IllegalArgumentException - if the width and height of eachimage in the images array is not equal to the width and height of thisImageComponent object. |
| set | | public void set(RenderedImage[] images)(Code) | | Sets the array of images in this image component to the
specified array of RenderedImage objects. If the data access
mode is not by-reference, then the RenderedImage data is copied
into this object. If the data access mode is by-reference,
then a shallow copy of the array of references to the
RenderedImage objects is made, but the RenderedImage
data is not necessarily copied.
The image class is set to ImageClass.RENDERED_IMAGE if the data access
mode is by-reference and any of the specified RenderedImages
is not an instance of BufferedImage. In all other cases,
the image class is set to ImageClass.BUFFERED_IMAGE.
Parameters:
images - array of RenderedImage objects containing the image.The size (width and height) of each image must be the same as thesize of the image component, and the length of the images arraymust equal the depth of the image component.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalArgumentException - if the length of the images array isnot equal to the depth of this ImageComponent object.
exception:
IllegalArgumentException - if the width and height of eachimage in the images array is not equal to the width and height of thisImageComponent object.
since:
Java 3D 1.2 |
| set | | public void set(NioImageBuffer[] images)(Code) | | Sets the array of images in this image component to the
specified array of NioImageBuffer objects. If the data access
mode is not by-reference, then the NioImageBuffer data is copied
into this object. If the data access mode is by-reference,
then a shallow copy of the array of references to the
NioImageBuffer objects is made, but the NioImageBuffer
data is not necessarily copied.
The image class is set to ImageClass.NIO_IMAGE_BUFFER.
Parameters:
images - array of NioImageBuffer objects containing the image.The size (width and height) of each image must be the same as thesize of the image component, and the length of the images arraymust equal the depth of the image component.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if this ImageComponent objectis not yUp.
exception:
IllegalArgumentException - if the length of the images array isnot equal to the depth of this ImageComponent object.
exception:
IllegalArgumentException - if the width and height of eachimage in the images array is not equal to the width and height of thisImageComponent object.
exception:
UnsupportedOperationException - this method is not supportedfor Java 3D 1.5.
since:
Java 3D 1.5 |
| set | | public void set(int index, BufferedImage image)(Code) | | Sets this image component at the specified index to the
specified BufferedImage object. If the data access mode is not
by-reference, then the BufferedImage data is copied into this
object. If the data access mode is by-reference, then a
reference to the BufferedImage is saved, but the data is not
necessarily copied.
Parameters:
index - the image index.The index must be less than the depth of this ImageComponent3D object.
Parameters:
image - BufferedImage object containing the image.The size (width and height) must be the same as the current size of thisImageComponent3D object.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is notImageClass.BUFFERED_IMAGE.
exception:
IllegalArgumentException - if the width and height the imageis not equal to the width and height of this ImageComponent object. |
| set | | public void set(int index, RenderedImage image)(Code) | | Sets this image component at the specified index to the
specified RenderedImage object. If the data access mode is not
by-reference, then the RenderedImage data is copied into this
object. If the data access mode is by-reference, then a
reference to the RenderedImage is saved, but the data is not
necessarily copied.
Parameters:
index - the image index.The index must be less than the depth of this ImageComponent3D object.
Parameters:
image - RenderedImage object containing the image.The size (width and height) must be the same as the current size of thisImageComponent3D object.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is not one of:ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.
exception:
IllegalArgumentException - if the width and height the imageis not equal to the width and height of this ImageComponent object.
since:
Java 3D 1.2 |
| set | | public void set(int index, NioImageBuffer image)(Code) | | Sets this image component at the specified index to the
specified NioImageBuffer object. If the data access mode is not
by-reference, then the NioImageBuffer data is copied into this
object. If the data access mode is by-reference, then a
reference to the NioImageBuffer is saved, but the data is not
necessarily copied.
Parameters:
index - the image index.The index must be less than the depth of this ImageComponent3D object.
Parameters:
image - NioImageBuffer object containing the image.The size (width and height) must be the same as the current size of thisImageComponent3D object.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the image class is notImageClass.NIO_IMAGE_BUFFER.
exception:
IllegalArgumentException - if the width and height the imageis not equal to the width and height of this ImageComponent object.
exception:
UnsupportedOperationException - this method is not supportedfor Java 3D 1.5.
since:
Java 3D 1.5 |
| setSubImage | | public void setSubImage(int index, RenderedImage image, int width, int height, int srcX, int srcY, int dstX, int dstY)(Code) | | Modifies a contiguous subregion of a particular slice of
image of this ImageComponent3D object.
Block of data of dimension (width * height)
starting at the offset (srcX, srcY) of the specified
RenderedImage object will be copied into the particular slice of
image component
starting at the offset (dstX, dstY) of this ImageComponent3D object.
The specified RenderedImage object must be of the same format as
the current format of this object.
This method can only be used if the data access mode is
by-copy. If it is by-reference, see updateData().
Parameters:
index - index of the image to be modified.The index must be less than the depth of this ImageComponent3D object.
Parameters:
image - RenderedImage object containing the subimage.
Parameters:
width - width of the subregion.
Parameters:
height - height of the subregion.
Parameters:
srcX - starting X offset of the subregion in the specified image.
Parameters:
srcY - starting Y offset of the subregion in the specified image.
Parameters:
dstX - startin X offset of the subregion in the imagecomponent of this object.
Parameters:
dstY - starting Y offset of the subregion in the imagecomponent of this object.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the data access mode isBY_REFERENCE.
exception:
IllegalArgumentException - if width orheight ofthe subregion exceeds the dimension of the image in this object.
exception:
IllegalArgumentException - if dstX < 0, or(dstX + width) > width of this object, ordstY < 0, or(dstY + height) > height of this object.
exception:
IllegalArgumentException - if srcX < 0, or(srcX + width) > width of the RenderedImageobject containing the subimage, orsrcY < 0, or(srcY + height) > height of theRenderedImage object containing the subimage.
exception:
IllegalArgumentException - if the specified RenderedImageis not compatible with the existing RenderedImage.
exception:
IllegalStateException - if the image class is not one of:ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.
since:
Java 3D 1.3 |
| updateData | | public void updateData(Updater updater, int index, int x, int y, int width, int height)(Code) | | Updates a particular slice of image data that is accessed by reference.
This method calls the updateData method of the specified
ImageComponent3D.Updater object to synchronize updates to the
image data that is referenced by this ImageComponent3D object.
Applications that wish to modify such data must perform all
updates via this method.
The data to be modified has to be within the boundary of the
subregion
specified by the offset (x, y) and the dimension (width*height).
It is illegal to modify data outside this boundary. If any
referenced data is modified outside the updateData method, or
any data outside the specified boundary is modified, the
results are undefined.
Parameters:
updater - object whose updateData callback method will becalled to update the data referenced by this ImageComponent3D object.
Parameters:
index - index of the image to be modified.The index must be less than the depth of this ImageComponent3D object.
Parameters:
x - starting X offset of the subregion.
Parameters:
y - starting Y offset of the subregion.
Parameters:
width - width of the subregion.
Parameters:
height - height of the subregion.
exception:
CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
IllegalStateException - if the data access mode isBY_COPY.
exception:
IllegalArgumentException - if width orheight ofthe subregion exceeds the dimension of the image in this object.
exception:
IllegalArgumentException - if x < 0, or(x + width) > width of this object, ory < 0, or(y + height) > height of this object.
exception:
ArrayIndexOutOfBoundsException - if index > thedepth of this object.
since:
Java 3D 1.3 |
| Fields inherited from javax.media.j3d.NodeComponent | boolean forceDuplicate(Code)(Java Doc)
|
|
|