ch.randelshofer.geom3d
Class RotatedTransform3DModel

java.lang.Object
  ch.randelshofer.beans.AbstractStateModel
      ch.randelshofer.geom3d.RotatedTransform3DModel

All Implemented Interfaces:

Transform3DModel, java.util.EventListener, javax.swing.event.ChangeListener

public class RotatedTransform3DModel
extends AbstractStateModel
implements Transform3DModel, javax.swing.event.ChangeListener

This model wraps another Transform3DModel. All changes are propagated to the wrapped model. The Transform3D returned by the getTransformModels is concatenated with the rotation specified in the constructor of the model.

Version:

2.0 2007-11-15 Upgraded to Java 1.4.

Author:

Werner Randelshofer

Field Summary

Fields inherited from class ch.randelshofer.beans.AbstractStateModel

changeEvent, listenerList

Constructor Summary

RotatedTransform3DModel(double dx, double dy, double dz)
Creates a new instance of ConcatenatedTransform3DModel

RotatedTransform3DModel(double dx, double dy, double dz, Transform3DModel m)

Method Summary

void	concatenate(Transform3D t) Concatenates a transform Tx to this transform Cx.
Transform3D	getTransform() Returns the current state of the model.
Transform3D	getTransform(Transform3D t) Copies the current state of the model into the given Transform3D object and returns it.
void	rotate(double rx, double ry, double rz) Concatenates this transform with a rotation transformation.
void	rotateX(double rx) Concatenates this transform with a rotation transformation.
void	rotateY(double ry) Concatenates this transform with a rotation transformation.
void	rotateZ(double rz) Concatenates this transform with a rotation transformation.
void	scale(double sx, double sy, double sz) Concatenates this transform with a scaling transformation.
void	setModel(Transform3DModel m)
void	setToIdentity() Resets this transform to the Identity transform.
void	setTransform(Transform3D t) Sets this transform to a copy of the transform in the specified Transform3D object.
void	stateChanged(javax.swing.event.ChangeEvent changeEvent)
void	translate(double tx, double ty, double tz) Concatenates this transform with a translation transformation.

Methods inherited from class ch.randelshofer.beans.AbstractStateModel

addChangeListener, fireStateChanged, removeChangeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface ch.randelshofer.geom3d.Transform3DModel

addChangeListener, removeChangeListener

Constructor Detail

RotatedTransform3DModel

public RotatedTransform3DModel(double dx,
                               double dy,
                               double dz)

Creates a new instance of ConcatenatedTransform3DModel

RotatedTransform3DModel

public RotatedTransform3DModel(double dx,
                               double dy,
                               double dz,
                               Transform3DModel m)

Method Detail

setModel

public void setModel(Transform3DModel m)

concatenate

public void concatenate(Transform3D t)

Concatenates a transform Tx to this transform Cx. Cx is updated to perform the combined transformation. Transforming a point p by the updated transform Cx' is equivalent to first transforming p by Tx and then transforming the result by the original transform Cx. In other words, Cx'(p) = Cx(Tx(p)). In matrix notation, if this transform Cx is represented by the matrix [this] and Tx is represented by the matrix [Tx], then this method does the following:

   [this] = [this] x [Tx]
 

Specified by:

concatenate in interface Transform3DModel

Parameters:

t - The transform object to be concatenated with this transform object.

getTransform

public Transform3D getTransform()

Returns the current state of the model.

Specified by:

getTransform in interface Transform3DModel

getTransform

public Transform3D getTransform(Transform3D t)

Copies the current state of the model into the given Transform3D object and returns it.

Specified by:

getTransform in interface Transform3DModel

rotate

public void rotate(double rx,
                   double ry,
                   double rz)

Concatenates this transform with a rotation transformation. This is equivalent to calling concatenate0(R), where R is an Transform3D represented by the following matrix:

   [ cos(rz)*cos(ry)     cos(rz)*sin(ry)*sin(rx)     cos(rz)*-sin(ry)*cos(rx)    0 ]
                           +sin(rz)*cos(rx)            +sin(rz)*-sin(ry)*cos(rx)

   [ -sin(rz)*cos(ry)    -sin(rz)*sin(ry)*sin(rx)    -sin(rz)*-sin(ry)*cos(rx)   0 ]
                           +cos(rz)*cos(rx)            +cos(rz)*sin(rx)

   [ sin(ry)             cos(ry)*-sin(rx)            cos(ry)*cos(rx)            0 ]

     [ 0                   0                           0                        1 ]
 

Positive values rotate counterclockwise.

Specified by:

rotate in interface Transform3DModel

Parameters:

rx - Rotation along the x axis in radians.

ry - Rotation along the y axis in radians.

rz - Rotation along the z axis in radians.

rotateX

public void rotateX(double rx)

Concatenates this transform with a rotation transformation. This is equivalent to calling concatenate0(R), where R is an Transform3D represented by the following matrix:

   [ 1   0         0        0 ]
   [ 0   cos(rx)    sin(rx)   0 ]
   [ 0   -sin(rx)   cos(rx)   0 ]
     [ 0   0         0        1 ]
 

Positive values rotate counterclockwise.

Specified by:

rotateX in interface Transform3DModel

Parameters:

rx - Rotation along the x axis in radians.

rotateY

public void rotateY(double ry)

Concatenates this transform with a rotation transformation. This is equivalent to calling concatenate0(R), where R is an Transform3D represented by the following matrix:

   [ cos(ry)   0   -sin(ry)   0 ]
   [ 0        1   0         0 ]
   [ sin(ry)   0   cos(ry)    0 ]
     [ 0        0   0         1 ]
 

Positive values rotate counterclockwise.

Specified by:

rotateY in interface Transform3DModel

Parameters:

ry - Rotation along the y axis in radians.

rotateZ

public void rotateZ(double rz)

Concatenates this transform with a rotation transformation. This is equivalent to calling concatenate0(R), where R is an Transform3D represented by the following matrix:

   [ cos(rz)    sin(rz)   0   0 ]
   [ -sin(rz)   cos(rz)   0   0 ]
   [ 0         0        1   0 ]
     [ 0         0        0   1 ]
 

Positive values rotate counterclockwise.

Specified by:

rotateZ in interface Transform3DModel

Parameters:

rz - Rotation along the z axis in radians.

scale

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

Concatenates this transform with a scaling transformation. This is equivalent to calling concatenate0(S), where S is an Transform3D represented by the following matrix:

   [   sx   0    0    0   ]
   [   0    sy   0    0   ]
   [   0    0    sz   0   ]
   [   0    0    0    1   ]
 

Specified by:

scale in interface Transform3DModel

setToIdentity

public void setToIdentity()

Resets this transform to the Identity transform.

Specified by:

setToIdentity in interface Transform3DModel

setTransform

public void setTransform(Transform3D t)

Sets this transform to a copy of the transform in the specified Transform3D object.

Specified by:

setTransform in interface Transform3DModel

Parameters:

t - the Transform3D object from which to copy the transform

translate

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

Concatenates this transform with a translation transformation. This is equivalent to calling concatenate0(T), where T is an Transform3D represented by the following matrix:

   [   1    0    0    tx  ]
   [   0    1    0    ty  ]
   [   0    0    1    tz  ]
   [   0    0    0    1   ]
 

Specified by:

translate in interface Transform3DModel

stateChanged

public void stateChanged(javax.swing.event.ChangeEvent changeEvent)

Specified by:

stateChanged in interface javax.swing.event.ChangeListener