hep.wired.heprep.projection

Class FlatProjection

java.lang.Object

hep.wired.heprep.projection.AbstractProjection

hep.wired.heprep.projection.FlatProjection

All Implemented Interfaces:

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

public class FlatProjection
extends AbstractProjection
implements InverseProjection, Rotateable2D, Transformable2D, Resetable

2D projection of (X,Y) into (U,V).

Version:

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

Author:

Mark Donszelmann

Field Summary

Fields

Modifier and Type	Field and Description
static double	defaultScaleFactor

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

Constructor and Description
FlatProjection() Creates a 2D projection.
FlatProjection(double s) Creates a 2D projection with given scale factor.

Method Summary

Methods

Modifier and Type	Method and Description
Projection	copy() Returns a deep copy of the projection.
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	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	setScale(double s) Set scale to factor s.
void	setScale(double sx, double sy) Set scales to factors sx,sy.
void	setTranslate(double tx, double ty) Set translate to tx and ty.
void	shear(double shx, double shy) Shear using shx and shy.
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.

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

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

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

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

getID

Field Detail

defaultScaleFactor

public static final double defaultScaleFactor

See Also:

Constant Field Values

Constructor Detail

FlatProjection

public FlatProjection(double s)

Creates a 2D projection with given scale factor.

FlatProjection

public FlatProjection()

Creates a 2D projection.

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

copy

public Projection copy()

Description copied from interface: Projection

Returns a deep copy of the projection.

Specified by:

copy in interface Projection

Specified by:

copy in class AbstractProjection

toString

public String toString()

Description copied from class: AbstractProjection

Returns name of projection

Overrides:

toString in class AbstractProjection

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)

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

getScale

public double[] getScale()

Description copied from interface: Scaleable2D

Returns current scale

Specified by:

getScale in interface Scaleable2D

shear

public void shear(double shx,
         double shy)

Description copied from interface: Shearable2D

Shear using shx and shy.

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

getTranslate

public double[] getTranslate()

Description copied from interface: Translateable2D

Return current translation

Specified by:

getTranslate 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