Raster (Java 3D Javadocs 0-SNAPSHOT API)

java.lang.Object
- org.scijava.java3d.SceneGraphObject
- - org.scijava.java3d.NodeComponent
  - - org.scijava.java3d.Geometry
    - - org.scijava.java3d.Raster

```
public class Raster
extends Geometry
```
The Raster object extends Geometry to allow drawing a raster image that is attached to a 3D location in the virtual world. It contains a 3D point that is defined in the local object coordinate system of the Shape3D node that references the Raster. It also contains a type specifier, a clipping mode, a reference to a ImageComponent2D object and/or a DepthComponent object, an integer x,y source offset and a size (width, height) to allow reading or writing a portion of the referenced image, and an integer x,y destination offset to position the raster relative to the transformed 3D point. In addition to being used as a type of geometry for drawing, a Raster may be used to readback pixel data (color and/or z-buffer) from the frame buffer in immediate mode.
The geometric extent of a Raster object is a single 3D point, specified by the raster position. This means that geometry-based picking or collision with a Raster object will only intersect the object at this single point; the 2D raster image is neither pickable nor collidable.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ALLOW_CLIP_MODE_READ` Specifies that this Raster allows reading the clip mode.
`static int`	`ALLOW_CLIP_MODE_WRITE` Specifies that this Raster allows writing the clip mode.
`static int`	`ALLOW_DEPTH_COMPONENT_READ` Specifies that this Raster allows reading the depth component.
`static int`	`ALLOW_DEPTH_COMPONENT_WRITE` Specifies that this Raster allows writing the depth component.
`static int`	`ALLOW_IMAGE_READ` Specifies that this Raster allows reading the image.
`static int`	`ALLOW_IMAGE_WRITE` Specifies that this Raster allows writing the image.
`static int`	`ALLOW_OFFSET_READ` Specifies that this Raster allows reading the source or destination offset.
`static int`	`ALLOW_OFFSET_WRITE` Specifies that this Raster allows writing the source or destination offset.
`static int`	`ALLOW_POSITION_READ` Specifies that this Raster allows reading the position.
`static int`	`ALLOW_POSITION_WRITE` Specifies that this Raster allows writing the position.
`static int`	`ALLOW_SIZE_READ` Specifies that this Raster allows reading the size.
`static int`	`ALLOW_SIZE_WRITE` Specifies that this Raster allows writing the size.
`static int`	`ALLOW_TYPE_READ` Specifies that this Raster allows reading the type.
`static int`	`CLIP_IMAGE` Specifies that the raster object is clipped as an image after the raster position has been transformed.
`static int`	`CLIP_POSITION` Specifies that this raster object is not drawn if the raster position is outside the viewing volume.
`static int`	`RASTER_COLOR` Specifies a Raster object with color data.
`static int`	`RASTER_COLOR_DEPTH` Specifies a Raster object with both color and depth (z-buffer) data.
`static int`	`RASTER_DEPTH` Specifies a Raster object with depth (z-buffer) data.

Fields inherited from class org.scijava.java3d.Geometry
ALLOW_INTERSECT

Constructor Summary

Constructors
Constructor and Description
`Raster()` Constructs a Raster object with default parameters.
`Raster(Point3f pos, int type, int xSrcOffset, int ySrcOffset, int width, int height, ImageComponent2D image, DepthComponent depthComponent)` Constructs a new Raster object with the specified values.
`Raster(Point3f pos, int type, int clipMode, Point srcOffset, Dimension size, Point dstOffset, ImageComponent2D image, DepthComponent depthComponent)` Constructs a new Raster object with the specified values.
`Raster(Point3f pos, int type, Point srcOffset, Dimension size, ImageComponent2D image, DepthComponent depthComponent)` Constructs a new Raster object with the specified values.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
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`	`getClipMode()` Retrieves the current clipping mode of this raster object.
`DepthComponent`	`getDepthComponent()` Retrieves the current depth image object.
`void`	`getDstOffset(Point dstOffset)` Retrieves the current destination pixel offset.
`ImageComponent2D`	`getImage()` Retrieves the current pixel array object.
`void`	`getOffset(Point srcOffset)` Deprecated. As of Java 3D version 1.3, replaced by `getSrcOffset(java.awt.Point)`
`void`	`getPosition(Point3f pos)` Retrieves the current position in object coordinates of this raster.
`void`	`getSize(Dimension size)` Retrieves the current raster size.
`void`	`getSrcOffset(Point srcOffset)` Retrieves the current source pixel offset.
`int`	`getType()` Retrieves the current type of this raster object, one of: RASTER_COLOR, RASTER_DEPTH, or RASTER_COLOR_DEPTH.
`void`	`setClipMode(int clipMode)` Sets the clipping mode of this raster object.
`void`	`setDepthComponent(DepthComponent depthComponent)` Sets the depth image used to copy pixels to/from a Canvas3D.
`void`	`setDstOffset(int xDstOffset, int yDstOffset)` Sets the destination pixel offset of the upper-left corner of the rendered image relative to the transformed position.
`void`	`setDstOffset(Point dstOffset)` Sets the destination pixel offset of the upper-left corner of the rendered image relative to the transformed position.
`void`	`setImage(ImageComponent2D image)` Sets the pixel array used to copy pixels to/from a Canvas3D.
`void`	`setOffset(int xSrcOffset, int ySrcOffset)` Deprecated. As of Java 3D version 1.3, replaced by `setSrcOffset(int,int)`
`void`	`setOffset(Point srcOffset)` Deprecated. As of Java 3D version 1.3, replaced by `setSrcOffset(java.awt.Point)`
`void`	`setPosition(Point3f pos)` Sets the position in object coordinates of this raster.
`void`	`setSize(Dimension size)` Sets the size of the array of pixels to be copied.
`void`	`setSize(int width, int height)` Sets the number of pixels to be copied from the pixel array.
`void`	`setSrcOffset(int xSrcOffset, int ySrcOffset)` Sets the offset within the source array of pixels at which to start copying.
`void`	`setSrcOffset(Point srcOffset)` Sets the offset within the source array of pixels at which to start copying.
`void`	`setType(int type)` Sets the type of this raster object to one of: RASTER_COLOR, RASTER_DEPTH, or RASTER_COLOR_DEPTH.

Methods inherited from class org.scijava.java3d.NodeComponent
cloneNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTree

Methods inherited from class org.scijava.java3d.SceneGraphObject
clearCapability, clearCapabilityIsFrequent, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferences

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - RASTER_COLOR
```
public static final int RASTER_COLOR
```
    Specifies a Raster object with color data. In this mode, the image reference must point to a valid ImageComponent object.
    
    See Also:
    
    setType(int), Constant Field Values
  - RASTER_DEPTH
```
public static final int RASTER_DEPTH
```
    Specifies a Raster object with depth (z-buffer) data. In this mode, the depthImage reference must point to a valid DepthComponent object.
    
    See Also:
    
    setType(int), Constant Field Values
  - RASTER_COLOR_DEPTH
```
public static final int RASTER_COLOR_DEPTH
```
    Specifies a Raster object with both color and depth (z-buffer) data. In this mode, the image reference must point to a valid ImageComponent object, and the depthImage reference must point to a valid DepthComponent object.
    
    See Also:
    
    setType(int), Constant Field Values
  - CLIP_POSITION
```
public static final int CLIP_POSITION
```
    Specifies that this raster object is not drawn if the raster position is outside the viewing volume. In this mode, the raster is not drawn when the transformed raster position is clipped out, even if part of the raster would have been visible. This is the default mode.
    
    Since:
    
    Java 3D 1.3
    
    See Also:
    
    setClipMode(int), Constant Field Values
  - CLIP_IMAGE
```
public static final int CLIP_IMAGE
```
    Specifies that the raster object is clipped as an image after the raster position has been transformed. In this mode, part of the raster may be drawn even when the transformed raster position is clipped out.
    
    Since:
    
    Java 3D 1.3
    
    See Also:
    
    setClipMode(int), Constant Field Values
  - ALLOW_POSITION_READ
```
public static final int ALLOW_POSITION_READ
```
    Specifies that this Raster allows reading the position.
    
    See Also:
    
    Constant Field Values
  - ALLOW_POSITION_WRITE
```
public static final int ALLOW_POSITION_WRITE
```
    Specifies that this Raster allows writing the position.
    
    See Also:
    
    Constant Field Values
  - ALLOW_OFFSET_READ
```
public static final int ALLOW_OFFSET_READ
```
    Specifies that this Raster allows reading the source or destination offset.
    
    See Also:
    
    Constant Field Values
  - ALLOW_OFFSET_WRITE
```
public static final int ALLOW_OFFSET_WRITE
```
    Specifies that this Raster allows writing the source or destination offset.
    
    See Also:
    
    Constant Field Values
  - ALLOW_IMAGE_READ
```
public static final int ALLOW_IMAGE_READ
```
    Specifies that this Raster allows reading the image.
    
    See Also:
    
    Constant Field Values
  - ALLOW_IMAGE_WRITE
```
public static final int ALLOW_IMAGE_WRITE
```
    Specifies that this Raster allows writing the image.
    
    See Also:
    
    Constant Field Values
  - ALLOW_DEPTH_COMPONENT_READ
```
public static final int ALLOW_DEPTH_COMPONENT_READ
```
    Specifies that this Raster allows reading the depth component.
    
    See Also:
    
    Constant Field Values
  - ALLOW_DEPTH_COMPONENT_WRITE
```
public static final int ALLOW_DEPTH_COMPONENT_WRITE
```
    Specifies that this Raster allows writing the depth component.
    
    See Also:
    
    Constant Field Values
  - ALLOW_SIZE_READ
```
public static final int ALLOW_SIZE_READ
```
    Specifies that this Raster allows reading the size.
    
    See Also:
    
    Constant Field Values
  - ALLOW_SIZE_WRITE
```
public static final int ALLOW_SIZE_WRITE
```
    Specifies that this Raster allows writing the size.
    
    See Also:
    
    Constant Field Values
  - ALLOW_TYPE_READ
```
public static final int ALLOW_TYPE_READ
```
    Specifies that this Raster allows reading the type.
    
    See Also:
    
    Constant Field Values
  - ALLOW_CLIP_MODE_READ
```
public static final int ALLOW_CLIP_MODE_READ
```
    Specifies that this Raster allows reading the clip mode.
    
    Since:
    
    Java 3D 1.3
    
    See Also:
    
    Constant Field Values
  - ALLOW_CLIP_MODE_WRITE
```
public static final int ALLOW_CLIP_MODE_WRITE
```
    Specifies that this Raster allows writing the clip mode.
    
    Since:
    
    Java 3D 1.3
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Raster
```
public Raster()
```
    Constructs a Raster object with default parameters. The default values are as follows:
  - Raster
```
public Raster(Point3f pos,
              int type,
              int xSrcOffset,
              int ySrcOffset,
              int width,
              int height,
              ImageComponent2D image,
              DepthComponent depthComponent)
```
    Constructs a new Raster object with the specified values.
    
    Parameters:
    
    pos - the position in object coordinates of the upper-left corner of the raster
    
    type - the type of raster object, one of: RASTER_COLOR, RASTER_DEPTH, or RASTER_COLOR_DEPTH
    
    xSrcOffset - the x offset within the source array of pixels at which to start copying
    
    ySrcOffset - the y offset within the source array of pixels at which to start copying
    
    width - the number of columns of pixels to copy
    
    height - the number of rows of pixels to copy
    
    image - the ImageComponent2D object containing the color data
    
    depthComponent - the DepthComponent object containing the depth (z-buffer) data
    
    Throws:
    
    IllegalArgumentException - if the image class of the specified ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.
  - Raster
```
public Raster(Point3f pos,
              int type,
              Point srcOffset,
              Dimension size,
              ImageComponent2D image,
              DepthComponent depthComponent)
```
    Constructs a new Raster object with the specified values.
    
    Parameters:
    
    pos - the position in object coordinates of the upper-left corner of the raster
    
    type - the type of raster object, one of: RASTER_COLOR, RASTER_DEPTH, or RASTER_COLOR_DEPTH
    
    srcOffset - the offset within the source array of pixels at which to start copying
    
    size - the width and height of the image to be copied
    
    image - the ImageComponent2D object containing the color data
    
    depthComponent - the DepthComponent object containing the depth (z-buffer) data
    
    Throws:
    
    IllegalArgumentException - if the image class of the specified ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.
  - Raster
```
public Raster(Point3f pos,
              int type,
              int clipMode,
              Point srcOffset,
              Dimension size,
              Point dstOffset,
              ImageComponent2D image,
              DepthComponent depthComponent)
```
    Constructs a new Raster object with the specified values.
    
    Parameters:
    
    pos - the position in object coordinates of the upper-left corner of the raster
    
    type - the type of raster object, one of: RASTER_COLOR, RASTER_DEPTH, or RASTER_COLOR_DEPTH
    
    clipMode - the clipping mode of the raster object, one of: CLIP_POSITION or CLIP_IMAGE
    
    srcOffset - the offset within the source array of pixels at which to start copying
    
    size - the width and height of the image to be copied
    
    dstOffset - the destination pixel offset of the upper-left corner of the rendered image relative to the transformed position
    
    image - the ImageComponent2D object containing the color data
    
    depthComponent - the DepthComponent object containing the depth (z-buffer) data
    
    Throws:
    
    IllegalArgumentException - if the image class of the specified ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.
    
    Since:
    
    Java 3D 1.3
- Method Detail
  - setPosition
```
public void setPosition(Point3f pos)
```
    Sets the position in object coordinates of this raster. This position is transformed into device coordinates and is used as the upper-left corner of the raster.
    
    Parameters:
    
    pos - the new position of this raster
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - getPosition
```
public void getPosition(Point3f pos)
```
    Retrieves the current position in object coordinates of this raster.
    
    Parameters:
    
    pos - the vector that will receive the current position
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - setType
```
public void setType(int type)
```
    Sets the type of this raster object to one of: RASTER_COLOR, RASTER_DEPTH, or RASTER_COLOR_DEPTH.
    
    Parameters:
    
    type - the new type of this raster
    
    Throws:
    
    RestrictedAccessException - if the method is called when this object is part of live or compiled scene graph.
  - getType
```
public int getType()
```
    Retrieves the current type of this raster object, one of: RASTER_COLOR, RASTER_DEPTH, or RASTER_COLOR_DEPTH.
    
    Returns:
    
    type the type of this raster
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - setClipMode
```
public void setClipMode(int clipMode)
```
    Sets the clipping mode of this raster object.
    
    Parameters:
    
    clipMode - the new clipping mode of this raster, one of: CLIP_POSITION or CLIP_IMAGE. The default mode is CLIP_POSITION.
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - getClipMode
```
public int getClipMode()
```
    Retrieves the current clipping mode of this raster object.
    
    Returns:
    
    clipMode the clipping mode of this raster, one of: CLIP_POSITION or CLIP_IMAGE.
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - setOffset
```
public void setOffset(int xSrcOffset,
                      int ySrcOffset)
```
    Deprecated. As of Java 3D version 1.3, replaced by setSrcOffset(int,int)
  - setOffset
```
public void setOffset(Point srcOffset)
```
    Deprecated. As of Java 3D version 1.3, replaced by setSrcOffset(java.awt.Point)
  - getOffset
```
public void getOffset(Point srcOffset)
```
    Deprecated. As of Java 3D version 1.3, replaced by getSrcOffset(java.awt.Point)
  - setSrcOffset
```
public void setSrcOffset(int xSrcOffset,
                         int ySrcOffset)
```
    Sets the offset within the source array of pixels at which to start copying.
    
    Parameters:
    
    xSrcOffset - the x offset within the source array of pixels at which to start copying
    
    ySrcOffset - the y offset within the source array of pixels at which to start copying
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - setSrcOffset
```
public void setSrcOffset(Point srcOffset)
```
    Sets the offset within the source array of pixels at which to start copying.
    
    Parameters:
    
    srcOffset - the new source pixel offset
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - getSrcOffset
```
public void getSrcOffset(Point srcOffset)
```
    Retrieves the current source pixel offset.
    
    Parameters:
    
    srcOffset - the object that will receive the source offset
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - setSize
```
public void setSize(int width,
                    int height)
```
    Sets the number of pixels to be copied from the pixel array.
    
    Parameters:
    
    width - the number of columns in the array of pixels to copy
    
    height - the number of rows in the array of pixels to copy
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - setSize
```
public void setSize(Dimension size)
```
    Sets the size of the array of pixels to be copied.
    
    Parameters:
    
    size - the new size
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - getSize
```
public void getSize(Dimension size)
```
    Retrieves the current raster size.
    
    Parameters:
    
    size - the object that will receive the size
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - setDstOffset
```
public void setDstOffset(int xDstOffset,
                         int yDstOffset)
```
    Sets the destination pixel offset of the upper-left corner of the rendered image relative to the transformed position. This pixel offset is added to the transformed raster position prior to rendering the image.
    
    Parameters:
    
    xDstOffset - the x coordinate of the new offset
    
    yDstOffset - the y coordinate of the new offset
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - setDstOffset
```
public void setDstOffset(Point dstOffset)
```
    Sets the destination pixel offset of the upper-left corner of the rendered image relative to the transformed position. This pixel offset is added to the transformed raster position prior to rendering the image.
    
    Parameters:
    
    dstOffset - the new destination pixel offset
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - getDstOffset
```
public void getDstOffset(Point dstOffset)
```
    Retrieves the current destination pixel offset.
    
    Parameters:
    
    dstOffset - the object that will receive the destination offset
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    Since:
    
    Java 3D 1.3
  - setImage
```
public void setImage(ImageComponent2D image)
```
    Sets the pixel array used to copy pixels to/from a Canvas3D. This is used when the type is RASTER_COLOR or RASTER_COLOR_DEPTH.
    
    Parameters:
    
    image - the ImageComponent2D object containing the color data
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
    
    IllegalSharingException - if this Raster is live and the specified image is being used by a Canvas3D as an off-screen buffer.
    
    IllegalArgumentException - if the image class of the specified ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.
  - getImage
```
public ImageComponent2D getImage()
```
    Retrieves the current pixel array object.
    
    Returns:
    
    image the ImageComponent2D object containing the color data
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - setDepthComponent
```
public void setDepthComponent(DepthComponent depthComponent)
```
    Sets the depth image used to copy pixels to/from a Canvas3D. This is used when the type is RASTER_DEPTH or RASTER_COLOR_DEPTH.
    
    Parameters:
    
    depthComponent - the DepthComponent object containing the depth (z-buffer) data
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - getDepthComponent
```
public DepthComponent getDepthComponent()
```
    Retrieves the current depth image object.
    
    Returns:
    
    depthImage DepthComponent containing the depth (z-buffer) data
    
    Throws:
    
    CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
  - 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

Class Raster

Field Summary

Fields inherited from class org.scijava.java3d.Geometry

Constructor Summary

Method Summary

Methods inherited from class org.scijava.java3d.NodeComponent

Methods inherited from class org.scijava.java3d.SceneGraphObject

Methods inherited from class java.lang.Object

Field Detail

RASTER_COLOR

RASTER_DEPTH

RASTER_COLOR_DEPTH

CLIP_POSITION

CLIP_IMAGE

ALLOW_POSITION_READ

ALLOW_POSITION_WRITE

ALLOW_OFFSET_READ

ALLOW_OFFSET_WRITE

ALLOW_IMAGE_READ

ALLOW_IMAGE_WRITE

ALLOW_DEPTH_COMPONENT_READ

ALLOW_DEPTH_COMPONENT_WRITE

ALLOW_SIZE_READ

ALLOW_SIZE_WRITE

ALLOW_TYPE_READ

ALLOW_CLIP_MODE_READ

ALLOW_CLIP_MODE_WRITE

Constructor Detail

Raster

Raster

Raster

Raster

Method Detail

setPosition

getPosition

setType

getType

setClipMode

getClipMode

setOffset

setOffset

getOffset

setSrcOffset

setSrcOffset

getSrcOffset

setSize

setSize

getSize

setDstOffset

setDstOffset

getDstOffset

setImage

getImage

setDepthComponent

getDepthComponent

cloneNodeComponent

duplicateNodeComponent