Package com.luciad.format.gml32.model

Class TLcdGML32Polygon

java.lang.Object

com.luciad.datamodel.TLcdDataObject

com.luciad.format.gml32.model.TLcdGML32AbstractGML

com.luciad.format.gml32.model.TLcdGML32AbstractGeometry

com.luciad.format.gml32.model.TLcdGML32AbstractGeometricPrimitive

com.luciad.format.gml32.model.TLcdGML32AbstractSurface

com.luciad.format.gml32.model.TLcdGML32Polygon

All Implemented Interfaces:

ILcdDataObject, ILcdBounded, ILcdEditableSurface, ILcdShape, ILcdSurface, ILcdCloneable, ILcdDeepCloneable, Serializable, Cloneable

public class TLcdGML32Polygon
extends TLcdGML32AbstractSurface
implements ILcdEditableSurface

A Polygon is a special surface that is defined by a single surface patch (see D.3.6). The boundary of this patch is coplanar and the polygon uses planar interpolation in its interior. The elements exterior and interior describe the surface boundary of the polygon.

Since:

10.0

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final TLcdDataProperty	EXTERIOR_PROPERTY	Data property that maps to the exterior element.
static final TLcdDataProperty	INTERIOR_PROPERTY	Data property that maps to the interior element.

Fields inherited from class com.luciad.format.gml32.model.TLcdGML32AbstractGeometry

SRS_PROPERTY

Fields inherited from class com.luciad.format.gml32.model.TLcdGML32AbstractGML

DESCRIPTION_PROPERTY, DESCRIPTION_REFERENCE_PROPERTY, ID_PROPERTY, IDENTIFIER_PROPERTY, META_DATA_PROPERTY_PROPERTY, NAME_PROPERTY

Constructor Summary

Constructors

Constructor	Description
TLcdGML32Polygon()
TLcdGML32Polygon(TLcdDataType aType)
TLcdGML32Polygon(TLcdDataType aDataType, ILcdModelReference aSrs)	Constructs a polygon and initializes its model reference (srs).
TLcdGML32Polygon(ILcdModelReference aSrs)	Constructs a polygon and initializes its model reference (srs).

Method Summary

Modifier and Type	Method	Description
TLcdGML32Polygon	clone()	Returns a deep clone of this object.
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.
TLcdGML32AbstractRing	getExterior()	Returns the role value contained in the value of the EXTERIOR_PROPERTY property.
ILcdRing	getExteriorRing()	Returns the exterior boundary of this surface.
ILcdPoint	getFocusPoint()	Returns the focus point of this ILcdShape.
List<TLcdGML32AbstractRing>	getInterior()	Gets the value of the INTERIOR_PROPERTY property adapted to a list of TLcdGML32AbstractRing instances.
List<ILcdRing>	getInteriorRings()	Returns the holes in this surface, as a list of ILcdRing instances.
void	setExterior(TLcdGML32AbstractRing aValue)	Sets the value of the property that maps to the exterior element.
void	setExteriorRing(ILcdRing aExteriorRing)	Sets the exterior boundary of this surface.

Methods inherited from class com.luciad.format.gml32.model.TLcdGML32AbstractGeometry

getSrs, setSrs, toString

Methods inherited from class com.luciad.format.gml32.model.TLcdGML32AbstractGML

getDescription, getDescriptionReference, getId, getIdentifier, getMetaDataProperty, getName, setDescription, setDescriptionReference, setId, setIdentifier

Methods inherited from class com.luciad.datamodel.TLcdDataObject

getDataType, getValue, getValue, hasValue, hasValue, setValue, setValue

Methods inherited from class java.lang.Object

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

Field Details

EXTERIOR_PROPERTY

public static final TLcdDataProperty EXTERIOR_PROPERTY

Data property that maps to the exterior element. The possible values for this property are instances of TLcdGML32AbstractRingProperty.

INTERIOR_PROPERTY

public static final TLcdDataProperty INTERIOR_PROPERTY

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

Constructor Details

TLcdGML32Polygon

public TLcdGML32Polygon()

TLcdGML32Polygon

public TLcdGML32Polygon(TLcdDataType aType)

TLcdGML32Polygon

public TLcdGML32Polygon(ILcdModelReference aSrs)

Constructs a polygon and initializes its model reference (srs).

Parameters:

aSrs - the model reference for this object

See Also:

• TLcdGML32AbstractGeometry.setSrs(ILcdModelReference)

TLcdGML32Polygon

public TLcdGML32Polygon(TLcdDataType aDataType,
 ILcdModelReference aSrs)

Constructs a polygon and initializes its model reference (srs).

Parameters:

aDataType - the data type for this object

aSrs - the model reference for this object

See Also:

• TLcdGML32AbstractGeometry.setSrs(ILcdModelReference)

Method Details

setExteriorRing

public void setExteriorRing(ILcdRing aExteriorRing)

Description copied from interface: ILcdEditableSurface

Sets the exterior boundary of this surface.

Note that this implementations may throw a ClassCastException or IllegalArgumentException in case the class of the ring is not compatible with the implementation of the surface. Implementations should specify in their documentation all restrictions that apply in this context.

Specified by:

setExteriorRing in interface ILcdEditableSurface

Parameters:

aExteriorRing - the exterior boundary of this surface.

getExteriorRing

public ILcdRing getExteriorRing()

Description copied from interface: ILcdSurface

Returns the exterior boundary of this surface.

Specified by:

getExteriorRing in interface ILcdSurface

Returns:

the exterior boundary of this surface.

getInteriorRings

public List<ILcdRing> getInteriorRings()

Description copied from interface: ILcdEditableSurface

Returns the holes in this surface, as a list of ILcdRing instances. If there are no holes, an empty list is returned.

The returned list is editable and can be used to add, remove or replace interior rings.

Specified by:

getInteriorRings in interface ILcdEditableSurface

Specified by:

getInteriorRings in interface ILcdSurface

Returns:

an editable list containing zero or more rings, representing the holes in this surface.

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

Overrides:

contains2D in class TLcdGML32AbstractGeometry

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(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

Overrides:

contains3D in class TLcdGML32AbstractGeometry

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.

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

Overrides:

contains2D in class TLcdGML32AbstractGeometry

Parameters:

aPoint - the ILcdPoint to test.

Returns:

the boolean result of the containment test.

See Also:

• ILcdShape.contains2D(double, double)

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

Overrides:

contains3D in class TLcdGML32AbstractGeometry

Parameters:

aPoint - the ILcdPoint to test.

Returns:

the boolean result of the containment test.

See Also:

• ILcdShape.contains3D(double, double, double)

getFocusPoint

public ILcdPoint getFocusPoint()

Description copied from interface: ILcdShape

Returns the focus point of this ILcdShape.

Specified by:

getFocusPoint in interface ILcdShape

Overrides:

getFocusPoint in class TLcdGML32AbstractGeometry

Returns:

the focus point of this ILcdShape.

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

Overrides:

getBounds in class TLcdGML32AbstractGeometry

Returns:

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

clone

public TLcdGML32Polygon clone()

Description copied from class: TLcdDataObject

Returns a deep clone of this object. This method delegates to TLcdDataObject.clone(Map).

Specified by:

clone in interface ILcdCloneable

Overrides:

clone in class TLcdDataObject

Returns:

a deep clone of this object

See Also:

• Object.clone()

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

getExterior

public TLcdGML32AbstractRing getExterior()

Returns the role value contained in the value of the EXTERIOR_PROPERTY property. Returns null if the value of the EXTERIOR_PROPERTY property is null.

A boundary of a surface consists of a number of rings. In the normal 2D case, one of these rings is distinguished as being the exterior boundary. In a general manifold this is not always possible, in which case all boundaries shall be listed as interior boundaries, and the exterior will be empty.

Returns:

the role value of the EXTERIOR_PROPERTY property.

See Also:

• TLcdGML32AbstractRingProperty

setExterior

public void setExterior(TLcdGML32AbstractRing aValue)

Sets the value of the property that maps to the exterior element. to a new instance of the association class TLcdGML32AbstractRingProperty initialized with the given role value. In case the given role value is null, the EXTERIOR_PROPERTY property is set to null.

A boundary of a surface consists of a number of rings. In the normal 2D case, one of these rings is distinguished as being the exterior boundary. In a general manifold this is not always possible, in which case all boundaries shall be listed as interior boundaries, and the exterior will be empty.

Parameters:

aValue - the role value to set for the EXTERIOR_PROPERTY property.

getInterior

public List<TLcdGML32AbstractRing> getInterior()

Gets the value of the INTERIOR_PROPERTY property adapted to a list of TLcdGML32AbstractRing instances.

A boundary of a surface consists of a number of rings. The "interior" rings separate the surface / surface patch from the area enclosed by the rings.

Returns:

the value of the INTERIOR_PROPERTY property adapted to a list of TLcdGML32AbstractRing instances.

See Also:

• TLcdGML32AbstractRingProperty