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

Constructor Summary

Line()
Creates a line segment.

Method Summary

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

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

calculateArea2D, copyTo, 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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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).