de.micromata.opengis.kml.v_2_2_0

Class LineString

java.lang.Object

de.micromata.opengis.kml.v_2_2_0.AbstractObject

de.micromata.opengis.kml.v_2_2_0.Geometry

de.micromata.opengis.kml.v_2_2_0.LineString

All Implemented Interfaces:

Cloneable

public class LineString
extends Geometry
implements Cloneable

Defines a connected set of line segments. Use to specify the color, color mode, and width of the line. When a LineString is extruded, the line is extended to the ground, forming a polygon that looks somewhat like a wall or fence. For extruded LineStrings, the line itself uses the current LineStyle, and the extrusion uses the current PolyStyle. See the KML Tutorial for examples of LineStrings (or paths).

Syntax:

<LineString id="ID">
   <!-- specific to LineString -->
   <extrude>0</extrude>                   <!-- boolean -->
   <tessellate>0</tessellate>             <!-- boolean -->
   <altitudeMode>clampToGround</altitudeMode> 
       <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
         <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
                        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
   <coordinates>...</coordinates>         <!-- lon,lat[,alt] -->
 </LineString>

Extends:

Field Summary

Fields

Modifier and Type	Field and Description
protected AltitudeMode	altitudeMode AltitudeMode clampToGround, relativeToGround, absolute See Also: See and
protected List<Coordinate>	coordinates (required) A single tuple consisting of floating point values for longitude, latitude, and altitude (in that order).
protected Boolean	extrude Boolean value.
protected List<AbstractObject>	lineStringObjectExtension
protected List<Object>	lineStringSimpleExtension
protected Boolean	tessellate Boolean value.

Fields inherited from class de.micromata.opengis.kml.v_2_2_0.Geometry

geometryObjectExtension, geometrySimpleExtension

Fields inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject

id, objectSimpleExtension, targetId

Constructor Summary

Constructors

Constructor and Description
LineString()

Method Summary

Methods

Modifier and Type	Method and Description
LineString	addToCoordinates(double longitude, double latitude) add a value to the coordinates property collection
LineString	addToCoordinates(double longitude, double latitude, double altitude) add a value to the coordinates property collection
LineString	addToCoordinates(String coordinates) add a value to the coordinates property collection
LineString	addToGeometryObjectExtension(AbstractObject geometryObjectExtension) add a value to the geometryObjectExtension property collection
LineString	addToGeometrySimpleExtension(Object geometrySimpleExtension) add a value to the geometrySimpleExtension property collection
LineString	addToLineStringObjectExtension(AbstractObject lineStringObjectExtension) add a value to the lineStringObjectExtension property collection
LineString	addToLineStringSimpleExtension(Object lineStringSimpleExtension) add a value to the lineStringSimpleExtension property collection
LineString	addToObjectSimpleExtension(Object objectSimpleExtension) add a value to the objectSimpleExtension property collection
LineString	clone()
List<Coordinate>	createAndSetCoordinates() Creates a new instance of List<Coordinate and set it to this.coordinates.
boolean	equals(Object obj)
AltitudeMode	getAltitudeMode()
List<Coordinate>	getCoordinates()
List<AbstractObject>	getLineStringObjectExtension()
List<Object>	getLineStringSimpleExtension()
int	hashCode()
Boolean	isExtrude()
Boolean	isTessellate()
void	setAltitudeMode(AltitudeMode value)
void	setCoordinates(List<Coordinate> coordinates)
void	setExtrude(Boolean value)
void	setGeometryObjectExtension(List<AbstractObject> geometryObjectExtension)
void	setGeometrySimpleExtension(List<Object> geometrySimpleExtension)
void	setLineStringObjectExtension(List<AbstractObject> lineStringObjectExtension)
void	setLineStringSimpleExtension(List<Object> lineStringSimpleExtension)
void	setObjectSimpleExtension(List<Object> objectSimpleExtension)
void	setTessellate(Boolean value)
LineString	withAltitudeMode(AltitudeMode altitudeMode) fluent setter
LineString	withCoordinates(List<Coordinate> coordinates) fluent setter
LineString	withExtrude(Boolean extrude) fluent setter
LineString	withGeometryObjectExtension(List<AbstractObject> geometryObjectExtension) fluent setter
LineString	withGeometrySimpleExtension(List<Object> geometrySimpleExtension) fluent setter
LineString	withId(String id) fluent setter
LineString	withLineStringObjectExtension(List<AbstractObject> lineStringObjectExtension) fluent setter
LineString	withLineStringSimpleExtension(List<Object> lineStringSimpleExtension) fluent setter
LineString	withObjectSimpleExtension(List<Object> objectSimpleExtension) fluent setter
LineString	withTargetId(String targetId) fluent setter
LineString	withTessellate(Boolean tessellate) fluent setter

Methods inherited from class de.micromata.opengis.kml.v_2_2_0.Geometry

getGeometryObjectExtension, getGeometrySimpleExtension

Methods inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject

getId, getObjectSimpleExtension, getTargetId, setId, setTargetId

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

extrude

protected Boolean extrude

Boolean value. Specifies whether to connect the LineString to the ground. To extrude a LineString, the altitude mode must be either relativeToGround, relativeToSeaFloor, or absolute. The vertices in the LineString are extruded toward the center of the Earth's sphere.

Boolean value. Specifies whether to connect the LinearRing to the ground. To extrude this geometry, the altitude mode must be either relativeToGround, relativeToSeaFloor, or absolute. Only the vertices of the LinearRing are extruded, not the center of the geometry. The vertices are extruded toward the center of the Earth's sphere.

Boolean value. Specifies whether to connect the Polygon to the ground. To extrude a Polygon, the altitude mode must be either relativeToGround, relativeToSeaFloor, or absolute. Only the vertices are extruded, not the geometry itself (for example, a rectangle turns into a box with five faces. The vertices of the Polygon are extruded toward the center of the Earth's sphere.

Boolean value. Specifies whether to connect the point to the ground with a line. To extrude a Point, the value for must be either relativeToGround, relativeToSeaFloor, or absolute. The point is extruded toward the center of the Earth's sphere.

tessellate

protected Boolean tessellate

Boolean value. Specifies whether to allow the LineString to follow the terrain. To enable tessellation, the altitude mode must be clampToGround or clampToSeaFloor. Very large LineStrings should enable tessellation so that they follow the curvature of the earth (otherwise, they may go underground and be hidden).

Boolean value. Specifies whether to allow the LinearRing to follow the terrain. To enable tessellation, the value for must be clampToGround or clampToSeaFloor. Very large LinearRings should enable tessellation so that they follow the curvature of the earth (otherwise, they may go underground and be hidden).

Boolean value. Specifies whether to allow the Polygon to follow the terrain. To enable tessellation, the Polygon must have an altitude mode of clampToGround or clampToSeaFloor. Very large Polygons should enable tessellation so that they follow the curvature of the earth (otherwise, they may go underground and be hidden).

altitudeMode

protected AltitudeMode altitudeMode

AltitudeMode

clampToGround, relativeToGround, absolute

See Also: See and

coordinates

protected List<Coordinate> coordinates

(required)

A single tuple consisting of floating point values for longitude, latitude, and altitude (in that order). Longitude and latitude values are in degrees, where longitude ≥ −180 and <= 180 latitude ≥ −90 and ≤ 90 altitude values (optional) are in meters above sea level

Do not include spaces between the three values that describe a coordinate.

Two or more coordinate tuples, each consisting of floating point values for longitude, latitude, and altitude. The altitude component is optional. Insert a space between tuples. Do not include spaces within a tuple.

lineStringSimpleExtension

protected List<Object> lineStringSimpleExtension

lineStringObjectExtension

protected List<AbstractObject> lineStringObjectExtension