com.mousebird.maply

Class ShapeGreatCircle

java.lang.Object

com.mousebird.maply.Shape

com.mousebird.maply.ShapeGreatCircle

public class ShapeGreatCircle
extends Shape

Represents an great circle or great circle with height.
Great circles are the shortest distance between two points on a globe. We extend that a bit here, by adding height. The result is a curved object that can either sit on top of the globe or rise above it. In either case it begins and ends at the specified points on the globe.

Field Summary

Fields inherited from class com.mousebird.maply.Shape

nativeHandle

Constructor Summary

Constructors

Constructor and Description
ShapeGreatCircle() Construct an empty sphere.

Method Summary

Modifier and Type	Method and Description
double	angleBetween() Angle between start and end points in radians.
void	dispose()
void	finalize()
void	setHeight(double height) Height of the great circle shape right in its middle.
void	setPoints(Point2d startLoc, Point2d endLoc) Starting and ending points in geographic radians.
void	setSamplingEpsilon(double eps) If set, the sampling value used when breaking the great circle down into segments.
void	setSamplingStatic(int numSamples) If set, we'll do a static number of samples, rather than dynamically calculating them.

Methods inherited from class com.mousebird.maply.Shape

getSelectID, isSelectable, setClipCoords, setColor, setColor, setSelectable, setSelectID

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ShapeGreatCircle

public ShapeGreatCircle()

Construct an empty sphere. Be sure to fill in the fields.

Method Detail

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object

setPoints

public void setPoints(Point2d startLoc,
                      Point2d endLoc)

Starting and ending points in geographic radians.

setHeight

public void setHeight(double height)

Height of the great circle shape right in its middle.
This is the height of the great circle right in the middle. It will built toward that height and then go back down as it reaches the endPt. The height is in display units. For the globe that's based on a radius of 1.0.

setSamplingEpsilon

public void setSamplingEpsilon(double eps)

If set, the sampling value used when breaking the great circle down into segments.

setSamplingStatic

public void setSamplingStatic(int numSamples)

If set, we'll do a static number of samples, rather than dynamically calculating them.

angleBetween

public double angleBetween()

Angle between start and end points in radians. Useful for calculating a reasonable height.

dispose

public void dispose()

Overrides:

dispose in class Shape