Package geomss.geom

Class NoteTrans

java.lang.Object

geomss.geom.AbstractGeomElement<T>

geomss.geom.AbstractNote<GenScreenNote>

geomss.geom.GenScreenNote

geomss.geom.NoteTrans

All Implemented Interfaces:

GeomElement<GenScreenNote>, GeomTransform<GenScreenNote>, Transformable<GenScreenNote>, java.io.Serializable, java.lang.Cloneable, java.lang.Comparable, javolution.lang.Reusable, javolution.xml.XMLSerializable

public final class NoteTrans
extends GenScreenNote
implements GeomTransform<GenScreenNote>

A GeomTransform element that refers to a GenScreenNote object and masquerades as a GenScreenNote object itself.

Modified by: Joseph A. Huwaldt

Version:

April 10, 2018

Author:

Joseph A. Huwaldt, Date: February 6, 2014

See Also:

Serialized Form

Field Summary

Fields inherited from class geomss.geom.AbstractNote

DEFAULT_FONT

Fields inherited from class geomss.geom.AbstractGeomElement

RESOURCES

Method Summary

Modifier and Type	Method	Description
NoteTrans	changeFont(java.awt.Font font)	Return a new note object identical to this one, but with the specified font.
NoteTrans	changeLocation(GeomPoint location)	Return a new note object identical to this one, but with the specified location in model space.
NoteTrans	copy()	Returns a copy of this NoteTrans instance allocated by the calling thread (possibly on the stack).
Note	copyToReal()	Return a copy of the child object transformed by this transformation.
boolean	equals(java.lang.Object obj)	Compares this NoteTrans against the specified object for strict equality (same values and same units).
GenScreenNote	getChild()	Returns the child object transformed by this transform element.
java.awt.Font	getFont()	Return the font used to display this note.
Point	getLocation()	Return the location of this note in model space.
java.lang.String	getNote()	Return the text string associated with this note object.
int	getPhyDimension()	Returns the number of physical dimensions of the geometry element.
GTransform	getTotalTransform()	Returns the total transformation represented by an entire chain of GeomTransform objects below this one.
GTransform	getTransform()	Returns the transformation represented by this transformation element.
javax.measure.unit.Unit<javax.measure.quantity.Length>	getUnit()	Returns the unit in which the note location Point is stored.
int	hashCode()	Returns the hash code for this parameter.
Note	immutable()	Return an immutable version of this note.
boolean	isValid()	Return true if this Note contains valid and finite numerical components.
static NoteTrans	newInstance(GenScreenNote child, GTransform transform)	Returns a 3D NoteTrans instance holding the specified GenScreenNote and GTransform.
void	setTransform(GTransform transform)	Sets the transformation represented by this transformation element.
NoteTrans	to(javax.measure.unit.Unit<javax.measure.quantity.Length> unit)	Returns the equivalent to this note but with the location stated in the specified unit.
NoteTrans	toDimension(int newDim)	Return the equivalent of this note converted to the specified number of physical dimensions.

Methods inherited from class geomss.geom.GenScreenNote

getBoundsMax, getBoundsMin, getLimitPoint, getTransformed, size, toText

Methods inherited from class geomss.geom.AbstractNote

getParDimension, length

Methods inherited from class geomss.geom.AbstractGeomElement

addChangeListener, clone, compareTo, getAllUserData, getID, getName, getUserData, putAllUserData, putUserData, removeChangeListener, removeUserData, reset, setName, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface geomss.geom.GeomElement

addChangeListener, getAllUserData, getBoundsMax, getBoundsMin, getID, getLimitPoint, getName, getParDimension, getUserData, putAllUserData, putUserData, removeChangeListener, removeUserData, setName, size, toText

Methods inherited from interface geomss.geom.Transformable

getTransformed

Method Detail

newInstance

public static NoteTrans newInstance(GenScreenNote child,
                                    GTransform transform)

Returns a 3D NoteTrans instance holding the specified GenScreenNote and GTransform.

Parameters:

child - The note that is the child of this transform element (may not be null).

transform - The transform held by this transform element (may not be null).

Returns:

the transform element having the specified values.

Throws:

DimensionException - if the input element is not 3D.

getTransform

public GTransform getTransform()

Returns the transformation represented by this transformation element.

Specified by:

getTransform in interface GeomTransform<GenScreenNote>

Returns:

The transformation represented by this transformation element.

getTotalTransform

public GTransform getTotalTransform()

Returns the total transformation represented by an entire chain of GeomTransform objects below this one.

Specified by:

getTotalTransform in interface GeomTransform<GenScreenNote>

Returns:

The total transformation represented by an entire chain of GeomTransform objects below this one.

setTransform

public void setTransform(GTransform transform)

Sets the transformation represented by this transformation element.

Specified by:

setTransform in interface GeomTransform<GenScreenNote>

Parameters:

transform - The transform to set this transform element to (may not be null).

getChild

public GenScreenNote getChild()

Returns the child object transformed by this transform element.

Specified by:

getChild in interface GeomTransform<GenScreenNote>

Returns:

The child object transformed by this transform element.

getNote

public java.lang.String getNote()

Return the text string associated with this note object.

Specified by:

getNote in class AbstractNote<GenScreenNote>

Returns:

The text string associated with this note object.

getLocation

public Point getLocation()

Return the location of this note in model space.

Specified by:

getLocation in class AbstractNote<GenScreenNote>

Returns:

The location of this note in model space.

getFont

public java.awt.Font getFont()

Return the font used to display this note.

Specified by:

getFont in class AbstractNote<GenScreenNote>

Returns:

The font used to display this note.

immutable

public Note immutable()

Return an immutable version of this note.

Specified by:

immutable in class GenScreenNote

Returns:

An immutable version of this note.

changeFont

public NoteTrans changeFont(java.awt.Font font)

Return a new note object identical to this one, but with the specified font.

Specified by:

changeFont in class AbstractNote<GenScreenNote>

Parameters:

font - The font for the copy of this note. May not be null.

Returns:

A new note object identical to this one, but with the specified font.

changeLocation

public NoteTrans changeLocation(GeomPoint location)

Return a new note object identical to this one, but with the specified location in model space.

Specified by:

changeLocation in class AbstractNote<GenScreenNote>

Parameters:

location - The location for the copy of this note. May not be null.

Returns:

A new note object identical to this one, but with the specified location in model space.

copyToReal

public Note copyToReal()

Return a copy of the child object transformed by this transformation.

Specified by:

copyToReal in interface GeomElement<GenScreenNote>

Specified by:

copyToReal in interface GeomTransform<GenScreenNote>

Returns:

A copy of the child object transformed by this transformation.

getPhyDimension

public int getPhyDimension()

Returns the number of physical dimensions of the geometry element. This implementation always returns 3.

Specified by:

getPhyDimension in interface GeomElement<GenScreenNote>

Returns:

The number of physical dimensions of this geometry element.

isValid

public boolean isValid()

Return true if this Note contains valid and finite numerical components. A value of false will be returned if any of the coordinate values are NaN or Inf.

Specified by:

isValid in interface GeomElement<GenScreenNote>

Returns:

true if this geometry element contains valid and finite data.

copy

public NoteTrans copy()

Returns a copy of this NoteTrans instance allocated by the calling thread (possibly on the stack).

Specified by:

copy in interface GeomElement<GenScreenNote>

Returns:

an identical and independent copy of this note.

getUnit

public final javax.measure.unit.Unit<javax.measure.quantity.Length> getUnit()

Returns the unit in which the note location Point is stored.

Specified by:

getUnit in interface GeomElement<GenScreenNote>

Returns:

The unit in which the geometry in this element are stated.

to

public NoteTrans to(javax.measure.unit.Unit<javax.measure.quantity.Length> unit)
             throws javax.measure.converter.ConversionException

Returns the equivalent to this note but with the location stated in the specified unit.

Specified by:

to in interface GeomElement<GenScreenNote>

Parameters:

unit - the length unit of the note to be returned. May not be null.

Returns:

an equivalent of this note but with location stated in the specified unit.

Throws:

javax.measure.converter.ConversionException - if the the input unit is not a length unit.

toDimension

public NoteTrans toDimension(int newDim)

Return the equivalent of this note converted to the specified number of physical dimensions. This implementation will throw an exception if the specified dimension is anything other than 3.

Specified by:

toDimension in interface GeomElement<GenScreenNote>

Parameters:

newDim - The dimension of the point to return. MUST equal 3.

Returns:

The equivalent of this note converted to the new dimensions.

Throws:

java.lang.IllegalArgumentException - if the new dimension is anything other than 3.

equals

public boolean equals(java.lang.Object obj)

Compares this NoteTrans against the specified object for strict equality (same values and same units).

Overrides:

equals in class AbstractGeomElement<GenScreenNote>

Parameters:

obj - the object to compare with.

Returns:

true if this note is identical to that note; false otherwise.

hashCode

public int hashCode()

Returns the hash code for this parameter.

Overrides:

hashCode in class AbstractGeomElement<GenScreenNote>

Returns:

the hash code value.