com.luciad.format.gml31.model

LuciadFusionClass TLcdGML31Triangle

java.lang.Object

com.luciad.datamodel.TLcdDataObject

com.luciad.datamodel.TLcdFeaturedDataObject

com.luciad.format.gml31.model.TLcdGML31AbstractSurfacePatch

com.luciad.format.gml31.model.TLcdGML31Triangle

All Implemented Interfaces:

ILcdDataObject, ILcdBounded, ILcdPointList, ILcdPolygon, ILcdShape, ILcd2DEditablePointList, ILcd2DEditableShape, ILcd3DEditablePointList, ILcd3DEditablePolygon, ILcd3DEditableShape, ILcdCloneable, ILcdDeepCloneable, ILcdFeatured , ILcdSelfDescribedFeatured , java.io.Serializable, java.lang.Cloneable

public class TLcdGML31Triangle
extends TLcdGML31AbstractSurfacePatch
implements ILcd3DEditablePolygon

gml:Triangle represents a triangle as a surface patch with an outer boundary consisting of a linear ring. Note that this is a polygon (subtype) with no inner boundaries. The number of points in the linear ring shall be four. The ring (element exterior) shall be a gml:LinearRing and shall form a triangle, the first and the last position shall be coincident. interpolation is fixed to "planar", i.e. an interpolation shall return points on a single plane. The boundary of the patch shall be contained within that plane.

Since:

10.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static TLcdDataProperty	EXTERIOR_PROPERTY Data property that maps to the exterior element.
static TLcdDataProperty	INTERPOLATION_ATTR_PROPERTY Data property that maps to the interpolation attribute.

Fields inherited from interface com.luciad.shape.ILcdPolygon

CLOCKWISE, COUNTERCLOCKWISE, INVALID_ORIENTATION

Constructor Summary

Constructors

Constructor and Description
TLcdGML31Triangle()
TLcdGML31Triangle(ILcdModelReference aModelReference) Constructs a new instance and sets its exterior to a new TLcdGML31LinearRing initialized with the given model reference.
TLcdGML31Triangle(TLcdDataType aType)
TLcdGML31Triangle(TLcdDataType aDataType, ILcdModelReference aModelReference) Constructs a new instance and sets its exterior to a new TLcdGML31LinearRing initialized with the given model reference.

Method Summary

Modifier and Type	Method and Description
TLcdGML31Triangle	clone() Returns a deep clone of this object.
TLcdDataObject	clone(java.util.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 aArg0) 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 aArg0) 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.
TLcdGML31AbstractRing	getExterior() Returns the role value contained in the value of the EXTERIOR_PROPERTY property.
ILcdPoint	getFocusPoint() Returns the focus point of this ILcdShape.
ELcdGML31SurfaceInterpolation	getInterpolationAttr() Returns the value of the property that maps to the interpolation attribute.
int	getOrientation() Returns the orientation of this ILcdPolygon: ILcdPolygon.CLOCKWISE or ILcdPolygon.COUNTERCLOCKWISE.
ILcdPoint	getPoint(int aIndex) Returns the ILcdPoint at a given index.
int	getPointCount() Returns the number of ILcdPoint objects in the list.
void	insert2DPoint(int aIndex, double aX, double aY) Inserts a point at the given index into this ILcd2DEditablePointList.
void	insert3DPoint(int aIndex, double aX, double aY, double aZ) Inserts a point at the given index into this ILcd3DEditablePointList.
void	move2D(double aX, double aY) Moves this ILcd2DEditableShape to the given point in the 2D space.
void	move2D(ILcdPoint aArg0) Moves this ILcd2DEditableShape to the given point in the 2D space.
void	move2DPoint(int aIndex, double aX, double aY) Moves the specified point of this ILcd2DEditablePointList 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.
void	move3DPoint(int aIndex, double aX, double aY, double aZ) Moves the specified point of this ILcd3DEditablePointList to the given point in the 3D space.
void	removePointAt(int aIndex) Removes the point at the given index from this ILcd3DEditablePointList.
void	setExterior(TLcdGML31AbstractRing aValue) Sets the value of the property that maps to the exterior element.
void	setInterpolationAttr(ELcdGML31SurfaceInterpolation aValue) Sets the value of the property that maps to the interpolation attribute.
void	translate2D(double aX, double aY) Translates this ILcd2DEditableShape from its current position over the given translation vector in the 2D space.
void	translate2DPoint(int aIndex, double aX, double aY) Translates the specified point of this ILcd2DEditablePointList from its current position over the given translation vector in the 2D space.
void	translate3D(double aX, double aY, double aZ) Translates this ILcd3DEditableShape from its current position over the given translation vector in the 3D space.
void	translate3DPoint(int aIndex, double aX, double aY, double aZ) Translates the specified point of this ILcd3DEditablePointList from its current position over the given translation vector in the 3D space.

Methods inherited from class com.luciad.datamodel.TLcdFeaturedDataObject

canSetFeature, getFeature, getFeature, getFeatureCount, getFeaturedDescriptor, setFeature, setFeature

Methods inherited from class com.luciad.datamodel.TLcdDataObject

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.shape.shape2D.ILcd2DEditablePointList

append2DPoint

Methods inherited from interface com.luciad.shape.ILcdPointList

getPointSFCT, getX, getY, getZ

Field Detail

INTERPOLATION_ATTR_PROPERTY

public static final TLcdDataProperty INTERPOLATION_ATTR_PROPERTY

Data property that maps to the interpolation attribute. The possible values for this property are instances of ELcdGML31SurfaceInterpolation.

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 TLcdGML31AbstractRingProperty.

Constructor Detail

TLcdGML31Triangle

public TLcdGML31Triangle(TLcdDataType aType)

TLcdGML31Triangle

public TLcdGML31Triangle()

TLcdGML31Triangle

public TLcdGML31Triangle(ILcdModelReference aModelReference)

Constructs a new instance and sets its exterior to a new TLcdGML31LinearRing initialized with the given model reference.

Parameters:

aModelReference - the model reference of this object

TLcdGML31Triangle

public TLcdGML31Triangle(TLcdDataType aDataType,
                         ILcdModelReference aModelReference)

Constructs a new instance and sets its exterior to a new TLcdGML31LinearRing initialized with the given model reference.

Parameters:

aDataType - the data type for this object

aModelReference - the model reference of this object

Method Detail

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 TLcdGML31AbstractSurfacePatch

Parameters:

aX - the x coordinate of the point.

aY - the y coordinate of the point.

Returns:

the boolean result of the containment test.

contains2D

public boolean contains2D(ILcdPoint aArg0)

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 TLcdGML31AbstractSurfacePatch

Parameters:

aArg0 - the ILcdPoint to test.

Returns:

the boolean result of the containment test.

See Also:

ILcdShape.contains2D(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

Overrides:

contains3D in class TLcdGML31AbstractSurfacePatch

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.

contains3D

public boolean contains3D(ILcdPoint aArg0)

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 TLcdGML31AbstractSurfacePatch

Parameters:

aArg0 - the ILcdPoint to test.

Returns:

the boolean result of the containment test.

See Also:

ILcdShape.contains3D(double, double, double)

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 TLcdGML31AbstractSurfacePatch

Returns:

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

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 TLcdGML31AbstractSurfacePatch

Returns:

the focus point of this ILcdShape.

getOrientation

public int getOrientation()

Description copied from interface: ILcdPolygon

Returns the orientation of this ILcdPolygon: ILcdPolygon.CLOCKWISE or ILcdPolygon.COUNTERCLOCKWISE.

Specified by:

getOrientation in interface ILcdPolygon

Returns:

the orientation of this ILcdPolygon: ILcdPolygon.CLOCKWISE or ILcdPolygon.COUNTERCLOCKWISE. This method should not return INVALID_ORIENTATION, which is only to be used for resetting the orientation so that it can be recalculated.

getPointCount

public int getPointCount()

Description copied from interface: ILcdPointList

Returns the number of ILcdPoint objects in the list.

Specified by:

getPointCount in interface ILcdPointList

Returns:

the number of ILcdPoint objects in the list.

insert2DPoint

public void insert2DPoint(int aIndex,
                          double aX,
                          double aY)

Description copied from interface: ILcd2DEditablePointList

Inserts a point at the given index into this ILcd2DEditablePointList.

Specified by:

insert2DPoint in interface ILcd2DEditablePointList

Parameters:

aIndex - a valid new index in the list of points.

aX - the x coordinate of the new point.

aY - the y coordinate of the new point.

insert3DPoint

public void insert3DPoint(int aIndex,
                          double aX,
                          double aY,
                          double aZ)

Description copied from interface: ILcd3DEditablePointList

Inserts a point at the given index into this ILcd3DEditablePointList.

Specified by:

insert3DPoint in interface ILcd3DEditablePointList

Parameters:

aIndex - a valid new index in the list of points.

aX - the x coordinate of the new point.

aY - the y coordinate of the new point.

aZ - the z coordinate of the new point.

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.

move2D

public void move2D(ILcdPoint aArg0)

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:

aArg0 - the ILcdPoint to move to.

See Also:

ILcd2DEditableShape.move2D(double, double)

move2DPoint

public void move2DPoint(int aIndex,
                        double aX,
                        double aY)

Description copied from interface: ILcd2DEditablePointList

Moves the specified point of this ILcd2DEditablePointList to the given point in the 2D space. Only the first two dimensions of the ILcdShape are considered. The third dimension is left unchanged.

Specified by:

move2DPoint in interface ILcd2DEditablePointList

Parameters:

aIndex - a valid index in the list of points.

aX - the x coordinate of the point.

aY - the y coordinate of the point.

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.

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)

move3DPoint

public void move3DPoint(int aIndex,
                        double aX,
                        double aY,
                        double aZ)

Description copied from interface: ILcd3DEditablePointList

Moves the specified point of this ILcd3DEditablePointList to the given point in the 3D space.

Specified by:

move3DPoint in interface ILcd3DEditablePointList

Parameters:

aIndex - a valid index in the list of points.

aX - the x coordinate of the point.

aY - the y coordinate of the point.

aZ - the z coordinate of the point.

removePointAt

public void removePointAt(int aIndex)

Description copied from interface: ILcd3DEditablePointList

Removes the point at the given index from this ILcd3DEditablePointList.

Specified by:

removePointAt in interface ILcd2DEditablePointList

Specified by:

removePointAt in interface ILcd3DEditablePointList

Parameters:

aIndex - a valid index in the list of ILcdPoint objects.

translate2D

public void translate2D(double aX,
                        double aY)

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 ILcd2DEditablePointList

Specified by:

translate2D in interface ILcd2DEditableShape

Parameters:

aX - the x coordinate of the translation vector.

aY - the y coordinate of the translation vector.

translate2DPoint

public void translate2DPoint(int aIndex,
                             double aX,
                             double aY)

Description copied from interface: ILcd2DEditablePointList

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

Specified by:

translate2DPoint in interface ILcd2DEditablePointList

aX - the x coordinate of the translation vector.

aY - the y coordinate of the translation vector.

translate3D

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

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 ILcd3DEditablePointList

Specified by:

translate3D in interface ILcd3DEditableShape

Parameters:

aX - the x coordinate of the translation vector.

aY - the y coordinate of the translation vector.

aZ - the z coordinate of the translation vector.

translate3DPoint

public void translate3DPoint(int aIndex,
                             double aX,
                             double aY,
                             double aZ)

Description copied from interface: ILcd3DEditablePointList

Translates the specified point of this ILcd3DEditablePointList from its current position over the given translation vector in the 3D space.

Specified by:

translate3DPoint in interface ILcd3DEditablePointList

Parameters:

aIndex - a valid new index in the list of points.

aX - the x coordinate of the translation vector.

aY - the y coordinate of the translation vector.

aZ - the z coordinate of the translation vector.

getPoint

public ILcdPoint getPoint(int aIndex)
                   throws java.lang.IndexOutOfBoundsException

Description copied from interface: ILcdPointList

Returns the ILcdPoint at a given index.

Specified by:

getPoint in interface ILcdPointList

Parameters:

aIndex - a valid index in the list of ILcdPoint objects.

Returns:

the ILcdPoint at the given index.

Throws:

java.lang.IndexOutOfBoundsException - if the given index is out of bounds.

clone

public TLcdGML31Triangle 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(java.util.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

getInterpolationAttr

public ELcdGML31SurfaceInterpolation getInterpolationAttr()

Returns the value of the property that maps to the interpolation attribute.

The attribute "interpolation" specifies the interpolation mechanism used for this surface patch. Currently only planar surface patches are defined in GML 3, the attribute is fixed to "planar", i.e. the interpolation method shall return points on a single plane. The boundary of the patch shall be contained within that plane.

Returns:

the value of the INTERPOLATION_ATTR_PROPERTY property.

setInterpolationAttr

public void setInterpolationAttr(ELcdGML31SurfaceInterpolation aValue)

Sets the value of the property that maps to the interpolation attribute.

The attribute "interpolation" specifies the interpolation mechanism used for this surface patch. Currently only planar surface patches are defined in GML 3, the attribute is fixed to "planar", i.e. the interpolation method shall return points on a single plane. The boundary of the patch shall be contained within that plane.

Parameters:

aValue - the value to set for the INTERPOLATION_ATTR_PROPERTY property.

getExterior

public TLcdGML31AbstractRing 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:

TLcdGML31AbstractRingProperty

setExterior

public void setExterior(TLcdGML31AbstractRing aValue)

Sets the value of the property that maps to the exterior element. to a new instance of the association class TLcdGML31AbstractRingProperty 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.