gov.nasa.worldwind.symbology

Class TacticalGraphicUtil

java.lang.Object

gov.nasa.worldwind.symbology.TacticalGraphicUtil

public class TacticalGraphicUtil
extends java.lang.Object

Utility methods for working with tactical graphics.

Constructor Summary

Constructors

Constructor and Description
TacticalGraphicUtil()

Method Summary

Modifier and Type	Method and Description
static java.util.List<Position>	asPositionList(Globe globe, Vec4... points) Convert a list of cartesian points to Positions.
static Vec4	bezierCurve(Vec4[] controlPoints, double t, int[] coefficients) Compute a point along a Bezier curve defined by a list of control points.
protected static void	binomial(int n, int[] coefficients) Compute binomial coefficients for a polynomial of order n.
static java.lang.Object[]	getAltitudeRange(TacticalGraphic graphic) Get the altitude range from the graphic's modifiers.
static java.lang.Object[]	getDateRange(TacticalGraphic graphic) Get the date range from a graphic's modifiers.
static void	placeLabelsOnPath(DrawContext dc, java.lang.Iterable<? extends Position> positions, TacticalGraphicLabel label1, TacticalGraphicLabel label2, double distance) Position one or two labels some distance along the path.

Methods inherited from class java.lang.Object

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

Constructor Detail

TacticalGraphicUtil

public TacticalGraphicUtil()

Method Detail

asPositionList

public static java.util.List<Position> asPositionList(Globe globe,
                                                      Vec4... points)

Convert a list of cartesian points to Positions.

Parameters:

globe - Globe used to convert points to positions.

points - Points to convert.

Returns:

List of positions computed from cartesian points.

bezierCurve

public static Vec4 bezierCurve(Vec4[] controlPoints,
                               double t,
                               int[] coefficients)

Compute a point along a Bezier curve defined by a list of control points. The first and last points should mark the start and end of the curve.

This function implements the Bezier curve equation from "Mathematics for 3D Game Programming and Computer Graphics, Second Edition" by Eric Lengyel (equation 15.16, pg. 458).

A typical usage looks like this:

 Vec4[] controlPoints = ... // Determine control points appropriate for your curve

 List<Position> curvePositions = new ArrayList<Position>();
 int[] coefficients = new int[controlPoints.length];

 int intervals = 32;
 double delta = 1.0 / intervals;
 for (int i = 0; i < intervals; i++)
 {
     double t = i * delta;
     Vec4 pt = TacticalGraphicUtil.bezierCurve(controlPoints, t, coefficients);
     Position pos = globe.computePositionFromPoint(p);
     curvePositions.add(pos);
 }
 

Parameters:

controlPoints - Control points for the curve.

t - Interpolation parameter in the range [0..1].

coefficients - Array to store binomial coefficients between invocations of this function. On the first invocation, pass an int[] with length equal to the controlPoints array. bezierCurve will populate the array on the first invocation, and reuse the computed values on subsequent invocations.

Returns:

A point along the curve.

binomial

protected static void binomial(int n,
                               int[] coefficients)

Compute binomial coefficients for a polynomial of order n. Stated another way, computes the nth row of Pascal's triangle.

Parameters:

n - Order of polynomial for which to calculate coefficients.

coefficients - Array to receive coefficients. The length of this array must be n + 1.

getAltitudeRange

public static java.lang.Object[] getAltitudeRange(TacticalGraphic graphic)

Get the altitude range from the graphic's modifiers. This method looks at the value of the AVKey.ALTITUDE modifier, and returns the results as a two element array. If the value of the modifier is an Iterable, then this method returns the first two values of the iteration. If the value of the modifier is a single object, this method returns an array containing that object and null.

Parameters:

graphic - Graphic from which to retrieve dates.

Returns:

A two element array containing the altitude modifiers. One or both elements may be null.

getDateRange

public static java.lang.Object[] getDateRange(TacticalGraphic graphic)

Get the date range from a graphic's modifiers. This method looks at the value of the AVKey.DATE_TIME modifier, and returns the results as a two element array. If the value of the modifier is an Iterable, then this method returns the first two values of the iteration. If the value of the modifier is a single object, this method returns an array containing that object and null.

Parameters:

graphic - Graphic from which to retrieve dates.

Returns:

A two element array containing the altitude modifiers. One or both elements may be null.

placeLabelsOnPath

public static void placeLabelsOnPath(DrawContext dc,
                                     java.lang.Iterable<? extends Position> positions,
                                     TacticalGraphicLabel label1,
                                     TacticalGraphicLabel label2,
                                     double distance)

Position one or two labels some distance along the path. Top and bottom labels are often positioned above and below the same point, so this method supports positioning a pair of labels at the same point. The label offsets determine how the labels draw in relation to the line.

Parameters:

dc - Current draw context.

positions - Positions that describe the path.

label1 - First label to position.

label2 - Second label to position. (May be null.)

distance - Distance along the path at which to position the labels.