com.esri.core.geometry

Class Line

java.lang.Object

com.esri.core.geometry.Geometry

com.esri.core.geometry.Segment

com.esri.core.geometry.Line

All Implemented Interfaces:

Serializable

public final class Line
extends Segment
implements Serializable

A straight line between a pair of points.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.esri.core.geometry.Geometry

Geometry.GeometryAccelerationDegree, Geometry.GeometryType, Geometry.Type

Constructor Summary

Constructors

Constructor and Description
Line() Creates a line segment.

Method Summary

Methods

Modifier and Type	Method and Description
void	applyTransformation(Transformation2D transform) Applies 2D affine transformation in XY plane.
double	calculateLength2D() Calculates the length of the geometry.
Geometry	createInstance() Creates an instance of an empty geometry of the same type.
boolean	equals(Object other)
double	getAttributeAsDbl(double t, int semantics, int ordinate) Returns the attribute on the segment for the given parameter value.
Geometry.Type	getType() Returns the geometry type.
int	intersectionWithAxis2D(boolean b_axis_x, double ordinate, double[] result_ordinates, double[] parameters) Calculates intersection points of this segment with an infinite line, parallel to one of the axes.
boolean	isCurve() Indicates if the line segment is a curve.
void	queryEnvelope(Envelope env) Returns the axis aligned bounding box of the geometry.
void	queryEnvelope2D(Envelope2D env) Returns tight bbox of the Geometry in X, Y plane.
void	replaceNaNs(int semantics, double value) Replaces NaNs in the attribute with the given value.
String	toString() The output of this method can be only used for debugging.

Methods inherited from class com.esri.core.geometry.Segment

_assignVertexDescriptionImpl, calculateArea2D, copyTo, getBoundary, getDimension, getEndAttributeAsDbl, getEndAttributeAsInt, getEndX, getEndY, getStartAttributeAsDbl, getStartAttributeAsInt, getStartX, getStartY, isEmpty, isEmptyImpl, queryEnd, queryInterval, queryStart, setEmpty, setEnd, setEndAttribute, setEndAttribute, setStart, setStartAttribute, setStartAttribute

Methods inherited from class com.esri.core.geometry.Geometry

_getImpl, addAttribute, addID, addM, copy, dropAllAttributes, dropAttribute, getDescription, getDimensionFromType, getStateFlag, hasAttribute, hasID, hasM, hasZ, isArea, isLinear, isMultiPath, isMultiVertex, isPoint, isSegment, queryLooseEnvelope2D, vertex_count

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Line

public Line()

Creates a line segment.

Method Detail

getType

public Geometry.Type getType()

Description copied from class: Geometry

Returns the geometry type.

Specified by:

getType in class Geometry

Returns:

Returns the geometry type.

calculateLength2D

public double calculateLength2D()

Description copied from class: Geometry

Calculates the length of the geometry. If the spatial reference is a Geographic Coordinate System (a system where coordinates are defined using angular units such as longitude and latitude) then the 2D distance calculation is returned in angular units. In cases where length must be calculated on a Geographic Coordinate System consider the using the geodeticLength method on the GeometryEngine

Overrides:

calculateLength2D in class Geometry

Returns:

A double value representing the 2D length of the geometry.

isCurve

public boolean isCurve()

Indicates if the line segment is a curve.

queryEnvelope

public void queryEnvelope(Envelope env)

Description copied from class: Geometry

Returns the axis aligned bounding box of the geometry.

Specified by:

queryEnvelope in class Geometry

Parameters:

env - The envelope to return the result in.

queryEnvelope2D

public void queryEnvelope2D(Envelope2D env)

Description copied from class: Geometry

Returns tight bbox of the Geometry in X, Y plane.

Specified by:

queryEnvelope2D in class Geometry

applyTransformation

public void applyTransformation(Transformation2D transform)

Description copied from class: Geometry

Applies 2D affine transformation in XY plane.

Specified by:

applyTransformation in class Geometry

Parameters:

transform - The affine transformation to be applied to this geometry.

createInstance

public Geometry createInstance()

Description copied from class: Geometry

Creates an instance of an empty geometry of the same type.

Specified by:

createInstance in class Geometry

getAttributeAsDbl

public double getAttributeAsDbl(double t,
                       int semantics,
                       int ordinate)

Description copied from class: Segment

Returns the attribute on the segment for the given parameter value. The interpolation of attribute is given by the attribute interpolation type.

Specified by:

getAttributeAsDbl in class Segment

intersectionWithAxis2D

public int intersectionWithAxis2D(boolean b_axis_x,
                         double ordinate,
                         double[] result_ordinates,
                         double[] parameters)

Description copied from class: Segment

Calculates intersection points of this segment with an infinite line, parallel to one of the axes.

Specified by:

intersectionWithAxis2D in class Segment

Parameters:

b_axis_x - TRUE if the function works with the line parallel to the axis X.

ordinate - The ordinate value of the line (x for axis Y, y for axis X).

result_ordinates - The value of ordinate in the intersection points One ordinate is equal to the ordinate parameter. This parameter can be NULL.

parameters - The value of the parameter in the intersection points (between 0 and 1). This parameter can be NULL.

Returns:

The number of intersection points, 0 when no intersection points exist, -1 when the segment coincides with the line (infinite number of intersection points).

equals

public boolean equals(Object other)

Overrides:

equals in class Object

replaceNaNs

public void replaceNaNs(int semantics,
               double value)

Description copied from class: Geometry

Replaces NaNs in the attribute with the given value. If the geometry is not empty, it adds the attribute if geometry does not have it yet, and replaces the values. If the geometry is empty, it adds the attribute and does not set any values.

Specified by:

replaceNaNs in class Geometry

toString

public String toString()

The output of this method can be only used for debugging. It is subject to change without notice.

Overrides:

toString in class Geometry