com.luciad.format.kml22.model.geometry

LuciadFusionClass TLcdKML22AbstractGeometry

java.lang.Object

com.luciad.datamodel.TLcdDataObject

com.luciad.format.kml22.model.TLcdKML22AbstractObject

com.luciad.format.kml22.model.geometry.TLcdKML22AbstractGeometry

All Implemented Interfaces:

ILcdDataObject, ILcdBounded, ILcdShape, ILcd2DEditableShape, ILcd3DEditableShape, ILcdCache, ILcdCloneable, ILcdDeepCloneable, Serializable, Cloneable

Direct Known Subclasses:

TLcdKML223DModel, TLcdKML22LinearRing, TLcdKML22LineString, TLcdKML22MultiGeometry, TLcdKML22Point, TLcdKML22Polygon

public class TLcdKML22AbstractGeometry
extends TLcdKML22AbstractObject
implements ILcd3DEditableShape, ILcdCache

Domain class modeling the KML AbstractGeometryType type.

TLcdKML22AbstractGeometry is the super class of all geometries that can be used within KML.

Since:

10.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static TLcdDataProperty	ABSTRACT_GEOMETRY_OBJECT_EXTENSION_GROUP_PROPERTY Data property that maps to the AbstractGeometryObjectExtensionGroup element.
static TLcdDataProperty	ABSTRACT_GEOMETRY_SIMPLE_EXTENSION_GROUP_PROPERTY Data property that maps to the AbstractGeometrySimpleExtensionGroup element.

Fields inherited from class com.luciad.format.kml22.model.TLcdKML22AbstractObject

ID_PROPERTY, OBJECT_SIMPLE_EXTENSION_GROUP_PROPERTY, TARGET_ID_PROPERTY

Constructor Summary

Constructors

Constructor and Description
TLcdKML22AbstractGeometry(TLcdDataType aType) Creates a new TLcdKML22AbstractGeometry with a custom TLcdDataType.

Method Summary

Modifier and Type	Method and Description
void	clearCache() Clears the cache.
TLcdDataObject	clone(Map aObjectDictionary) Returns a deep clone of this object.
boolean	contains2D(double aX, double aY) Checks whether this ILcdShape contains the given point in the 2D space.
boolean	contains2D(ILcdPoint aPoint) Checks whether this ILcdShape contains the given ILcdPoint in the 2D space.
boolean	contains3D(double aX, double aY, double aZ) Checks whether this ILcdShape contains the given point in the 3D space.
boolean	contains3D(ILcdPoint aPoint) Checks whether this ILcdShape contains the given ILcdPoint in the 3D space.
ILcdBounds	getBounds() Returns the ILcdBounds by which the geometry of this ILcdBounded object is bounded.
Object	getCachedObject(Object aKey) Looks up and returns the cached Object corresponding to the given key.
ILcdPoint	getFocusPoint() Returns the focus point of this ILcdShape.
void	insertIntoCache(Object aKey, Object aValue) Inserts a cache Object corresponding to the given key Object.
void	move2D(double aX, double aY) Moves this ILcd2DEditableShape to the given point in the 2D space.
void	move2D(ILcdPoint aPoint) Moves this ILcd2DEditableShape to the given point in the 2D space.
void	move3D(double aX, double aY, double aZ) Moves this ILcd3DEditableShape to the given point in the 3D space.
void	move3D(ILcdPoint aPoint) Moves this ILcd3DEditableShape to the given point in the 3D space.
Object	removeCachedObject(Object aKey) Looks up and removes the cached Object corresponding to the given key.
void	translate2D(double aDeltaX, double aDeltaY) Translates this ILcd2DEditableShape from its current position over the given translation vector in the 2D space.
void	translate3D(double aDeltaX, double aDeltaY, double aDeltaZ) Translates this ILcd3DEditableShape from its current position over the given translation vector in the 3D space.

Methods inherited from class com.luciad.format.kml22.model.TLcdKML22AbstractObject

getId, getTargetId, setId, setTargetId

Methods inherited from class com.luciad.datamodel.TLcdDataObject

clone, getDataType, getValue, getValue, hasValue, hasValue, setValue, setValue, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.util.ILcdCloneable

clone

Field Detail

ABSTRACT_GEOMETRY_SIMPLE_EXTENSION_GROUP_PROPERTY

public static final TLcdDataProperty ABSTRACT_GEOMETRY_SIMPLE_EXTENSION_GROUP_PROPERTY

Data property that maps to the AbstractGeometrySimpleExtensionGroup element. The possible values for this property are instances of List<String>.

ABSTRACT_GEOMETRY_OBJECT_EXTENSION_GROUP_PROPERTY

public static final TLcdDataProperty ABSTRACT_GEOMETRY_OBJECT_EXTENSION_GROUP_PROPERTY

Data property that maps to the AbstractGeometryObjectExtensionGroup element. The possible values for this property are instances of List<TLcdKML22AbstractObject>.

Constructor Detail

TLcdKML22AbstractGeometry

public TLcdKML22AbstractGeometry(TLcdDataType aType)

Creates a new TLcdKML22AbstractGeometry with a custom TLcdDataType.

Parameters:

aType - a custom TLcdDataType

Method Detail

move3D

public void move3D(ILcdPoint aPoint)

Description copied from interface: ILcd3DEditableShape

Moves this ILcd3DEditableShape to the given point in the 3D space. The focus point is used as the handle by which the shape is moved.

Specified by:

move3D in interface ILcd3DEditableShape

Parameters:

aPoint - the ILcdPoint to move to.

See Also:

ILcd3DEditableShape.move3D(double, double, double)

move3D

public void move3D(double aX,
                   double aY,
                   double aZ)

Description copied from interface: ILcd3DEditableShape

Moves this ILcd3DEditableShape to the given point in the 3D space. The focus point is used as the handle by which the shape is moved.

Specified by:

move3D in interface ILcd3DEditableShape

Parameters:

aX - the x coordinate of the point.

aY - the y coordinate of the point.

aZ - the z coordinate of the point.

translate3D

public void translate3D(double aDeltaX,
                        double aDeltaY,
                        double aDeltaZ)

Description copied from interface: ILcd3DEditableShape

Translates this ILcd3DEditableShape from its current position over the given translation vector in the 3D space.

Specified by:

translate3D in interface ILcd3DEditableShape

Parameters:

aDeltaX - the x coordinate of the translation vector.

aDeltaY - the y coordinate of the translation vector.

aDeltaZ - the z coordinate of the translation vector.

move2D

public void move2D(ILcdPoint aPoint)

Description copied from interface: ILcd2DEditableShape

Moves this ILcd2DEditableShape to the given point in the 2D space. The focus point is used as the handle by which the shape is moved. Only the first two dimensions of the ILcdShape and the ILcdPoint are considered. The third dimension is left unchanged.

Specified by:

move2D in interface ILcd2DEditableShape

Parameters:

aPoint - the ILcdPoint to move to.

See Also:

ILcd2DEditableShape.move2D(double, double)

move2D

public void move2D(double aX,
                   double aY)

Description copied from interface: ILcd2DEditableShape

Moves this ILcd2DEditableShape to the given point in the 2D space. The focus point is used as the handle by which the shape is moved. Only the first two dimensions of the ILcdShape are considered. The third dimension is left unchanged.

Specified by:

move2D in interface ILcd2DEditableShape

Parameters:

aX - the x coordinate of the point.

aY - the y coordinate of the point.

translate2D

public void translate2D(double aDeltaX,
                        double aDeltaY)

Description copied from interface: ILcd2DEditableShape

Translates this ILcd2DEditableShape from its current position over the given translation vector in the 2D space. Only the first two dimensions of the ILcdShape are considered. The third dimension is left unchanged.

Specified by:

translate2D in interface ILcd2DEditableShape

Parameters:

aDeltaX - the x coordinate of the translation vector.

aDeltaY - the y coordinate of the translation vector.

getFocusPoint

public ILcdPoint getFocusPoint()

Description copied from interface: ILcdShape

Returns the focus point of this ILcdShape.

Specified by:

getFocusPoint in interface ILcdShape

Returns:

the focus point of this ILcdShape.

contains2D

public boolean contains2D(ILcdPoint aPoint)

Description copied from interface: ILcdShape

Checks whether this ILcdShape contains the given ILcdPoint in the 2D space. Only the first two dimensions of the ILcdShape and the ILcdPoint are considered.

Specified by:

contains2D in interface ILcdShape

Parameters:

aPoint - the ILcdPoint to test.

Returns:

the boolean result of the containment test.

See Also:

ILcdShape.contains2D(double, double)

contains2D

public boolean contains2D(double aX,
                          double aY)

Description copied from interface: ILcdShape

Checks whether this ILcdShape contains the given point in the 2D space. Only the first two dimensions of the ILcdShape are considered.

Specified by:

contains2D in interface ILcdShape

Parameters:

aX - the x coordinate of the point.

aY - the y coordinate of the point.

Returns:

the boolean result of the containment test.

contains3D

public boolean contains3D(ILcdPoint aPoint)

Description copied from interface: ILcdShape

Checks whether this ILcdShape contains the given ILcdPoint in the 3D space.

Specified by:

contains3D in interface ILcdShape

Parameters:

aPoint - the ILcdPoint to test.

Returns:

the boolean result of the containment test.

See Also:

ILcdShape.contains3D(double, double, double)

contains3D

public boolean contains3D(double aX,
                          double aY,
                          double aZ)

Description copied from interface: ILcdShape

Checks whether this ILcdShape contains the given point in the 3D space.

Specified by:

contains3D in interface ILcdShape

Parameters:

aX - the x coordinate of the point.

aY - the y coordinate of the point.

aZ - the z coordinate of the point.

Returns:

the boolean result of the containment test.

getBounds

public ILcdBounds getBounds()

Description copied from interface: ILcdBounded

Returns the ILcdBounds by which the geometry of this ILcdBounded object is bounded.

If the geometry does not allow retrieving valid bounds (for example a polyline with 0 points) the return value is unspecified. It is highly recommended to return an undefined bounds. You can create undefined bounds using the default constructors of TLcdLonLatBounds or TLcdXYBounds.

Specified by:

getBounds in interface ILcdBounded

Returns:

the ILcdBounds by which the geometry of this ILcdBounded object is bounded.

getCachedObject

public Object getCachedObject(Object aKey)

Description copied from interface: ILcdCache

Looks up and returns the cached Object corresponding to the given key.

Specified by:

getCachedObject in interface ILcdCache

Parameters:

aKey - the key Object that was used for storing the cache Object.

Returns:

the cached Object, or null if there is no Object corresponding to the given key.

clearCache

public void clearCache()

Description copied from interface: ILcdCache

Clears the cache.

Specified by:

clearCache in interface ILcdCache

removeCachedObject

public Object removeCachedObject(Object aKey)

Description copied from interface: ILcdCache

Looks up and removes the cached Object corresponding to the given key.

Specified by:

removeCachedObject in interface ILcdCache

Parameters:

aKey - the key Object that was used for storing the cache Object.

Returns:

the cached Object, or null if there was no Object corresponding to the given key.

insertIntoCache

public void insertIntoCache(Object aKey,
                            Object aValue)

Description copied from interface: ILcdCache

Inserts a cache Object corresponding to the given key Object.

Specified by:

insertIntoCache in interface ILcdCache

Parameters:

aKey - the key Object that will be used to identify the Object. The key must therefore be a unique identifier, typically the caller itself: insertIntoCache(this, ...).

aValue - the Object to be cached.

clone

public TLcdDataObject clone(Map aObjectDictionary)

Description copied from class: TLcdDataObject

Returns a deep clone of this object. If the clone is not already present in the dictionary, a new instance if created as follows:

• First, a new instance is created using Java's clone() mechanism.
• Then, all properties of this object are cloned and set on the newly created instance. A property is cloned as follows:
  • If the property value is an ILcdDataObject, the value is cloned by first creating a new instance via the value.getDataType().newInstance() method, and then cloning its properties one by one.
  • If the value implements ILcdDeepCloneable or ILcdCloneable then this interface is used to clone the value.
  • Otherwise, the property value is copied by reference.

Specified by:

clone in interface ILcdDeepCloneable

Overrides:

clone in class TLcdDataObject

Parameters:

aObjectDictionary - the Object dictionary that keeps track of the objects for which a clone has already been made, and their corresponding clone Object.

Returns:

a deep clone of this object