Slice

java.lang.Object
- edu.unh.sdb.datasource.Slice

Direct Known Subclasses:

SliceIterator
```
public class Slice
extends java.lang.Object
```
A class that knows how to read data for the intersection between a Volume over a DataSource and a Plane. The data is read from a DataSource.

Constructor Summary

Constructors
Constructor and Description
`Slice(byte[] outsideColor, byte[] insideColor, Volume volume, Plane plane, DataSource dataSource)` Creates a new instance of Slice and sets its parameters

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`calculateSliceTranslation()` Calculates the translation for the 2D projection of intersection polygon such that the 2D polygon is stationary as the polygon move through the volume.
`int[][]`	`getBounds()`
`int`	`getBytesPerTexel()`
`DataSource`	`getDataSource()`
`javax.vecmath.Point2d[]`	`getIntersection2d()`
`javax.vecmath.Point3d[]`	`getIntersection3d()`
`int`	`getMaxProjectionAxis()`
`float[]`	`getNormalArray()` Required for ObliquePlaneIteratorInterface
`Plane`	`getPlane()`
`int[]`	`getPlaneShapeArray()`
`ISBounds`	`getSpaceBounds()`
`int[]`	`getSpaceShapeArray()`
`javax.vecmath.Point2d[]`	`getTextureCoordinates()`
`byte[]`	`getTextureData()`
`int[]`	`getTextureDimensions()`
`Volume`	`getVolume()`
`void`	`init()` Initialize the slice by allocating memory for the data to be read, seting the default transfer function and performing other initialisations This initialisation can be done once per iteration.
`void`	`log(java.lang.String fileName)`
`static void`	`projectTuple(javax.vecmath.Tuple3d source, javax.vecmath.Tuple2d dest, int axis)` Project the 'source' on a plane perpendicular on 'axis' and store the result in 'dest'.
`void`	`read()` Calculates the intersection between the `Plane` and the `Volume` and fills the the intersection poligon with data
`void`	`setDataSource(DataSource dataSource)` Sets the data source where the volume is stored.
`static void`	`setGoodScanConversionOrder(boolean good)`
`void`	`setInsideColor(byte[] color)` Sets the color for the texture inside the bounds of the slice projection
`void`	`setOutsideColor(byte[] color)` Sets the color for the texture ouside the bounds of the slice projection
`void`	`setPlane(Plane plane)` Specifies the plane we want to intersect with the volume
`void`	`setTransferFunction(TransferFunction transferFunction)` Specifies how do we convert the Datum read from the file into a rgba tupple.
`void`	`setVertical(javax.vecmath.Vector3d vertical)` Specifies a vector in the intersection plane.
`void`	`setVolume(Volume volume)` Specifies the volume we iterate over
`java.lang.String`	`toString()`

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

- Constructor Detail
  - Slice
```
public Slice(byte[] outsideColor,
     byte[] insideColor,
     Volume volume,
     Plane plane,
     DataSource dataSource)
```
    Creates a new instance of Slice and sets its parameters
- Method Detail
  - getBytesPerTexel
```
public int getBytesPerTexel()
```
    Returns:
    How many bytes do we use per texel, when we store the texture. Currently this is 4 (rgba)
  - setTransferFunction
```
public void setTransferFunction(TransferFunction transferFunction)
```
    Specifies how do we convert the Datum read from the file into a rgba tupple.
  - setVolume
```
public void setVolume(Volume volume)
```
    Specifies the volume we iterate over
  - getVolume
```
public Volume getVolume()
```
    Returns:
    volume we iterate over
  - setPlane
```
public void setPlane(Plane plane)
```
    Specifies the plane we want to intersect with the volume
  - getPlane
```
public Plane getPlane()
```
    Returns:
    plane we want to intersect with the volume
  - setDataSource
```
public void setDataSource(DataSource dataSource)
```
    Sets the data source where the volume is stored.
  - getDataSource
```
public DataSource getDataSource()
```
    Returns:
    The data source where the volume is stored.
  - setOutsideColor
```
public void setOutsideColor(byte[] color)
```
    Sets the color for the texture ouside the bounds of the slice projection
  - setInsideColor
```
public void setInsideColor(byte[] color)
```
    Sets the color for the texture inside the bounds of the slice projection
  - setGoodScanConversionOrder
```
public static void setGoodScanConversionOrder(boolean good)
```
  - getTextureData
```
public byte[] getTextureData()
```
    Returns:
    a byte array containing the texture.
  - getTextureDimensions
```
public int[] getTextureDimensions()
```
    Returns:
    the x,y dimensions of the texture. These are a power of 2.
  - getBounds
```
public int[][] getBounds()
```
    Returns:
    bounds[0] contains the lower and upper bounds for the x coordinate bounds[1] contains the same for the y coordinate. These coordinates delimit the rectangle that includes the intersection poligon projected to maximum projection orthogonal plane.
  - getIntersection3d
```
public javax.vecmath.Point3d[] getIntersection3d()
```
    Returns:
    the 3d points that form the intersection polygon.
  - getIntersection2d
```
public javax.vecmath.Point2d[] getIntersection2d()
```
    Returns:
    the 2d points that form the intersection polygon seen from a direction normal to the plane of the polygon.
  - getMaxProjectionAxis
```
public int getMaxProjectionAxis()
```
    Returns:
    the axis perpendicular on the plane for which the slice has the maximum projection area
  - getTextureCoordinates
```
public javax.vecmath.Point2d[] getTextureCoordinates()
```
    Returns:
    the 2d points that form the intersection polygon, translated and scaled such that they are between [0,1].
  - init
```
public void init()
```
    Initialize the slice by allocating memory for the data to be read, seting the default transfer function and performing other initialisations This initialisation can be done once per iteration. In an iteration the slice will slide along its normal until the entire volume will be traversed.
  - read
```
public void read()
```
    Calculates the intersection between the Plane and the Volume and fills the the intersection poligon with data
  - setVertical
```
public void setVertical(javax.vecmath.Vector3d vertical)
```
    Specifies a vector in the intersection plane. The intersection poligon is displayed rotated such that this vector is vertical.
  - getSpaceBounds
```
public ISBounds getSpaceBounds()
```
  - getSpaceShapeArray
```
public int[] getSpaceShapeArray()
```
  - getNormalArray
```
public float[] getNormalArray()
```
    Required for ObliquePlaneIteratorInterface
  - getPlaneShapeArray
```
public int[] getPlaneShapeArray()
```
  - calculateSliceTranslation
```
public void calculateSliceTranslation()
```
    Calculates the translation for the 2D projection of intersection polygon such that the 2D polygon is stationary as the polygon move through the volume. This function needs to be called each time the normal of the plane changes.
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - projectTuple
```
public static void projectTuple(javax.vecmath.Tuple3d source,
                javax.vecmath.Tuple2d dest,
                int axis)
```
    Project the 'source' on a plane perpendicular on 'axis' and store the result in 'dest'.
  - log
```
public void log(java.lang.String fileName)
```

Class Slice

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Slice

Method Detail

getBytesPerTexel

setTransferFunction

setVolume

getVolume

setPlane

getPlane

setDataSource

getDataSource

setOutsideColor

setInsideColor

setGoodScanConversionOrder

getTextureData

getTextureDimensions

getBounds

getIntersection3d

getIntersection2d

getMaxProjectionAxis

getTextureCoordinates

init

read

setVertical

getSpaceBounds

getSpaceShapeArray

getNormalArray

getPlaneShapeArray

calculateSliceTranslation

toString

projectTuple

log