hep.wired.heprep.projection

Class PerspectiveProjection

java.lang.Object

hep.wired.heprep.projection.AbstractProjection

hep.wired.heprep.projection.ParallelProjection

hep.wired.heprep.projection.PerspectiveProjection

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:

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

public abstract class PerspectiveProjection
extends ParallelProjection

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

Version:

$Id: PerspectiveProjection.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	PerspectiveProjection.XY
static class	PerspectiveProjection.XZ
static class	PerspectiveProjection.YZ
static class	PerspectiveProjection.ZX
static class	PerspectiveProjection.ZY

Field Summary

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

matrix, 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	PerspectiveProjection() Creates a 3D perpective projection.
protected	PerspectiveProjection(Matrix3D matrix)
protected	PerspectiveProjection(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[]	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	save(org.freehep.xml.io.XMLIOManager xmlioManager, org.jdom.Element nodeEl)
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).

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

getModelTranslation, getScale, getScreenTranslation, getTranslate, rotate, rotate, scale, scale, scale, setScale, setScale, setScale, setTranslate, setTranslate, shear, translate, translate

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

Constructor Detail

PerspectiveProjection

protected PerspectiveProjection()

Creates a 3D perpective projection.

PerspectiveProjection

protected PerspectiveProjection(Matrix3D matrix)

PerspectiveProjection

protected PerspectiveProjection(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 ParallelProjection

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

Overrides:

transform in class ParallelProjection

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 ParallelProjection

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

Overrides:

deltaTransform in class ParallelProjection

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

Overrides:

inverseTransform in class ParallelProjection

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

Overrides:

inverseDeltaTransform in class ParallelProjection

Throws:

UnsupportedOperationException

toString

public String toString()

Description copied from class: AbstractProjection

Returns name of projection

Overrides:

toString in class ParallelProjection

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

Overrides:

reset in class ParallelProjection

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 ParallelProjection

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 ParallelProjection