hep.wired.heprep.projection

Class ParallelProjection

java.lang.Object

hep.wired.heprep.projection.AbstractProjection

hep.wired.heprep.projection.ParallelProjection

All Implemented Interfaces:

Resetable, Rotateable2D, Rotateable3D, Scaleable, Scaleable2D, Scaleable3D, Shearable2D, Transformable2D, Transformable3D, Translateable, Translateable2D, Translateable3D, InverseProjection, Projection, ProjectionFeature, Feature, UVWindices, WiredRegistry.ID, XYZindices, org.freehep.xml.io.XMLIO

Direct Known Subclasses:

ParallelProjection.XY, ParallelProjection.XZ, ParallelProjection.YZ, ParallelProjection.ZX, ParallelProjection.ZY, PerspectiveProjection

public abstract class ParallelProjection
extends AbstractProjection
implements InverseProjection, Rotateable2D, Transformable2D, Rotateable3D, Transformable3D, Resetable

3D parallel projection of (X,Y,Z) into (U,V,W).

Version:

$Id: ParallelProjection.java 8598 2006-08-14 20:38:02Z duns $

Author:

Mark Donszelmann

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ParallelProjection.XY
static class	ParallelProjection.XZ
static class	ParallelProjection.YZ
static class	ParallelProjection.ZX
static class	ParallelProjection.ZY

Field Summary

Fields

Modifier and Type	Field and Description
protected Matrix3D	matrix
protected Matrix3D	resetMatrix

Fields inherited from class hep.wired.heprep.projection.AbstractProjection

defaultProjections

Fields inherited from interface hep.wired.util.XYZindices

X, Y, Z

Fields inherited from interface hep.wired.util.UVWindices

U, V, W

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ParallelProjection() Creates a 3D parallel projection.
protected	ParallelProjection(Matrix3D matrix)
protected	ParallelProjection(Matrix3D matrix, Matrix3D resetMatrix) Used for cloning

Method Summary

Methods

Modifier and Type	Method and Description
double[]	deltaTransform(double[] xyz) Returns an array of length 3: uvw = delta projection(xyz).
String	getFormula() Returns the formula in text readable form
double[]	getModelTranslation(double[] uvw, ViewPort viewPort)
double[]	getScale()
double[]	getScreenTranslation(double[] xyz, ViewPort viewPort)
double[]	getTranslate()
double[]	inverseDeltaTransform(double[] uvw) Returns an array of length 3: xyz = inverse delta projection(uvw).
double[]	inverseTransform(double[] uvw) Returns an array of length 3: xyz = inverse projection(uvw).
Object	reset(Object newState)
void	restore(org.freehep.xml.io.XMLIOManager xmlioManager, org.jdom.Element nodeEl)
void	rotate(double theta)
void	rotate(double theta, double nx, double ny, double nz)
void	save(org.freehep.xml.io.XMLIOManager xmlioManager, org.jdom.Element nodeEl)
void	scale(double s)
void	scale(double sx, double sy)
void	scale(double sx, double sy, double sz)
void	setScale(double s)
void	setScale(double sx, double sy)
void	setScale(double sx, double sy, double sz)
void	setTranslate(double tx, double ty)
void	setTranslate(double tx, double ty, double tz)
void	shear(double shx, double shy) Shears the viewpoint.
String	toString() Returns name of projection
double[]	transform(double[] xyz) Returns an array of length 3: uvw = projection(xyz).
double[][]	transform(double[][] xyz, int n) Implements this method in terms of double[] transform(double[] xyz).
void	translate(double tx, double ty)
void	translate(double tx, double ty, double tz)

Methods inherited from class hep.wired.heprep.projection.AbstractProjection

copy, getFeature, getID, getName, getViewPort, setViewPort, supports, transform, transform

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface hep.wired.heprep.services.Projection

copy, getFeature, getName, getViewPort, setViewPort, supports, transform, transform

Methods inherited from interface hep.wired.util.WiredRegistry.ID

getID

Field Detail

matrix

protected Matrix3D matrix

resetMatrix

protected Matrix3D resetMatrix

Constructor Detail

ParallelProjection

protected ParallelProjection()

Creates a 3D parallel projection.

ParallelProjection

protected ParallelProjection(Matrix3D matrix)

ParallelProjection

protected ParallelProjection(Matrix3D matrix,
                  Matrix3D resetMatrix)

Used for cloning

Method Detail

getFormula

public String getFormula()

Description copied from interface: Projection

Returns the formula in text readable form

Specified by:

getFormula in interface Projection

Overrides:

getFormula in class AbstractProjection

transform

public double[] transform(double[] xyz)

Description copied from interface: Projection

Returns an array of length 3: uvw = projection(xyz). The returned array may have a lifetime up to the next call to this method on this object.

Specified by:

transform in interface Projection

Specified by:

transform in class AbstractProjection

transform

public double[][] transform(double[][] xyz,
                   int n)

Description copied from class: AbstractProjection

Implements this method in terms of double[] transform(double[] xyz). Not a very efficient implementation, so concrete projections should probably override this method with something better.

Specified by:

transform in interface Projection

Overrides:

transform in class AbstractProjection

deltaTransform

public double[] deltaTransform(double[] xyz)

Description copied from interface: Projection

Returns an array of length 3: uvw = delta projection(xyz). The returned array may have a lifetime up to the next call to this method on this object.

Specified by:

deltaTransform in interface Projection

Specified by:

deltaTransform in class AbstractProjection

inverseTransform

public double[] inverseTransform(double[] uvw)
                          throws UnsupportedOperationException

Description copied from interface: InverseProjection

Returns an array of length 3: xyz = inverse projection(uvw). The returned array may have a lifetime up to the next call to this method on this object. UnsupportedOperation is thrown in no inverse projection is possible.

Specified by:

inverseTransform in interface InverseProjection

Throws:

UnsupportedOperationException

inverseDeltaTransform

public double[] inverseDeltaTransform(double[] uvw)
                               throws UnsupportedOperationException

Description copied from interface: InverseProjection

Returns an array of length 3: xyz = inverse delta projection(uvw). The returned array may have a lifetime up to the next call to this method on this object. UnsupportedOperation is thrown in no inverse delta projection is possible.

Specified by:

inverseDeltaTransform in interface InverseProjection

Throws:

UnsupportedOperationException

toString

public String toString()

Description copied from class: AbstractProjection

Returns name of projection

Overrides:

toString in class AbstractProjection

rotate

public void rotate(double theta,
          double nx,
          double ny,
          double nz)

Specified by:

rotate in interface Rotateable3D

rotate

public void rotate(double theta)

Specified by:

rotate in interface Rotateable2D

getModelTranslation

public double[] getModelTranslation(double[] uvw,
                           ViewPort viewPort)

Specified by:

getModelTranslation in interface Translateable

getScreenTranslation

public double[] getScreenTranslation(double[] xyz,
                            ViewPort viewPort)

Specified by:

getScreenTranslation in interface Translateable

scale

public void scale(double s)

Specified by:

scale in interface Scaleable

setScale

public void setScale(double s)

Specified by:

setScale in interface Scaleable

scale

public void scale(double sx,
         double sy,
         double sz)

Specified by:

scale in interface Scaleable3D

setScale

public void setScale(double sx,
            double sy,
            double sz)

Specified by:

setScale in interface Scaleable3D

getScale

public double[] getScale()

Specified by:

getScale in interface Scaleable2D

Specified by:

getScale in interface Scaleable3D

translate

public void translate(double tx,
             double ty,
             double tz)

Specified by:

translate in interface Translateable3D

setTranslate

public void setTranslate(double tx,
                double ty,
                double tz)

Specified by:

setTranslate in interface Translateable3D

getTranslate

public double[] getTranslate()

Specified by:

getTranslate in interface Translateable2D

Specified by:

getTranslate in interface Translateable3D

scale

public void scale(double sx,
         double sy)

Specified by:

scale in interface Scaleable2D

setScale

public void setScale(double sx,
            double sy)

Specified by:

setScale in interface Scaleable2D

shear

public void shear(double shx,
         double shy)

Shears the viewpoint. Preconcatenates with the matrix:

    [   1               shx             0               0       ]
    [   shy             1               0               0       ]
    [   0               0               1               0       ]
    [   0               0               0               1       ]
 

Specified by:

shear in interface Shearable2D

translate

public void translate(double tx,
             double ty)

Specified by:

translate in interface Translateable2D

setTranslate

public void setTranslate(double tx,
                double ty)

Specified by:

setTranslate in interface Translateable2D

reset

public Object reset(Object newState)

Specified by:

reset in interface Resetable

save

public void save(org.freehep.xml.io.XMLIOManager xmlioManager,
        org.jdom.Element nodeEl)

Specified by:

save in interface org.freehep.xml.io.XMLIO

Overrides:

save in class AbstractProjection

restore

public void restore(org.freehep.xml.io.XMLIOManager xmlioManager,
           org.jdom.Element nodeEl)

Specified by:

restore in interface org.freehep.xml.io.XMLIO

Overrides:

restore in class AbstractProjection