gov.nasa.worldwind.globe

Interface GeographicProjection

All Known Implementing Classes:

ProjectionWgs84

public interface GeographicProjection

Represents transformations between geographic coordinates and Cartesian coordinates. GeographicProjection specifies the Cartesian coordinate system used by Globe and WorldWindow.

Method Summary

Modifier and Type	Method and Description
Position	cartesianToGeographic(Globe globe, double x, double y, double z, Vec3 offset, Position result) Converts a Cartesian point to a geographic position.
Matrix4	cartesianToLocalTransform(Globe globe, double x, double y, double z, Vec3 offset, Matrix4 result)
Vec3	geographicToCartesian(Globe globe, double latitude, double longitude, double altitude, Vec3 offset, Vec3 result) Converts a geographic position to Cartesian coordinates.
float[]	geographicToCartesianGrid(Globe globe, Sector sector, int numLat, int numLon, double[] elevations, Vec3 origin, Vec3 offset, float[] result, int stride, int pos)
Vec3	geographicToCartesianNormal(Globe globe, double latitude, double longitude, Vec3 result)
Matrix4	geographicToCartesianTransform(Globe globe, double latitude, double longitude, double altitude, Vec3 offset, Matrix4 result)
java.lang.String	getDisplayName() This projection's display name.
boolean	intersect(Globe globe, Line line, Vec3 offset, Vec3 result) Computes the first intersection of a specified globe and line.

Method Detail

getDisplayName

java.lang.String getDisplayName()

This projection's display name.

Returns:

the display name

geographicToCartesian

Vec3 geographicToCartesian(Globe globe,
                           double latitude,
                           double longitude,
                           double altitude,
                           Vec3 offset,
                           Vec3 result)

Converts a geographic position to Cartesian coordinates.

Parameters:

globe - the globe this projection is applied to

latitude - the position's latitude in degrees

longitude - the position's longitude in degrees

altitude - the position's altitude in meters

offset - an offset to apply to the Cartesian output. Typically only projections that are continuous apply to this offset. Others ignore it. May be null to indicate no offset is applied.

result - a pre-allocated Vec3 in which to store the computed X, Y and Z Cartesian coordinates

Returns:

the result argument, set to the computed Cartesian coordinates

Throws:

java.lang.IllegalArgumentException - If any argument is null

geographicToCartesianNormal

Vec3 geographicToCartesianNormal(Globe globe,
                                 double latitude,
                                 double longitude,
                                 Vec3 result)

Parameters:

globe -

latitude -

longitude -

result -

Returns:

geographicToCartesianTransform

Matrix4 geographicToCartesianTransform(Globe globe,
                                       double latitude,
                                       double longitude,
                                       double altitude,
                                       Vec3 offset,
                                       Matrix4 result)

Parameters:

globe -

latitude -

longitude -

altitude -

result -

Returns:

geographicToCartesianGrid

float[] geographicToCartesianGrid(Globe globe,
                                  Sector sector,
                                  int numLat,
                                  int numLon,
                                  double[] elevations,
                                  Vec3 origin,
                                  Vec3 offset,
                                  float[] result,
                                  int stride,
                                  int pos)

Parameters:

globe -

sector -

numLat -

numLon -

elevations -

origin -

offset -

result -

stride -

pos -

Returns:

cartesianToGeographic

Position cartesianToGeographic(Globe globe,
                               double x,
                               double y,
                               double z,
                               Vec3 offset,
                               Position result)

Converts a Cartesian point to a geographic position.

Parameters:

globe -

x - the Cartesian point's X component

y - the Cartesian point's Y component

z - the Cartesian point's Z component

offset - an offset to apply to the Cartesian output. Typically only projections that are continuous apply to this offset. Others ignore it. May be null to indicate no offset is applied.

result - a pre-allocated Position in which to store the computed geographic position

Returns:

the result argument, set to the computed geographic position

Throws:

java.lang.IllegalArgumentException - if the result is null

cartesianToLocalTransform

Matrix4 cartesianToLocalTransform(Globe globe,
                                  double x,
                                  double y,
                                  double z,
                                  Vec3 offset,
                                  Matrix4 result)

intersect

boolean intersect(Globe globe,
                  Line line,
                  Vec3 offset,
                  Vec3 result)

Computes the first intersection of a specified globe and line. The line is interpreted as a ray; intersection points behind the line's origin are ignored.

Parameters:

globe - the globe this projection is applied to

line - the line to intersect with the globe

offset - an offset to apply to the Cartesian output. Typically only projections that are continuous apply to this offset. Others ignore it. May be null to indicate no offset is applied.

result - a pre-allocated Vec3 in which to return the computed point

Returns:

true if the ray intersects the globe, otherwise false

Throws:

java.lang.IllegalArgumentException - If any of the globe, line or result are null