agi.foundation.geometry.discrete

(agi.foundation.graphics-2021r1.jar)

Class SurfaceExtentTriangulator

java.lang.Object

agi.foundation.geometry.discrete.SurfaceExtentTriangulator

public final class SurfaceExtentTriangulator
extends Object

Triangulates an extent on a central body into a triangle mesh and a surrounding boundary. The mesh is commonly visualized with the TriangleMeshPrimitive or SurfaceMeshPrimitive. The boundary is commonly visualized with the PolylinePrimitive. Triangle Mesh Primitive topic

See Also:

SurfaceTriangulatorResult, TriangleMeshPrimitive, SurfaceMeshPrimitive, PolylinePrimitive

Method Summary

Modifier and Type	Method and Description
static SurfaceTriangulatorResult	compute(CentralBody centralBody, CartographicExtent extent) Computes a triangulation on the specified centralBody for the specified extent.
static SurfaceTriangulatorResult	compute(CentralBody centralBody, CartographicExtent extent, double altitude, double granularity) Computes a triangulation on the specified centralBody for the specified extent.

Methods inherited from class java.lang.Object

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

Method Detail

compute

public static final SurfaceTriangulatorResult compute(CentralBody centralBody,
                                                      CartographicExtent extent)

Computes a triangulation on the specified centralBody for the specified extent. This is equivalent to calling agi.foundation.geometry.discrete.SurfaceExtentTriangulator#Compute(agi.foundation.celestial.CentralBody,agi.foundation.coordinates.CartographicExtent,system.Double,system.Double) with an altitude of 0 and a granularity of 1 degree.

Parameters:

centralBody - The central body to compute the triangulation on. The extent, in radians, to compute the triangulation for.

Returns:

A SurfaceTriangulatorResult object representing the triangulation. See agi.foundation.geometry.discrete.SurfaceExtentTriangulator#Compute(agi.foundation.celestial.CentralBody,agi.foundation.coordinates.CartographicExtent,system.Double,system.Double) for a full discussion.

See Also:

agi.foundation.geometry.discrete.SurfaceExtentTriangulator#Compute(agi.foundation.celestial.CentralBody,agi.foundation.coordinates.CartographicExtent,system.Double,system.Double)

compute

public static final SurfaceTriangulatorResult compute(CentralBody centralBody,
                                                      CartographicExtent extent,
                                                      double altitude,
                                                      double granularity)

Computes a triangulation on the specified centralBody for the specified extent.

Parameters:

centralBody - The central body to compute the triangulation on. The extent, in radians, to compute the triangulation for.

altitude - The altitude of the triangulation. When 0, the mesh is computed to conform to the ellipsoid.

granularity - The angular separation, in radians, of triangles in the triangulation. Lower granularities are more precise but create more triangles.

Returns:

A SurfaceTriangulatorResult object representing the triangulation. Using SurfaceExtentTriangulator to compute the triangulation for an extent is almost always more efficient than using the more general purpose SurfacePolygonTriangulator with the 4 corners of the extent. Also, SurfacePolygonTriangulator will connect the corners with great arcs which aren't necessarily lines of constant latitude and longitude, which is guaranteed by SurfaceExtentTriangulator.

Throws:

system.ArgumentNullException - centralBody is null.

system.ArgumentOutOfRangeException - extent south and north must both be between -90 degrees and 90 degrees.

system.ArgumentException - granularity must be greater than 0. Triangle Mesh Primitive topic