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) Returns Model translation from screen translation.
double[]	getScale() Returns current scale
double[]	getScreenTranslation(double[] xyz, ViewPort viewPort) Returns Screen translation from model translation.
double[]	getTranslate() Return current translation
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) Resets graphics panel to a new state or its initial state.
void	restore(org.freehep.xml.io.XMLIOManager xmlioManager, org.jdom.Element nodeEl)
void	rotate(double theta) Rotates viewpoint in Z-plane over theta radians.
void	rotate(double theta, double nx, double ny, double nz) Rotate theta radians over unit vector (nx,ny,nz).
void	save(org.freehep.xml.io.XMLIOManager xmlioManager, org.jdom.Element nodeEl)
void	scale(double s) Scales by factor s.
void	scale(double sx, double sy) Scales by factor sx,sy.
void	scale(double sx, double sy, double sz) Scales by factor sx, sy, sz.
void	setScale(double s) Set scale to factor s.
void	setScale(double sx, double sy) Set scales to factors sx,sy.
void	setScale(double sx, double sy, double sz) Set scales to factors sx, sy, sz.
void	setTranslate(double tx, double ty) Set translate to tx and ty.
void	setTranslate(double tx, double ty, double tz) Set translate to tx, ty and 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) Translate over tx and ty.
void	translate(double tx, double ty, double tz) Translate over tx, ty and 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)

Description copied from interface: Rotateable3D

Rotate theta radians over unit vector (nx,ny,nz).

Specified by:

rotate in interface Rotateable3D

rotate

public void rotate(double theta)

Description copied from interface: Rotateable2D

Rotates viewpoint in Z-plane over theta radians.

Specified by:

rotate in interface Rotateable2D

getModelTranslation

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

Description copied from interface: Translateable

Returns Model translation from screen translation. An array of length 3: xyz[] = model(uvw[]). For 2D systems the 3rd coordinate may be ignored. The returned array may have a lifetime up to the next call to this method on this object.

Specified by:

getModelTranslation in interface Translateable

getScreenTranslation

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

Description copied from interface: Translateable

Returns Screen translation from model translation. An array of length 3: uvw[] = model(xyz[]). For 2D systems the 3rd coordinate may be ignored. The returned array may have a lifetime up to the next call to this method on this object.

Specified by:

getScreenTranslation in interface Translateable

scale

public void scale(double s)

Description copied from interface: Scaleable

Scales by factor s.

Specified by:

scale in interface Scaleable

setScale

public void setScale(double s)

Description copied from interface: Scaleable

Set scale to factor s.

Specified by:

setScale in interface Scaleable

scale

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

Description copied from interface: Scaleable3D

Scales by factor sx, sy, sz.

Specified by:

scale in interface Scaleable3D

setScale

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

Description copied from interface: Scaleable3D

Set scales to factors sx, sy, sz.

Specified by:

setScale in interface Scaleable3D

getScale

public double[] getScale()

Description copied from interface: Scaleable2D

Returns current scale

Specified by:

getScale in interface Scaleable2D

Specified by:

getScale in interface Scaleable3D

translate

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

Description copied from interface: Translateable3D

Translate over tx, ty and tz.

Specified by:

translate in interface Translateable3D

setTranslate

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

Description copied from interface: Translateable3D

Set translate to tx, ty and tz.

Specified by:

setTranslate in interface Translateable3D

getTranslate

public double[] getTranslate()

Description copied from interface: Translateable2D

Return current translation

Specified by:

getTranslate in interface Translateable2D

Specified by:

getTranslate in interface Translateable3D

scale

public void scale(double sx,
         double sy)

Description copied from interface: Scaleable2D

Scales by factor sx,sy.

Specified by:

scale in interface Scaleable2D

setScale

public void setScale(double sx,
            double sy)

Description copied from interface: Scaleable2D

Set scales to factors sx,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)

Description copied from interface: Translateable2D

Translate over tx and ty.

Specified by:

translate in interface Translateable2D

setTranslate

public void setTranslate(double tx,
                double ty)

Description copied from interface: Translateable2D

Set translate to tx and ty.

Specified by:

setTranslate in interface Translateable2D

reset

public Object reset(Object newState)

Description copied from interface: Resetable

Resets graphics panel to a new state or its initial state.

Specified by:

reset in interface Resetable

Parameters:

newState - new state, if null, use initial state of graphics panel.

Returns:

old state just before setting the new state

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